Panoramica della risoluzione dei problemi

Questa pagina fornisce informazioni generali per la risoluzione dei problemi e link ad altre pagine per ulteriori informazioni.

Errori durante il deployment della configurazione di Cloud Endpoints

Se hai ricevuto un messaggio di errore dal comando gcloud endpoints services deploy, consulta Risoluzione dei problemi di implementazione della configurazione degli endpoint per informazioni sulla risoluzione dell'errore.

Errori durante il deployment del backend dell'API

Il deployment dell'API e dell'Extensible Service Proxy (ESP) in un backend Google Cloud dipende dalla piattaforma. Per ulteriori informazioni, consulta le seguenti guide alla risoluzione dei problemi:

Errori di risposta

Quando invii una richiesta all'API e ricevi una risposta di errore, consulta la sezione Risoluzione dei problemi relativi alle risposte di errore per informazioni su come risolvere il problema.

Verifica dei servizi richiesti

Verifica dei servizi richiesti

Come minimo, Endpoints ed ESP richiedono l'attivazione dei seguenti servizi Google:
Nome Titolo
servicemanagement.googleapis.com API Service Management
servicecontrol.googleapis.com API Service Control

Nella maggior parte dei casi, il comando gcloud endpoints services deploy attiva questi servizi obbligatori. Tuttavia, il comando gcloud viene completato correttamente, ma non attiva i servizi richiesti nelle seguenti circostanze:

  • Se hai utilizzato un'applicazione di terze parti come Terraform e non includi questi servizi.

  • Hai eseguito il deployment della configurazione di Endpoints in un progetto Google Cloud esistente in cui questi servizi sono stati disattivati esplicitamente.

Utilizza il seguente comando per verificare che i servizi richiesti siano abilitati:

gcloud services list

Se non vedi i servizi richiesti nell'elenco, attivali:

gcloud services enable servicemanagement.googleapis.com
gcloud services enable servicecontrol.googleapis.com

Abilita anche il servizio Endpoints:

gcloud services enable ENDPOINTS_SERVICE_NAME

Per determinare ENDPOINTS_SERVICE_NAME, puoi:

  • Dopo aver eseguito il deployment della configurazione di Endpoints, vai alla pagina Endpoints nella console Cloud. L'elenco dei possibili ENDPOINTS_SERVICE_NAME è riportato nella colonna Nome servizio.

  • Per OpenAPI, ENDPOINTS_SERVICE_NAME è il valore specificato nel campo host della specifica OpenAPI. Per gRPC, ENDPOINTS_SERVICE_NAME è il valore specificato nel campo name della configurazione degli endpoint gRPC.

Per ulteriori informazioni sui comandi gcloud, consulta Servizi gcloud.

Controllo delle autorizzazioni richieste

L'istanza che esegue Extensible Service Proxy richiede le autorizzazioni per chiamare Service Management e ServiceControl.

Controllare le informazioni di debug

L'esecuzione di Google Cloud CLI con la modalità di verbosità di debug è utile per il debugging.

gcloud --verbosity=debug COMMAND

Questo comando consente a Google Cloud CLI di stampare un log dettagliato dell'errore. A seconda del comando in esecuzione, l'output può includere informazioni sulle richieste e sulle risposte del server.

Attivazione di un servizio

Puoi verificare se un servizio è attivo utilizzando gcloud.

gcloud services list

Per visualizzare la configurazione di un determinato servizio, utilizza il seguente comando:

gcloud endpoints services describe SERVICE_NAME

OAuth proxy non riesce, ma le richieste vengono accettate

Assicurati che nel file di configurazione dell'API gRPC sia presente una sezione authentication con la definizione di OAuth. Un file di configurazione di esempio è disponibile nell'esempio di libreria su GitHub.

Passaggi successivi