Tentang asmcli

asmcli adalah alat yang disediakan Google yang dapat Anda gunakan untuk menginstal atau mengupgrade Cloud Service Mesh. Jika Anda mengizinkannya, asmcli akan mengonfigurasi project dan cluster Anda sebagai berikut:

  • Memberikan izin Identity and Access Management (IAM) yang diperlukan di project Google Cloud Anda.
  • Aktifkan Google API yang diperlukan di project Google Cloud Anda.
  • Tetapkan label pada cluster yang mengidentifikasi mesh.
  • Buat akun layanan yang memungkinkan komponen bidang data, seperti proxy sidecar, mengakses data dan resource project Anda dengan aman.
  • Daftarkan cluster ke fleet jika belum terdaftar.

Cukup sertakan flag --enable_all saat Anda menjalankan asmcli agar dapat mengonfigurasi project dan cluster Anda. Untuk mengetahui informasi selengkapnya tentang opsi dan flag asmcli, lihat referensi asmcli.

Selanjutnya, asmcli akan 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 berikutnya ditujukan untuk membantu Cloud Service Mesh yang ada diupgrade ke 1.23.

Bertransisi ke asmcli

asmcli menggantikan istioctl install dan install_asm. Meskipun Anda masih dapat menggunakan alat lama di Cloud Service Mesh 1.11, kami tidak lagi menggunakannya dan alat tersebut tidak akan didukung lagi di Cloud Service Mesh 1.12 dan yang lebih baru. Update skrip dan alat Anda untuk menggunakan asmcli.

Dengan Cloud Service Mesh 1.11 dan yang lebih baru, semua cluster harus terdaftar ke fleet. Lihat Persyaratan armada untuk mengetahui detailnya.

Bertransisi dari install_asm

Jika Anda sudah terbiasa dengan install_asm, asmcli mirip, tetapi dengan perbedaan penting berikut:

  • Anda menggunakan asmcli install untuk penginstalan dan upgrade baru. Tidak ada opsi --mode seperti dengan install_asm. Saat Anda menjalankan asmcli install, asmcli install akan memeriksa apakah ada panel kontrol yang ada di cluster. Jika tidak ada bidang kontrol yang ada, asmcli akan menginstal Cloud Service Mesh. Jika cluster memiliki bidang kontrol yang ada (baik bidang kontrol Cloud Service Mesh maupun bidang kontrol Istio open source):

    • Jika label revisi pada panel kontrol yang ada tidak cocok dengan label revisi untuk panel kontrol baru, asmcli akan melakukan upgrade canary.

    • Jika label revisi panel kontrol sama, asmcli akan melakukan upgrade di tempat.

  • Sebagian besar opsi dan tanda asmcli berperilaku sama dengan yang ada untuk install_asm.

Bertransisi dari istioctl install

Jika Anda sudah terbiasa dengan istioctl install, jika biasanya Anda meneruskan file YAML IstioOperator menggunakan argumen command line -f untuk mengonfigurasi platform kontrol, Anda dapat meneruskan file ke asmcli menggunakan opsi --custom_overlay. Dalam dokumentasi Cloud Service Mesh, kita menyebut file ini sebagai file overlay.

Platform yang didukung

Penginstalan Cloud Service Mesh dalam daftar Platform yang didukung dapat dikonfigurasi atau diupgrade oleh asmcli.

Namun, tidak semua fitur tersedia di platform di luar Google Cloud. Untuk mengetahui detailnya, lihat Fitur yang didukung di bidang kontrol dalam cluster.

Langkah selanjutnya