Tentang asmcli

asmcli adalah skrip 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.
  • Daftarkan cluster ke fleet jika belum terdaftar.

Cukup sertakan flag --enable_all saat menjalankan asmcli untuk mengizinkannya mengonfigurasi project dan cluster Anda.

Selanjutnya, asmcli akan mengonfigurasi file YAML dengan informasi project dan cluster Anda. File konfigurasi ini diperlukan untuk menginstal bidang kontrol dalam cluster Anthos Service Mesh.

Secara default, asmcli tidak menginstal gateway masuk dengan bidang kontrol. Meskipun tidak masalah untuk evaluasi dan kasus penggunaan sederhana, penggabungan gateway ke bidang kontrol akan membuat pengelolaan dan upgrade menjadi lebih rumit. Untuk deployment produksi, sebaiknya Anda menginstal gateway secara terpisah.

asmcli menggantikan istioctl install dan skrip 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 di tempat.

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

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.

Dengan pratinjau ini, kami memiliki dokumentasi untuk menggunakan asmcli guna menginstal bidang kontrol dalam cluster Anthos Service Mesh di platform berikut:

  • GKE:

    • Untuk penginstalan baru, cluster dapat berada dalam project yang sama atau berbeda.

    • Untuk upgrade, kecuali jika Anda menggunakan asmcli untuk penginstalan awal, rilis pratinjau asmcli ini tidak mendukung upgrade cluster yang ada di project berbeda. Untuk mengupgrade mesh multi-project, lihat Mengupgrade Anthos Service Mesh di GKE dalam mesh multi-project.

  • Lokal: Instalasi dan upgrade baru didukung di GKE di VMware dan Google Distributed Cloud Virtual untuk Bare Metal

Langkah selanjutnya