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:

<plugin>
   <groupId>com.google.cloud.tools</groupId>
   <artifactId>appengine-maven-plugin</artifactId>
   <version>2.8.1</version>
</plugin>

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 executa.

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?