Memahami Kondisi Status Fitur
Catatan: Canonical Service didukung secara otomatis di Cloud Service Mesh versi 1.6.8 dan yang lebih tinggi.
Halaman ini menjelaskan cara menafsirkan dan menindaklanjuti Kondisi yang dilaporkan di cluster atau fleet Cloud Service Mesh Anda.
Untuk memeriksa kondisi, jalankan perintah ini:
gcloud container fleet mesh describe --project FLEET_PROJECT
Output-nya mungkin menyertakan conditions di membershipStates untuk cluster, seperti:
...
membershipStates:
projects/test-project/locations/us-central1/memberships/my-membership:
servicemesh:
conditions:
- code: <CONDITION_CODE>
details: ...
documentationLink: ....
severity: ...
Nilai code dijelaskan secara lebih mendetail di halaman ini.
NODEPOOL_WORKLOAD_IDENTITY_FEDERATION_REQUIRED
Anda mungkin melihat kode error NODEPOOL_WORKLOAD_IDENTITY_FEDERATION_REQUIRED di
kolom Conditions keanggotaan Anda:
membershipStates:
projects/test-project/locations/us-central1/memberships/my-membership:
servicemesh:
conditions:
- code: NODEPOOL_WORKLOAD_IDENTITY_FEDERATION_REQUIRED
details: One or more node pools have workload identity federation disabled.
documentationLink: https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity
severity: ERROR
controlPlaneManagement:
details:
- code: REVISION_FAILED_PRECONDITION
details: Required in-cluster components are not ready. This will be retried
within 15 minutes.
implementation: TRAFFIC_DIRECTOR
state: FAILED_PRECONDITION
Error ini ditampilkan jika cluster GKE tidak mengaktifkan Workload Identity Federation di semua node pool cluster tersebut, karena ini adalah prasyarat untuk penginstalan Cloud Service Mesh.
Untuk mengatasi pesan error ini, Anda harus mengikuti petunjuk untuk Mengaktifkan Workload Identity Federation di semua node pool. Perhatikan bahwa pengaktifan dapat bervariasi bergantung pada kasus cluster spesifik Anda.
Setelah diaktifkan, pesan error akan otomatis dihapus dan cluster Anda akan kembali ke status ACTIVE. Jika masalah berlanjut dan Anda memerlukan bantuan tambahan, lihat Mendapatkan dukungan.
MESH_IAM_PERMISSION_DENIED
Error ini menunjukkan bahwa agen layanan Cloud Service Mesh di project fleet tidak memiliki izin yang diperlukan pada project cluster. Hal ini dapat terjadi jika cluster berada di project yang berbeda dengan fleet, atau jika izin dicabut.
Untuk memecahkan masalah, ikuti salah satu metode berikut:
Konsol Google Cloud
Di konsol Google Cloud , buka IAM & Admin > IAM.
Pilih Sertakan pemberian peran yang disediakan Google.
Tinjau daftar Principal.
Jika Anda melihat agen layanan dengan peran IAM yang diperlukan dalam daftar, berarti agen layanan tersebut telah dikonfigurasi dengan benar.
Jika daftar tidak menyertakan agen layanan dan peran yang diperlukan, lanjutkan ke langkah berikutnya.
Berikan peran Agen Layanan Anthos Service Mesh (
roles/anthosservicemesh.serviceAgent) ke agen layanan Cloud Service Mesh pada project. Untuk mengetahui petunjuknya, lihat Mengelola akses ke project, folder, dan organisasi.
Google Cloud CLI
Di Google Cloud CLI, jalankan perintah berikut untuk memeriksa apakah peran IAM yang diperlukan telah diberikan:
gcloud projects get-iam-policy PROJECT_ID \ --flatten="bindings[].members" \ --filter="bindings.members:serviceAccount:service-PROJECT_NUMBER@gcp-sa-servicemesh.iam.gserviceaccount.com AND bindings.role:roles/anthosservicemesh.serviceAgent" \ --format='table(bindings.role)'Tinjau daftar
ROLE.Jika Anda melihat peran apa pun dalam daftar, berarti peran tersebut dikonfigurasi dengan benar.
Jika Anda tidak melihat peran apa pun dalam daftar, berarti peran yang diperlukan telah dicabut.
Untuk memberikan peran yang diperlukan kepada agen layanan, jalankan perintah berikut:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-servicemesh.iam.gserviceaccount.com" \ --role="roles/anthosservicemesh.serviceAgent"
Jika izin telah diverifikasi, tetapi masalah masih berlanjut, hubungi dukungan pelanggan Google untuk mendapatkan bantuan lebih lanjut.
MESH_IAM_CROSS_PROJECT_PERMISSION_DENIED
Error ini menunjukkan bahwa akun layanan project fleet tidak memiliki izin yang cukup untuk mengakses project lain (project cluster atau project jaringan).
Untuk VPC Bersama, pastikan untuk memberikan peran Anthos Service Mesh Service Agent ke semua akun layanan project fleet di project jaringan VPC Bersama.
Untuk skenario project fleet GKE dan project cluster, pastikan untuk memberikan peran Anthos Service Mesh Service Agent kepada akun layanan project fleet di project cluster.
Contoh perintah pemecahan masalah:
Pastikan akun layanan project jaringan atau project cluster Anda telah memberikan peran
Anthos Service Mesh Service Agentke akun layanan project fleet. Jika tidak, jalankan:gcloud projects add-iam-policy-binding NETWORK_OR_CLUSTER_PROJECT_ID \ --member "serviceAccount:service-FLEET_PROJECT_NUMBER@gcp-sa-servicemesh.iam.gserviceaccount.com" \ --role roles/anthosservicemesh.serviceAgentSelain itu, pastikan Anda tidak memiliki otomatisasi yang akan menghapus binding ini.
Jika izin telah diverifikasi, tetapi masalah masih berlanjut, hubungi dukungan pelanggan Google untuk mendapatkan bantuan lebih lanjut.
CONFIG_VALIDATION_ERROR
Error ini menunjukkan bahwa beberapa konfigurasi terkait mesh yang diterapkan pada satu atau beberapa keanggotaan dalam fleet tidak dapat diterapkan dengan berhasil. Detail error menjelaskan cara terbaik bagi pengguna untuk mengatasinya.
membershipStates:
projects/test-project/locations/us-central1/memberships/my-membership:
servicemesh:
conditions:
- code: CONFIG_VALIDATION_ERROR
details: 'Unsupported ProxyConfig fields: [proxyconfig.statNameLength]'
severity: ERROR
controlPlaneManagement:
Error validasi konfigurasi untuk konfigurasi tertentu memerlukan tindakan pengguna. Misalnya, error terkait penggunaan kolom API yang tidak didukung sebaiknya diatasi dengan menghapus konfigurasi yang bermasalah dari Mesh API.
Di Konsol Cloud, buka Kubernetes Engine > Secrets & ConfigMaps > istio-asm-managed (nama ConfigMap bergantung pada saluran rilis yang Anda gunakan; misalnya istio-asm-managed-stable atau istio-asm-managed-rapid), lalu pilih tab YAML.
Misalnya, meshConfig.configSources tidak lagi didukung:
apiVersion: v1
data:
mesh: |
enablePrometheusMerge: true
trustDomain: "foobar.svc.id.goog"
trustDomainAliases:
- cluster.local
configSources:
- address: k8s://
- address: fs:///var/lib/istio/config/data