Informazioni sulle condizioni dello stato della funzionalità

Nota: i servizi canonici sono supportati automaticamente in Cloud Service Mesh versione 1.6.8 e successive.

Questa pagina descrive come interpretare e agire in base alle condizioni segnalate nel cluster o nel parco risorse di Cloud Service Mesh.

Per verificare la presenza di condizioni, esegui questo comando:

  gcloud container fleet mesh describe --project FLEET_PROJECT

L'output potrebbe includere conditions in membershipStates per un cluster, ad esempio:

  ...
  membershipStates:
    projects/test-project/locations/us-central1/memberships/my-membership:
      servicemesh:
        conditions:
          - code: <CONDITION_CODE>
            details: ...
            documentationLink: ....
            severity: ...

I valori di code sono descritti in modo più dettagliato in questa pagina.

NODEPOOL_WORKLOAD_IDENTITY_FEDERATION_REQUIRED

Potresti visualizzare il codice di errore NODEPOOL_WORKLOAD_IDENTITY_FEDERATION_REQUIRED nel campo Conditions del tuo abbonamento:

    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

Questo errore viene visualizzato se il cluster GKE non ha la federazione delle identità per i workload abilitata su tutti i node pool del cluster, poiché si tratta di un prerequisito per l'installazione di Cloud Service Mesh.

Per risolvere questo messaggio di errore, devi seguire le istruzioni per attivare la federazione delle identità per i workload su tutti i node pool. Tieni presente che l'attivazione può variare a seconda del caso specifico del cluster.

Dopo l'attivazione, il messaggio di errore dovrebbe essere rimosso automaticamente e il cluster dovrebbe tornare allo stato ACTIVE. Se il problema persiste e hai bisogno di ulteriore assistenza, consulta Richiedi assistenza.

MESH_IAM_PERMISSION_DENIED

Questo errore indica che l'agente di servizio Cloud Service Mesh nel progetto del parco risorse non dispone delle autorizzazioni richieste nel progetto del cluster. Questo può accadere se il cluster si trova in un progetto diverso da quello del parco risorse o se le autorizzazioni sono state revocate.

Per risolvere i problemi, segui uno dei seguenti metodi:

Console Google Cloud

  1. Nella console Google Cloud , vai a IAM e amministrazione > IAM.

  2. Seleziona Includi concessioni di ruoli fornite da Google.

  3. Esamina l'elenco Entità.

    Se nell'elenco vedi l'agente di servizio con il ruolo IAM richiesto, significa che è configurato correttamente.

    Se l'elenco non include l'agente di servizio e il ruolo richiesto, vai al passaggio successivo.

  4. Concedi il ruolo Anthos Service Mesh Service Agent (roles/anthosservicemesh.serviceAgent) al service agent Cloud Service Mesh nel progetto. Per istruzioni, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Google Cloud CLI

  1. In Google Cloud CLI, esegui questo comando per verificare se è stato concesso il ruolo IAM richiesto:

    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)'
    
  2. Esamina l'elenco ROLE.

    Se nell'elenco sono presenti ruoli, la configurazione è corretta.

    Se non vedi alcun ruolo nell'elenco, significa che il ruolo richiesto è stato revocato.

  3. Per concedere il ruolo richiesto all'agente di servizio, esegui questo comando:

     gcloud projects add-iam-policy-binding PROJECT_ID \
     --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-servicemesh.iam.gserviceaccount.com" \
     --role="roles/anthosservicemesh.serviceAgent"
    

Se l'autorizzazione è verificata, ma il problema persiste, contatta l'assistenza clienti Google per ulteriore aiuto.

MESH_IAM_CROSS_PROJECT_PERMISSION_DENIED

Questo errore indica che il account di servizio del progetto del parco risorse non dispone di autorizzazioni sufficienti per accedere a un altro progetto (il progetto del cluster o il progetto di rete).

Per il VPC condiviso, assicurati di concedere il ruolo Anthos Service Mesh Service Agent account di servizio di tutti i progetti del parco risorse nel progetto di rete VPC condiviso.

Per gli scenari di progetto del parco risorse GKE e di progetto del cluster, assicurati di concedere il ruolo Anthos Service Mesh Service Agent al account di servizio del progetto del parco risorse nel progetto del cluster.

Esempio di comando per la risoluzione dei problemi:

  1. Verifica se il account di servizio del progetto di rete o del progetto del cluster ha concesso il ruolo Anthos Service Mesh Service Agent al account di servizio del progetto del parco risorse. In caso contrario, esegui:

    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.serviceAgent
    

    Inoltre, verifica di non avere un'automazione che rimuoverebbe questa associazione.

  2. Se l'autorizzazione è verificata, ma il problema persiste, contatta l'assistenza clienti Google per ulteriore aiuto.

CONFIG_VALIDATION_ERROR

Questo errore indica che non è possibile applicare correttamente una configurazione relativa al mesh applicata a una o più membership del parco risorse. I dettagli dell'errore descrivono il modo migliore in cui l'utente può risolverlo.

  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:

Gli errori di convalida della configurazione per una configurazione specifica richiedono l'intervento dell'utente. Ad esempio, gli errori relativi all'utilizzo di campi API non supportati vengono risolti al meglio rimuovendo la configurazione incriminata dall'API Mesh.

Nella console Cloud, vai a Kubernetes Engine > Secret e ConfigMap > istio-asm-managed (il nome di ConfigMap dipende dal canale di rilascio che stai utilizzando, ad esempio istio-asm-managed-stable o istio-asm-managed-rapid), quindi seleziona la scheda YAML.

Ad esempio, meshConfig.configSources non è più supportato:

apiVersion: v1
data:
  mesh: |
    enablePrometheusMerge: true
    trustDomain: "foobar.svc.id.goog"
    trustDomainAliases:
      - cluster.local

    configSources:
      - address: k8s://
      - address: fs:///var/lib/istio/config/data