Primeiros passos: como configurar o ambiente de desenvolvimento

Saiba como configurar o ambiente de criação para desenvolvimento e implantação de aplicativos no ambiente de execução do Java 8 no ambiente padrão do App Engine.

Neste guia, mostraremos como:

  • instalar a ferramenta de linha de comando do Google Cloud SDK;
  • instalar e configurar o plug-in do App Engine para Maven.
    O App Engine também fornece plug-ins para Gradle, IntelliJ IDEA e Eclipse, mas este guia demonstra o plug-in do Maven.
  • criar um novo projeto do App Engine.
  • Dê permissão ao Cloud Build para ativar a criação e a implantação do aplicativo.

Como instalar os SDKs necessários

  1. Instale o Java SE 8 Development Kit (JDK), caso ainda não tenha feito isso.

  2. Instale e inicialize a versão mais recente do SDK do Google Cloud.

    Instale e inicialize o SDK do Google Cloud

  3. Instale o componente Java do App Engine:

    gcloud components install app-engine-java
    
  4. Autorize sua conta de usuário:

    gcloud auth application-default login
    

Como configurar o Maven no ambiente para desenvolvedores

  1. Faça o download do Maven 3.5 ou mais recente no site do Maven.

  2. Instale o Maven 3.5 ou mais recente na máquina local.

Como criar um novo projeto do App Engine

Para criar um aplicativo 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. Configure -Dappengine-version com a versão mais recente do SDK do App Engine para Java e application-id com ID do seu projeto do Cloud.

    2. Configure -Djava8=true para implantar o projeto no ambiente de execução do Java 8.

    3. Configure -DCloudSDK_Tooling=true para usar as ferramentas do SDK do Cloud.

  3. Quando solicitado a escolher um arquétipo, escolha o valor 2 para o arquétipo da estrutura do App Engine. Isso cria um projeto vazio que contém a estrutura de diretórios e os arquivos obrigatórios.

  4. Quando a versão for solicitada, pressione ENTER para selecionar a versão mais recente padrão.

  5. Quando solicitado a Define value for property 'groupId', forneça o namespace pretendido para seu aplicativo. Por exemplo, com.mycompany.myapp.

  6. Quando solicitado a Define value for property 'artifactId', forneça o nome do projeto. Por exemplo, myapp.

  7. Quando solicitado a Define value for property 'version', aceite o valor padrão.

  8. Quando solicitado a Define value for property 'package', forneça o nome que preferir para o pacote ou aceite o padrão. Os arquivos do Java gerados terão o nome do pacote que você especificar aqui.

  9. Quando solicitado a confirmar as opções escolhidas, aceite o valor padrão (Y).

  10. Aguarde a conclusão da geração do projeto. Em seguida, substitua o diretório pelo novo diretório do projeto. Por exemplo, myapp/.

  11. Adicione o plug-in baseado no SDK do Cloud ao arquivo pom.xml do projeto.

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

Conceder permissão ao Cloud Build

Quando você implanta seu aplicativo, o App Engine usa o Cloud Build para criar o aplicativo em um contêiner e implantar o contêiner no ambiente de execução. O Cloud Build não tem permissão para implantar aplicativos Java 8 por padrão. Portanto, você precisa conceder ao Cloud Build permissão para implantar aplicativos no projeto.

A seguir

Agora que o ambiente para desenvolvedores está configurado, você está pronto para começar a desenvolver e implantar aplicativos Java no App Engine.