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 per informazioni sulla risoluzione dell'errore.
Verifica dei servizi richiesti
Verifica 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 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.comAbilita 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
hostdella specifica OpenAPI. Per gRPC, ENDPOINTS_SERVICE_NAME è il valore specificato nel camponamedella 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.
Per ESP di cui è stato eseguito il deployment su Cloud Run, consulta il tutorial sulla creazione di una nuova immagine ESPv2 in Cloud Run per maggiori dettagli.
Per ESP di cui è stato eseguito il deployment su Compute Engine, consulta il tutorial Verifica delle autorizzazioni richieste in Compute Engine per maggiori dettagli.
Per ESP di cui è stato eseguito il deployment su GKE, consulta il tutorial Verifica delle autorizzazioni richieste in GKE per maggiori dettagli.
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.