Como solucionar problemas na implantação flexível do App Engine

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 todos os serviços do Google Cloud que o Endpoints e o ESP exigem estão ativados no seu projeto. Consulte Como verificar os serviços obrigatórios para detalhes.

Mensagens de erro sobre rollout_strategy

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:

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

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.

  1. No console do Google Cloud, conecte-se via SSH à sua máquina virtual. Veja Como se conectar a uma instância para mais informações.

  2. Use um visualizador de texto como tail:

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

A seguir