Add Indonesian translation for container lifecycle hooks (#14089)
* Add Indonesian translation for container lifecycle hooks * Rephrase some of the wordingspull/14123/head
Giri Kuncoro
Kubernetes Prow Robot
parent
d1ed2d2916
commit
b191b55588
|
|
@ -0,0 +1,119 @@
|
|||
---
|
||||
title: Lifecyle Hook pada Kontainer
|
||||
content_template: templates/concept
|
||||
weight: 30
|
||||
---
|
||||
|
||||
{{% capture overview %}}
|
||||
|
||||
Laman ini menjelaskan bagaimana semua Kontainer yang diatur kubelet menggunakan *framework lifecycle hook*
|
||||
untuk menjalankan kode yang di-*trigger* oleh *event* selama *lifecycle* berlangsung.
|
||||
|
||||
{{% /capture %}}
|
||||
|
||||
|
||||
{{% capture body %}}
|
||||
|
||||
## Ikhtisar
|
||||
|
||||
Kubernetes menyediakan *hook* untuk *lifecycle* Kontainer. Hal ini sejalan dengan *framework* bahasa
|
||||
pemrograman pada umumnya yang memiliki *hook* untuk *lifecycle* komponen, seperti Angular contohnya.
|
||||
*Hook* tersebut digunakan Kontainer untuk selalu siap menerima *event* selama *lifecycle* dan
|
||||
menjalankan kode yang diimplementasi pada suatu *handler*, ketika *hook lifecycle* terkait telah dieksekusi.
|
||||
|
||||
## Jenis-jenis *hook* pada Kontainer
|
||||
|
||||
Ada dua jenis *hook* yang diekspos pada Kontainer:
|
||||
|
||||
`PostStart`
|
||||
|
||||
*Hook* ini dijalankan segera setelah suatu kontainer dibuat.
|
||||
Hanya saja, tidak ada jaminan bahwa *hook* akan tereksekusi sebelum `ENTRYPOINT` dari kontainer.
|
||||
Tidak ada parameter yang diberikan pada *handler*.
|
||||
|
||||
`PreStop`
|
||||
|
||||
*Hook* ini akan dipanggil sesaat sebelum kontainer dimatikan, karena suatu *request* API atau *event* pengaturan,
|
||||
contohnya kegagalan pada *liveness probe*, *preemption*, perebutan *resource*, dan lainnya.
|
||||
Sebuah panggilan untuk *hook* `PreStop` akan gagal jika kontainer tersebut telah ada pada *state terminate* atau *complete*.
|
||||
Hal ini bersifat *blocking*, yang artinya panggilan bersifat sinkron (*synchronous*), harus menunggu eksekusi selesai, sebelum melakukan panggilan
|
||||
untuk menghapus kontainer tersebut.
|
||||
Tidak ada parameter yang diberikan pada *handler*.
|
||||
|
||||
Penjelasan yang lebih rinci tentang proses terminasi dapat dilihat pada [Terminasi Pod](/docs/concepts/workloads/pods/pod/#termination-of-pods).
|
||||
|
||||
### Implementasi *handler* untuk *hook*
|
||||
|
||||
Kontainer dapat mengakses sebuah *hook* melalui implementasi dan registrasi sebuah *handler* untuk *hook* tersebut.
|
||||
Ada dua jenis *handler* untuk *hook* yang dapat diimplementasikan untuk Kontainer:
|
||||
|
||||
* Exec - Mengeksekusi sebuah perintah tertentu, contohnya `pre-stop.sh`, di dalam cgroups dan *namespace* suatu Kontainer. *Resource* yang dikonsumsi oleh perintah tersebut dianggap sebagai bagian dari Kontainer.
|
||||
* HTTP - Mengeksekusi sebuah *request* HTTP untuk *endpoint* tertentu pada Kontainer tersebut.
|
||||
|
||||
### Eksekusi *handler* untuk *hook*
|
||||
|
||||
Ketika manajemen *hook* untuk suatu *lifecycle* Kontainer dipanggil, sistem manajemen internal pada Kubernetes
|
||||
akan mengeksekusi *handler* di dalam Kontainer yang terdaftar untuk *hook* tersebut.
|
||||
|
||||
Panggilan *handler* untuk *hook* semuanya bersifat *synchronous* di dalam konteks Pod yang
|
||||
memiliki Kontainer tersebut. Artinya, untuk *hook* `PostStart`, Kontainer `ENTRYPOINT`
|
||||
dan *hook* dieksekusi secara *asyncrhonous*. Akan tetapi, jika *hook* mengambil waktu terlalu lama,
|
||||
atau *hang*, Kontainer tersebut tidak bisa sampai ke *state* `running`.
|
||||
|
||||
Perilaku ini mirip dengan yang terjadi pada *hook* `PreStop`.
|
||||
Jika *hook* terlalu lama atau *hang* saat dieksekusi, Pod tersebut tetap ada pada *state* `Terminating`
|
||||
dan akan dimatikan setelah `terminationGracePeriodSeconds` Pod selesai.
|
||||
Jika sebuah *hook* `PostStart` atau `PreStop` gagal dieksekusi, Kontainer akan dimatikan.
|
||||
|
||||
Para pengguna sangat disarankan membuat *handler* untuk *hook* seringan mungkin (*lightweight*).
|
||||
Biar bagaimanapun, ada beberapa kasus yang memang membutuhkan waktu lama untuk mengeksekusi
|
||||
suatu perintah, misalnya saat proses penyimpanan *state* sebelum Kontainer dimatikan.
|
||||
|
||||
### Jaminan pengiriman *hook*
|
||||
|
||||
Proses pengiriman *hook* akan dilakukan **paling tidak satu kali**.
|
||||
Artinya suatu *hook* boleh dipanggil beberapa kali untuk *event* yang sama,
|
||||
seperti dalam `PostStart` atau`PreStop`.
|
||||
Namun begitu, implementasi *hook* masing-masing harus memastikan bagaimana
|
||||
menangani kasus ini dengan benar.
|
||||
|
||||
Pada umumnya, hanya terjadi satu proses pengiriman.
|
||||
Jika misalnya sebuah penerima HTTP *hook* mati atau tidak bisa menerima trafik,
|
||||
maka tidak ada usaha untuk mengirimkan kembali.
|
||||
Namun demikian, bisa saja terjadi dua kali proses pengiriman untuk kasus tertentu.
|
||||
Contohnya, jika kubelet *restart* saat di tengah proses pengiriman *hook*,
|
||||
*hook* tersebut akan dikirimkan kembali saat kubelet sudah hidup kembali.
|
||||
|
||||
### Melakukan *debug* *handler* untuk *hook*
|
||||
|
||||
*Log* untuk suatu *handler hook* tidak terekspos pada *event* Pod.
|
||||
Jika *handler* gagal dieksekusi untuk alasan tertentu, *handler* akan melakukan *broadcast* sebuah *event*.
|
||||
Untuk `PostStart`, akan dilakukan *broadcast event* `FailedPostStartHook`,
|
||||
dan untuk `PreStop`, akan dilakukan *broadcast event* `FailedPreStopHook`.
|
||||
Kamu dapat melihat *event-event* ini dengan menjalankan perintah `kubectl describe pod <pod_name>`.
|
||||
Berikut merupakan contoh keluaran *event-event* setelah perintah tersebut dijalankan.
|
||||
|
||||
```
|
||||
Events:
|
||||
FirstSeen LastSeen Count From SubobjectPath Type Reason Message
|
||||
--------- -------- ----- ---- ------------- -------- ------ -------
|
||||
1m 1m 1 {default-scheduler } Normal Scheduled Successfully assigned test-1730497541-cq1d2 to gke-test-cluster-default-pool-a07e5d30-siqd
|
||||
1m 1m 1 {kubelet gke-test-cluster-default-pool-a07e5d30-siqd} spec.containers{main} Normal Pulling pulling image "test:1.0"
|
||||
1m 1m 1 {kubelet gke-test-cluster-default-pool-a07e5d30-siqd} spec.containers{main} Normal Created Created container with docker id 5c6a256a2567; Security:[seccomp=unconfined]
|
||||
1m 1m 1 {kubelet gke-test-cluster-default-pool-a07e5d30-siqd} spec.containers{main} Normal Pulled Successfully pulled image "test:1.0"
|
||||
1m 1m 1 {kubelet gke-test-cluster-default-pool-a07e5d30-siqd} spec.containers{main} Normal Started Started container with docker id 5c6a256a2567
|
||||
38s 38s 1 {kubelet gke-test-cluster-default-pool-a07e5d30-siqd} spec.containers{main} Normal Killing Killing container with docker id 5c6a256a2567: PostStart handler: Error executing in Docker Container: 1
|
||||
37s 37s 1 {kubelet gke-test-cluster-default-pool-a07e5d30-siqd} spec.containers{main} Normal Killing Killing container with docker id 8df9fdfd7054: PostStart handler: Error executing in Docker Container: 1
|
||||
38s 37s 2 {kubelet gke-test-cluster-default-pool-a07e5d30-siqd} Warning FailedSync Error syncing pod, skipping: failed to "StartContainer" for "main" with RunContainerError: "PostStart handler: Error executing in Docker Container: 1"
|
||||
1m 22s 2 {kubelet gke-test-cluster-default-pool-a07e5d30-siqd} spec.containers{main} Warning FailedPostStartHook
|
||||
```
|
||||
|
||||
{{% /capture %}}
|
||||
|
||||
{{% capture whatsnext %}}
|
||||
|
||||
* Pelajari lebih lanjut tentang [*environment* Kontainer](/docs/concepts/containers/container-environment-variables/).
|
||||
* Pelajari bagaimana caranya
|
||||
[melakukan *attach handler* pada *event lifecycle* sebuah Kontainer](/docs/tasks/configure-pod-container/attach-handler-lifecycle-event/).
|
||||
|
||||
{{% /capture %}}
|
||||
Loading…
Reference in New Issue