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.comgcloud 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 camponame
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.
Per i dettagli di ESP di cui è stato eseguito il deployment in Cloud Run, consulta il tutorial Creazione di una nuova immagine ESPv2 in Cloud Run.
Per ESP di cui è stato eseguito il deployment su Compute Engine, consulta il tutorial sul controllo delle autorizzazioni richieste in Compute Engine per maggiori dettagli.
Per ESP di cui è stato eseguito il deployment su GKE, consulta il tutorial per controllare le autorizzazioni richieste in GKE.
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.