Menginstal alat dependen dan memverifikasi cluster

Halaman ini menunjukkan cara menyiapkan lingkungan dan cluster untuk menginstal Cloud Service Mesh.

Menginstal alat yang diperlukan

Anda dapat menjalankan asmcli di Cloud Shell atau di komputer lokal yang menjalankan Linux. Cloud Shell telah menginstal semua alat yang diperlukan.

Catatan: macOS tidak didukung.

Jika Anda menjalankan asmcli secara lokal, pastikan Anda telah menginstal alat berikut:

• Google Cloud CLI
• Alat command line standar: awk, curl, grep, sed, dan tr
• git
• kubectl
• jq
• (Opsional, untuk menguji konektivitas) netcat (nc)

Mengonfigurasi gcloud

Lakukan langkah-langkah berikut meskipun Anda menggunakan Cloud Shell.

1. Lakukan autentikasi dengan Google Cloud CLI:

   gcloud auth login --project PROJECT_ID
   

2. Perbarui komponen:

   gcloud components update
   

3. Jika Anda menginstal Cloud Service Mesh di cluster GKE, konfigurasikan kubectl untuk mengarah ke cluster.

   gcloud container clusters get-credentials CLUSTER_NAME \
        --location CLUSTER_LOCATION \
        --project PROJECT_ID
   

Catatan: Anda juga dapat menggunakan peniruan akun layanan dengan mengonfigurasi gcloud config sebelum menjalankan alat. Jalankan perintah gcloud config set auth/impersonate_service_account [e-mail]. Untuk menghapus peniruan identitas setelah menginstal Cloud Service Mesh, jalankan gcloud config unset auth/impersonate_service_account. Untuk mengetahui informasi selengkapnya, lihat konfigurasi gcloud.

Mendownload asmcli

Bagian ini menjelaskan cara mendownload asmcli.

1. Download versi yang menginstal Cloud Service Mesh 1.23.3 ke direktori kerja saat ini:

   curl https://storage.googleapis.com/csm-artifacts/asm/asmcli_1.23 > asmcli
   

   Catatan: Sebaiknya selalu download versi terbaru asmcli saat menginstal Cloud Service Mesh di cluster GKE baru. Perintah di langkah sebelumnya akan mendownload versi terbaru.

   Output yang diharapkan:

   % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                Dload  Upload   Total   Spent    Left  Speed
   100  167k  100  167k    0     0   701k      0 --:--:-- --:--:-- --:--:--  701k
   

2. Setel agar skrip dapat dieksekusi:

   chmod +x asmcli
   

Memberikan izin admin cluster

1. Pastikan Anda telah menetapkan konteks ke cluster pengguna:

   Catatan: Untuk memeriksa konteks yang ada, jalankan kubectl config get-contexts.

   kubectl config use-context CONTEXT

2. Berikan izin admin cluster ke akun pengguna Anda (alamat email login Google Cloud Anda). Anda memerlukan izin ini untuk membuat aturan kontrol akses berbasis peran (RBAC) yang diperlukan untuk Cloud Service Mesh:

   kubectl create clusterrolebinding cluster-admin-binding \
     --clusterrole=cluster-admin \
     --user=USER_ACCOUNT

Memvalidasi project dan cluster

Anda dapat menjalankan asmcli validate untuk memastikan project dan cluster Anda disiapkan seperti yang diperlukan untuk menginstal Cloud Service Mesh. Dengan opsi ini, asmcli tidak akan membuat perubahan apa pun pada project atau cluster Anda, dan tidak menginstal Cloud Service Mesh.

asmcli memvalidasi bahwa:

• Lingkungan Anda memiliki alat yang diperlukan.

• Cluster memenuhi persyaratan minimum.

• Anda memiliki izin yang diperlukan pada project yang ditentukan.

• Project telah mengaktifkan semua Google API yang diperlukan.

Secara default, asmcli mendownload dan mengekstrak file penginstalan serta mendownload paket konfigurasi asm dari GitHub ke direktori sementara. Sebelum keluar, asmcli akan menampilkan pesan yang memberikan nama direktori sementara. Sebaiknya tentukan direktori untuk download dengan opsi --output_dir DIR_PATH. Opsi --output_dir memudahkan Anda menggunakan alat command line istioctl. (Anda mungkin memerlukan istioctl untuk memecahkan masalah konfigurasi atau menyiapkan mesh multi-cluster di cluster GKE pribadi). Selain itu, file konfigurasi untuk mengaktifkan fitur opsional menggunakan asmcli disertakan dalam direktori asm/istio/options.

Jalankan perintah berikut untuk memvalidasi konfigurasi Anda dan mendownload file penginstalan serta paket asm ke direktori OUTPUT_DIR.

GKE

./asmcli validate \
  --project_id PROJECT_ID \
  --cluster_name CLUSTER_NAME \
  --cluster_location CLUSTER_LOCATION \
  --fleet_id FLEET_PROJECT_ID \
  --output_dir DIR_PATH

• --project_id, --cluster_name, dan --cluster_location Tentukan project ID tempat cluster berada, nama cluster, dan zona atau region cluster.

• --fleet_id Project ID untuk project host fleet. asmcli validate memeriksa apakah cluster terdaftar ke fleet yang ditentukan.

