Panoramica della risoluzione dei problemi

Questa pagina fornisce informazioni generali sulla risoluzione dei problemi e fornisce link ad altre pagine per maggiori 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 deployment della configurazione di Endpoints per informazioni sulla risoluzione dell'errore.

Errori durante il deployment del backend dell'API

Il deployment dell'API e di Extensible Service Proxy (ESP) in un backend di Google Cloud dipende dalla piattaforma. Per saperne di più, 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 Risolvere gli errori di risposta per informazioni sulla risoluzione dell'errore.

Controllo dei servizi richiesti in corso...

Controllo dei servizi richiesti in corso...

Come minimo, Endpoints ed ESP richiedono che siano abilitati i seguenti servizi Google:
Nome Titolo
servicemanagement.googleapis.com API Service Management
servicecontrol.googleapis.com API Service Control
endpoints.googleapis.com Google Cloud Endpoints

Nella maggior parte dei casi, il comando gcloud endpoints services deploy abilita questi servizi richiesti. Tuttavia, il comando gcloud viene completato correttamente, ma non abilita 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 disabilitati esplicitamente.

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

gcloud services list

Se i servizi richiesti non sono elencati, attivali:

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

Abilita anche il servizio Endpoints:

gcloud services enable ENDPOINTS_SERVICE_NAME

Per determinare i ENDPOINTS_SERVICE_NAME puoi:

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

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

Per ulteriori informazioni sui comandi gcloud, consulta la pagina relativa ai servizi gcloud.

Controllo delle autorizzazioni richieste in corso...

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

Controllo delle informazioni di debug

L'esecuzione di Google Cloud CLI con informazioni di debug semplifica il debug.

gcloud --verbosity=debug COMMAND

Questo comando consente a Google Cloud CLI di stampare un log dettagliato dell'errore. A seconda del comando da eseguire, l'output può includere informazioni di richiesta e risposta del server.

Attivazione di un servizio

Puoi verificare se un servizio è abilitato utilizzando gcloud.

gcloud services list

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

gcloud endpoints services describe SERVICE_NAME

L'autenticazione OAuth del proxy non va a buon fine ma le richieste sono state superate

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

Passaggi successivi