Translating Ephemeral Container to ID Localization.
Fix glossary warning and note. Fixed formatting and Typos.pull/19815/head
Aris Cahyadi Risdianto
parent
fca1d58ce0
commit
b0175b6323
|
|
@ -0,0 +1,224 @@
|
||||||
|
---
|
||||||
|
title: Kontainer Sementara (Ephemeral)
|
||||||
|
content_template: templates/concept
|
||||||
|
weight: 80
|
||||||
|
---
|
||||||
|
|
||||||
|
{{% capture overview %}}
|
||||||
|
|
||||||
|
{{< feature-state state="alpha" for_k8s_version="v1.16" >}}
|
||||||
|
|
||||||
|
Halaman ini memberikan gambaran umum tentang kontainer sementara: satu jenis
|
||||||
|
kontainer khusus yang berjalan sementara pada {{< glossary_tooltip term_id="pod" >}}
|
||||||
|
yang sudah ada untuk melakukan tindakan yang diinisiasi oleh pengguna seperti
|
||||||
|
dalam pemecahan masalah. Kamu menggunakan kontainer sementara untuk memeriksa
|
||||||
|
layanan bukan untuk membangun aplikasi.
|
||||||
|
|
||||||
|
{{< warning >}}
|
||||||
|
Kontainer sementara masih berada dalam fase alpha dan tidak cocok untuk
|
||||||
|
klaster produksi. Kamu harus mengharapkan adanya suatu fitur yang tidak akan
|
||||||
|
berfungsi dalam beberapa situasi tertentu, seperti saat menargetkan _namespace_
|
||||||
|
dari suatu kontainer. Sesuai dengan Kubernetes
|
||||||
|
[_Deprecation Policy_](/docs/reference/using-api/deprecation-policy/), fitur alpha
|
||||||
|
ini dapat berubah secara signifikan di masa depan atau akan dihapus seluruhnya.
|
||||||
|
{{< /warning >}}
|
||||||
|
|
||||||
|
{{% /capture %}}
|
||||||
|
|
||||||
|
{{% capture body %}}
|
||||||
|
|
||||||
|
## Memahami Kontainer Sementara
|
||||||
|
|
||||||
|
{{< glossary_tooltip text="Pod" term_id="pod" >}} adalah blok pembangun
|
||||||
|
fundamental dalam aplikasi Kubernetes. Karena Pod diharapkan digunakan hanya
|
||||||
|
sekali dan dapat diganti, sehingga kamu tidak dapat menambahkan kontainer ke
|
||||||
|
dalam Pod setelah Pod tersebut dibuat. Sebaliknya, kamu biasanya menghapus dan
|
||||||
|
mengganti beberapa Pod dengan cara yang terkontrol melalui
|
||||||
|
{{< glossary_tooltip text="Deployment" term_id="deployment" >}}.
|
||||||
|
|
||||||
|
Namun, kadang-kadang perlu juga untuk memeriksa keadaan Pod yang telah ada,
|
||||||
|
sebagai contoh untuk memecahkan masalah _bug_ yang sulit direproduksi. Dalam
|
||||||
|
kasus ini, kamu dapat menjalankan sebuah kontainer sementara di dalam suatu Pod
|
||||||
|
yang sudah ada untuk memeriksa statusnya dan menjalankannya segala macam
|
||||||
|
perintah.
|
||||||
|
|
||||||
|
### Apa itu Kontainer Sementara?
|
||||||
|
|
||||||
|
Kontainer sementara berbeda dengan kontainer lainnya karena tidak memiliki
|
||||||
|
jaminan sumber daya maupun akan eksekusi, dan mereka tidak akan pernah secara
|
||||||
|
otomatis melakukan _restart_, jadi mereka tidak sesuai untuk membangun aplikasi.
|
||||||
|
Kontainer sementara dideskripsikan dengan menggunakan ContainerSpec yang sama
|
||||||
|
dengan kontainer biasa, tetapi banyak bagian yang tidak kompatibel dan tidak
|
||||||
|
diperbolehkan untuk kontainer sementara.
|
||||||
|
|
||||||
|
- Kontainer sementara mungkin tidak memiliki port, sehingga bagian seperti
|
||||||
|
`port`, `livenessProbe`, `readinessProbe` tidak diperbolehkan.
|
||||||
|
- Alokasi sumber daya untuk Pod tidak dapat diubah, sehingga pengaturan
|
||||||
|
sumber daya tidak diperbolehkan.
|
||||||
|
- Untuk daftar lengkap bagian yang diperbolehkan, dapat di lihat
|
||||||
|
[referensi dokumentasi Kontainer Sementara](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#ephemeralcontainer-v1-core).
|
||||||
|
|
||||||
|
Kontainer sementara dibuat dengan menggunakan _handler_ khusus
|
||||||
|
EphemeralContainers dalam API tanpa menambahkannya langsung ke `pod.spec`,
|
||||||
|
sehingga tidak memungkinan untuk menambahkan kontainer sementara dengan
|
||||||
|
menggunakan `kubectl edit`.
|
||||||
|
|
||||||
|
Seperti dengan kontainer biasa, kamu tidak dapat mengubah atau menghapus
|
||||||
|
kontainer sementara setelah kamu memasukkannya ke dalam sebuah Pod.
|
||||||
|
|
||||||
|
## Penggunaan Kontainer Sementara
|
||||||
|
|
||||||
|
Kontainer sementara berguna untuk pemecahan masalah secara interaktif pada saat
|
||||||
|
`kubectl exec` tidak mencukupi karena sebuah kontainer telah hancur atau
|
||||||
|
kontainer _image_ tidak memiliki utilitas untuk _debugging_.
|
||||||
|
|
||||||
|
Khususnya, untuk [_images_distroless_](https://github.com/GoogleContainerTools/distroless)
|
||||||
|
memungkinkan kamu untuk menyebarkan kontainer *image* minimal yang mengurangi
|
||||||
|
_surface attack_ dan paparan _bug_ dan _vulnerability_. Karena
|
||||||
|
_image distroless_ tidak mempunyai sebuah _shell_ atau utilitas _debugging_ apa
|
||||||
|
pun, sehingga sulit untuk memecahkan masalah _image distroless_ dengan
|
||||||
|
menggunakan `kubectl exec` saja.
|
||||||
|
|
||||||
|
Saat menggunakan kontainer sementara, akan sangat membantu untuk mengaktifkan
|
||||||
|
[_process namespace sharing_](/docs/tasks/configure-pod-container/share-process-namespace/)
|
||||||
|
sehingga kamu dapat melihat proses pada kontainer lain.
|
||||||
|
|
||||||
|
### Contoh
|
||||||
|
|
||||||
|
{{< note >}}
|
||||||
|
Contoh-contoh pada bagian ini membutuhkan `EphemeralContainers` [feature
|
||||||
|
gate](/docs/reference/command-line-tools-reference/feature-gates/) untuk
|
||||||
|
diaktifkan, dan membutuhkan Kubernetes klien dan server versi v1.16 atau
|
||||||
|
yang lebih baru.
|
||||||
|
{{< /note >}}
|
||||||
|
|
||||||
|
Contoh-contoh pada bagian ini menunjukkan bagaimana kontainer sementara muncul
|
||||||
|
dalam API. Kamu biasanya dapat menggunakan plugin `kubectl` untuk mengatasi
|
||||||
|
masalah untuk mengotomatiskan langkah-langkah ini.
|
||||||
|
|
||||||
|
Kontainer sementara dibuat menggunakan _subresource_ `ephemeralcontainers`
|
||||||
|
Pod, yang dapat didemonstrasikan menggunakan `kubectl --raw`. Pertama-tama
|
||||||
|
deskripsikan kontainer sementara untuk ditambahkan dalam daftar
|
||||||
|
`EphemeralContainers`:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"apiVersion": "v1",
|
||||||
|
"kind": "EphemeralContainers",
|
||||||
|
"metadata": {
|
||||||
|
"name": "example-pod"
|
||||||
|
},
|
||||||
|
"ephemeralContainers": [{
|
||||||
|
"command": [
|
||||||
|
"sh"
|
||||||
|
],
|
||||||
|
"image": "busybox",
|
||||||
|
"imagePullPolicy": "IfNotPresent",
|
||||||
|
"name": "debugger",
|
||||||
|
"stdin": true,
|
||||||
|
"tty": true,
|
||||||
|
"terminationMessagePolicy": "File"
|
||||||
|
}]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Untuk memperbarui kontainer yang sudah berjalan dalam `example-pod`:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
kubectl replace --raw /api/v1/namespaces/default/pods/example-pod/ephemeralcontainers -f ec.json
|
||||||
|
```
|
||||||
|
|
||||||
|
Ini akan menampilkan daftar baru dari seluruh kontainer sementara:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"kind":"EphemeralContainers",
|
||||||
|
"apiVersion":"v1",
|
||||||
|
"metadata":{
|
||||||
|
"name":"example-pod",
|
||||||
|
"namespace":"default",
|
||||||
|
"selfLink":"/api/v1/namespaces/default/pods/example-pod/ephemeralcontainers",
|
||||||
|
"uid":"a14a6d9b-62f2-4119-9d8e-e2ed6bc3a47c",
|
||||||
|
"resourceVersion":"15886",
|
||||||
|
"creationTimestamp":"2019-08-29T06:41:42Z"
|
||||||
|
},
|
||||||
|
"ephemeralContainers":[
|
||||||
|
{
|
||||||
|
"name":"debugger",
|
||||||
|
"image":"busybox",
|
||||||
|
"command":[
|
||||||
|
"sh"
|
||||||
|
],
|
||||||
|
"resources":{
|
||||||
|
|
||||||
|
},
|
||||||
|
"terminationMessagePolicy":"File",
|
||||||
|
"imagePullPolicy":"IfNotPresent",
|
||||||
|
"stdin":true,
|
||||||
|
"tty":true
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Kamu dapat melihat kondisi kontainer sementara yang baru dibuat dengan
|
||||||
|
menggunakan `kubectl describe`:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
kubectl describe pod example-pod
|
||||||
|
```
|
||||||
|
|
||||||
|
```
|
||||||
|
...
|
||||||
|
Ephemeral Containers:
|
||||||
|
debugger:
|
||||||
|
Container ID: docker://cf81908f149e7e9213d3c3644eda55c72efaff67652a2685c1146f0ce151e80f
|
||||||
|
Image: busybox
|
||||||
|
Image ID: docker-pullable://busybox@sha256:9f1003c480699be56815db0f8146ad2e22efea85129b5b5983d0e0fb52d9ab70
|
||||||
|
Port: <none>
|
||||||
|
Host Port: <none>
|
||||||
|
Command:
|
||||||
|
sh
|
||||||
|
State: Running
|
||||||
|
Started: Thu, 29 Aug 2019 06:42:21 +0000
|
||||||
|
Ready: False
|
||||||
|
Restart Count: 0
|
||||||
|
Environment: <none>
|
||||||
|
Mounts: <none>
|
||||||
|
...
|
||||||
|
```
|
||||||
|
|
||||||
|
Kamu dapat mengakses kontainer sementara yang baru menggunakan
|
||||||
|
`kubectl attach`:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
kubectl attach -it example-pod -c debugger
|
||||||
|
```
|
||||||
|
|
||||||
|
Jika proses berbagi _namespace_ diaktifkan, kamu dapat melihat proses dari semua
|
||||||
|
kontainer dalam Pod tersebut. Misalnya, setelah mengakses, kamu jalankan
|
||||||
|
`ps` di kontainer _debugger_:
|
||||||
|
|
||||||
|
```shell
|
||||||
|
# Jalankan ini pada _shell_ dalam _debugger_ dari kontainer sementara
|
||||||
|
ps auxww
|
||||||
|
```
|
||||||
|
Hasilnya akan seperti ini:
|
||||||
|
```
|
||||||
|
PID USER TIME COMMAND
|
||||||
|
1 root 0:00 /pause
|
||||||
|
6 root 0:00 nginx: master process nginx -g daemon off;
|
||||||
|
11 101 0:00 nginx: worker process
|
||||||
|
12 101 0:00 nginx: worker process
|
||||||
|
13 101 0:00 nginx: worker process
|
||||||
|
14 101 0:00 nginx: worker process
|
||||||
|
15 101 0:00 nginx: worker process
|
||||||
|
16 101 0:00 nginx: worker process
|
||||||
|
17 101 0:00 nginx: worker process
|
||||||
|
18 101 0:00 nginx: worker process
|
||||||
|
19 root 0:00 /pause
|
||||||
|
24 root 0:00 sh
|
||||||
|
29 root 0:00 ps auxww
|
||||||
|
```
|
||||||
|
|
||||||
|
{{% /capture %}}
|
||||||
Loading…
Reference in New Issue