Résoudre des problèmes de déploiement dans l'environnement flexible App Engine
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
OpenAPI | gRPC
Ce document présente des techniques de dépannage relatives aux déploiements de Cloud Endpoints dans l'environnement flexible App Engine. Si vous recevez un message d'erreur en réponse à une requête adressée à votre API, reportez-vous à la section Dépanner des erreurs de réponse pour obtenir plus d'informations sur la résolution de l'erreur.
Erreurs de déploiement
Cette section explique comment résoudre les erreurs de gcloud app deploy.
Message d'erreur
Dépannage
Votre déploiement n'a pas pu être opérationnel dans le temps imparti et a donc été annulé. Si vous pensez qu'il s'agit d'une erreur, essayez de régler le paramètre app_start_timeout_sec dans la section readiness_check.
Vérifiez que votre fichier app.yaml dispose d'une section readiness_check avec une valeur pour app_start_timeout_sec. Si ce n'est pas le cas, ajoutez la section et définissez la valeur de app_start_timeout_sec sur une valeur supérieure à la valeur par défaut de 300 secondes.
Pour plus d'informations, consultez la page Vérifications de préparation.
Assurez-vous d'activer tous les services Google Cloud requis par Endpoints et ESP. Pour en savoir plus, consultez Vérifier les services requis.
Lorsque vous configurez app.yaml avant le déploiement, vous devez ajouter la section endpoints_api_service. Le proxy Extensible Service Proxy (ESP) a besoin des paramètres que vous avez spécifiés dans cette section pour obtenir la configuration définie pour votre service. Vous devez spécifier un ID de configuration dans le champ config_id ou inclure l'option rollout_strategy: managed, mais pas les deux. Cette option permet de configurer ESP pour qu'il utilise la dernière configuration de service déployée. Si cette option est spécifiée, jusqu'à 5 minutes après le déploiement d'une nouvelle configuration de service, ESP détecte la modification et commence à l'utiliser automatiquement. Nous vous recommandons de spécifier cette option plutôt qu'un ID de configuration spécifique à utiliser par ESP.
Exemple :
Si la section endpoints_api_service n'inclut pas les informations dont ESP a besoin pour obtenir une configuration de service, l'un des messages suivants s'affiche :
Message d'erreur
Dépannage
config_id est interdit lorsque rollout_strategy est défini sur "managed"
Vous ne pouvez pas à la fois spécifier un ID de configuration et inclure l'option rollout_strategy: managed. À moins que vous n'ayez une raison particulière d'utiliser un ID de configuration spécifique, nous vous recommandons de supprimer la ligne config_id: [YOUR_CONFIG_ID] du fichier app.yaml et d'exécuter à nouveau gcloud app deploy.
config_id doit être spécifié lorsque rollout_strategy n'est pas spécifié ou est défini à la valeur "fixed"
Ce message d'erreur s'affiche lorsque app.yaml ne comporte pas l'option rollout_strategy: managed ou que rollout_strategy est défini sur fixed et que vous n'avez pas indiqué d'ID de configuration. À moins que vous n'ayez une raison particulière d'utiliser un ID de configuration spécifique, nous vous recommandons d'ajouter la ligne rollout_strategy: managed à la section endpoints_api_service du fichier app.yaml, puis d'exécuter à nouveau gcloud app deploy.
Afficher les journaux sur une instance
Les plantages et les journaux système d'App Engine fournissent des informations sur les raisons pour lesquelles l'application n'a pas pu être lancée ou n'a pas fonctionné correctement. Vous pouvez trouver d'autres informations de débogage dans le journal de Endpoints.
Dans la console Google Cloud , connectez-vous en SSH à votre machine virtuelle. Pour en savoir plus, consultez Se connecter à une instance.
Utilisez une visionneuse de texte telle que tail :
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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)"]]
