- 1. Consideraciones generales
- 2. Preámbulo
- 3. Resumen del proyecto
- 4. Implementaciones de ejemplo
- 5. Paso a paso para empaquetar tu aplicación en un contenedor de Docker
- 6. Consideraciones para pedir tu Project Feedback
- 7. Objetivos de aprendizaje
- Este proyecto lo resolvemos de manera --individual--.
- El rango de tiempo estimado para completar el proyecto es de 1 a 2 Sprints.
Logo de Docker
Docker permite empaquetar una aplicación junto con todas sus dependencias (como bibliotecas, configuraciones y archivos necesarios) en una unidad estándar conocida como contenedor. Esto asegura que la aplicación funcione de manera consistente sin importar dónde se ejecute, ya sea en una máquina local, en la nube o en un servidor de producción. A diferencia de las máquinas virtuales, los contenedores no necesitan un sistema operativo completo, sino que comparten el núcleo del sistema operativo del host, lo que los hace más eficientes en términos de recursos y más rápidos de iniciar.
La currícula de Laboratoria incluye 4 proyectos enfocados en desplegar la Fleet Management API en la nube. Cada proyecto se distingue por utilizar diferentes métodos de despliegue, lo que te permitirá aprender y aplicar diversas estrategias para desplegar tu aplicación en producción en un entorno real.
Ruta Devops
En este proyecto empaquetarás la Fleet Management API en un contenedor de Docker a través de un Dockerfile.
En caso que no hayas implementado aún la Fleet Management API puedes usar las siguientes implementaciones mínimas para completar este proyecto. Elige la implementación en el lenguaje de programación que más te interese:
Docker es una herramienta que se usa para crear, desplegar y ejecutar aplicaciones en contenedores. Por lo tanto es importante que aprendas a administrar contenedores. Tómate un tiempo para familiarizarte con Docker. Puedes seguir el tutorial oficial de Docker o cualquier otro disponible en internet. Asegúrate que al final tengas respuestas claras para las siguientes preguntas:
- ¿Qué es un contenedor?
- ¿Qué es una Docker Image?
- ¿Qué es un Image Registry?
- ¿Cómo ejecutar un contenedor?
- ¿Cómo detener un contenedor?
- ¿Cómo publicar un puerto de un contenedor?
- ¿Cómo ejecutar un comando dentro de un contenedor?
- ¿Qué es un Dockerfile?
- En un Dockerfile, ¿para qué sirve el comando FROM?
- En un Dockerfile, ¿para qué sirve el comando EXPOSE?
- En un Dockerfile, ¿para qué sirve el comando USE?
- En un Dockerfile, ¿para qué sirve el comando RUN?
- En un Dockerfile, ¿para qué sirve el comando WORKDIR?
- En un Dockerfile, ¿para qué sirve el comando COPY?
- En un Dockerfile, ¿para qué sirven los comandos CMD y ENTRYPOINT?
- En un Dockerfile, ¿para qué sirve el comando ENV?
- ¿Cómo compartir imágenes en Docker Github?
Una vez estes familiarizada con Docker, el siguiente paso es escribir un Dockerfile para construir una imagen que empaquete tu API. Puedes seguir este tutorial o cualquier otro disponible en internet.
Para escribir un Dockerfile
adecuado que empaquete una aplicación,
es importante responder a varias preguntas clave sobre tu aplicación y su entorno.
Aquí tienes una lista de preguntas a considerar:
- ¿Cuál es el lenguaje de programación y entorno de ejecución de tu aplicación?
- ¿Cuál es el sistema operativo preferido o requerido?
- ¿En qué directorio está ubicado el código fuente de tu aplicación? ¿Necesitas copiar todo el directorio o solo ciertos archivos?
- ¿Qué herramientas o paquetes necesitas instalar para que tu aplicación funcione?
¿Usas un archivo como
package.json
(Node.js),requirements.txt
(Python),pom.xml
(Maven, Java) obuild.gradle
(Gradle, Java)? - ¿Cuál es el punto de entrada de tu aplicación? ¿Qué comando necesitas ejecutar para iniciar tu aplicación?
- ¿En qué puerto(s) escucha tu aplicación para recibir conexiones? Esto es necesario
para la instrucción
EXPOSE
. - ¿Existen variables de entorno que deban configurarse para que tu aplicación funcione correctamente?
- ¿Hay datos que deben mantenerse persistentes entre reinicios de contenedores? Si es así, puedes necesitar configurar volúmenes.
- ¿Existen permisos o configuraciones del sistema que deban aplicarse para que tu aplicación se ejecute correctamente?
- ¿Necesitas realizar alguna configuración específica o ejecución de scripts antes de que tu aplicación esté lista?
Con ayuda de las respuestas a estas preguntas escribe un Dockerfile que empaquete tu aplicación con todas sus dependencias, configure el entorno de trabajo y exponga el puerto necesario, asegurando que la aplicación esté lista para ejecutarse en un contenedor Docker.
Luego construye la imagen Docker desde el Dockerfile (docker build
) y ejecuta
un contenedor basado en la imagen construida (docker run
).
Prueba que la API funcione correctamente desde una colección de Postman. Puedes utilizar esta colección de ejemplo.
Crea una cuenta en Docker Hub e inicia sesión desde tu terminal (docker login
).
Etiqueta tu imagen Docker (docker tag
) y publícala en Docker Hub (docker push
)
para su distribución y uso.
Antes de agendar tu Project Feedback con tu coach, asegúrate de:
- Hacer push del Dockerfile al repositorio de proyecto Fleet Management API
- Construir una colección de Postman para probar la API. Puedes utilizar esta colección de ejemplo.
Reflexiona y luego marca los objetivos que has llegado a entender y aplicar en tu proyecto. Piensa en eso al decidir tu estrategia de trabajo.
-
Explicar qué es Docker, Docker container y Docker image
-
Comprender y usar las intrucciones básicas de un Dockerfile para definir una Docker image, como
FROM
,WORKDIR
,COPY
,RUN
yEXPOSE
-
Ejecutar comandos básicos de Docker para gestionar el ciclo de vida de un contenedor e imagen e interactuar con contenedores