Implemente no ambiente flexível do App Engine no Cloud Code para IntelliJ

Aviso: a partir de 31 de janeiro de 2024, o suporte do Java 8 para o App Engine foi descontinuado e vai ser desativado a 31 de janeiro de 2026. Como resultado, o Cloud Code desativa o App Engine por predefinição. Para ativar o App Engine no seu IDE, navegue para Definições > Google Cloud Code > App Engine. Devido à descontinuação do App Engine, não recomendamos a criação de novos projetos do App Engine. Para mais informações sobre as descontinuações do App Engine, consulte o artigo Descontinuações de funcionalidades. Para mais informações sobre o calendário de suporte de tempo de execução do App Engine, consulte o artigo Calendário de suporte de tempo de execução.

Este documento descreve como implementar uma aplicação do App Engine no ambiente flexível do App Engine a partir do IntelliJ IDEA.

Nota: os seguintes IDEs suportam esta funcionalidade:

• IntelliJ IDEA - Ultimate
• IntelliJ IDEA - Community

Nota: apenas são suportadas aplicações Java.

Antes de começar

• Siga o guia Crie uma app para instalar e configurar o Cloud Code, bem como criar uma app do App Engine para o ambiente flexível. Certifique-se de que adiciona o suporte da framework flexível do App Engine.

  Se não tiver uma aplicação, mas quiser experimentar estes procedimentos de implementação, transfira a app de exemplo:

  1. Clone a app de exemplo do Spring Boot para a 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 ficheiros.

  3. Navegar para /gs-spring-boot/.

  4. Selecione o diretório /complete/.

  5. Clique em OK.

  6. Adicione suporte para a framework flexível do App Engine.

Criar a configuração de implementação

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

   

2. Confirme a configuração do servidor:

   1. Clique nas reticências (...) junto ao campo Servidor.

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

   3. Clique em OK.

3. Selecione a origem da Implementação.

   O Cloud Code for IntelliJ suporta a implementação a partir de um artefacto do Maven, um artefacto específico do IntelliJ ou um ficheiro JAR ou WAR do sistema de ficheiros.

   1. Se selecionar um ficheiro JAR ou WAR do sistema de ficheiros como origem da implementação, clique nas reticências (...) junto ao campo Arquivo de implementação para navegar para o arquivo de implementação.

4. Selecione um projeto no campo Projeto.

   Quando configurar a implementação pela primeira vez, é-lhe pedido que inicie sessão na conta associada ao projeto da consola que quer implementar. Google Cloud

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

   1. Se não vir um ficheiro app.yaml válido no menu pendente, clique em Editar para selecionar um ficheiro. Consulte a secção Atualize as configurações flexíveis do App Engine para mais informações.

6. Preencha outros campos conforme necessário para configurar a implementação.

7. Clique em Executar para criar e implementar a sua app.

8. Na janela Servidores de aplicações, clique no nome do seu projeto para monitorizar o progresso da implementação. Se a janela não estiver a ser apresentada, clique em Ver > Janelas de ferramentas > Servidores de aplicações.

   Após a conclusão da implementação, pode ver o URL da sua app no resultado da consola.

Implementação num tempo de execução personalizado

Pode modificar o ficheiro app.yaml para implementar a sua app num tempo de execução personalizado através de um ficheiro Docker.

1. No ficheiro app.yaml, defina o tempo de execução como personalizado.

2. À medida que conclui os passos de criação da configuração de implementação, a secção Configuração flexível do App Engine apresenta o caminho para o ficheiro app.yaml e o Dockerfile.

   

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

   

4. Clique nas reticências (...) junto aos campos app.yaml e Dockerfile Directory para navegar para os ficheiros adequados.

5. Clique em OK.

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

Depois de criar a configuração de implementação inicial, pode fazer alterações a essas configurações conforme necessário para a sua aplicação.

1. Selecione Ficheiro > Estrutura do projeto.

   É apresentada a caixa de diálogo Estrutura do projeto.

2. Em Definições do projeto, selecione Aspetos.

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

4. Para selecionar um ficheiro app.yaml, clique nas reticências (...) junto ao campo app.yaml para navegar para a localização de um ficheiro válido.

5. Se implementar num tempo de execução personalizado, clique nas reticências (...) junto ao campo Diretório Dockerfile para navegar para a localização de um ficheiro válido.

6. Clique em OK.

Eliminar o servidor

Se quiser eliminar o servidor que configurou para o seu projeto, pode fazê-lo da seguinte forma:

1. Escolha Ficheiro > Definições > Compilação, execução e implementação > Nuvens.

   No macOS, aceda a IntelliJ IDEA > Preferences > Build, Execution, Deployment > Clouds.

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

3. Clique em OK.

O que se segue?

• Pode adicionar o seu projeto aos Cloud Source Repositories se ainda não o tiver feito.

Obter apoio técnico

Para enviar feedback ou comunicar um problema no seu IDE IntelliJ, aceda a Tools > Cloud Code > Help / About > Submit feedback or report an issue para comunicar um problema no GitHub.