QuickStart: implementación de una aplicación Java en Elastic Beanstalk

En este tutorial de QuickStart se detalla el proceso de creación de una aplicación Java y su implementación en un entorno de AWS Elastic Beanstalk.

Cuenta de AWS

Si aún no es cliente de AWS, necesitará crear una cuenta de AWS. Cuando lo haga, tendrá acceso a Elastic Beanstalk y otros servicios de AWS que necesita.

Si ya tiene una cuenta de AWS, puede pasar a Requisitos previos.

Requisitos previos

Para seguir los procedimientos de esta guía, necesitará un shell o un terminal de línea de comando donde pueda ejecutar los comandos. Los comandos aparecen en listas y van precedidos del símbolo del sistema ($) y del nombre del directorio actual, si es aplicable.

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

En Linux y macOS, puede utilizar el administrador de shell y paquetes preferido. En Windows, puede instalar Windows Subsystem para Linux para obtener una versión de Ubuntu y Bash integrada con Windows.

CLI DE EB

En este tutorial también se utiliza la interfaz de línea de comandos de Elastic Beanstalk (CLI de EB). Para obtener detalles sobre la instalación y configuración de la CLI de EB, consulte Instalar la interfaz de línea de comando de Elastic Beanstalk y Configuración de la CLI de EB.

Java y Maven

Si no tiene Amazon Corretto instalado en su máquina local, puede instalarlo según las instrucciones de instalación de la Guía del usuario de Amazon Corretto.

Verifique la instalación de Java con el siguiente comando.

~$ java -version 

En este tutorial se utiliza Maven. Siga las instrucciones de descarga e instalación del sitio web del proyecto Apache Maven. Para obtener más información sobre Maven, consulte el Centro de usuarios de Maven en el sitio web del Proyecto Apache Maven:

Verifique la instalación de Maven con el siguiente comando.

~$ mvn -v

Paso 1: crear una aplicación Java

Cree el directorio del proyecto.

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

A continuación, vamos a crear una aplicación que implementará con Elastic Beanstalk. Crearemos el servicio web RESTful "Hello World".

En este ejemplo se utiliza el marco Spring Boot. Esta aplicación abre un oyente en el puerto 5000. De forma predeterminada, Elastic Beanstalk configura el proxy para reenviar las solicitudes a la aplicación en el puerto 5000.

Cree los siguientes archivos:

Este archivo crea una aplicación Spring Boot sencilla.

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);
    }
}

Este archivo crea un mapeo que devuelve una cadena que definimos aquí.

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!";
    }
}

Este archivo define la configuración del proyecto 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>

Este archivo de propiedades anula el puerto predeterminado para que sea 5000. Este es el puerto predeterminado al que Elastic Beanstalk envía el tráfico para las aplicaciones Java.

server.port=5000

Paso 2: ejecutar la aplicación a nivel local

Empaquete la aplicación con el siguiente comando:

~/eb-java$ mvn clean package

Ejecute su aplicación a nivel local con el siguiente comando:

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

Mientras la aplicación está en ejecución, vaya a http://127.0.0.1:5000/ en su navegador. Debería ver el texto «Hola, Elastic Beanstalk».

Paso 3: implementar la aplicación Java con la CLI de EB

Antes de implementar la aplicación Java en Elastic Beanstalk, limpiaremos la aplicación de compilación del directorio y creemos un Buildfile y un Procfile para controlar cómo se crea y ejecuta la aplicación en el entorno de Elastic Beanstalk.

Ahora que ha configurado los archivos de configuración para compilar e iniciar la aplicación, está listo para desplegarla.

Paso 4: ejecutar la aplicación en Elastic Beanstalk

Cuando finalice el proceso de creación del entorno, abra el sitio web con eb open.

~/eb-java eb open

¡Enhorabuena! Ha implementado una aplicación Java con Elastic Beanstalk. Se abre una ventana del navegador con el nombre de dominio creado para su aplicación.

Paso 5: Eliminar

Cuando termine de trabajar con la aplicación, puede terminar el entorno. Elastic Beanstalk cancela todos los recursos de AWS asociados a su entorno.

Utilice el comando siguiente de la CLI de EB para terminar su entorno de Elastic Beanstalk.

~/eb-java$ eb terminate

Recursos deAWS para su aplicación

Acaba de crear una aplicación de instancia única. Sirve como un ejemplo de aplicación sencillo con una sola instancia de EC2, por lo que no requiere equilibrio de carga ni escalado automático. Para aplicaciones de instancia única, Elastic Beanstalk crea los siguientes recursos de AWS:

Elastic Beanstalk administra todos estos recursos. Cuando termina su entorno, Elastic Beanstalk termina todos los recursos que este contiene.

Siguientes pasos

Una vez que disponga de un entorno que ejecute una aplicación, podrá implementar una nueva versión de la aplicación o una aplicación distinta en cualquier momento. La implementación de una nueva versión de la aplicación es una tarea muy rápida, ya que no se requiere aprovisionar ni reiniciar instancias EC2. También puede explorar el nuevo entorno con la consola de Elastic Beanstalk. Para ver los pasos detallados, consulte Explorar entorno en el capítulo Introducción de esta guía.

Después de que implemente una aplicación de ejemplo o dos y esté listo para empezar a desarrollar y poner en funcionamiento las aplicaciones de Java de forma local, consulte Configuración del entorno de desarrollo de Java.

Implementar con la consola de Elastic Beanstalk

También puede utilizar la consola de Elastic Beanstalk para lanzar ele ejemplo de aplicación. Para ver los pasos detallados, consulte Crear ejemplo de aplicación en el capítulo Introducción de esta guía.