From 258111bd1b16424de7413b9eef868b47d68fd6ce Mon Sep 17 00:00:00 2001 From: Irvi Firqotul Aini Date: Thu, 22 Aug 2019 21:49:23 +0700 Subject: [PATCH 1/2] Add ttlafterfinished for ID localization. --- .../workloads/controllers/ttlafterfinished.md | 89 +++++++++++++++++++ 1 file changed, 89 insertions(+) create mode 100644 content/id/docs/concepts/workloads/controllers/ttlafterfinished.md diff --git a/content/id/docs/concepts/workloads/controllers/ttlafterfinished.md b/content/id/docs/concepts/workloads/controllers/ttlafterfinished.md new file mode 100644 index 0000000000000..5d3d94ce68ea2 --- /dev/null +++ b/content/id/docs/concepts/workloads/controllers/ttlafterfinished.md @@ -0,0 +1,89 @@ +--- +title: Kontroler TTL untuk Sumber Daya yang Telah Selesai Digunakan +content_template: templates/concept +weight: 65 +--- + +{{% capture overview %}} + +{{< feature-state for_k8s_version="v1.12" state="alpha" >}} + +Kontroler TTL menyediakan mekanisme TTL yang membatasi _lifetime_ dari sebuah +objek sumber daya yang telah selesai digunakan. Kontroler TTL untuk saat ini hanya menangani +[Jobs](/docs/concepts/workloads/controllers/jobs-run-to-completion/), +dan nantinya bisa saja digunakan untuk sumber daya lain yang telah selesai digunakan +misalnya saja Pod atau sumber daya kustom lainnya. + +Peringatan Fitur Alpha: fitur ini tergolong datam fitur alpha dan dapat diaktifkan dengan +[feature gate](/docs/reference/command-line-tools-reference/feature-gates/) +`TTLAfterFinished`. + + +{{% /capture %}} + + + + +{{% capture body %}} + +## Kontroler TTL + +Kontroler TTL untuk saat ini hanya mendukung Job. Sebuah operator kluster +dapat menggunakan fitur ini untuk membersihkan Job yang telah dieksekusi (baik +`Complete` atau `Failed`) secara otomatis dengan mennetukan _field_ +`.spec.ttlSecondsAfterFinished` pada Job, seperti yang tertera di +[contoh](/docs/concepts/workloads/controllers/jobs-run-to-completion/#clean-up-finished-jobs-automatically). +Kontroler TTL akan berasumsi bahwa sebuah sumber daya dapat dihapus apabila +TTL dari sumber daya tersebut telah habis. Proses dihapusnya sumber daya ini +dilakukan secara berantai, yaitu sekaligus menghapus sumber daya lain yang +berkaitan dengannya. Perhatikan bahwa ketika sebuah sumber daya dihapus, +_lifecycle_ yang ada akan menjaga bahwa _finalizer_ akan tetap dijalankan sebagaimana mestinya. + +Waktu TTL dalam detik dapat diatur kapan pun. Terdapat beberapa contoh untuk mengaktifkan _field_ +`.spec.ttlSecondsAfterFinished` pada sebuah Job: + +* Spesifikasikan _field_ ini pada _manifest_ sumber daya, sehingga Job akan + dihapus secara otomatis beberapa saat setelah selesai dieksekusi. +* Aktifkan _field_ ini pada sumber daya yang sudah selesai dieksekusi untuk + menerapkan fitur ini. +* Gunakan sebuah + [webhook admisi pengubah (_mutating admission webhook_)](/docs/reference/access-authn-authz/extensible-admission-controllers/#admission-webhooks) + untuk mengaktifkan _field_ ini secara dinamis pada saat pembuatan sumber daya. + Administrator kluster dapat menggunakan hal ini untuk menjamin _policy_ TTL pada + sumber daya yang telah selesai digunakan. +* Gunakan sebuah + [webhook admisi pengubah (_mutating admission webhook_)](/docs/reference/access-authn-authz/extensible-admission-controllers/#admission-webhooks) + untuk mengaktifkan _field_ ini secara dinamis setelah sumber daya + selesai digunakan dan TTL didefinisikan sesuai dengan status, label, atau hal lain + yang diinginkan. + +## Peringatan + +### Mengubah TTL Detik + +Perhatikan bahwa periode TTL, yaitu _field_ `.spec.ttlSecondsAfterFinished` pada Job, +dapat dimodifikasi baik setelah sumber daya dibuat atau setelah selesai digunakan. +Meskipun begitu, setelah Job dapat dihapus (TTL sudah habis), sistem tidak akan +menjamin Job tersebut akan tetap ada, meskipun nilai TTL berhasil diubah. + +### _Time Skew_ + +Karena kontroler TTL menggunakan _timestamps_ yang disimpan di sumber daya +Kubernetes untuk mennetukan apakah TTL sudah habis atau belum, fitur ini tidak sensitif +terhadap _time skew_ yang ada pada kluster dan bisa saja menghapus objek pada waktu yang salah +bagi objek tersebut akibat adanya _time skew_. + +Pada Kubernetes, NTP haruslah dilakukan pada semua node untuk mecegah adanya _time skew_ +(lihat [#6159](https://github.com/kubernetes/kubernetes/issues/6159#issuecomment-93844058)). +_Clock_ tidak akan selalu tepat, meskipun begitu perbedaan yang ada haruslah diminimalisasi. +Perhatikan bahwa hal ini dapat terjadi apabila TTL diaktifkan dengan nilai selain 0. + +{{% /capture %}} + +{{% capture whatsnext %}} + +[Membersikan Job secara Otomatis](/docs/concepts/workloads/controllers/jobs-run-to-completion/#clean-up-finished-jobs-automatically) + +[Dokumentasi _Design_](https://github.com/kubernetes/enhancements/blob/master/keps/sig-apps/0026-ttl-after-finish.md) + +{{% /capture %}} From 314316a475c14ce22d97d67d75c24cee391254f6 Mon Sep 17 00:00:00 2001 From: Irvi Firqotul Aini Date: Mon, 26 Aug 2019 01:27:00 +0700 Subject: [PATCH 2/2] Fix consistency of language usage based on review. --- .../workloads/controllers/ttlafterfinished.md | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/content/id/docs/concepts/workloads/controllers/ttlafterfinished.md b/content/id/docs/concepts/workloads/controllers/ttlafterfinished.md index 5d3d94ce68ea2..5681c4a9e8d53 100644 --- a/content/id/docs/concepts/workloads/controllers/ttlafterfinished.md +++ b/content/id/docs/concepts/workloads/controllers/ttlafterfinished.md @@ -1,5 +1,5 @@ --- -title: Kontroler TTL untuk Sumber Daya yang Telah Selesai Digunakan +title: Pengendali TTL untuk Sumber Daya yang Telah Selesai Digunakan content_template: templates/concept weight: 65 --- @@ -8,14 +8,14 @@ weight: 65 {{< feature-state for_k8s_version="v1.12" state="alpha" >}} -Kontroler TTL menyediakan mekanisme TTL yang membatasi _lifetime_ dari sebuah -objek sumber daya yang telah selesai digunakan. Kontroler TTL untuk saat ini hanya menangani +Pengendali TTL menyediakan mekanisme TTL yang membatasi umur dari suatu +objek sumber daya yang telah selesai digunakan. Pengendali TTL untuk saat ini hanya menangani [Jobs](/docs/concepts/workloads/controllers/jobs-run-to-completion/), dan nantinya bisa saja digunakan untuk sumber daya lain yang telah selesai digunakan -misalnya saja Pod atau sumber daya kustom lainnya. +misalnya saja Pod atau sumber daya khusus (_custom resource_) lainnya. Peringatan Fitur Alpha: fitur ini tergolong datam fitur alpha dan dapat diaktifkan dengan -[feature gate](/docs/reference/command-line-tools-reference/feature-gates/) +[_feature gate_](/docs/reference/command-line-tools-reference/feature-gates/) `TTLAfterFinished`. @@ -26,33 +26,33 @@ Peringatan Fitur Alpha: fitur ini tergolong datam fitur alpha dan dapat diaktifk {{% capture body %}} -## Kontroler TTL +## Pengendali TTL -Kontroler TTL untuk saat ini hanya mendukung Job. Sebuah operator kluster +Pengendali TTL untuk saat ini hanya mendukung Job. Sebuah operator kluster dapat menggunakan fitur ini untuk membersihkan Job yang telah dieksekusi (baik -`Complete` atau `Failed`) secara otomatis dengan mennetukan _field_ +`Complete` atau `Failed`) secara otomatis dengan menentukan _field_ `.spec.ttlSecondsAfterFinished` pada Job, seperti yang tertera di [contoh](/docs/concepts/workloads/controllers/jobs-run-to-completion/#clean-up-finished-jobs-automatically). -Kontroler TTL akan berasumsi bahwa sebuah sumber daya dapat dihapus apabila +Pengendali TTL akan berasumsi bahwa sebuah sumber daya dapat dihapus apabila TTL dari sumber daya tersebut telah habis. Proses dihapusnya sumber daya ini -dilakukan secara berantai, yaitu sekaligus menghapus sumber daya lain yang -berkaitan dengannya. Perhatikan bahwa ketika sebuah sumber daya dihapus, -_lifecycle_ yang ada akan menjaga bahwa _finalizer_ akan tetap dijalankan sebagaimana mestinya. +dilakukan secara berantai, dimana sumber daya lain yang +berkaitan akan ikut terhapus. Perhatikan bahwa ketika sebuah sumber daya dihapus, +siklus hidup yang ada akan menjaga bahwa _finalizer_ akan tetap dijalankan sebagaimana mestinya. Waktu TTL dalam detik dapat diatur kapan pun. Terdapat beberapa contoh untuk mengaktifkan _field_ -`.spec.ttlSecondsAfterFinished` pada sebuah Job: +`.spec.ttlSecondsAfterFinished` pada suatu Job: * Spesifikasikan _field_ ini pada _manifest_ sumber daya, sehingga Job akan dihapus secara otomatis beberapa saat setelah selesai dieksekusi. * Aktifkan _field_ ini pada sumber daya yang sudah selesai dieksekusi untuk menerapkan fitur ini. * Gunakan sebuah - [webhook admisi pengubah (_mutating admission webhook_)](/docs/reference/access-authn-authz/extensible-admission-controllers/#admission-webhooks) + [mengubah (_mutating_) _admission)](/docs/reference/access-authn-authz/extensible-admission-controllers/#admission-webhooks) untuk mengaktifkan _field_ ini secara dinamis pada saat pembuatan sumber daya. - Administrator kluster dapat menggunakan hal ini untuk menjamin _policy_ TTL pada + Administrator kluster dapat menggunakan hal ini untuk menjamin kebijakan (_policy_) TTL pada sumber daya yang telah selesai digunakan. * Gunakan sebuah - [webhook admisi pengubah (_mutating admission webhook_)](/docs/reference/access-authn-authz/extensible-admission-controllers/#admission-webhooks) + [mengubah (_mutating_) _admission](/docs/reference/access-authn-authz/extensible-admission-controllers/#admission-webhooks) untuk mengaktifkan _field_ ini secara dinamis setelah sumber daya selesai digunakan dan TTL didefinisikan sesuai dengan status, label, atau hal lain yang diinginkan. @@ -68,8 +68,8 @@ menjamin Job tersebut akan tetap ada, meskipun nilai TTL berhasil diubah. ### _Time Skew_ -Karena kontroler TTL menggunakan _timestamps_ yang disimpan di sumber daya -Kubernetes untuk mennetukan apakah TTL sudah habis atau belum, fitur ini tidak sensitif +Karena pengendali TTL menggunakan cap waktu (_timestamp_) yang disimpan di sumber daya +Kubernetes untuk menentukan apakah TTL sudah habis atau belum, fitur ini tidak sensitif terhadap _time skew_ yang ada pada kluster dan bisa saja menghapus objek pada waktu yang salah bagi objek tersebut akibat adanya _time skew_. @@ -84,6 +84,6 @@ Perhatikan bahwa hal ini dapat terjadi apabila TTL diaktifkan dengan nilai selai [Membersikan Job secara Otomatis](/docs/concepts/workloads/controllers/jobs-run-to-completion/#clean-up-finished-jobs-automatically) -[Dokumentasi _Design_](https://github.com/kubernetes/enhancements/blob/master/keps/sig-apps/0026-ttl-after-finish.md) +[Dokumentasi Rancangan](https://github.com/kubernetes/enhancements/blob/master/keps/sig-apps/0026-ttl-after-finish.md) {{% /capture %}}