Risoluzione dei problemi di deployment in ambienti flessibili di App Engine

Questo documento presenta tecniche di risoluzione dei problemi per i deployment di Cloud Endpoints negli ambienti flessibili di App Engine. Se ricevi un errore da una richiesta alla tua API, consulta Risoluzione dei problemi relativi agli errori di risposta per informazioni sulla risoluzione del problema.

Errori di deployment

Questa sezione descrive come risolvere gli errori di gcloud app deploy.

Messaggio di errore Risoluzione dei problemi
Il deployment non è riuscito a raggiungere lo stato integro nel tempo assegnato e pertanto è stato eseguito il rollback. Se ritieni che si tratti di un errore, prova a modificare l'impostazione app_start_timeout_sec nella sezione readiness_check.

Verifica che il file app.yaml abbia una sezione readiness_check con un valore per app_start_timeout_sec. Se non esiste, aggiungi la sezione e imposta il valore di app_start_timeout_sec su un valore superiore a quello predefinito di 300 secondi. Per saperne di più, consulta la sezione Controlli di idoneità.

Assicurati di abilitare tutti i servizi Google Cloud richiesti da Endpoints e ESP. Per i dettagli, consulta Controllo dei servizi richiesti.

Assicurati che il VPC associato alla tua app flessibile App Engine abbia una route statica locale con la destinazione 0.0.0.0/0 e l'hop successivo del gateway internet predefinito. Se utilizzi servizi privati solo interni, assicurati che l'accesso privato Google sia abilitato nella subnet selezionata.

Messaggi di errore relativi a rollout_strategy

Quando configuri app.yaml prima del deployment, devi aggiungere la sezione endpoints_api_service. Extensible Service Proxy (ESP) ha bisogno delle impostazioni specificate in questa sezione per ottenere la configurazione del tuo servizio. Devi specificare un ID configurazione nel campo config_id o includere l'opzione rollout_strategy: managed, ma non entrambi. Questa opzione configura ESP in modo che utilizzi la configurazione del servizio di cui è stato eseguito il deployment più recente. Quando specifichi questa opzione, fino a 5 minuti dopo il deployment di una nuova configurazione del servizio, ESP rileva la modifica e inizia a utilizzarla automaticamente. Ti consigliamo di specificare questa opzione anziché un ID configurazione specifico da utilizzare per ESP. Ad esempio:

endpoints_api_service:
  name: example-project-12345.appspot.com
  rollout_strategy: managed

Se la sezione endpoints_api_service non include le informazioni necessarie all'ESP per ottenere una configurazione del servizio, viene visualizzato uno dei seguenti messaggi:

Messaggio di errore Risoluzione dei problemi
config_id è vietato quando rollout_strategy è impostato su "managed" Non puoi specificare sia un ID configurazione sia rollout_strategy: managed. A meno che tu non abbia un motivo per utilizzare un ID configurazione specifico, ti consigliamo di rimuovere config_id: [YOUR_CONFIG_ID] da app.yaml ed eseguire di nuovo gcloud app deploy.
config_id deve essere specificato quando rollout_strategy non è specificato o è impostato su "fixed" Questo messaggio di errore viene visualizzato quando app.yaml non include rollout_strategy: managed o rollout_strategy è impostato su fixed e non hai specificato un ID configurazione. A meno che tu non abbia un motivo per utilizzare un ID configurazione specifico, ti consigliamo di aggiungere rollout_strategy: managed alla sezione endpoints_api_service di app.yaml ed eseguire di nuovo gcloud app deploy.

Visualizzazione dei log su un'istanza

I log degli arresti anomali e di sistema di App Engine forniscono informazioni sul motivo per cui l'applicazione non è stata avviata o non ha funzionato come previsto. Puoi trovare ulteriori informazioni sul debug nel log di Endpoints.

  1. Nella console Google Cloud , accedi tramite SSH alla macchina virtuale. Per saperne di più, vedi Connettiti a un'istanza.

  2. Utilizza un visualizzatore di testo come tail:

     tail -f /var/log/nginx/error.log

Passaggi successivi