Tentang asmcli

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

  • Memberi Anda 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 menjalankan asmcli untuk mengizinkannya 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 Anthos Service Mesh.

Jika Anda baru menggunakan Anthos Service Mesh dan Istio, lanjutkan ke Platform yang didukung. Bagian berikutnya ditujukan untuk membantu upgrade Anthos Service Mesh yang sudah ada ke 1.12.

Bertransisi ke asmcli

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

Dengan Anthos Service Mesh 1.11 dan yang lebih baru, semua cluster harus didaftarkan ke fleet. Lihat Persyaratan perangkat untuk mengetahui detailnya.

Bertransisi dari install_asm

Jika Anda sudah terbiasa menggunakan install_asm, asmcli akan serupa, tetapi memiliki perbedaan penting berikut:

  • Anda menggunakan asmcli install untuk penginstalan dan upgrade baru. Tidak ada opsi --mode seperti install_asm. Saat Anda menjalankan asmcli install, kode akan memeriksa apakah ada bidang kontrol pada cluster. Jika tidak ada bidang kontrol, asmcli akan menginstal Anthos Service Mesh. Jika cluster memiliki bidang kontrol yang sudah ada (bidang kontrol Anthos Service Mesh atau bidang kontrol Istio open source):

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

    • Jika label revisi bidang kontrol sama, asmcli akan melakukan upgrade langsung.

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

Bertransisi dari istioctl install

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

Platform yang didukung

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

Tidak semua fitur tersedia di platform di luar Google Cloud. Misalnya, certificate authority (Mesh CA) Anthos Service Mesh tidak didukung di GKE di AWS, Amazon EKS, atau Microsoft AKS. Untuk mengetahui detailnya, lihat Fitur yang didukung bidang kontrol dalam cluster.

Langkah selanjutnya