Começar: configurar o ambiente de programação

Saiba como configurar o seu ambiente de compilação para o desenvolvimento e a implementação de apps no tempo de execução do Java 8 no ambiente padrão do App Engine.

Este guia explica como:

  • Instale a CLI do Google Cloud.
  • Instale e configure o plugin do App Engine para o Maven. O App Engine também fornece plug-ins para Gradle, IntelliJ IDEA e Eclipse, mas este guia demonstra o plug-in Maven.
  • Crie um novo projeto do App Engine.
  • Conceda autorização ao Cloud Build para permitir a criação e a implementação da sua app.

Instalar SDKs obrigatórios

  1. Se ainda não tiver instalado o SDK Java SE 8, instale o Java SE 8 Development Kit (JDK).

  2. Instale e inicialize a versão mais recente da CLI gcloud.

    Instale e inicialize a CLI gcloud

  3. Instale o componente Java do App Engine:

    gcloud components install app-engine-java
    
  4. Autorize a sua conta de utilizador:

    gcloud auth application-default login
    

Configurar o Maven no seu ambiente de programação

  1. Transfira o Maven 3.5 ou posterior a partir do Website do Maven.

  2. Instale o Maven 3.5 ou posterior na sua máquina local.

Criar um novo projeto do App Engine

Para criar uma app do App Engine:

  1. Crie um novo diretório.

  2. Inicialize o novo projeto no diretório criado:

     mvn archetype:generate -Dappengine-version=1.9.59 -Djava8=true -DCloudSDK_Tooling=true -Dapplication-id=your-app-id -Dfilter=com.google.appengine.archetypes:
    
    1. Defina -Dappengine-version para a versão mais recente do App Engine SDK para Java e application-id para o ID do seu projeto doGoogle Cloud .

    2. Defina -Djava8=true para implementar o projeto no tempo de execução do Java 8.

    3. Defina -DCloudSDK_Tooling=true para usar as ferramentas da CLI gcloud.

  3. Quando lhe for pedido que escolha um arquétipo, escolha o valor 2 para o arquétipo de estrutura do App Engine. Esta ação cria um projeto vazio que contém a estrutura de diretórios e os ficheiros necessários.

  4. Quando lhe for pedido para indicar a versão, prima ENTER para selecionar a versão predefinida mais recente.

  5. Quando lhe for pedido que Define value for property 'groupId', indique o espaço de nomes pretendido para a sua app; por exemplo, com.mycompany.myapp.

  6. Quando lhe for pedido que Define value for property 'artifactId', indique o nome do projeto. Por exemplo, myapp.

  7. Quando lhe for pedido que Define value for property 'version', aceite o valor predefinido.

  8. Quando lhe for pedido que Define value for property 'package', indique o nome do pacote preferido (ou aceite o predefinido). Os ficheiros Java gerados vão ter o nome do pacote que especificar aqui.

  9. Quando lhe for pedido para confirmar as suas escolhas, aceite o valor predefinido (Y).

  10. Aguarde que o projeto termine a geração e, em seguida, altere os diretórios para o diretório do novo projeto, por exemplo, myapp/.

  11. Adicione o plug-in baseado na CLI gcloud ao ficheiro pom.xml do seu projeto.

    <build>
        <plugins>
           [...]
              <plugin>
                <groupId>com.google.cloud.tools</groupId>
                <artifactId>appengine-maven-plugin</artifactId>
                <version>2.4.4</version>
                <configuration>
                    <projectId>your-project-ID-goes-here</projectId>
                    <version>1</version>
                </configuration>
              </plugin>
           [...]
        </plugins>
    </build>
    
  12. Especifique o ID do projeto da Google Cloud Platform de destino e o serviço e a versão na configuração do plug-in.

Conceda autorização ao Cloud Build

Quando implementa a sua app, o App Engine usa o Cloud Build para compilar a app num contentor e implementar o contentor no tempo de execução. Por predefinição, o Cloud Build não tem autorização para implementar apps Java 8, pelo que tem de conceder autorização ao Cloud Build para implementar apps no seu projeto. As compilações são criadas na região da app.

O que se segue?

Agora que o ambiente de desenvolvimento está configurado, pode começar a desenvolver e implementar apps Java no App Engine.