Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # QuickStart: Implemente una aplicación Java en Elastic Beanstalk En este QuickStart tutorial se explica el proceso de creación de una aplicación Java y de su implementación en un AWS Elastic Beanstalk entorno. **No válido para uso en producción** Los ejemplos se presentan solo con fines de demostración. No utilice aplicaciones de ejemplo en producción. **Topics** + [Sus AWS inscrita](#java-quickstart-aws-account) + [Requisitos previos](#java-quickstart-prereq) + [Paso 1: crear una aplicación Java](#java-quickstart-create-app) + [Paso 2: ejecutar la aplicación a nivel local](#java-quickstart-run-local) + [Paso 3: implementar la aplicación Java con la CLI de EB](#java-quickstart-deploy) + [Paso 4: ejecutar la aplicación en Elastic Beanstalk](#java-quickstart-run-eb-ap) + [Paso 5: Eliminar](#java-tutorial-cleanup) + [AWS recursos para su aplicación](#java-quickstart-eb-resources) + [Siguientes pasos](#java-quickstart-next-steps) + [Implementar con la consola de Elastic Beanstalk](#java-quickstart-console) ## Sus AWS inscrita Si aún no es AWS cliente, debe crear una AWS cuenta. Registrarse le permite acceder a Elastic Beanstalk y a otros AWS servicios que necesite. Si ya tienes una AWS cuenta, puedes pasar a. [Requisitos previos](#java-quickstart-prereq) ### Crea un AWS inscrita #### Regístrese para un Cuenta de AWS Para empezar AWS, necesitas un Cuenta de AWS. Para obtener información sobre cómo crear un Cuenta de AWS, consulte [ Cómo empezar a utilizar un Cuenta de AWS](https://docs.aws.amazon.com/accounts/latest/reference/getting-started.html) en la Guía de *AWS Account Management referencia*. ## 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 ](https://docs.microsoft.com/en-us/windows/wsl/install-win10) 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)](eb-cli3.md#eb-cli3-install) y [Configuración de la CLI de EB](eb-cli3-configuration.md). ### Java y Maven Si no tiene Amazon Corretto instalado en su máquina local, puede instalarlo según las [instrucciones de instalación](https://docs.aws.amazon.com/corretto/latest/corretto-21-ug/amazon-linux-install.html) 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](https://maven.apache.org/download.cgi) e [instalación](https://maven.apache.org/install.html) del sitio web del proyecto Apache Maven. Para obtener más información sobre Maven, consulte el [Centro de usuarios de Maven](https://maven.apache.org/users/index.html) 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](https://spring.io/projects/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. **Example `~/eb-///java/srcmain/javacom/exampleApplication.java`** ``` 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í. **Example `~/eb-///java/srcmain/javacom/exampleController.java`** ``` 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. **Example `~/eb-.xml java/pom`** ``` 4.0.0 org.springframework.boot spring-boot-starter-parent 3.2.3 com.example BeanstalkJavaExample 1.0-SNAPSHOT 21 org.springframework.boot spring-boot-starter-data-rest org.springframework.boot spring-boot-maven-plugin ``` 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. **Example `~/eb- .propiedades java/application`** ``` 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](java-se-buildfile.md) y un [Procfile](java-se-procfile.md) para controlar cómo se crea y ejecuta la aplicación en el entorno de Elastic Beanstalk. **Cómo preparar y configurar una aplicación para su implementación.** 1. Limpie la aplicación creada. ``` ~/eb-java$ mvn clean ``` 1. Cree su `Buildfile`. **Example `~/eb- java/Buildfile`** ``` build: mvn clean package ``` `Buildfile` especifica el comando utilizado para compilar la aplicación. Si no incluye `Buildfile` para una aplicación Java, Elastic Beanstalk no intentará compilar la aplicación. 1. Cree su `Procfile`. **Example `~/eb- java/Procfile`** ``` web: java -jar target/BeanstalkJavaExample-1.0-SNAPSHOT.jar ``` `Procfile` especifica el comando utilizado para ejecutar la aplicación. Si no incluye `Procfile` para una aplicación Java, Elastic Beanstalk asume que hay un archivo JAR en la raíz del paquete de código fuente e intenta ejecutarlo con el comando `java -jar`. Ahora que ha configurado los archivos de configuración para compilar e iniciar la aplicación, está listo para implementarla. **Cómo crear un entorno e implementar la aplicación de Java** 1. Inicialice el repositorio de la CLI de EB con el comando **eb init**. ``` ~/eb-java eb init -p corretto java-tutorial --region {{us-east-2}} Application java-tutorial has been created. ``` Este comando crea una aplicación llamada `java-tutorial` y configura el repositorio local para crear entornos con la última versión de la plataforma de Java. 1. (Opcional) Ejecute de nuevo **eb init** para configurar un par de claves predeterminadas de forma que pueda usar SSH para conectarse a la instancia de EC2 donde se ejecuta la aplicación. ``` ~/eb-java$ eb init Do you want to set up SSH for your instances? (y/n): y Select a keypair. 1) my-keypair 2) [ Create new KeyPair ] ``` Seleccione un par de claves si ya tiene uno o siga las instrucciones para crear uno. Si no ve el símbolo del sistema o más adelante necesita cambiar la configuración, ejecute **eb init -i**. 1. Cree un entorno e implemente la aplicación en él con **eb create**. Elastic Beanstalk crea automáticamente un archivo zip para su aplicación y lo inicia en el puerto 5000. ``` ~/eb-java$ eb create java-env ``` Elastic Beanstalk tarda aproximadamente cinco minutos en crear el entorno. ## 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 termina todos AWS 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 + **EC2 instance (Instancia de EC2)**: máquina virtual de Amazon EC2 configurada para ejecutar aplicaciones web en la plataforma que elija. Cada plataforma ejecuta un conjunto distinto de software, archivos de configuración y scripts compatibles con una determinada versión de lenguaje, marco y contenedor web (o una combinación de ellos). La mayoría de las plataformas utilizan Apache o nginx como un proxy inverso que procesa el tráfico web delante de la aplicación web, reenvía las solicitudes a esta, administra los recursos estáticos y genera registros de acceso y errores. + **Instance security group (Grupo de seguridad de la instancia)**: grupo de seguridad de Amazon EC2 configurado para permitir el tráfico entrante en el puerto 80. Este recurso permite que el tráfico HTTP procedente del equilibrador de carga llegue a la instancia de EC2 en la que se ejecuta la aplicación web. De forma predeterminada, el tráfico no está permitido en otros puertos. + **Bucket de Amazon S3**: ubicación de almacenamiento para el código fuente, los registros y otros artefactos que se crean al utilizar Elastic Beanstalk. + ** CloudWatch Alarmas de Amazon**: dos CloudWatch alarmas que supervisan la carga de las instancias de su entorno y se activan si la carga es demasiado alta o demasiado baja. Cuando se activa una alarma, en respuesta, el grupo de escalado automático aumenta o reduce los recursos. + **CloudFormation stack**: Elastic Beanstalk se utiliza CloudFormation para lanzar los recursos de su entorno y propagar los cambios de configuración. Los recursos se definen en una plantilla que puede verse en la [consola de CloudFormation](https://console.aws.amazon.com/cloudformation). + **Nombre de dominio**: un nombre de dominio que se dirige a su aplicación web en el formulario. * {{subdomain}} {{region}}.elasticbeanstalk.com*. 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](GettingStarted.md#GettingStarted.Explore) en el capítulo *Getting started* de esta guía. **Probar más tutoriales** Si desea probar otros tutoriales con diferentes aplicaciones de ejemplo, consulte [Ejemplos de tutoriales y aplicaciones](java-getstarted.md). 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](java-development-environment.md). ## 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](GettingStarted.md#GettingStarted.CreateApp) en el capítulo *Getting Started* de esta guía.