Tentang asmcli
asmcli
adalah alat yang disediakan Google yang
dapat Anda gunakan untuk menginstal atau
upgrade Cloud Service Mesh. Jika Anda mengizinkannya, asmcli
akan mengonfigurasi
project dan cluster sebagai berikut:
- Memberi Anda izin Identity and Access Management (IAM) yang diperlukan pada project Google Cloud Anda.
- Aktifkan Google API yang diperlukan di project Google Cloud Anda.
- Berikan label pada cluster yang mengidentifikasi mesh.
- Buat akun layanan yang memungkinkan komponen bidang data, seperti sebagai proxy file bantuan, akses data dan resource project Anda dengan aman.
- Mendaftarkan cluster ke armada jika belum terdaftar.
Cukup sertakan flag --enable_all
saat Anda menjalankan asmcli
untuk memungkinkan konfigurasi
project dan cluster Anda. Untuk mengetahui informasi selengkapnya tentang opsi dan tanda asmcli
,
lihat referensi asmcli
.
Selanjutnya, asmcli
mengonfigurasi file YAML dengan informasi project dan cluster Anda.
File konfigurasi ini diperlukan untuk menginstal bidang kontrol Cloud Service Mesh.
Jika Anda baru menggunakan Cloud Service Mesh dan Istio, lanjutkan ke Platform yang didukung. Bagian selanjutnya dimaksudkan untuk membantu Cloud Service Mesh melakukan upgrade ke 1.20.
Transisi ke asmcli
asmcli
menggantikan istioctl install
dan install_asm
. Meskipun
Anda masih dapat menggunakan alat lama di Cloud Service Mesh 1.11, kami menghentikan
dan tidak akan didukung lagi
di Cloud Service Mesh 1.12 dan yang lebih baru.
Harap update skrip dan alat Anda untuk menggunakan asmcli
.
Dengan Cloud Service Mesh 1.11 dan yang lebih baru, semua cluster harus terdaftar di fleet. Lihat Persyaratan perangkat untuk mengetahui detailnya.
Bertransisi dari install_asm
Jika Anda sudah terbiasa dengan install_asm
, asmcli
serupa, tetapi dengan
perbedaan penting berikut:
Anda menggunakan
asmcli install
untuk penginstalan dan upgrade baru. Tidak ada Opsi--mode
seperti denganinstall_asm
. Saat Anda menjalankanasmcli install
, sistem akan memeriksa apakah terdapat bidang kontrol yang ada di cluster. Jika tidak ada bidang kontrol,asmcli
menginstal Cloud Service Mesh. Jika cluster memiliki bidang kontrol yang ada (baik bidang kontrol Cloud Service Mesh maupun bidang Bidang kontrol Istio):Jika label revisi pada bidang kontrol yang ada tidak cocok dengan label revisi untuk bidang kontrol baru,
asmcli
melakukan upgrade canary.Jika label revisi bidang kontrol sama,
asmcli
akan melakukan {i>upgrade.<i}
Sebagian besar
asmcli
opsi dan flag berperilaku sama seperti yang digunakan untukinstall_asm
.
Bertransisi dari istioctl install
Jika Anda sudah terbiasa dengan istioctl install
, jika Anda biasanya meneruskan
File YAML IstioOperator
menggunakan argumen command line -f
untuk mengonfigurasi
bidang kontrol, Anda dapat meneruskan file ke asmcli
menggunakan --custom_overlay
sebelumnya. Dalam dokumentasi Cloud Service Mesh, kami menyebut file ini sebagai overlay
.
Platform yang didukung
Penginstalan Cloud Service Mesh pada daftar
Platform yang didukung dapat dikonfigurasi
atau diupgrade oleh asmcli
.
Namun, tidak semua fitur tersedia pada platform di luar Google Cloud. Untuk mengetahui detailnya, lihat Fitur yang didukung bidang kontrol dalam cluster.