Questa pagina fornisce istruzioni dettagliate per aiutarti a risolvere i problemi di configurazione del connettore on-premise IAP. Per ulteriori informazioni sulla risoluzione dei problemi, consulta Debug di Cloud Service Mesh.
Risolvere i problemi relativi all'errore 500
Di seguito sono riportati vari problemi e possibili soluzioni per aiutarti a risolvere un errore 500 che ricevi quando tenti di accedere alla tua applicazione.
L'applicazione on-premise non è connessa alla Google Cloud rete
La tua applicazione on-premise potrebbe non essere connessa alla Google Cloud rete. Verifica la connettività eseguendo il ping dell'applicazione on-premise da una delle istanze Compute Engine del connettore on-premise. Se l'endpoint del connettore on-premise non è raggiungibile, esegui il debug della connettività e delle impostazioni di rete prima di continuare.
Envoy non è installato correttamente nelle VM
Completa i seguenti passaggi per verificare che Envoy sia installato correttamente:
- Accedi a una delle VM Compute Engine dal connettore on-premise. Il nome della VM del connettore on-premise inizia con
opc-on-prem-app-deployment-ig-${app}. - Nella console Google Cloud, verifica che i controlli di integrità del servizio di backend di bilanciamento del carico
opc-on-prem-app-deployment-gclb-urlmapsiano verdi. - Se il servizio di backend non viene visualizzato come integro, accedi tramite SSH a una delle istanze:
gcloud compute ssh INSTANCE_NAME --zone=ZONE_NAME
Verifica che Envoy sia in esecuzione eseguendo il seguente comando:
Oltre aps aux | grep envoy
grep envoy, devono essere in esecuzione più processi.Un output di esempio:
envoy 943 0.0 0.0 5488 3076 ? Ss 06:25 0:00 /bin/bash /usr/local/bin/run-proxy.sh envoy 944 0.1 1.5 178928 57352 ? Sl 06:25 1:23 /usr/local/bin/envoy --config-path /usr/local/etc/ envoy/envoy-proxy-bootstrap.json --allow-unknown-static-fields --disable-hot-restart --log-level info --drain-time- s 60Verifica che la directory dei log di Envoy sia stata creata in
/var/log/envoy/.Assicurati che il bucket gce-mesh sia raggiungibile dalle VM eseguendo il seguente comando:
gcloud storage cp gs://gce-mesh/service-proxy-agent/releases/service-proxy-agent-0.2.tgz .
Se una delle convalide in questo passaggio non è riuscita, Envoy non è installato correttamente. Per ulteriori informazioni, consulta i log di avvio in /var/log/daemon.log.
Se hai notato che Envoy non è in esecuzione dai passaggi precedenti, uno dei motivi potrebbe essere dovuto ai Controlli di servizio VPC. Lo script di avvio nelle VM scarica l'immagine di Envoy dal bucket gce-mesh. Se le regole dei Controlli di servizio VPC non consentono la connessione, il deployment del connettore on-premise non funzionerà.
Per assicurarti che Envoy venga installato correttamente, consenti l'accesso al bucket di archiviazione gce-mesh nei Controlli di servizio VPC nel progetto host. Inoltre, assicurati che il VPC abbia una regola di routing per consentire il traffico verso la rete internet pubblica. In questo modo, Envoy può essere sottoposto a deployment.
Per saperne di più, consulta
Regole in entrata e in uscita.
L'applicazione on-premise non è connessa a Envoy
Se puoi eseguire il ping dell'applicazione on-premise dalla VM, ma non puoi utilizzare il connettore on-premise, è possibile che Envoy non riesca a connettersi all'applicazione.
Per verificare che Envoy possa connettersi alla tua applicazione on-premise, prova a effettuare una chiamata a Envoy dalla macchina su cui è in esecuzione Envoy. Utilizzando SSH,connettiti alla VM opc-on-prem-app-deployment-ig-${app} ed esegui il seguente comando. Puoi trovare il numero di porta di Envoy in Gruppi di istanze > Dettagli > Mappatura dei nomi delle porte.
curl -x -v localhost:${envoy_port}Se l'endpoint non è raggiungibile, controlla quanto segue:
/var/log/envoy/envoy.err.logper eventuali log di errori. Se non sono presenti log di errori, verifica se Cloud Service Mesh è abilitato e se è in grado di configurare Envoy eseguendo il seguente comando:sudo curl 0.0.0.0:15000/config_dump
- Verifica che
TRAFFICDIRECTOR_INTERCEPTION_LISTENERsia impostato. SeTRAFFICDIRECTOR_INTERCEPTION_LISTENERnon è impostato, Cloud Service Mesh non è riuscito a configurare Envoy. - Controlla la presenza di eventuali messaggi di errore in ogni listener.
Le autorizzazioni dell'account Envoy e Cloud Service Mesh non sono impostate
Se visualizzi l'errore GRPC 403 in envoy.err.log o se non vedi TRAFFICDIRECTOR_INTERCEPTION_LISTENER nella configurazione di Envoy, potresti non aver impostato le autorizzazioni dell'account corrette.
Verifica che il account di servizio della VM disponga delle autorizzazioni di accesso TD per xDS v3:
- Verifica le autorizzazioni: Preparati a configurare Cloud Service Mesh con Envoy
- Verifica l'account: Abilita il service account
Risolvere i problemi relativi agli errori ERR_SSL_VERSION_OR_CIPHER_MISMATCH
Se il browser mostra l'errore ERR_SSL_VERSION_OR_CIPHER_MISMATCH senza
reindirizzare alla pagina di accesso, verifica lo stato dei certificati nella
Google Cloud pagina dei dettagli del bilanciatore del carico.
Tieni presente che il provisioning di un certificato gestito da Google potrebbe richiedere fino a 60 minuti.
Risolvere i problemi di installazione di Envoy
Se il connettore on-premise è stato sottoposto a deployment correttamente e il certificato è stato sottoposto a provisioning, ma la connessione continua a non riuscire, potrebbe significare che Envoy non è installato correttamente nelle VM.
Per verificare se Envoy è installato, accedi tramite SSH a una delle VM ed esegui il seguente comando:
Oltre aps aux | grep envoy
grep envoy, devono essere in esecuzione più processi. La porta di amministrazione di Envoy 127.0.0.1:15000 deve essere in ascolto.netstat -tlpn
Se una delle azioni precedenti non va a buon fine, esegui le seguenti azioni per mitigare il problema:
- Assicurati che l'accesso privato Google sia abilitato nella subnet in cui viene sottoposto a deployment il connettore.
- Assicurati che VM Manager (API OS Config) sia abilitato.
Risolvere i problemi relativi all'errore di deployment delle risorse IamMemberBinding
Se il connettore on-premise è in fase di deployment o aggiornamento e si verifica un
PERMISSION_DENIED errore correlato alle risorse IamMemberBinding, potrebbe essere
perché al service account Google APIs Service Agent non è stato concesso il ruolo
OWNER come richiesto quando
si abilita IAP per le app on-premise.
Esempi di errori di deployment:
bind-iam-policy: {"ResourceType":"gcp-types/cloudresourcemanager-v1:virtual.projects.iamMemberBinding","ResourceErrorCode":"403","ResourceErrorMessage":{"code":403,"message":"Policy update access denied.","status":"PERMISSION_DENIED","statusMessage":"Forbidden","requestPath":"https://cloudresourcemanager.googleapis.com/v1/projects/<project-ID>:setIamPolicy","httpMethod":"POST"}}
bind-storage-admin-account-iam-policy: {"ResourceType":"gcp-types/cloudresourcemanager-v1:virtual.projects.iamMemberBinding","ResourceErrorCode":"403","ResourceErrorMessage":{"code":403,"message":"Policy update access denied.","status":"PERMISSION_DENIED","statusMessage":"Forbidden","requestPath":"https://cloudresourcemanager.googleapis.com/v1/projects/<project-ID>:setIamPolicy","httpMethod":"POST"}}
Se visualizzi questi errori durante il deployment, verifica che al service account Google APIs Service Agent sia stato concesso il ruolo OWNER e riprova.