Tutorial: GlassFish en Docker: camino a Amazon Linux 2023

GlassFish Contenedores Docker preconfigurados en Elastic Beanstalk

nota

El 18 de julio de 2022, Elastic Beanstalk estableció el estado de todas las sucursales de plataforma basadas en Amazon Linux () como retiradas. AMI AL1 Para obtener más información sobre la migración a una ramificación de la plataforma Amazon Linux 2023 actual y totalmente compatible, consulte Migración de su aplicación de Linux de Elastic Beanstalk a Amazon Linux 2023 o Amazon Linux 2.

La rama de GlassFish plataforma Docker preconfigurada que se ejecuta en Amazon Linux AMI (AL1) ya no es compatible. Para migrar su GlassFish aplicación a una plataforma Amazon Linux 2023 compatible, despliegue GlassFish y el código de la aplicación en una imagen de Docker de Amazon Linux 2023. Para obtener más información, consulte el siguiente tema, Implementación de una GlassFish aplicación en la plataforma Docker: una ruta de migración a Amazon Linux 2023.

En esta sección se muestra cómo desarrollar una aplicación de ejemplo localmente e implementarla después en Elastic Beanstalk con un contenedor Docker preconfigurado.

Configurar su entorno de desarrollo local

Para este tutorial, utilizamos una aplicación de ejemplo. GlassFish

Para configurar el entorno

Cree una nueva carpeta para la aplicación de ejemplo.


~$ mkdir eb-preconf-example
~$ cd eb-preconf-example

Descargue el código de la aplicación de ejemplo en la nueva carpeta.


~$ wget https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/samples/docker-glassfish-v1.zip
~$ unzip docker-glassfish-v1.zip
~$ rm docker-glassfish-v1.zip

Desarrollar y probar la aplicación localmente

Para desarrollar una aplicación de ejemplo GlassFish

Añada un Dockerfile en la carpeta raíz de la aplicación. En el archivo, especifique la imagen base de AWS Elastic Beanstalk Docker que se utilizará para ejecutar su contenedor Docker local preconfigurado. Más adelante, implementará la aplicación en una versión de plataforma Docker preconfigurada de Elastic GlassFish Beanstalk. Elija la imagen base de Docker que utiliza esta versión de la plataforma. Para averiguar la imagen de Docker actual de la versión de la plataforma, consulte la sección Docker preconfigurado de la página Plataformas compatibles con AWS Elastic Beanstalk en la guía Plataformas de AWS Elastic Beanstalk .
ejemplo b-preconf-example~/E /Dockerfile
```
# For Glassfish 5.0 Java 8
FROM amazon/aws-eb-glassfish:5.0-al-onbuild-2.11.1
```
Para obtener más información sobre cómo usar un Dockerfile, consulte Preparar la imagen de Docker para su implementación en Elastic Beanstalk.

Cree la imagen de Docker.


~/eb-preconf-example$ docker build -t my-app-image .

Ejecute el contenedor Docker desde la imagen.

nota
Debe incluir la marca -p para asignar el puerto 8080 del contenedor al puerto 3000 del host local. Los contenedores Docker de Elastic Beanstalk siempre exponen la aplicación en el puerto 8080 del contenedor. Las marcas -it ejecutan la imagen como un proceso interactivo. La marca --rm limpia el sistema de archivos del contenedor cuando el contenedor existe. De forma opcional, puede incluir una marca -d para ejecutar la imagen como un daemon.
```
$ docker run -it --rm -p 3000:8080 my-app-image
```
Para ver la aplicación de ejemplo, escriba lo siguiente URL en su navegador web.
```
http://localhost:3000
```

Implementar en Elastic Beanstalk

Después de probar la aplicación, ya puede implementarla en Elastic Beanstalk.

Para implementar su aplicación en Elastic Beanstalk

