Resolver problemas do App Engine

Deployment

Se você tiver problemas ao implantar seu aplicativo usando a API Admin do App Engine, esta página listará as mensagens de erro que podem aparecer e fornece sugestões sobre como corrigir cada erro.

O autor da chamada não tem permissão para acessar o projeto

O seguinte erro ocorre ao implantar o app:

User EMAIL_ADDRESS does not have permission to access project PROJECT_ID (or it may not exist): The caller does not have permission

Esse erro ocorrerá se a conta usada para implantar o app não tiver permissão para implantar apps no projeto atual.

Para resolver esse problema, conceda o papel de Implantador do App Engine (roles/appengine.deployer) à conta. Para ver qual conta você usou para implantar, siga um destes procedimentos:

  • Se você usou a ferramenta de linha de comando gcloud para implantar, execute o comando gcloud auth list.
  • Se você implantou em um ambiente de desenvolvimento integrado, veja as configurações do plug-in do Cloud Tools.

Falha ao buscar metadados pelo registro

O seguinte erro ocorre ao implantar o app:

Failed to fetch metadata from the registry, with reason: generic::permission_denied

Esse erro ocorrerá se você usar o comando gcloud app deploy de uma conta de serviço que não tem o papel Administrador do Storage (roles/storage.admin).

Para resolver esse problema, conceda o papel Administrador do Storage à conta de serviço:

  • Para ver qual conta você usou, execute o comando gcloud auth list.
  • Para saber por que apenas atribuir o papel de Implantador do App Engine (roles/appengine.deployer) pode não ser suficiente em alguns casos, consulte os Papéis do App Engine.

As contas de serviço precisam ter permissões na imagem.

O seguinte erro ocorre ao implantar o app:

The App Engine appspot and App Engine flexible environment service accounts must have permissions on the image IMAGE_NAME

Esse erro ocorre por um dos seguintes motivos:

Falha ao criar o Cloud Build

O seguinte erro ocorre ao implantar o app:

Failed to create cloud build: Permission denied

Esse erro ocorrerá se você usar o comando gcloud app deploy de uma conta que não tem o papel Editor do Cloud Build (roles/cloudbuild.builds.editor).

Para resolver esse problema, conceda o papel Editor do Cloud Build à conta de serviço que você está usando para implantar seu app.

Para ver qual conta você usou, execute o comando gcloud auth list.

Ocorreu um erro de permissão ao buscar o aplicativo

O seguinte erro ocorre ao implantar o app:

Permissions error fetching application apps/app_name. Please make sure you are using the correct project ID and that you have permission to view applications on the project

Se você estiver executando a versão 328 ou outra mais recente do SDK do Cloud, o seguinte erro ocorrerá quando seu aplicativo for implantado:

Permissions error fetching application apps/app_name. Please
make sure that you have permission to view applications on the project and that
SERVICE_ACCOUNT has the App Engine Deployer (roles/appengine.deployer) role.

Esse erro ocorrerá se a conta que você usou para implantar o app não tiver o papel de Implantador do App Engine (roles/appengine.deployer).

Para resolver esse problema, verifique se você concedeu o papel de Implantador do App Engine à conta de serviço usada para implantar o app. Conceda o papel caso ela não tenha a conta de serviço. Para ver qual conta você usou para implantar, siga um destes procedimentos:

  • Se você usou a ferramenta de linha de comando gcloud para implantar, execute o comando gcloud auth list.
  • Se você implantou em um ambiente de desenvolvimento integrado, veja as configurações do plug-in do Cloud Tools.

Tempo limite excedido para a infraestrutura do app se tornar íntegra

O seguinte erro ocorre ao implantar o app:

Timed out waiting for the app infrastructure to become healthy

Vários fatores podem causar esse erro, como permissões ausentes, erros de código, CPU ou memória insuficiente ou verificações de integridade com falha. O erro só ocorre no ambiente flexível do App Engine.

