Como solucionar problemas na implantação flexível do App Engine
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
OpenAPI | gRPC
Neste documento, apresentamos as técnicas de solução de problemas para implantações do Cloud Endpoints nos ambientes flexíveis do App Engine. Se você receber um erro como resposta a uma solicitação enviada à API, consulte Como solucionar erros de respostas.
Erros de implantação
Nesta seção, descrevemos como solucionar erros de gcloud app deploy.
Mensagem de erro
Solução de problemas
Sua implantação não pôde tornar-se íntegra no tempo alocado e, portanto, foi revertida. Se você acredita que isso foi um erro, tente ajustar a configuração app_start_timeout_sec na seção readiness_check.
Verifique se seu arquivo app.yaml tem uma seção readiness_check com um valor para app_start_timeout_sec. Se ele não existir, adicione a seção e defina o valor de app_start_timeout_sec para um valor maior do que o padrão de 300 segundos.
Para mais informações, consulte verificações de prontidão.
Verifique se você ativou todos os serviços do Google Cloud que o Endpoints e o ESP exigem. Consulte Como verificar os serviços obrigatórios para mais detalhes.
Ao configurar app.yaml antes da implantação, adicione a seção endpoints_api_service. As configurações especificadas nesta seção precisam estar disponíveis para o Extensible Service Proxy (ESP) reconhecer a configuração de seu serviço. Especifique um ID de configuração no campo config_id ou inclua a opção rollout_strategy: managed, mas não realize as duas ações simultaneamente. Essa opção configura o ESP para usar a implantação mais recente da configuração do serviço. Quando você especifica essa opção, até 5 minutos depois de implantar uma nova configuração de serviço, o ESP detecta a alteração e começa a usá-la automaticamente. Recomendamos especificar essa opção em vez de um ID de configuração específico para uso do ESP.
Por exemplo:
Se a seção endpoints_api_service não incluir as informações que o ESP precisa para conseguir uma configuração de serviço, uma das seguintes mensagens será exibida:
Mensagem de erro
Solução de problemas
config_id é proibido quando rollout_strategy está definido como "managed"
Não é possível especificar um código de configuração e rollout_strategy: managed. A menos que você tenha um motivo para usar um código de configuração específico, recomendamos que remova config_id: [YOUR_CONFIG_ID] de app.yaml e reexecução gcloud app deploy.
config_id precisa ser especificado quando rollout_strategy não for especificado ou definido como "fixed"
Essa mensagem de erro é exibida quando app.yaml não inclui rollout_strategy: managed ou rollout_strategy está definido como fixed e você não especificou um código de configuração. A menos que você tenha um motivo para usar um código de configuração específico, recomendamos que adicione rollout_strategy: managed à seção endpoints_api_service de app.yaml e execute gcloud app deploy novamente.
Como exibir registros em uma instância
Os registros de falhas e do sistema do App Engine fornecem informações sobre o motivo de o aplicativo apresentar falha na inicialização ou desempenho diferente do esperado. Veja mais informações sobre depuração no registro do Endpoints.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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)"]]