En la carpeta raíz de la aplicación, cambie el nombre de Dockerfile a Dockerfile.local. Este paso es necesario para que Elastic Beanstalk Dockerfile utilice el que contiene las instrucciones correctas para que Elastic Beanstalk cree una imagen de Docker personalizada en cada instancia de Amazon del entorno de Elastic Beanstalk. EC2

nota
No es necesario realizar este paso si su Dockerfile incluye instrucciones que modifican la imagen de Docker base de la versión de la plataforma. No necesita usar un Dockerfile en absoluto si su Dockerfile incluye solo una línea FROM para especificar la imagen base desde la que se crea el contenedor. En tal caso, el Dockerfile es redundante.
Cree el paquete de código fuente de la aplicación.
```
~/eb-preconf-example$ zip myapp.zip -r *
```
Abra la consola de Elastic Beanstalk con este enlace preconfigurado: console.aws.amazon.com/elasticbeanstalk/home#/? newApplication applicationName=tutoriales& = environmentType LoadBalanced
En Platform (Plataforma), en Preconfigured Docker (Docker preconfigurado), elija Glassfish.
En Application code, seleccione Upload your code y, luego, Upload.
Elija Local file (Archivo local), seleccione Browse (Examinar) y abra el paquete de código fuente de la aplicación que acaba de crear.
Seleccione Upload.
Elija Review and launch (Revisar y lanzar).
Revise la configuración disponible y, a continuación, elija Create app (Crear aplicación).
Cuando se crea el entorno, puede ver la aplicación implementada. Elija el entorno URL que se muestra en la parte superior del panel de control de la consola.

Implementación de una GlassFish aplicación en la plataforma Docker: una ruta de migración a Amazon Linux 2023

El objetivo de este tutorial es proporcionar a los clientes que utilizan la GlassFish plataforma Docker preconfigurada (basada en Amazon LinuxAMI) una ruta de migración a Amazon Linux 2023. Puede migrar su GlassFish aplicación a Amazon Linux 2023 mediante la implementación GlassFish y el código de la aplicación a una imagen de Docker de Amazon Linux 2023.

El tutorial explica el uso de la plataforma AWS Elastic Beanstalk Docker para implementar una aplicación basada en el servidor de aplicaciones Java EE en un GlassFish entorno de Elastic Beanstalk.

Demostramos dos enfoques para construir una imagen de Docker:

Sencillo: proporciona el código fuente de GlassFish la aplicación y deja que Elastic Beanstalk cree y ejecute una imagen de Docker como parte del aprovisionamiento del entorno. Esto es fácil de configurar, a costa de un mayor tiempo de aprovisionamiento de instancias.
Avanzado: cree una imagen de Docker personalizada que contenga el código de la aplicación y las dependencias, y proporciónela a Elastic Beanstalk para usarla en su entorno. Este enfoque es un poco más complejo y reduce el tiempo de aprovisionamiento de las instancias en su entorno.

Requisitos previos

En este tutorial se presupone que tiene algunos conocimientos sobre las operaciones básicas de Elastic Beanstalk, la interfaz de línea de comandos (EB) de Elastic Beanstalk y Docker. CLI Si aún no lo ha hecho, siga las instrucciones que se indican en Introducción a Elastic Beanstalk para lanzar su primer entorno de Elastic Beanstalk. En este tutorial se utiliza el EB CLI, pero también puede crear entornos y cargar aplicaciones mediante la consola de Elastic Beanstalk.

Para realizar este tutorial, también necesitará los siguientes componentes de Docker:

Una instalación local activa de Docker. Para obtener más información, consulte Descripción de Docker en la página de documentos de Docker.
Acceso a Docker Hub. Deberá crear un ID de Docker para poder acceder a Docker Hub. Para obtener más información, consulte Compartir la aplicación en la página de documentos de Docker.

Para obtener más información acerca de la configuración de los entornos Docker en las plataformas Elastic Beanstalk, consulte Preparar la imagen de Docker para su implementación en Elastic Beanstalk en este mismo capítulo.

