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

En este tutorial de QuickStart se detalla el proceso de creación de una aplicación Docker 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.

Docker

Para seguir este tutorial, necesita 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.

Compruebe que el daemon de Docker esté en funcionamiento con el siguiente comando.

~$ docker info

Paso 1: crear una aplicación y un contenedor de Docker

En este ejemplo, creamos una imagen de Docker de el ejemplo de aplicación Flask de Implementación de una aplicación Flask en Elastic Beanstalk.

La aplicación consta de dos archivos:

Coloque ambos archivos en la raíz de un directorio.

~/eb-docker-flask/
|-- Dockerfile
|-- app.py

Agregue el siguiente contenido al Dockerfile.

FROM python:3.12
COPY . /app
WORKDIR /app
RUN pip install Flask==3.0.2
EXPOSE 5000
CMD [ "python3", "-m" , "flask", "run", "--host=0.0.0.0"]

Agergue el siguiente contenido al archivo app.py.

from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello_world():
    return 'Hello Elastic Beanstalk! This is a Docker application'

Cree el contenedor de Docker y etiquete la imagen con. eb-docker-flask

~/eb-docker-flask$ docker build -t eb-docker-flask

Paso 2: ejecutar la aplicación a nivel local

Use el comando docker build para crear una imagen de contenedor a nivel local y etiquétela con eb-docker-flask. El punto (.) al final del comando especifica que la ruta es un directorio local.

~/eb-docker-flask$ docker run -dp 127.0.0.1:5000:5000 eb-docker-flask .

Ejecute el contenedor con el comando docker run. El comando imprimirá el ID del contenedor en ejecución. La opción -d ejecuta el docker en modo de segundo plano. La opción -p expone la aplicación en el puerto 5000. Elastic Beanstalk envía el tráfico al puerto 5000 de la plataforma Docker por defecto.

~/eb-docker-flask$ docker run -dp 127.0.0.1:5000:5000 eb-docker-flask container-id

En el navegador, vaya a http://127.0.0.1:5000/ . Debería ver el texto «Hola, Elastic Beanstalk. Esta es una aplicación de Docker».

Ejecute el comando docker kill para terminar el contenedor.

~/eb-docker-flask$ docker kill container-id

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

Ejecute los siguientes comandos para crear un entorno de Elastic Beanstalk en esta aplicación.

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-docker-flask$ eb open

¡Enhorabuena! Ha implementado una aplicación de Docker 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-docker-flask$ 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 Docker de forma local, consulte Preparación de la imagen de Docker para implementarla en Elastic Beanstalk.

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.