• --output_dir Sertakan opsi ini untuk menentukan direktori tempat asmcli mendownload paket asm dan mengekstrak file penginstalan, yang berisi istioctl, sampel, dan manifes. Jika tidak, asmcli akan mendownload file ke direktori tmp. Anda dapat menentukan jalur relatif atau jalur lengkap. Variabel lingkungan $PWD tidak berfungsi di sini.

Di luar Google Cloud

Gunakan perintah berikut untuk menjalankan asmcli validate di platform berikut: Google Distributed Cloud, Google Distributed Cloud, GKE di AWS, Amazon EKS, dan Microsoft AKS.

1. Tetapkan konteks saat ini ke cluster pengguna Anda:

   kubectl config use-context CLUSTER_NAME
   

2. Jalankan perintah berikut untuk memvalidasi konfigurasi dan mendownload file penginstalan serta paket asm ke direktori OUTPUT_DIR:

   ./asmcli validate \
     --kubeconfig KUBECONFIG_FILE \
     --fleet_id FLEET_PROJECT_ID \
     --output_dir DIR_PATH \
     --platform multicloud
   

   • --kubeconfig Jalur ke kubeconfig Anda dapat menentukan jalur relatif atau jalur lengkap. Variabel lingkungan $PWD tidak berfungsi di sini.

   • --fleet_id Project ID untuk project host fleet. asmcli validate memeriksa apakah cluster terdaftar ke fleet yang ditentukan.

   • --output_dir Sertakan opsi ini untuk menentukan direktori tempat asmcli mendownload paket asm dan mengekstrak file penginstalan, yang berisi istioctl, sampel, dan manifes. Jika tidak, asmcli akan mendownload file ke direktori tmp. Anda dapat menentukan jalur relatif atau jalur lengkap. Variabel lingkungan $PWD tidak berfungsi di sini.

   • --platform multicloud Menentukan bahwa platform tersebut adalah sesuatu yang bukan Google Cloud, seperti lokal atau multi-cloud.

Jika berhasil, asmcli akan menampilkan output berikut:

asmcli: Setting up necessary files...
asmcli: Using asm_kubeconfig as the kubeconfig...
asmcli: Checking installation tool dependencies...
asmcli: Fetching/writing GCP credentials to kubeconfig file...
asmcli: Verifying connectivity (10s)...
asmcli: kubeconfig set to asm_kubeconfig
asmcli: using context gke_example-project-12345_us-central1_cluster-2
asmcli: Getting account information...
asmcli: Downloading ASM..
asmcli: Downloading ASM kpt package...
fetching package "/asm" from "https://github.com/GoogleCloudPlatform/anthos-service-mesh-packages" to "asm"
asmcli: Checking required APIs...
asmcli: Checking for project example-project-12345...
asmcli: Reading labels for us-central1/cluster-2...
asmcli: Checking for istio-system namespace...
asmcli: Confirming node pool requirements for example-project-12345/us-central1/cluster-2...
asmcli: Checking Istio installations...
asmcli: [WARNING]: There is no way to validate that the meshconfig API has been initialized.
asmcli: [WARNING]: This needs to happen once per GCP project. If the API has not been initialized
asmcli: [WARNING]: for example-project-12345, please re-run this tool with the --enable_gcp_components
asmcli: [WARNING]: flag. Otherwise, installation will succeed but Anthos Service Mesh
asmcli: [WARNING]: will not function correctly.
asmcli: Successfully validated all requirements to install ASM.

Jika salah satu pengujian gagal dalam validasi, asmcli akan menampilkan pesan error. Misalnya, jika project Anda tidak mengaktifkan semua Google API yang diperlukan, Anda akan melihat error berikut:

ERROR: One or more APIs are not enabled. Please enable them and retry, or run
`asmcli` with the '--enable_gcp_apis' flag to allow `asmcli` to enable them
on your behalf.

Jika Anda mendapatkan pesan error tentang perlunya menjalankan asmcli dengan tanda pengaktifan, Anda memiliki opsi berikut:

• Sertakan flag tertentu dari pesan error atau flag --enable_all saat menjalankan asmcli untuk melakukan penginstalan yang sebenarnya.

• Jika mau, Anda dapat mengupdate project dan cluster sendiri sebelum menjalankan asmcli seperti yang dijelaskan dalam Menyiapkan project dan cluster GKE sendiri.

Perhatikan bahwa asmcli validate tidak mengizinkan flag pengaktifan apa pun karena hanya memvalidasi bahwa project dan cluster Anda siap untuk diinstal.

Memeriksa persyaratan penginstalan dan upgrade cluster

Sebelum mengupgrade, Anda harus memeriksa apakah konfigurasi Anda kompatibel dengan Cloud Service Mesh versi baru.

1. Ubah ke direktori yang Anda tentukan di --output_dir.

2. Jalankan perintah berikut untuk memeriksa cluster Kubernetes untuk persyaratan penginstalan dan upgrade. Pastikan Anda menggunakan versi istioctl yang didistribusikan dengan versi Cloud Service Mesh baru.

   istioctl experimental precheck
   

Apa langkah selanjutnya?

• Menginstal Cloud Service Mesh
• Mengupgrade Cloud Service Mesh