Testar e implantar um aplicativo

ID da região

O REGION_ID é um código abreviado que o Google atribui com base na região que você selecionou ao criar o aplicativo. O código não corresponde a um país ou estado, ainda que alguns IDs de região sejam semelhantes aos códigos de país e estado geralmente usados. A inclusão de REGION_ID.r em URLs do App Engine é opcional para aplicativos atuais. Em breve, será necessária para todos os aplicativos novos.

Para garantir uma transição tranquila, estamos atualizando o App Engine gradativamente para usar IDs de região. Se ainda não tivermos atualizado seu projeto do Google Cloud, você não verá um ID da região para o app. Como o ID é opcional para os apps atuais, não é necessário atualizar os URLs ou fazer outras alterações quando o ID da região está disponível para eles.

Saiba mais sobre IDs de região.

Saiba como executar seu aplicativo localmente, implantá-lo e testá-lo no App Engine.

Como executar localmente

Para testar a funcionalidade do seu aplicativo antes de implantá-lo, execute-o no ambiente local com as ferramentas de desenvolvimento que você costuma usar.

Para mais detalhes, inclusive sobre comandos específicos que dependem do plug-in, consulte Testes locais para o ambiente de execução Java 8/Jetty 9 ou Testes locais para o ambiente de execução Java 8.

Como implantar o aplicativo

Antes de começar

Antes de implantar o aplicativo:

Implantar um serviço

Use qualquer uma das ferramentas compatíveis para implantar seu aplicativo Java no ambiente flexível do App Engine. Para a implantação da linha de comando, use gcloud app deploy do SDK do Cloud ou use os plug-ins do Maven ou do Gradle. Para implantar utilizando um ambiente de desenvolvimento integrado, use os plug-ins do IntelliJ ou do Eclipse. Para implantar os aplicativos de maneira programática, use a API Admin.

Como ignorar arquivos

É possível usar um arquivo .gcloudignore para especificar arquivos e diretórios que não serão enviados ao Google Cloud ao implantar seus serviços. Isso é útil para ignorar artefatos de versão e outros que não precisam ser enviados com a implantação.

Saiba mais sobre a sintaxe do arquivo .gcloudignore na referência do gcloud (em inglês).

Como criar manualmente um contêiner para implantação

Para criar imagens de contêiner fora do Google Cloud Platform, faça upload das imagens para um repositório de imagens de contêiner antes de implantá-las no App Engine com o comando gcloud app deploy.

Por exemplo, ao criar localmente imagens de contêiner com o Docker, envie-as para o Google Container Registry e especifique o URL correspondente na sinalização --image-url do comando:

gcloud app deploy src/main/appengine/app.yaml --image-url gcr.io/YOUR_PROJECT_ID/YOUR_CONTAINER_IMAGE

Como usar canais de implantação contínua automatizada

Use o Cloud Build para automatizar implantações em pipelines de implantação contínua. Para mais informações, consulte Como implantar artefatos e Como automatizar versões com acionadores de versão na documentação do Cloud Build.

Imagens base do Docker para Java

Se você quiser criar do zero um aplicativo Java de ambiente de execução personalizado, use esta imagem de base em um Dockerfile:

Ambiente de execução Comando do Docker
Java 8 FROM gcr.io/google_appengine/openjdk
Java 8/Jetty 9 FROM gcr.io/google-appengine/jetty

Como visualizar o aplicativo

Depois de implantar o aplicativo no App Engine, execute o comando a seguir para iniciar o navegador e visualizá-lo em https://PROJECT_ID.REGION_ID.r.appspot.com:

gcloud app browse

Como fazer testes no App Engine

Antes de configurar uma nova versão para receber tráfego, teste-a no App Engine. Por exemplo, para testar uma nova versão do seu serviço default, siga estas etapas:

  1. Implante sua nova versão com o parâmetro promote definido como false:

  2. Acesse a nova versão no URL a seguir:

    https://VERSION_ID-dot-default-dot-PROJECT_ID.REGION_ID.r.appspot.com

    Agora você pode testar sua nova versão no ambiente de execução do App Engine. Depure o aplicativo visualizando os registros no Visualizador de registros do Console do Google Cloud. Para saber mais informações, consulte Como gravar registros de aplicativos.

    As solicitações enviadas para https://PROJECT_ID.REGION_ID.r.appspot.com ainda serão encaminhadas para a versão configurada anteriormente para receber tráfego.

  3. Quando você quiser enviar tráfego para a nova versão, use o Console do Cloud para migrá-lo:

    Gerenciar versões

    Selecione a versão que você acabou de implantar e clique em Migrar tráfego.

Use o mesmo processo para testar novas versões de outros serviços substituindo default no URL pelo nome do serviço:

Para mais informações sobre como apontar serviços e versões específicos, consulte Como as solicitações são roteadas.

Resolver problemas

Veja mensagens de erro comuns que você talvez encontre ao implantar aplicativos:

PERMISSION_DENIED: Operation not allowed
The "appengine.applications.create" permission is required.
Se o projeto do Cloud não incluir o aplicativo necessário do App Engine, o comando gcloud app deploy pode falhar ao tentar executar o comando gcloud app create. Somente contas com o papel Proprietário têm as permissões necessárias para criar aplicativos do App Engine.
502 Bad Gateway
O projeto do Cloud poderá falhar ao iniciar se o app.yaml estiver configurado incorretamente. Verifique os registros do aplicativo para ver mensagens de erro mais detalhadas.