Usar o Apache Maven e o App Engine Plugin

O Apache Maven é uma ferramenta de automatização de compilação para Java.

O App Engine fornece um plug-in do Maven que pode usar para criar e implementar a sua app no App Engine. O plug-in não suporta projetos de arquivo de aplicações empresariais (EAR).

Antes de começar

  1. Determine se o Maven está instalado e que versão tem executando o seguinte comando:

    mvn -v

    Se o Maven estiver instalado, é apresentada uma longa sequência de informações que começa com Apache Maven e é seguida por um número de versão, como 3.9.1.

  2. Se não tiver o Maven 3.9.1 ou mais recente instalado:

    1. Transfira o Maven 3.9.1 ou mais recente.
    2. Instale o Maven 3.9.1 ou mais recente.

  3. Se ainda não o fez, siga os passos aqui para transferir a CLI gcloud, criar o seu Google Cloud projeto e inicializar a sua app do App Engine.

  4. Instale o componente app-engine-java da CLI gcloud:

    gcloud components install app-engine-java

Adicionar o plug-in Maven do App Engine

Para usar o plug-in do App Engine Maven, adicione as seguintes linhas à secção plugins no ficheiro pom.xml do seu projeto:

<plugins>
   <plugin>
     <groupId>com.google.cloud.tools</groupId>
     <artifactId>appengine-maven-plugin</artifactId>
     <version>2.8.1</version>
   </plugin>
   <plugin>
     <groupId>org.eclipse.jetty</groupId>
     <artifactId>jetty-maven-plugin</artifactId>
     <version>9.4.56.v20240826</version>
   </plugin>
</plugins>
 O plug-in do App Engine inclui o plug-in do Jetty Maven, que pode usar para testar a sua aplicação rapidamente sem criar um ficheiro WAR.

Usar o Jetty Maven Plugin para testar a sua app localmente

Durante a fase de desenvolvimento, pode executar e testar a sua app em qualquer altura no servidor de desenvolvimento invocando o plug-in Jetty Maven.

Para executar a sua app no servidor de desenvolvimento:

  1. Crie a sua app, se ainda não o tiver feito:

    mvn package

  2. Altere o diretório para o nível superior do seu projeto (por exemplo, para myapp) e execute a sua app invocando o Maven:

    mvn jetty:run

  3. Aguarde que o servidor seja iniciado e use o navegador para visitar http://localhost:8080/ para aceder à sua app.

  4. Encerre a app e o servidor de desenvolvimento premindo Control+C.

Criar e implementar a sua app

Depois de adicionar o plug-in Maven do App Engine ao ficheiro pom.xml do seu projeto, pode usar o seguinte comando para criar e implementar a sua app:

mvn package appengine:deploy -Dapp.deploy.projectId=PROJECT_ID

Substitua PROJECT_ID pelo ID do seu Google Cloud projeto. Se o seu ficheiro pom.xml já especificar o seu ID do projeto, não precisa de incluir a propriedade -Dapp.deploy.projectId no comando que executar.

O objetivo package cria e empacota a sua app, e o objetivo appengine:deploy faz o seguinte:

  1. Gera um ID da versão exclusivo para a nova versão da sua app.

  2. Implementa a nova versão no App Engine.

  3. Encaminha todo o tráfego para a nova versão.

Alterar as predefinições de implementação

Pode alterar o comportamento de implementação predefinido transmitindo parâmetros no comando appengine:deploy. Por exemplo, o comando seguinte implementa o serviço definido no ficheiro pom.xml num projeto Google Cloud específico, atribui um ID de versão personalizado ao serviço e desativa o encaminhamento automático de tráfego para a nova versão:

mvn appengine:deploy -Dapp.deploy.projectId=PROJECT_ID -Dapp.deploy.version=VERSION_ID -Dapp.deploy.promote=False

Também pode usar o comando appengine:deploy para implementar ficheiros de configuração, como cron.yaml, dispatch.yaml e index.yaml.

Para mais informações, consulte a appengine:deploy referência .

O que se segue?