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 deployment della configurazione di Endpoints
per informazioni sulla risoluzione dell'errore.
Errori durante il deployment del backend API
Il deployment dell'API e di Extensible Service Proxy (ESP) in un backendGoogle Cloud dipende dalla piattaforma. Per ulteriori informazioni, consulta le seguenti guide alla risoluzione dei problemi:
Errori di risposta
Quando invii una richiesta alla tua API e ricevi una risposta di errore, consulta la sezione Risoluzione dei problemi relativi agli errori di risposta per informazioni sulla risoluzione del problema.
Controllo dei servizi richiesti
Controllo dei servizi richiesti
Come minimo, Endpoints ed ESP richiedono l'abilitazione 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 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 progettoGoogle Cloud esistente in cui questi servizi sono stati disattivati esplicitamente.
Utilizza questo comando per verificare che i servizi richiesti siano abilitati:
gcloud services list
Se non vedi i servizi richiesti elencati, attivali:
gcloud services enable servicemanagement.googleapis.com
gcloud services enable servicecontrol.googleapis.comAbilita anche il servizio Endpoints:
gcloud services enable ENDPOINTS_SERVICE_NAME
Per determinare il 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 viene visualizzato nella colonna Nome servizio.
Per OpenAPI, ENDPOINTS_SERVICE_NAME è ciò che hai specificato nel campo
hostdella specifica OpenAPI. Per gRPC, ENDPOINTS_SERVICE_NAME è ciò che hai specificato nel camponamedella configurazione di gRPC Endpoints.
Per saperne di più 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.
Per ESP di cui è stato eseguito il deployment su Cloud Run, consulta Creazione di una nuova immagine ESPv2 nel tutorial di Cloud Run per i dettagli.
Per ESP di cui è stato eseguito il deployment su Compute Engine, consulta Verifica delle autorizzazioni richieste nell'esercitazione di Compute Engine per maggiori dettagli.
Per ESP di cui è stato eseguito il deployment su GKE, consulta Verifica delle autorizzazioni richieste nel tutorial GKE per i dettagli.
Controllare le informazioni di debug
L'esecuzione di Google Cloud CLI con il livello di verbosità di debug aiuta a eseguire il debug.
gcloud --verbosity=debug COMMAND
Questo comando fa in modo che Google Cloud CLI stampi un log dettagliato dell'errore. A seconda del comando in esecuzione, l'output può includere informazioni sulla richiesta e sulla risposta del server.
Attivazione di un servizio
Puoi verificare se un servizio è abilitato 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 approvate
Assicurati che nel file di configurazione dell'API gRPC sia presente una sezione authentication con la definizione OAuth. Un file di configurazione di esempio è disponibile nell'esempio Bookstore su GitHub.