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:

  • 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.
  • Berikan label pada cluster yang mengidentifikasi mesh.
  • Buat akun layanan yang memungkinkan komponen bidang data, seperti proxy file bantuan, 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 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 sudah ada 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 menghentikannya dan tidak akan lagi didukung 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 ke sebuah 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 pada install_asm. Saat Anda menjalankan asmcli install, sistem ini akan memeriksa apakah ada bidang kontrol yang ada di cluster. Jika bidang kontrol belum ada, asmcli akan menginstal Cloud Service Mesh. Jika cluster memiliki bidang kontrol yang sudah ada (baik bidang kontrol Cloud 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 secara langsung.

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

Bertransisi dari istioctl install

Jika Anda sudah terbiasa dengan istioctl install, jika biasanya meneruskan file YAML IstioOperator menggunakan argumen command line -f untuk mengonfigurasi bidang kontrol, Anda dapat meneruskan file tersebut ke asmcli menggunakan opsi --custom_overlay. Dalam dokumentasi Cloud Service Mesh, kami menyebut file ini sebagai file 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.

Langkah selanjutnya