From 00b8aeafb48f6bdbdf4de3c7c20cebed9b3772fe Mon Sep 17 00:00:00 2001 From: Kurnianto Trilaksono Date: Wed, 22 May 2019 10:54:03 +0700 Subject: [PATCH] Translate "Pod Preset" page to Bahasa Indonesia (#14394) * add pod preset page for language/id * fix formatting * fix typos and wording * fix formatting and add few missed lines * fix note formatting --- .../id/docs/concepts/workloads/pods/_index.md | 4 ++ .../docs/concepts/workloads/pods/podpreset.md | 56 +++++++++++++++++++ 2 files changed, 60 insertions(+) create mode 100644 content/id/docs/concepts/workloads/pods/_index.md create mode 100644 content/id/docs/concepts/workloads/pods/podpreset.md diff --git a/content/id/docs/concepts/workloads/pods/_index.md b/content/id/docs/concepts/workloads/pods/_index.md new file mode 100644 index 0000000000..b5db982c71 --- /dev/null +++ b/content/id/docs/concepts/workloads/pods/_index.md @@ -0,0 +1,4 @@ +--- +title: "Pods" +weight: 10 +--- \ No newline at end of file diff --git a/content/id/docs/concepts/workloads/pods/podpreset.md b/content/id/docs/concepts/workloads/pods/podpreset.md new file mode 100644 index 0000000000..7c4c2d7267 --- /dev/null +++ b/content/id/docs/concepts/workloads/pods/podpreset.md @@ -0,0 +1,56 @@ +--- +title: Pod Preset +content_template: templates/concept +weight: 50 +--- + +{{% capture overview %}} +Halaman ini menyajikan gambaran umum tentang PodPreset, yang merupakan objek untuk memasukkan informasi tertentu ke dalam Pod pada saat waktu penciptaan. Informasi dapat berupa _secret_, _volume_, _volume mount_, dan variabel _environment_. +{{% /capture %}} + +{{% capture body %}} +## Memahami Pod Preset +--- + +Sebuah `Pod Preset` adalah sebuah _resource_ API untuk memasukkan kebutuhan _runtime_ tambahan ke dalam sebuah Pod pada saat waktu penciptaan. Kamu akan menggunakan _label selector_ untuk menunjuk Pod dimana Pod Preset diterapkan. + +Menggunakan sebuah Pod Preset memungkinkan pembuat templat pod untuk tidak menyediakan secara eksplisit semua informasi untuk setiap pod. Dengan demikian, pembuat templat pod yang mengkonsumsi sebuah _service_ spesifik tidak perlu tahu semua detail-detail tentang _service_ tersebut. + +Untuk informasi lebih lanjut mengenai latar belakang lihat [proposal desain untuk PodPreset](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/service-catalog/pod-preset.md). + +## Bagaimana Cara Kerja Pod Preset +--- + +Kubernetes menyediakan sebuah _admission controller_ (`PodPreset`) dimana, ketika diaktifkan, PodPreset diterapkan kepada permintaan penciptaan Pod yang akan datang. Ketika sebuah penciptaan Pod terjadi, sistem melakukan hal-hal berikut: + +1. Mengambil semua `PodPreset` yang tersedia untuk digunakan. +2. Cek jika _label selector_ dari salah satu `PodPreset` cocok dengan _label_ pada pod yang sedang diciptakan. +3. Usaha untuk menggabungkan berbagai _resource_ didefinisikan oleh `PodPreset` ke dalam Pod yang sedang diciptakan. +4. Ketika terjadi galat, lempar sebuah _event_ yang mendokumentasikan galat penggabungan dalam pod, dan membuat pod tanpa salah satu _resource_ dari `PodPreset`. +5. Anotasikan hasil spesifikasi Pod yang telah dimodifikasi untuk menunjukkan bahwa Pod telah dimodifikasi oleh sebuah PodPreset. Anotasi berupa `podpreset.admission.kubernetes.io/podpreset-: ""`. + +Tiap Pod akan bisa dipasangkan oleh nol atau lebih PodPreset; dan tiap PodPreset bisa diterapkan ke nol atau lebih Pod. Ketika sebuah PodPreset diterapkan ke satu atau lebih Pod, Kubernetes memodifikasi Pod Spec. Untuk perubahan terhadap `Env`,`EnvFrom`, dan `VolumeMount`, Kubernetes memodifikasi spesifikasi kontainer untuk semua kontainer di dalam Pod; Untuk perubahan terhadap `Volume`, Kubernetes memodifikasi Pod Spec. + +{{< note >}} +Catatan: Sebuah Pod Preset mampu memodifikasi kolom `.spec.containers` pada sebuah Pod Spec jika sesuai. Tidak ada definisi resource dari Pod Preset yang akan diterapkan kepada kolom `initContainer`. +{{< /note >}} + +### Menonaktifkan Pod Preset untuk sebuah Pod Spesifik +Mungkin akan ada keadaan dimana kamu menginginkan sebuah Pod tidak bisa diubah oleh sebuah mutasi PodPreset. Pada kasus ini, kamu bisa menambahkan sebuah anotasi pada Pod Spec dalam bentuk: `podpreset.admission.kubernetes.io/exclude: "true"`. + +## Mengaktifkan Pod Preset +--- +Dalam rangka untuk menggunakan Pod Preset di dalam kluster kamu, kamu harus memastikan hal berikut: + +1. Kamu telah mengaktifkan tipe API `settings.k8s.io/v1alpha1/podpreset`. Sebagai contoh, ini bisa dilakukan dengan menambahkan `settings.k8s.io/v1alpha1=true` di dalam opsi `--runtime-config` untuk API _server_. Dalam _minikube_ tambahkan argumen berikut `--extra-config=apiserver.runtime-config=settings.k8s.io/v1alpha1=true` saat menginisialisasi kluster. + +2. Kamu telah mengaktifkan _admission controller_ dari `PodPreset`. Salah satu cara untuk melakukannya adalah dengan menambahkan `PodPreset` di dalam nilai opsi `--enable-admission-plugins` yang dispesifikasikan untuk API _server_. Dalam _minikube_ tambahkan argumen berikut `--extra-config=apiserver.enable-admission-plugins=Initializers,NamespaceLifecycle,LimitRanger,ServiceAccount,DefaultStorageClass,DefaultTolerationSeconds,NodeRestriction,MutatingAdmissionWebhook,ValidatingAdmissionWebhook,ResourceQuota,PodPreset ` saat menginisialisasi kluster. + +3. Kamu telah membuat objek `PodPreset` pada _namespace_ yang kamu gunakan dengan cara mendefinisikan Pod Preset. + +{{% /capture %}} + +{{% capture whatsnext %}} + * [Memasukkan data ke dalam sebuah Pod dengan PodPreset](/docs/concepts/workloads/pods/pod/#injecting-data-into-a-pod-using-podpreset.md) + +{{% /capture %}} \ No newline at end of file