Para resolver esse problema, elimine as seguintes causas possíveis:

  1. Verifique se você concedeu o papel Editor (roles/editor) à conta de serviço padrão do App Engine.

  2. Verifique se a política da organização do seu projeto restringe o acesso a endereços IP externos. Para mais informações, consulte Problemas conhecidos do ambiente flexível do App Engine.

  3. Verifique se você concedeu os seguintes papéis à conta de serviço usada para executar o aplicativo (geralmente a conta de serviço padrão, app-id@appspot.gserviceaccount.com):

  4. Conceda os papéis caso a conta de serviço não os tenha.

  5. Se você estiver implantando na configuração da VPC compartilhada e transmitir instance_tag em app.yaml, consulte esta seção para corrigir o problema.

Erro de permissões ao implantar um serviço com o conector VPC sem servidor

O seguinte erro ocorre ao implantar o app:

Please ensure you have [compute.globalOperations.get] on the service project

Esse erro ocorre quando o usuário ou a conta de serviço que está tentando implantar o aplicativo com o conector de VPC sem servidor não tem as permissões necessárias.

Para resolver esse problema, verifique se o usuário ou a conta de serviço que faz a implantação tem os papéis Usuário de acesso VPC sem servidor e IAM do visualizador do Compute.

Erro de valor inválido ao implantar em uma configuração de VPC compartilhada

O seguinte erro é exibido no Cloud Logging para instâncias de VM do Flex quando você implanta o aplicativo:

Invalid value for field 'resource.tags.items[1]': 'aef-instance'. Duplicate
tags are not allowed: aef-instance on compute.instances.insert

Esse erro ocorre devido a um problema atual em que a configuração de instance_tag resulta em erros durante a criação de instâncias.

Para resolver o problema, remova o campo instance_tag de app.yaml e reimplante.

Permissão 'compute.firewalls.list' obrigatória

O seguinte erro ocorre quando você implanta o aplicativo em uma rede VPC compartilhada:

Request to https://compute.googleapis.com/compute/v1/projects/projects/PROJECT_ID/global/firewalls?key failed, details: Required 'compute.firewalls.list' permission for 'projects/PROJECT_ID'

Este erro ocorrerá se as seguintes contas de serviço para o projeto host não tiverem o papel Usuário da rede do Compute (roles/compute.networkUser):

Para resolver esse problema, verifique se você concedeu o papel de usuário da rede do Compute às contas de serviço do agente de serviço de APIs do Google e de agente de ambiente do App Engine para o projeto host. Conceda o papel se as contas de serviço não tiverem esse papel.

O build durante a implantação falha sem erros nos registros do build

O seguinte erro ocorre ao implantar o aplicativo:

ERROR: (gcloud.app.deploy) Cloud build failed. Check logs at https://console.cloud.google.com/cloud-build/builds/BUILD_ID?project=PROJECT_NUMBER Failure status: UNKNOWN: Error Response: [2] Build failed; check build logs for details

Seguir o link na mensagem de erro mostra que todas as etapas da criação foram bem-sucedidas. No entanto, não foi possível criar o aplicativo.

Esse problema ocorre se você estiver usando chaves de criptografia gerenciadas pelo cliente (CMEK, na sigla em inglês) ou tiver configurado uma política de retenção de dados para seu bucket staging.PROJECT_ID.appspot.com.

Para resolver esse problema, altere as seguintes configurações do bucket staging.PROJECT_ID.appspot.com:

Disponibilização

O Nginx falha ao se conectar ou entrar em contato com o contêiner do aplicativo

O seguinte erro ocorre apenas no ambiente flexível do App Engine e normalmente retorna com erros 502 imediatamente após o erro:

recv() failed (104: Connection reset by peer) while reading response header from upstream

Esse erro indica que o proxy reverso nginx (arquivo secundário nginx) não consegue acessar o contêiner do app. Nos registros, é possível comparar o tempo de fechamento do erro 502 no registro nginx com o tempo do registro nginx.error. Um nginx.error seguido imediatamente por um erro nginx 502 é provavelmente a causa do erro nginx 502.

Para resolver problemas, verifique os registros gravados pelo código em execução no contêiner do aplicativo. Para isso, conecte-se à instância de VM e adicione mais registros, se necessário, para encontrar a causa principal.