Início rápido: implantar uma aplicação Java no Elastic Beanstalk

Este tutorial de início rápido orienta você no processo de criação de uma aplicação Java e sua implantação em um ambiente AWS Elastic Beanstalk.

Sua conta da AWS

Se você ainda não for um cliente da AWS, será necessário criar uma conta da AWS. O cadastro habilita o acesso ao Elastic Beanstalk e outros serviços necessários da AWS.

Se você já tem uma conta da AWS, pode prosseguir para Pré-requisitos.

Pré-requisitos

Para seguir os procedimentos neste manual, você precisa de um terminal de linha de comando ou de um shell para executar os comandos. Nas listagens, os comandos são mostrados precedidos por um símbolo de prompt ($) e pelo nome do diretório atual, quando apropriado.

~/eb-project$ this is a command
this is output

No Linux e no macOS, você pode usar seu gerenciador de pacotes e de shell preferido. No Windows, você pode instalar o subsistema Windows para Linux para obter uma versão do Ubuntu e Bash integrada ao Windows.

EB CLI

Este tutorial também usa a Interface de Linhas de Comando do Elastic Beanstalk (CLI do EB). Para obter detalhes sobre a instalação e configuração da CLI do EB, consulte Instalar a interface de linha de comando do Elastic Beanstalk e Configurar a EB CLI.

Java e Maven

Se você não tiver o Amazon Corretto instalado no computador local, poderá instalá-lo seguindo as instruções de instalação no Guia do Usuário do Amazon Corretto.

Verifique sua instalação do Java executando o seguinte comando.

~$ java -version 

Este tutorial usa o Maven. Siga as instruções de download e instalação no site do Projeto Apache Maven. Para obter mais informações sobre o Maven, consulte o Centro de usuários do Maven no site do Projeto Apache Maven.

Verifique sua instalação do Maven executando o seguinte comando.

~$ mvn -v

Etapa 1: criar uma aplicação Java

Crie um diretório do projeto.

~$ mkdir eb-java
~$ cd eb-java

Depois, crie uma aplicação a ser implantada usando o Elastic Beanstalk. Vamos criar um serviço Web RESTful "Hello World".

Este exemplo usa a framework Spring Boot. Essa aplicação abre um receptor na porta 5000. O Elastic Beanstalk encaminha solicitações para sua aplicação na porta 5000 por padrão.

Crie os seguintes arquivos:

Esse arquivo cria uma aplicação Spring Boot simples.

package com.example;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

Esse arquivo cria um mapeamento que retorna um String que definimos aqui.

package com.example;
    
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
    
@RestController
public class Controller {
    
    @GetMapping("/")
    public String index() {
       return "Hello Elastic Beanstalk!";
    }
}

Esse arquivo define a configuração do projeto Maven.

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.2.3</version>
  </parent>

  <groupId>com.example</groupId>
  <artifactId>BeanstalkJavaExample</artifactId>
  <version>1.0-SNAPSHOT</version>

  <properties>
    <java.version>21</java.version>
  </properties>

  <dependencies>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-rest</artifactId>
    </dependency>
  </dependencies>

  <build>
    <plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
    </plugins>
  </build>

</project>

Esse arquivo de propriedades substitui a porta padrão, que passa a ser 5000. Essa é a porta padrão à qual o Elastic Beanstalk envia tráfego para aplicações Java.

server.port=5000

Etapa 2: executar a aplicação localmente

Empacote sua aplicação com o seguinte comando:

~/eb-java$ mvn clean package

Execute sua aplicação localmente com o seguinte comando:

~/eb-java$ java -jar target/BeanstalkJavaExample-1.0-SNAPSHOT.jar

Enquanto a aplicação estiver em execução, navegue até http://127.0.0.1:5000/ no navegador. Você verá o texto "Hello Elastic Beanstalk!”.

Etapa 3: implantar sua aplicação Java com a EB CLI

Antes de implantar sua aplicação Java no Elastic Beanstalk, vamos limpar a aplicação de compilação do diretório e criar um Buildfile e um Procfile para controlar como ela é compilada e executada no ambiente Elastic Beanstalk.

Agora que você definiu os arquivos de configuração para criar e iniciar a aplicação, está pronto para implantá-la.

Etapa 4: executar a aplicação no Elastic Beanstalk

Quando o processo de criação de seu ambiente for concluído, abra seu site com eb open.

~/eb-java eb open

Parabéns! Você implantou uma aplicação Java com o Elastic Beanstalk! Isso abre uma janela do navegador usando o nome de domínio criado para o seu aplicativo.

Etapa 5: limpar

Você pode encerrar o ambiente quando terminar de trabalhar com a aplicação. O Elastic Beanstalk encerra todos os recursos da AWS associados ao seu ambiente.

Para encerrar seu ambiente do Elastic Beanstalk com a CLI do EB, execute o seguinte comando.

~/eb-java$ eb terminate

Recursos da AWS para sua aplicação

Você acabou de criar uma aplicação de instância única. Ela serve como uma aplicação de exemplo simples com uma única instância do EC2 e, portanto, não requer balanceamento de carga ou ajuste de escala automático. Para aplicações de instância única, o Elastic Beanstalk cria os seguintes recursos da AWS:

O Elastic Beanstalk gerencia todos esses recursos. Quando você encerra o ambiente, o Elastic Beanstalk encerra todos os recursos dele.

Próximas etapas

Depois que um ambiente estiver executando um aplicativo, você poderá implantar uma nova versão do aplicativo ou um aplicativo diferente a qualquer momento. A implantação de uma nova versão do aplicativo é muito rápida, pois não é necessário provisionar ou reiniciar as instâncias do EC2. Também é possível explorar o novo ambiente usando o console do Elastic Beanstalk. Para conhecer as etapas detalhadas, consulte Explore seu ambiente, no capítulo Primeiros passos deste guia.

Depois de implantar uma ou duas aplicações de exemplo e estiver pronto para começar a desenvolver e executar aplicações Java localmente, consulte Configurar seu ambiente de desenvolvimento Java.

Implantar com o console do Elastic Beanstalk

Você também pode usar o console do Elastic Beanstalk para iniciar a aplicação de exemplo. Para conhecer as etapas detalhadas, consulte Criar uma aplicação de exemplo, no capítulo Primeiros passos deste guia.