QuickStart: Implementar una aplicación Java en Elastic Beanstalk

Este QuickStart tutorial explica el proceso de creación de una aplicación Java e implementarla en un AWS Elastic Beanstalk entorno.

Sus AWS inscrita

Si aún no es AWS cliente, debe crear una AWS cuenta. El registro le permite acceder a Elastic Beanstalk AWS y a otros servicios que necesite.

Si ya tiene una AWS cuenta, 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 el subsistema de Windows para Linux para obtener una Windows-integrated versión de Ubuntu y Bash.

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 Instalación de la CLI de EB con el script de configuración (recomendado) 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. Creación deemos 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 implementarla.

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 AWS cancela todos los recursos asociados a su entorno.

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

~/eb-java$ eb terminate

AWS recursos para su aplicación

Acaba de crear una aplicación de instancia única. Sirve como una aplicación de muestra sencilla con una sola instancia de EC2, por lo que no requiere equilibrio de carga ni escalado automático. Para las aplicaciones de instancia única, Elastic Beanstalk crea los siguientes recursos: 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 Explore your environment en el capítulo Getting started de esta guía.

Después de que implemente una aplicación de muestra 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 la aplicación de muestra. Para ver los pasos detallados, consulte Create an example application en el capítulo Getting Started de esta guía.