Como implantar no ambiente flexível do App Engine

Neste documento, você aprenderá a implantar um aplicativo do App Engine no ambiente flexível do App Engine no IntelliJ IDEA.

Antes de começar

  • Siga o guia Criar um aplicativo para instalar e configurar o Cloud Code, bem como criar um aplicativo do App Engine para o ambiente flexível. Não deixe de adicionar o suporte ao framework flexível do App Engine.

    Caso você não tenha um aplicativo, mas queira testar estes procedimentos de implantação, faça o download do aplicativo de amostra:

    1. Clone o aplicativo de amostra Spring Boot em sua máquina local:

       git clone https://github.com/spring-guides/gs-spring-boot
      
    2. No IntelliJ, escolha File > Open para abrir o seletor de arquivos.

    3. Acesse /gs-spring-boot/.

    4. Selecione o diretório /complete/.

    5. Clique em OK.

    6. Adicione o suporte à biblioteca flexível do App Engine.

Como criar a configuração de implantação

  1. Escolha Ferramentas > Cloud Code > App Engine > Implantar no App Engine.

    A caixa de diálogo criar configuração de implantação. Há campos para Nome, Servidor, Implantação, Projeto, Versão e app.yaml.

  2. Confirme a configuração do servidor:

    1. Clique nas reticências (…) ao lado do campo Servidor.

    2. Na caixa de diálogo, verifique se o campo Nome exibe Google App Engine.

    3. Clique em OK.

  3. Selecione a origem da Implantação.

    O Cloud Code para IntelliJ é compatível com a implantação de um artefato Maven, um artefato específico do IntelliJ ou um arquivo JAR ou WAR do sistema de arquivos.

    1. Se você selecionar um arquivo JAR ou WAR do sistema de arquivos como origem de implantação, clique nas reticências (...) ao lado do campo Arquivo de implantação para navegar até ele.
  4. Selecione um projeto no campo Projeto.

    Na primeira configuração da implantação, será solicitado fazer login na conta associada ao projeto do Console do Cloud que você quer implantar.

  5. Na seção Configuração flexível do App Engine, selecione um arquivo app.yaml válido.

    1. Se não houver um arquivo app.yaml válido no menu suspenso, clique em Editar para selecionar um arquivo. Consulte a seção Atualizar as configurações flexíveis do App Engine para obter mais informações.
  6. Preencha outros campos conforme necessário para configurar a implantação.

  7. Clique em Executar para compilar e implantar seu aplicativo.

  8. Na janela "Servidores de aplicativo", clique no nome do seu projeto para monitorar o progresso da implantação. Se a janela não for exibida, clique em View > Tool Windows > Application Servers.

    Após a conclusão da implantação, será possível ver o URL do seu aplicativo na saída do console.

Como implantar em um ambiente de execução personalizado

É possível modificar o arquivo app.yaml para implantar o aplicativo em um ambiente de execução personalizado usando um arquivo do Docker.

  1. No arquivo app.yaml, defina o ambiente de execução como personalizado.

  2. Ao concluir as etapas de criação da configuração de implantação, a seção Configuração flexível do App Engine exibirá o caminho para o arquivo do Docker e app.yaml.

    Caixa de diálogo que mostra a seção de configuração flexível do App Engine da tela criar configurações de implantação. Campo que mostra o caminho para o arquivo app.yaml. Há um botão de edição para selecionar um arquivo diferente. Rótulo que mostra o ambiente de execução como personalizado. Rótulo que mostra o caminho do arquivo do Docker. Campo "Nome de artefato testado" que mostra o caminho para o arquivo do Docker.

  3. Clique em Editar para selecionar arquivos do Docker e app.yaml válidos.

    Caixa de diálogo que mostra a seção de configuração flexível do App Engine da tela criar configurações de implantação. Campo que mostra o caminho para o arquivo app.yaml. Há um botão de edição para selecionar um arquivo diferente. Rótulo que mostra o ambiente de execução como personalizado. Rótulo que mostra o caminho do arquivo do Docker. Campo "Nome de artefato testado" que mostra o caminho para o arquivo do Docker.

  4. Clique nas reticências (...) ao lado dos campos do Diretório do Dockerfile e app.yaml para navegar até os arquivos apropriados.

  5. Clique em OK.

Atualizar as configurações flexíveis do App Engine

Depois de criar a configuração de implantação inicial, é possível fazer alterações nas configurações conforme a necessidade do seu aplicativo.

  1. Selecione File > Project Structure.

    A caixa de diálogo Estrutura do projeto é exibida.

  2. Em Configurações do projeto, selecione Atributos.

  3. Selecione o atributo flexível do App Engine.

  4. Para selecionar um arquivo app.yaml, clique nas reticências (...) ao lado do campo app.yaml para navegar até o local de um arquivo válido.

  5. Para implantar em um ambiente de execução personalizado, clique nas reticências (...) ao lado do campo Diretório do Dockerfile e navegue até o local de um arquivo válido.

  6. Clique em OK.

Como excluir o servidor

Se você quiser excluir o servidor configurado para seu projeto, use o seguinte procedimento:

  1. Escolha Arquivo > Configurações > Build, Execution, Deployment > Clouds.

    No macOS, ele é chamado de IntelliJ IDEA > Preferences > Build, Execution, Deployment > Clouds.

  2. Selecione o servidor App Engine e clique no sinal de menos (-) na parte superior da janela para removê-lo.

  3. Clique em OK.

A seguir

Como receber suporte

Para enviar um feedback ou informar um problema no ambiente de desenvolvimento integrado do IntelliJ, acesse Tools > Cloud Code > Ajuda / Sobre > Envie feedback ou relate um problema no GitHub ou faça uma pergunta no Stack Overflow.

Você também pode participar do canal #cloud-code, que faz parte da comunidade do Google Cloud no Slack.