Memasukkan proxy file bantuan dengan Anthos Service Mesh

Dokumen ini membahas cara mengonfigurasi injeksi proxy file bantuan dengan Anthos Service Mesh untuk meningkatkan keamanan, keandalan, dan kemampuan observasi jaringan. Fungsi-fungsi ini diabstraksikan dari container utama aplikasi dan diimplementasikan dalam proxy di luar proses yang umum (file bantuan), yang dikirim sebagai container terpisah dalam Pod yang sama. Mesh ini menyediakan fitur Anthos Service Mesh tanpa mendesain ulang aplikasi produksi untuk berpartisipasi dalam mesh layanan.

Injeksi proxy file bantuan otomatis (injeksi otomatis) terjadi saat Anthos Service Mesh mendeteksi label namespace yang Anda konfigurasikan untuk Pod workload. Proxy ini mencegat semua traffic masuk dan keluar ke workload dan berkomunikasi dengan Anthos Service Mesh.

Izin yang diperlukan untuk tugas ini

Untuk melakukan tugas di halaman ini, Anda harus memiliki roles/container.clusterAdmin atau peran yang lebih tinggi. Lihat peran Google Kubernetes Engine untuk mengetahui detail tentang izin yang tercakup dalam peran ini.

Mengaktifkan injeksi file bantuan otomatis

Cara yang direkomendasikan untuk memasukkan proxy file bantuan adalah dengan menggunakan injektor file bantuan otomatis berbasis webhook, meskipun Anda dapat mengupdate konfigurasi Kubernetes Pod secara manual.

Untuk mengaktifkan injeksi otomatis, beri label namespace dengan label injeksi default jika tag default sudah disiapkan, atau dengan label revisi ke namespace Anda. Label yang Anda tambahkan juga bergantung pada apakah Anda men-deploy Anthos Service Mesh terkelola (dengan fleet API atau dengan asmcli), atau menginstal bidang kontrol dalam cluster. Label digunakan oleh webhook injektor sidecar untuk mengaitkan file bantuan yang dimasukkan dengan revisi bidang kontrol tertentu.

Untuk mengaktifkan injeksi otomatis:

Dalam cluster

Gunakan perintah berikut untuk menemukan label revisi di istiod:

kubectl -n istio-system get pods -l app=istiod --show-labels

Outputnya terlihat mirip dengan yang berikut ini:

NAME                                READY   STATUS    RESTARTS   AGE   LABELS
istiod-asm-1167-22-5788d57586-bljj4   1/1     Running   0          23h   app=istiod,istio.io/rev=asm-1167-22,istio=istiod,pod-template-hash=5788d57586
istiod-asm-1167-22-5788d57586-vsklm   1/1     Running   1          23h   app=istiod,istio.io/rev=asm-1167-22,istio=istiod,pod-template-hash=5788d57586

Pada output, di kolom LABELS, catat nilai label revisi istiod, yang mengikuti awalan istio.io/rev=. Dalam contoh ini, nilainya adalah asm-1167-22.

Catatan: Anda dapat mengganti istio.io/rev dengan label istio-injection=enabled jika tag default dikonfigurasi. Verifikasi bahwa tag default ada dengan menjalankan istioctl tag list dengan istioctl dari OUTPUT_DIR.

Terapkan label revisi ke namespace dan hapus label injeksi istio (jika ada). Dalam perintah berikut, NAMESPACE adalah nama namespace tempat Anda ingin mengaktifkan injeksi otomatis, dan REVISION adalah label revisi yang Anda catat pada langkah sebelumnya.
```
kubectl label namespace NAMESPACE  istio-injection- istio.io/rev=REVISION --overwrite
```
Anda dapat mengabaikan pesan "istio-injection not found" di output. Artinya, namespace sebelumnya tidak memiliki label istio-injection, yang akan Anda harapkan dalam penginstalan baru Anthos Service Mesh atau deployment baru. Karena injeksi otomatis gagal jika namespace memiliki istio-injection dan label revisi, semua perintah kubectl label dalam dokumentasi Anthos Service Mesh secara eksplisit menentukan kedua label.
Mulai ulang pod yang terpengaruh, menggunakan langkah-langkah di bagian berikutnya.

Mesh layanan terkelola

Gunakan perintah berikut untuk menemukan saluran rilis yang tersedia:
```
kubectl -n istio-system get controlplanerevision
```
Outputnya mirip dengan hal berikut ini:
```
NAME                AGE
asm-managed         6d7h
```
Pada output, pilih nilai pada kolom NAME yang berisi label REVISION yang sesuai dengan saluran rilis yang tersedia untuk versi Anthos Service Mesh. Terapkan label ini ke namespace Anda, dan hapus label istio-injection (jika ada). Dalam perintah berikut, ganti REVISION dengan label revisi yang Anda catat di atas, lalu ganti NAMESPACE dengan nama namespace tempat Anda ingin mengaktifkan injeksi otomatis:
```
kubectl label namespace NAMESPACE  istio-injection- istio.io/rev=REVISION --overwrite
```
Anda dapat mengabaikan pesan "istio-injection not found" di output. Artinya, namespace sebelumnya tidak memiliki label istio-injection, yang akan Anda harapkan dalam penginstalan baru Anthos Service Mesh atau deployment baru. Karena injeksi otomatis gagal jika namespace memiliki istio-injection dan label revisi, semua perintah kubectl label dalam dokumentasi Anthos Service Mesh secara eksplisit menentukan kedua label.
Mulai ulang pod yang terpengaruh, menggunakan langkah-langkah di bagian berikutnya.
Jika Anda juga men-deploy bidang data yang dikelola Google opsional, beri anotasi pada namespace demo sebagai berikut:
```
kubectl annotate --overwrite namespace YOUR_NAMESPACE \
mesh.cloud.google.com/proxy='{"managed":"true"}'
```

Memulai ulang Pod untuk memperbarui proxy file bantuan

Dengan injeksi file bantuan otomatis, Anda dapat mengupdate file bantuan untuk Pod yang ada dengan memulai ulang Pod:

Cara memulai ulang Pod bergantung pada apakah Pod dibuat sebagai bagian dari Deployment.

Jika Anda menggunakan Deployment, mulai ulang Deployment, yang akan memulai ulang semua Pod dengan file bantuan:
```
kubectl rollout restart deployment -n YOUR_NAMESPACE
```
Jika Anda tidak menggunakan Deployment, hapus Pod, lalu Pod akan otomatis dibuat ulang dengan file bantuan:
```
kubectl delete pod -n YOUR_NAMESPACE --all
```
Pastikan semua Pod di namespace memiliki file bantuan yang dimasukkan:
```
kubectl get pod -n YOUR_NAMESPACE
```
Pada contoh output dari perintah sebelumnya berikut, perhatikan bahwa kolom READY menunjukkan bahwa ada dua penampung untuk setiap beban kerja: penampung utama dan container untuk proxy sidecar.
```
NAME                    READY   STATUS    RESTARTS   AGE
YOUR_WORKLOAD           2/2     Running   0          20s
...
```

Langkah selanjutnya

Pelajari lebih lanjut: