Risoluzione dei problemi di deployment in ambienti flessibili di App Engine
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
OpenAPI | gRPC
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.
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:
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.
Nella console Google Cloud , accedi tramite SSH alla macchina virtuale. Per saperne di più, vedi
Connettiti a un'istanza.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 UTC."],[[["\u003cp\u003eThis document provides troubleshooting guidance for Cloud Endpoints deployments in App Engine flexible environments, specifically addressing errors encountered during the \u003ccode\u003egcloud app deploy\u003c/code\u003e process.\u003c/p\u003e\n"],["\u003cp\u003eIf your deployment fails due to health checks, adjust the \u003ccode\u003eapp_start_timeout_sec\u003c/code\u003e setting in the \u003ccode\u003ereadiness_check\u003c/code\u003e section of your \u003ccode\u003eapp.yaml\u003c/code\u003e file, ensuring it's higher than the default of 300 seconds and ensuring all necessary Google Cloud services are enabled.\u003c/p\u003e\n"],["\u003cp\u003eWhen configuring \u003ccode\u003eapp.yaml\u003c/code\u003e, the \u003ccode\u003eendpoints_api_service\u003c/code\u003e section should include either \u003ccode\u003econfig_id\u003c/code\u003e or \u003ccode\u003erollout_strategy: managed\u003c/code\u003e, but not both, with \u003ccode\u003erollout_strategy: managed\u003c/code\u003e recommended for automatic service configuration updates.\u003c/p\u003e\n"],["\u003cp\u003eErrors related to \u003ccode\u003erollout_strategy\u003c/code\u003e indicate either an invalid combination of \u003ccode\u003econfig_id\u003c/code\u003e and \u003ccode\u003erollout_strategy\u003c/code\u003e settings or a missing \u003ccode\u003econfig_id\u003c/code\u003e when \u003ccode\u003erollout_strategy\u003c/code\u003e is not set to \u003ccode\u003emanaged\u003c/code\u003e, which is resolvable by modifying the \u003ccode\u003eapp.yaml\u003c/code\u003e file and redeploying.\u003c/p\u003e\n"],["\u003cp\u003eApp Engine logs, including crash, system and Endpoints logs, can be accessed via SSH to an instance to help pinpoint the source of issues, utilizing tools like tail to view log data.\u003c/p\u003e\n"]]],[],null,["# Troubleshooting App Engine flexible deployment\n\nOpenAPI \\| gRPC\n\n\u003cbr /\u003e\n\nThis document presents troubleshooting techniques for Cloud Endpoints\ndeployments in App Engine flexible environments. If you receive an\nerror back from a request to your API, see\n[Troubleshooting response errors](/endpoints/docs/openapi/troubleshoot-response-errors)\nfor information on troubleshooting the error.\n\nDeployment errors\n-----------------\n\nThis section describes how to troubleshoot errors from `gcloud app deploy`.\n\n### Error messages about `rollout_strategy`\n\nWhen you configure `app.yaml` before deploying, you must add the\n`endpoints_api_service` section. The Extensible Service Proxy (ESP) needs the\nsettings that you specify in this section to obtain the configuration for your\nservice. You must specify either a configuration ID in the `config_id` field, or\ninclude the `rollout_strategy: managed` option, but not both. This option\n\nconfigures ESP to use the latest deployed service configuration. When you\nspecify this option, up to 5 minutes after you deploy a new service\nconfiguration, ESP detects the change and automatically begins using it. We\nrecommend that you specify this option instead of a specific configuration ID\nfor ESP to use.\nFor example: \n\n endpoints_api_service:\n name: example-project-12345.appspot.com\n rollout_strategy: managed\n\nIf the `endpoints_api_service` section doesn't include the information that\nESP needs to obtain a service configuration, one of the following\nmessages is displayed:\n\nViewing logs on an instance\n---------------------------\n\nApp Engine crash and system logs provide information on why the\napplication failed to launch or perform as intended. You can find further\ndebugging information in the Endpoints log.\n\n1. In the Google Cloud console, SSH into your virtual machine. See\n [connecting to an instance](/appengine/docs/flexible/python/debugging-an-instance#connecting_to_the_instance)\n for more information.\n\n2. Use a text viewer such as `tail`:\n\n tail -f /var/log/nginx/error.log\n\nWhat's next\n-----------\n\n- [App Engine flexible environment logs](https://cloud.google.com/logging/docs/view/service/appengine-logs#appengine-vms)\n- [Viewing Logs](https://cloud.google.com/logging/docs/view/logs-explorer-interface)\n- [Using Cloud Logging in App Engine apps](https://cloud.google.com/appengine/articles/logging)"]]