Ejemplo sencillo: proporcione su código de aplicación

Esta es una forma sencilla de implementar la aplicación. GlassFish Proporciona el código fuente de la aplicación junto con el Dockerfile incluido en este tutorial. Elastic Beanstalk crea una imagen de Docker que incluye la aplicación y la pila de software. GlassFish A continuación, Elastic Beanstalk ejecuta la imagen en las instancias de su entorno.

Un problema de este enfoque es que Elastic Beanstalk crea la imagen de Docker localmente cada vez que crea una instancia para su entorno. La creación de la imagen aumenta el tiempo de aprovisionamiento de instancias. Este impacto no se limita a la creación inicial del entorno, sino que también ocurre durante las acciones de escalado ascendente.

Para lanzar un entorno con una aplicación de ejemplo GlassFish

Descargue el docker-glassfish-al2-v1.zip de ejemplo y, a continuación, expanda el archivo .zip en un directorio del entorno de desarrollo.
```
~$ curl https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/samples/docker-glassfish-al2-v1.zip --output docker-glassfish-al2-v1.zip
~$ mkdir glassfish-example
~$ cd glassfish-example
~/glassfish-example$ unzip ../docker-glassfish-al2-v1.zip
```
La estructura de directorios debe ser similar a la siguiente.
```
~/glassfish-example
|-- Dockerfile
|-- Dockerrun.aws.json
|-- glassfish-start.sh
|-- index.jsp
|-- META-INF
|   |-- LICENSE.txt
|   |-- MANIFEST.MF
|   `-- NOTICE.txt
|-- robots.txt
`-- WEB-INF
    `-- web.xml
