Risoluzione dei problemi di Cloud Service Mesh gestito
Questo documento descrive i problemi più comuni di Cloud Service Mesh e spiega come risolverli, ad esempio quando un pod viene inserito con istio.istio-system, lo strumento di installazione genera errori come i codici di stato HTTP 400 ed errori di appartenenza al cluster.
Se hai bisogno di ulteriore assistenza per la risoluzione dei problemi di Cloud Service Mesh, consulta Richiedi assistenza.
Errore di segnalazione di stato non integro delle revisioni
Se l'agente di servizio per Cloud Service Mesh gestito non dispone del ruolo Identity and Access Management (IAM) richiesto, potresti visualizzare un errore Revision(s) reporting unhealthy generico.
Per risolvere questo errore, segui i passaggi per concedere il ruolo di agente di servizio Cloud Service Mesh.
Lo strumento di installazione genera errori HTTP 400
Lo strumento di installazione potrebbe generare errori HTTP 400 come i seguenti:
HealthCheckContainerError, message: Cloud Run error: Container failed to start.
Failed to start and then listen on the port defined by the PORT environment
variable. Logs for this revision might contain more information.
L'errore può verificarsi se non hai attivato Workload Identity sul tuo cluster Kubernetes, cosa che puoi fare utilizzando il seguente comando:
export CLUSTER_NAME=...
export PROJECT_ID=...
export LOCATION=...
gcloud container clusters update $CLUSTER_NAME --zone $LOCATION \
--workload-pool=$PROJECT_ID.svc.id.goog
Stato del piano dati gestito
Il seguente comando mostra lo stato del piano dati gestito:
gcloud container fleet mesh describe --project PROJECT_ID
La tabella seguente elenca tutti i possibili stati del piano dati gestito:
| Stato | Codice | Descrizione |
|---|---|---|
ACTIVE |
OK |
Il piano dati gestito funziona normalmente. |
DISABLED |
DISABLED |
Il piano dati gestito sarà in questo stato se non è configurato alcuno spazio dei nomi o alcuna revisione per utilizzarlo. Segui le istruzioni per abilitare Cloud Service Mesh gestito tramite l'API Fleet o abilita il piano dati gestito dopo aver eseguito il provisioning di Cloud Service Mesh gestito con asmcli.
Tieni presente che i report sullo stato del piano dati gestito sono disponibili solo se hai attivato il piano dati gestito annotando uno spazio dei nomi o una revisione.
L'annotazione di singoli pod fa sì che questi pod vengano gestiti, ma con uno stato funzionalità DISABLED se non vengono annotati spazi dei nomi o revisioni. |
FAILED_PRECONDITION |
MANAGED_CONTROL_PLANE_REQUIRED |
Il piano dati gestito richiede un control plane Cloud Service Mesh gestito attivo. |
PROVISIONING |
PROVISIONING |
È in corso il provisioning del piano dati gestito. Se questo stato persiste per più di 10 minuti, è probabile che si sia verificato un errore e devi contattare l'assistenza. |
STALLED |
INTERNAL_ERROR |
Il piano dati gestito non può funzionare a causa di una condizione di errore interno. Se il problema persiste, contatta l'assistenza. |
NEEDS_ATTENTION |
UPGRADE_FAILURES |
Il piano dati gestito richiede un intervento manuale per riportare il servizio allo stato normale. Per ulteriori informazioni e su come risolvere questo problema, consulta Stato NEEDS_ATTENTION. |
NEEDS_ATTENTION stato
Se il comando gcloud container fleet mesh describe mostra che lo stato del piano dati gestito è NEEDS_ATTENTION e il codice è UPGRADE_FAILURES, significa che il piano dati gestito non è riuscito a eseguire l'upgrade di determinati workload. Questi workload verranno etichettati con dataplane-upgrade: failed dal servizio del piano dati gestito per un'ulteriore analisi. I proxy devono essere riavviati manualmente per eseguire l'upgrade. Per ottenere l'elenco dei pod che richiedono attenzione, esegui questo comando:
kubectl get pods --all-namespaces -l dataplane-upgrade=failed
Errore di appartenenza al cluster (nessun provider di identità specificato)
Lo strumento di installazione potrebbe non riuscire con errori di appartenenza al cluster come i seguenti:
asmcli: [ERROR]: Cluster has memberships.hub.gke.io CRD but no identity
provider specified. Please ensure that an identity provider is available for the
registered cluster.
L'errore può verificarsi se non hai
abilitato Workload Identity di GKE
prima di registrare il cluster. Puoi registrare nuovamente il cluster dalla riga di comando utilizzando il comando gcloud container fleet memberships register --enable-workload-identity.
Controlla lo stato del control plane gestito
Per controllare lo stato del control plane gestito, esegui gcloud container fleet mesh describe --project FLEET_PROJECT_ID.
Nella risposta, il campo membershipStates[].servicemesh.controlPlaneManagement.details potrebbe spiegare l'errore specifico.
Se hai bisogno di ulteriori dettagli, controlla la risorsa personalizzata ControlPlaneRevision nel cluster, che viene aggiornata quando viene eseguito il provisioning del control plane gestito o quando il provisioning non va a buon fine.
Per esaminare lo stato della risorsa, sostituisci NAME con il valore corrispondente a ciascun canale: asm-managed, asm-managed-stable o asm-managed-rapid.
kubectl describe controlplanerevision NAME -n istio-system
L'output è simile al seguente:
Name: asm-managed
…
Status:
Conditions:
Last Transition Time: 2021-08-05T18:56:32Z
Message: The provisioning process has completed successfully
Reason: Provisioned
Status: True
Type: Reconciled
Last Transition Time: 2021-08-05T18:56:32Z
Message: Provisioning has finished
Reason: ProvisioningFinished
Status: True
Type: ProvisioningFinished
Last Transition Time: 2021-08-05T18:56:32Z
Message: Provisioning has not stalled
Reason: NotStalled
Status: False
Type: Stalled
La condizione Reconciled determina se il control plane gestito è in esecuzione correttamente. Se è true, il control plane è in esecuzione correttamente.
Stalled determina se il processo di provisioning del control plane gestito ha riscontrato un errore. Se Stalled, il campo Message contiene ulteriori informazioni sull'errore specifico. Per ulteriori informazioni sui possibili errori, consulta la sezione Codici bloccati.
Codici di blocco di ControlPlaneRevision
Esistono diversi motivi per cui la condizione Stalled potrebbe diventare vera nello stato ControlPlaneRevisions.
| Motivo | Messaggio | Descrizione |
|---|---|---|
| PreconditionFailed | Sono supportate solo le iscrizioni GKE, ma ${CLUSTER_NAME} non è un cluster GKE. | Il cluster attuale non sembra essere un cluster GKE. Il control plane gestito funziona solo sui cluster GKE. |
| Nome ControlPlaneRevision non supportato: ${NAME} | Il nome di ControlPlaneRevision deve essere uno dei seguenti:
|
|
| Spazio dei nomi ControlPlaneRevision non supportato: ${NAMESPACE} | Lo spazio dei nomi di ControlPlaneRevision deve essere istio-system. |
|
| Canale ${CHANNEL} non supportato per ControlPlaneRevision con nome ${NAME}. Consegna prevista ${OTHER_CHANNEL} | Il nome di ControlPlaneRevision deve corrispondere al canale di ControlPlaneRevision con quanto segue:
|
|
| Il canale non deve essere omesso o vuoto | Channel è un campo obbligatorio in ControlPlaneRevision. Manca o è vuoto nella risorsa personalizzata. |
|
| Tipo di revisione del control plane non supportato: ${TYPE} | managed_service è l'unico campo consentito per il campo ControlPlaneRevisionType. |
|
| Versione di Kubernetes non supportata: ${VERSION} | Sono supportate le versioni di Kubernetes 1.15 e successive. | |
| Workload Identity non è abilitato | Abilita Workload Identity sul cluster. | |
| Pool di workload non supportato: ${POOL} | Il pool di workload deve essere nel formato ${PROJECT_ID}.svc.id.goog. |
|
| ProvisioningFailed | Si è verificato un errore durante l'aggiornamento delle risorse del cluster | Google non è riuscita ad aggiornare le risorse nel cluster, come CRD e webhook. |
| MutatingWebhookConfiguration "istiod-asm-managed" contiene un webhook con URL ${EXISTING_URL}, ma è previsto ${EXPECTED_URL} | Google non sovrascriverà i webhook esistenti per evitare di interrompere l'installazione. Se questo è il comportamento desiderato, aggiorna manualmente. | |
| ValidatingWebhookConfiguration ${NAME} contiene un webhook con URL ${EXISTING_URL}, ma è previsto ${EXPECTED_URL} | Google non sovrascriverà i webhook esistenti per evitare di interrompere l'installazione. Se questo è il comportamento desiderato, aggiorna manualmente. |
Cloud Service Mesh gestito non riesce a connettersi al cluster GKE
Tra giugno 2022 e settembre 2022, Google ha completato le attività di sicurezza relative alle reti autorizzate, a Cloud Run e a Cloud Run Functions su Google Kubernetes Engine (GKE). I progetti che in precedenza utilizzavano Cloud Service Mesh gestito, ma hanno smesso di utilizzarlo prima della migrazione, non dispongono dell'API richiesta per la comunicazione tra Cloud Run e GKE.
In questo scenario, il provisioning di Cloud Service Mesh gestito non andrà a buon fine e Cloud Logging visualizzerà il seguente messaggio di errore:
Connect Gateway API has not been used in project [*PROJECT_NUMBER*] before or it is disabled.
Enable it by visiting https://console.developers.google.com/apis/api/connectgateway.googleapis.com/overview?project=[*PROJECT_NUMBER*] then retry.
If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry.
Filtra questo messaggio utilizzando la seguente query:
resource.type="istio_control_plane"
resource.labels.project_id=[*PROJECT_ID*]
resource.labels.location=[*REGION*]
severity=ERROR
jsonPayload.message=~"Connect Gateway API has not been used in project"
Nel frattempo, anche l'iniezione sidecar e il deployment di qualsiasi risorsa personalizzata Kubernetes correlata a Cloud Service Mesh non riusciranno e Cloud Logging visualizzerà il seguente messaggio di avviso:
Error creating: Internal error occurred: failed calling webhook
"rev.namespace.sidecar-injector.istio.io": failed to call webhook: an error on
the server ("unknown") has prevented the request from succeeding.
Filtra questo messaggio utilizzando la seguente query:
resource.type="k8s_cluster"
resource.labels.project_id=[*PROJECT_ID*]
resource.labels.location=[*REGION*]
resource.labels.cluster_name=[*CLUSTER_NAME*]
severity=WARNING
jsonPayload.message=~"Internal error occurred: failed calling webhook"
Per risolvere il problema:
Abilita l'API
connectgatewayrichiesta:gcloud services enable connectgateway.googleapis.com --project=[*PROJECT_ID*]Esegui un riavvio in sequenza dei workload.
Google Cloud Le API non sono abilitate
Se il tuo parco risorse Cloud Service Mesh gestito utilizza l'implementazione del control plane TRAFFIC_DIRECTOR, devi abilitare determinate API.
Abilita tutte le API richieste, incluse quelle elencate come "Può essere disabilitata" quando non utilizzi Cloud Service Mesh gestito.
gcloud services enable --project=[*PROJECT_ID*] \ trafficdirector.googleapis.com \ networkservices.googleapis.com \ networksecurity.googleapis.comAssicurati di non avere strumenti automatici che annullino questa modifica. Se l'errore si ripresenta, aggiorna le configurazioni o le liste consentite pertinenti.