Testar e implantar um aplicativo

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

Como executar localmente

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

Implantar o aplicativo

Implantar a aplicação no App Engine usando o comandogcloud app deploy. Ele cria automaticamente uma imagem do contêiner usando o serviço Cloud Build e a implanta no ambiente flexível do App Engine. O contêiner inclui quaisquer modificações locais realizadas na imagem do ambiente de execução.

Para implantar os aplicativos de maneira programática, use a API Admin.

Antes de começar

Antes de implantar seu aplicativo:

Como implantar um serviço

O aplicativo é implantado no App Engine quando você implanta as versões dos serviços dele e os respectivos arquivos de configuração.

Para implantar uma versão do serviço do seu aplicativo, execute o seguinte comando:

gcloud app deploy .\bin\Debug\netcoreapp2.1\publish\app.yaml

Por padrão, o comando deploy gera automaticamente um novo código da versão cada vez que você o utiliza e faz o roteamento do tráfego para a nova versão.

Para modificar esse comportamento, especifique o código da versão com a sinalização version:

gcloud app deploy .\bin\Debug\netcoreapp2.1\publish\app.yaml --version myID

Para especificar que o tráfego não deverá ser enviado para a nova versão imediatamente, basta usa a sinalização --no-promote:

gcloud app deploy .\bin\Debug\netcoreapp2.1\publish\app.yaml --no-promote

Como ignorar arquivos

É possível usar um arquivo .gcloudignore para especificar os arquivos e diretórios que não serão enviados ao GCP na implantação dos 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 .\bin\Debug\netcoreapp2.1\publish\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 saber mais informações, consulte Como implantar artefatos e Como automatizar versões com acionadores de versão na documentação do Cloud Build.

Imagens de base do Docker para .NET

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

Ambiente de execução Comando do Docker
.NET FROM gcr.io/google-appengine/aspnetcore:1.0.11
.NET FROM gcr.io/google-appengine/aspnetcore:1.1.8
.NET FROM gcr.io/google-appengine/aspnetcore:2.0.7
.NET FROM gcr.io/google-appengine/aspnetcore:2.1.0

Ver o aplicativo

Após a implantação do aplicativo no App Engine, execute o comando abaixo para iniciar o navegador e visualizá-lo em http://YOUR_PROJECT_ID.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 e inclua a sinalização --no-promote:

    gcloud app deploy .\bin\Debug\netcoreapp2.1\publish\app.yaml --no-promote
  2. Acesse a nova versão no URL a seguir:

    http://VERSION_ID.default.YOUR_PROJECT_ID.appspot.com
    

    Agora é possível testar sua nova versão no ambiente de execução do App Engine. É possível depurar seu aplicativo visualizando os registros no Visualizador de registros do Stackdriver, no Console do Google Cloud Platform. Para saber mais informações, consulte Como gravar registros de aplicativos.

    As solicitações enviadas a http://YOUR_PROJECT_ID.appspot.com serão encaminhadas para a versão configurada anteriormente para receber tráfego.

  3. Quando quiser enviar tráfego para a nova versão, use o Console do GCP:

    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:

http://VERSION_ID.SERVICE_ID.YOUR_PROJECT_ID.appspot.com
Para saber mais informações sobre como apontar serviços e versões específicos, consulte Como as solicitações são encaminhadas.

Solução de problemas

Esta é uma mensagem de erro comum que você pode encontrar ao implantar apps:

PERMISSION_DENIED: Operation not allowed
The "appengine.applications.create" permission is required.
Caso o aplicativo obrigatório do App Engine não esteja incluído no projeto do GCP, o comando gcloud app deploy falhará ao tentar executar o comando gcloud app create. Somente contas com o papel de proprietário têm as permissões necessárias para criar aplicativos do App Engine.
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Ambiente flexível do App Engine para documentos .NET