```
Los siguientes archivos son clave para crear y ejecutar un contenedor de Docker en su entorno:
- Dockerfile: proporciona instrucciones que Docker utiliza para crear una imagen con la aplicación y las dependencias requeridas.
- glassfish-start.sh: un script de shell que ejecuta la imagen de Docker para iniciar la aplicación.
- Dockerrun.aws.json— Proporciona una clave de registro para incluir las GlassFish solicitudes del archivo de registro del servidor de aplicaciones. Si no le interesan GlassFish los registros, puede omitir este archivo.
Configure el directorio local para su implementación en Elastic Beanstalk.
```
~/glassfish-example$ eb init -p docker glassfish-example
```
(Opcional) Utilice el comando eb local run para crear y ejecutar el contenedor de forma local.
```
~/glassfish-example$ eb local run --port 8080
```
nota
Para obtener más información acerca del comando eb local, consulte eb local. El comando no es compatible con Windows. Si lo prefiere, puede crear y ejecutar el contenedor con los comandos docker build y docker run. Para obtener más información, consulte la documentación de Docker.
(Opcional) Aunque el contenedor se está ejecutando, utilice el comando eb local open para ver la aplicación en un navegador web. Si lo prefiere, abra http://localhost:8080/ en un navegador web.
```
~/glassfish-example$ eb local open
```
Use el comando eb create para crear un entorno e implementar su aplicación.
```
~/glassfish-example$ eb create glassfish-example-env
```
Una vez que se lanza el entorno, utilice el comando eb open para verlo en un explorador Web.
```
~/glassfish-example$ eb open
```

Cuando termine de trabajar con el ejemplo, termine el entorno y elimine los recursos relacionados.


~/glassfish-example$ eb terminate --all

Ejemplo avanzado: proporcione una imagen de Docker predefinida

Se trata de una forma más avanzada de implementar GlassFish la aplicación. A partir del primer ejemplo, se crea una imagen de Docker que contiene el código de la aplicación y la pila de GlassFish software, y se envía a Docker Hub. Después de realizar este paso único, puede lanzar entornos de Elastic Beanstalk basados en la imagen personalizada.

Cuando lanza un entorno y proporciona la imagen de Docker, las instancias del entorno descargan y usan esta imagen directamente y no necesitan crear una imagen de Docker. Por lo tanto, se reduce el tiempo de aprovisionamiento de instancias.

Notas

Los siguientes pasos crearán una imagen de Docker disponible públicamente.
Utilizará los comandos Docker de su instalación local de Docker, junto con las credenciales de Docker Hub. Para obtener más información, consulte la sección anterior sobre los requisitos previos de este tema.

Para lanzar un entorno con una imagen de Docker de una GlassFish aplicación prediseñada

Descargue y expanda el ejemplo docker-glassfish-al2-v1.zip como en el ejemplo sencillo anterior. Si ha completado dicho ejemplo, puede usar el directorio que ya tiene.
Cree una imagen de Docker y envíela a Docker Hub. Introduzca su ID de Docker para docker-id para iniciar sesión en Docker Hub.
```
~/glassfish-example$ docker build -t docker-id/beanstalk-glassfish-example:latest .
~/glassfish-example$ docker push docker-id/beanstalk-glassfish-example:latest
```
nota
Antes de enviar la imagen, es posible que deba ejecutar docker login. Se le pedirán las credenciales de Docker Hub si ejecuta el comando sin parámetros.

Cree un directorio adicional.


~$ mkdir glassfish-prebuilt
~$ cd glassfish-prebuilt

Copie el siguiente ejemplo en un archivo denominado Dockerrun.aws.json.

ejemplo `~/glassfish-prebuilt/Dockerrun.aws.json`


{
  "AWSEBDockerrunVersion": "1",
  "Image": {
    "Name": "docker-username/beanstalk-glassfish-example"
  },
  "Ports": [
    {
      "ContainerPort": 8080,
      "HostPort": 8080
    }
  ],
  "Logging": "/usr/local/glassfish5/glassfish/domains/domain1/logs"
}

Configure el directorio local para su implementación en Elastic Beanstalk.
```
~/glassfish-prebuilt$ eb init -p docker glassfish-prebuilt$
```
(Opcional) Utilice el comando eb local run para ejecutar el contenedor localmente.
```
~/glassfish-prebuilt$ eb local run --port 8080
```
(Opcional) Aunque el contenedor se está ejecutando, utilice el comando eb local open para ver la aplicación en un navegador web. Si lo prefiere, abra http://localhost:8080/ en un navegador web.
```
~/glassfish-prebuilt$ eb local open
```
Utilice el comando eb create para crear un entorno e implementar la imagen de Docker.
```
~/glassfish-prebuilt$ eb create glassfish-prebuilt-env
```
Una vez que se lanza el entorno, utilice el comando eb open para verlo en un explorador Web.
```
~/glassfish-prebuilt$ eb open
```

Cuando termine de trabajar con el ejemplo, termine el entorno y elimine los recursos relacionados.


~/glassfish-prebuilt$ eb terminate --all

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Migración (heredada) a Docker que se ejecuta en Amazon Linux 2

Uso de Go

GlassFish Contenedores Docker preconfigurados en Elastic Beanstalk

nota

Configurar su entorno de desarrollo local

Para configurar el entorno

Desarrollar y probar la aplicación localmente

Para desarrollar una aplicación de ejemplo GlassFish

ejemplo b-preconf-example~/E /Dockerfile

nota

Implementar en Elastic Beanstalk

Para implementar su aplicación en Elastic Beanstalk

nota

Implementación de una GlassFish aplicación en la plataforma Docker: una ruta de migración a Amazon Linux 2023

Requisitos previos

Ejemplo sencillo: proporcione su código de aplicación

Para lanzar un entorno con una aplicación de ejemplo GlassFish

nota

Ejemplo avanzado: proporcione una imagen de Docker predefinida

Notas

Para lanzar un entorno con una imagen de Docker de una GlassFish aplicación prediseñada

nota

ejemplo ~/glassfish-prebuilt/Dockerrun.aws.json

ejemplo `~/glassfish-prebuilt/Dockerrun.aws.json`