Merge remote-tracking branch 'upstream/master'

OWNERS_ALIASES

@@ -80,6 +80,12 @@ aliases:
     - jygastaud
     - awkif
     - oussemos
+  sig-docs-id-owners: # Admins for Indonesian content
+    - girikuncoro
+    - irfiva
+  sig-docs-id-reviews: # PR reviews for Indonesian content
+    - girikuncoro
+    - irfiva
   sig-docs-it-owners: # Admins for Italian content
     - rlenferink
     - micheleberardi

README-id.md

@@ -0,0 +1,72 @@
+# Dokumentasi Kubernetes
+
+[![Build Status](https://api.travis-ci.org/kubernetes/website.svg?branch=master)](https://travis-ci.org/kubernetes/website)
+[![GitHub release](https://img.shields.io/github/release/kubernetes/website.svg)](https://github.com/kubernetes/website/releases/latest)
+
+Selamat datang! Repositori ini merupakan wadah bagi semua komponen yang dibutuhkan untuk membuat [dokumentasi Kubernetes](https://kubernetes.io/). Kami merasa sangat senang apabila kamu berminat untuk menjadi kontributor!
+
+## Kontribusi pada dokumentasi
+
+Pertama, kamu dapat menekan tombol **Fork** yang berada pada bagian atas layar, untuk menyalin repositori pada akun Github-mu. Salinan ini disebut sebagai **fork**. Kamu dapat menambahkan konten pada **fork** yang kamu miliki, setelah kamu merasa cukup untuk menambahkan konten yang kamu miliki dan ingin memberikan konten tersebut pada kami, kamu dapat melihat **fork** yang telah kamu buat dan membuat **pull request** untuk memberi tahu kami bahwa kamu ingin menambahkan konten yang telah kamu buat.
+
+Setelah kamu membuat sebuah **pull request**, seorang **reviewer** akan memberikan masukan terhadap konten yang kamu sediakan serta beberapa hal yang dapat kamu lakukan apabila perbaikan diperlukan terhadap konten yang telah kamu sediakan. Sebagai seorang yang membuat **pull request**, **sudah menjadi kewajiban kamu untuk melakukan modifikasi terhadap konten yang kamu berikan sesuai dengan masukan yang diberikan oleh seorang reviewer Kubernetes**. Perlu kamu ketahui bahwa kamu dapat saja memiliki lebih dari satu orang **reviewer Kubernetes** atau dalam kasus kamu bisa saja mendapatkan **reviewer Kubernetes** yang berbeda dengan **reviewer Kubernetes** awal yang ditugaskan untuk memberikan masukan terhadap konten yang kamu sediakan. Selain itu, seorang **reviewer Kubernetes** bisa saja meminta masukan teknis dari [reviewer teknis Kubernetes](https://github.com/kubernetes/website/wiki/Tech-reviewers) jika diperlukan. 
+
+Untuk informasi lebih lanjut mengenai tata cara melakukan kontribusi, kamu dapat melihat tautan di bawah ini:
+
+* [Petunjuk Melakukan Kontribusi](https://kubernetes.io/docs/contribute/start/)
+* [Melakukan Tahap Staging pada Konten Dokumentasi yang telah Kamu Sediakan](http://kubernetes.io/docs/contribute/intermediate#view-your-changes-locally)
+* [Petunjuk Menggunakan Page Templates](http://kubernetes.io/docs/contribute/style/page-templates/)
+* [Petunjuk untuk Documentation Style](http://kubernetes.io/docs/contribute/style/style-guide/)
+* [Petunjuk untuk Melakukan Lokalisasi Dokumentasi Kubernetes](https://kubernetes.io/docs/contribute/localization/)
+
+## Menjalankan Dokumentasi Kubernetes pada Mesin Lokal Kamu
+
+Petunjuk yang disarankan untuk menjalankan Dokumentasi Kubernetes pada mesin lokal kamus adalah dengan menggunakan [Docker](https://docker.com) **image** yang memiliki **package** [Hugo](https://gohugo.io), **Hugo** sendiri merupakan generator website statis. 
+
+> Jika kamu menggunakan Windows, kamu mungkin membutuhkan beberapa langkah tambahan untuk melakukan instalasi perangkat lunak yang dibutuhkan. Instalasi ini dapat dilakukan dengan menggunakan [Chocolatey](https://chocolatey.org). `choco install make`
+
+> Jika kamu ingin menjalankan **website** tanpa menggunakan **Docker**, kamu dapat melihat tautan berikut [Petunjuk untuk menjalankan website pada mesin lokal dengan menggunakan Hugo](#petunjuk-untuk-menjalankan-website-pada-mesin-lokal-denga-menggunakan-hugo) di bagian bawah.
+
+Jika kamu sudah memiliki **Docker** [yang sudah dapat digunakan](https://www.docker.com/get-started), kamu dapat melakukan **build** `kubernetes-hugo` **Docker image** secara lokal:
+
+```bash
+make docker-image
+```
+
+Setelah **image** berhasil di-**build**, kamu dapat menjalankan website tersebut pada mesin lokal-mu:
+
+```bash
+make docker-serve
+```
+
+Buka **browser** kamu ke http://localhost:1313 untuk melihat laman dokumentasi. Selama kamu melakukan penambahan konten, **Hugo** akan secara otomatis melakukan perubahan terhadap laman dokumentasi apabila **browser** melakukan proses **refresh**.
+
+
+## Petunjuk untuk menjalankan website pada mesin lokal dengan menggunakan Hugo
+
+Kamu dapat melihat [dokumentasi resmi Hugo](https://gohugo.io/getting-started/installing/) untuk mengetahui langkah yang diperlukan untuk melakukan instalasi **Hugo**. Pastikan kamu melakukan instalasi versi **Hugo** sesuai dengan versi yang tersedia pada **environment variable** `HUGO_VERSION` pada **file**[`netlify.toml`](netlify.toml#L9). 
+
+Untuk menjalankan laman pada mesin lokal setelah instalasi **Hugo**, kamu dapat menjalankan perintah berikut:
+
+```bash
+make serve
+```
+
+Buka **browser** kamu ke http://localhost:1313 untuk melihat laman dokumentasi. Selama kamu melakukan penambahan konten, **Hugo** akan secara otomatis melakukan perubahan terhadap laman dokumentasi apabila **browser** melakukan proses **refresh**.
+
+## Komunitas, Diskusi, Kontribusi, dan Bantuan
+
+Kamu dapat belajar bagaimana tata cara untuk ikut terlibat dalam komunitas Kubernetes melalui [laman komunitas](http://kubernetes.io/community/).
+
+Kamu dapat berinteraksi dengan **maintainers** project ini melalui:
+
+- [Slack](https://kubernetes.slack.com/messages/sig-docs)
+- [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)
+
+### Etika dalam Berkontribusi
+
+Partisipasi dalam komunitas Kubernetes diatur dalam [Etika dalam Berkontribusi pada Kubernetes](code-of-conduct.md).
+
+## Terima Kasih!
+
+Kubernetes sangat menjunjung tinggi partisipasi dari komunitas, dan kami sangat mengapresiasi kontribusi kamu pada laman dan dokumentasi kami!

config.toml

@@ -224,3 +224,15 @@ contentDir = "content/es"
 time_format_blog = "02.01.2006"
 # A list of language codes to look for untranslated content, ordered from left to right.
 language_alternatives = ["en"]
+
+[languages.id]
+title = "Kubernetes"
+description = "Production-Grade Container Orchestration"
+languageName ="Bahasa Indonesia"
+weight = 10
+contentDir = "content/id"
+
+[languages.id.params]
+time_format_blog = "02.01.2006"
+# A list of language codes to look for untranslated content, ordered from left to right.
+language_alternatives = ["en"]

content/en/docs/concepts/overview/working-with-objects/kubernetes-objects.md

@@ -64,9 +64,9 @@ In the `.yaml` file for the Kubernetes object you want to create, you'll need to
 * `metadata` - Data that helps uniquely identify the object, including a `name` string, UID, and optional `namespace`
 
 You'll also need to provide the object `spec` field. The precise format of the object `spec` is different for every Kubernetes object, and contains nested fields specific to that object. The [Kubernetes API Reference](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/) can help you find the spec format for all of the objects you can create using Kubernetes.
-For example, the `spec` format for a `Pod` object can be found
+For example, the `spec` format for a `Pod` can be found
 [here](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#podspec-v1-core),
-and the `spec` format for a `Deployment` object can be found
+and the `spec` format for a `Deployment` can be found
 [here](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#deploymentspec-v1-apps).
 
 {{% /capture %}}

content/en/docs/concepts/policy/pod-security-policy.md

@@ -74,7 +74,7 @@ typically created indirectly as part of a
 [Deployment](/docs/concepts/workloads/controllers/deployment/),
 [ReplicaSet](/docs/concepts/workloads/controllers/replicaset/), or other
 templated controller via the controller manager. Granting the controller access
-to the policy would grant access for *all* pods created by that the controller,
+to the policy would grant access for *all* pods created by that controller,
 so the preferred method for authorizing policies is to grant access to the
 pod's service account (see [example](#run-another-pod)).
 

content/es/docs/concepts/_index.md

@@ -0,0 +1,77 @@
+---
+title: Conceptos
+main_menu: true
+content_template: templates/concept
+weight: 40
+---
+
+{{% capture overview %}}
+
+La sección de conceptos te ayudará a conocer los componentes de Kubernetes así como las abstracciones que utiliza para representar tu cluster. Además, te ayudará a obtener un conocimiento más profundo sobre cómo funciona Kubernetes.
+
+{{% /capture %}}
+
+{{% capture body %}}
+
+## Introducción
+
+En Kubernetes se utilizan objetos *objetos de la API de Kubernetes* para describir el *estado deseado* del clúster: qué aplicaciones u otras cargas de trabajo se quieren ejecutar, qué imagenes de contendores usan, el número de replicas, qué red y qué recursos de almacenamiento quieres que tengan disponibles, etc. Se especifica el estado deseado del clúster mediante la creación de objetos usando la API de Kubernetes, típicamente mediante la interfaz de línea de comandos, `kubectl`. También se puede usar la API de Kubernetes directamente para interactuar con el clúster y especificar o modificar tu estado deseado.
+
+Una vez que se especifica el estado deseado, el *Plano de Control de Kubernetes* realizará las acciones necesarias para que el estado actual del clúster coincida con el estado deseado. Para ello, Kubernetes realiza diferentes tareas de forma automática, como pueden ser: parar o arrancar contenedores, escalar el número de réplicas de una aplicación dada, etc. El Plano de Control de Kubernetes consiste en un grupo de procesos que corren en tu clúster:
+
+* El **Master de Kubernetes** es un conjunto de tres procesos que se ejecutan en un único nodo del clúster, que se denomina nodo master. Estos procesos son: [kube-apiserver](/docs/admin/kube-apiserver/), [kube-controller-manager](/docs/admin/kube-controller-manager/) y [kube-scheduler](/docs/admin/kube-scheduler/).
+
+* Los restantes nodos no master contenidos en tu clúster, ejecutan los siguientes dos procesos:
+  * **[kubelet](/docs/admin/kubelet/)**, el cual se comunica con el Master de Kubernetes.
+  * **[kube-proxy](/docs/admin/kube-proxy/)**, un proxy de red que implementa los servicios de red de Kubernetes en cada nodo.
+
+## Objetos de Kubernetes
+
+Kubernetes tiene diferentes abstracciones que representan el estado de tu sistema: aplicaciones contenerizadas desplegadas y cargas de trabajo, sus recursos de red y almacenamiento asociados e información adicional acerca de lo que el clúster está haciendo en un momento dado. Estas abstracciones están representadas por objetos de la API de Kubernetes. Puedes revisar [Entendiendo los Objetos de Kubernetes] (/docs/concepts/overview/working-with-objects/kubernetes-objects/) para obtener más detalles.
+
+Los objetos básicos de Kubernetes incluyen:
+
+* [Pod](/docs/concepts/workloads/pods/pod-overview/)
+* [Service](/docs/concepts/services-networking/service/)
+* [Volume](/docs/concepts/storage/volumes/)
+* [Namespace](/docs/concepts/overview/working-with-objects/namespaces/)
+
+Además, Kubernetes contiene abstracciónes de nivel superior llamadas Controladores. Los Controladores se basan en los objetos básicos y proporcionan funcionalidades adicionales sobre ellos. Incluyen:
+
+* [ReplicaSet](/docs/concepts/workloads/controllers/replicaset/)
+* [Deployment](/docs/concepts/workloads/controllers/deployment/)
+* [StatefulSet](/docs/concepts/workloads/controllers/statefulset/)
+* [DaemonSet](/docs/concepts/workloads/controllers/daemonset/)
+* [Job](/docs/concepts/workloads/controllers/jobs-run-to-completion/)
+
+
+## Plano de Control de Kubernetes
+
+Los distintos componentes del Plano de Control de Kubernetes, tales como el Master de Kubernetes y el proceso kubelet, gobiernan cómo Kubernetes se comunica con el clúster. El Plano de Control mantiene un registro de todos los Objetos de Kubernetes presentes en el sistema y ejecuta continuos bucles de control para gestionar el estado de los mismos. En un momento dado, los bucles del Plano de Control responderán a los cambios que se realicen en el clúster y ejecutarán las acciones necesarias para hacer que el estado actual de todos los objetos del sistema converjan hacia el estado deseado que has proporcionado.
+
+Por ejemplo, cuando usas la API de Kubernetes para crear un Deployment, estás proporcionando un nuevo estado deseado para el sistema. El Plano de Control de Kubernetes registra la creación del objeto y lleva a cabo tus instrucciones ejecutando las aplicaciones requeridas en los nodos del clúster, haciendo de esta manera que el estado actual coincida con el estado deseado.
+
+### El Master de Kubernetes
+
+El Master de Kubernetes es el responsable de mantener el estado deseado de tu clúster. Cuando interactuas con Kubernetes, como por ejemplo cuando utilizas la interfaz de línea de comandos `kubectl`, te estás comunicando con el master de tu clúster de Kubernetes.
+
+> Por "master" entendemos la colección de procesos que gestionan el estado del clúster. Típicamente, estos procesos se ejecutan todos en un único nodo del clúster, y este nodo recibe por tanto la denominación de master. El master puede estar replicado por motivos de disponibilidad y redundancia.
+
+### Kubernetes Nodes
+
+En un clúster de Kubernetes, los nodos son las máquinas (máquinas virtuales, servidores físicos, etc) que ejecutan tus aplicaciones y flujos de trabajo en la nube. El master de Kubernetes controla cada nodo, por lo que en raras ocasiones interactuarás con los nodos directamente.
+
+#### Metadatos de los Objectos
+
+
+* [Annotations](/docs/concepts/overview/working-with-objects/annotations/)
+
+{{% /capture %}}
+
+{{% capture whatsnext %}}
+
+Si estás interesado en escribir una página sobre conceptos,
+revisa [Usando Templates de Páginas](/docs/home/contribute/page-templates/)
+para obtener información sobre el tipo de página conceptos y la plantilla conceptos.
+
+{{% /capture %}}

content/es/docs/concepts/architecture/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Arquitectura de Kubernetes"
+weight: 30
+---

content/es/docs/concepts/cluster-administration/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Administración del Clúster"
+weight: 100
+---

content/es/docs/concepts/configuration/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Configuración"
+weight: 80
+---

content/es/docs/concepts/containers/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Contenedores"
+weight: 40
+---

content/es/docs/concepts/extend-kubernetes/_index.md

@@ -0,0 +1,4 @@
+---
+title: Extendiendo Kubernetes
+weight: 110
+---

content/es/docs/concepts/extend-kubernetes/api-extension/_index.md

@@ -0,0 +1,4 @@
+---
+title: Extendiendo la API de Kubernetes
+weight: 20
+---

content/es/docs/concepts/extend-kubernetes/compute-storage-net/_index.md

@@ -0,0 +1,4 @@
+---
+title: Extensiones de computación, almacenamiento y redes
+weight: 30
+---

content/es/docs/concepts/overview/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Introducción"
+weight: 20
+---

content/es/docs/concepts/overview/object-management-kubectl/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Gestión de objetos usando kubectl"
+weight: 50
+---

content/es/docs/concepts/overview/working-with-objects/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Objetos de Kubernetes"
+weight: 40
+---

content/es/docs/concepts/policy/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Políticas"
+weight: 90
+---

content/es/docs/concepts/services-networking/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Servicios, balanceo de carga y redes"
+weight: 60
+---

content/es/docs/concepts/storage/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Almacenamiento"
+weight: 70
+---

content/es/docs/concepts/workloads/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Cargas de trabajo"
+weight: 50
+---

content/es/docs/concepts/workloads/controllers/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Controladores"
+weight: 20
+---

content/es/docs/concepts/workloads/pods/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Pods"
+weight: 10
+---

content/es/docs/contribute/_index.md

@@ -0,0 +1,85 @@
+---
+content_template: templates/concept
+title: Contribuir a la documentación de Kubernetes
+linktitle: Contribuir
+main_menu: true
+weight: 80
+---
+
+{{% capture overview %}}
+
+Kubernetes es posible gracias a la participación de la comunidad y la
+documentación es vital para facilitar el acceso al proyecto.
+
+Cualquiera puede contribuir en el proyecto de Kubernetes, tanto si acabas de
+descubrir la plataforma como si lleves años involucrado. Tampoco importa si
+eres desarrollador, usuario final o alguien que simplemente no soporta ver
+errores tipográficos. **¡Cualquier contribución será bien recibida!**
+
+Para conocer más formas de involucrarse en la comunidad de Kubernetes o de
+aprender sobre nosotros, visite la sección [comunidad de Kubernetes](/community/).
+
+Para obtener información cómo escribir documentación de Kubernetes,
+consulte la [guía de estilo](/docs/contribute/style/style-guide/).
+
+{{% capture body %}}
+
+## Tipos de contribuidores
+
+- _**Kubernetes Member**_, un miembro de la organziación de Kubernetes que ha
+  [firmado el CLA](/docs/contribute/start#sign-the-cla) y contribuido al projecto.
+  Puedes consultar más información en el documento sobre los requisitos para ser
+  miembro de Kubernetes en el documento _[Community membership](https://github.com/kubernetes/community/blob/master/community-membership.md)_.
+
+- _**SIG Docs reviewer**_, un revisor del grupo de interés de documentación es
+  un miembro de la organización Kubernetes que tiene interés en revisar las
+  _pull requests_ relacionadas con el site y la documentación. Para poder ser
+  revisor, un aprobador de SIG Docs debe añadirlo al grupo adecuado de GitHub y
+  al fichero `OWNERS` del contenido que está interesado en revisar.
+
+- _**SIG Docs approver**_, un aprobador del grupo de interés de documentación
+  es un miembro de la organización de Kubernetes con buena reputación y que ha
+  mostrado una compromiso continuado con el proyecto.
+  Un aprobador se responsabiliza de mergear las _pull requests_ y publicar
+  contenido en nombre de la organización Kubernetes. Los aprobadores también
+  pueden representar a SIG Docs en la comunidad de Kubernetes en general.
+  Algunas de las responsabilidades de un aprobador de SIG Docs, como por ejemplo
+  coordinar una _release_, requieren un compromiso de tiempo significativo.
+
+## Cómo contribuir
+
+La siguiente lista está organizada por el nivel de implicación con la comunidad,
+desde las contribuciones que cualquiera puede hacer hasta las que requieren un
+compromiso con el equipo de documentación y estar familiarizado con los procesos
+de SIG Docs. Contribuir consistentemente a lo largo del tiempo puede ayudarte a
+comprender algunas de las herramientas y decisiones organizativas que se han ido
+tomando a lo largo del proyecto.
+
+La lista no contiene todas las formas de contribución posibles, está pensada
+para proporcionar un punto de partida.
+
+- [Todo el mundo](/docs/contribute/start/)
+  - Abrir issues accionables para que el equipo pueda trabajar en ello
+- [Miembro](/docs/contribute/start/)
+  - Mejorar la documetanción existente
+  - Proponer ideas de mejora en [Slack](http://slack.k8s.io/) o en [SIG docs mailing list](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)
+  - Mejorar la accesibilidad de la documentación
+  - Proporcionar comentarios no vinculantes sobre PRs
+  - Escribir una entrada para el blog o un caso de estudio
+- [Revisor](/docs/contribute/intermediate/)
+  - Documentar nuevas funcionalidades
+  - Selección y clasificacion de nuevos Issues
+  - Revisar PRs
+  - Crear diagramas, material gráfico y screencasts / videos
+  - Localización del contenido
+  - Contribuye a otros repos como representante del equipo de documentación
+  - Edit user-facing strings in code
+  - Mejorar los comentarios de código, Godoc
+- [Aprobador](/docs/contribute/advanced/)
+  - Publicar el contenido de colaboradores aprobando y mergeando las PRs
+  - Participar en el equipo de Release de Kubernetes como representeante del equipo de Docs
+  - Proponer mejoras a la guía de estilo
+  - Proponer mejoras a los tests de la documentación
+  - Proponer mejoras al sitio web de Kubernetes y otras herramientas
+
+{{% /capture %}}

content/es/docs/contribute/generate-ref-docs/_index.md

@@ -0,0 +1,10 @@
+---
+title: Documentación de referencia
+main_menu: true
+weight: 80
+---
+
+Gran parte de la documentación de referencia de **Kubernetes** se genera a
+partir del propio **código fuente de Kubernetes** utilizando scripts.
+
+Los temas de esta sección documentan cómo generar este tipo de contenido.