Saltar al contenido

Lección 5 de 20 · Lectura y práctica

Quiz: Conceptos Básicos de Docker

Tipo de lección: QuizConcepto claveDocker es una plataforma de containerización que permite empaquetar aplicaciones y sus dependencias en unidades estandarizadas llamadas contenedores. Imagina que eres un científico de datos que.

Del concepto a la práctica

Taller de esta lección

Este repaso distingue decisiones que suelen mezclarse: una imagen es un artefacto construido, un contenedor es su ejecución, un volumen conserva datos y un puerto publicado conecta el host con el proceso. La respuesta correcta debe justificar la relación, no repetir definiciones.

Ejemplo resuelto

Si una aplicación escucha en 5000 dentro del contenedor y se ejecuta con -p 8080:5000, una petición al host usa 8080. EXPOSE 5000 documenta el puerto, pero no publica por sí solo. Si el proceso termina, el contenedor deja de atender aunque la imagen siga disponible.

Pruébalo

  1. Dibuja las capas imagen, contenedor y volumen.

  2. Relaciona 8080 del host con 5000 del contenedor.

  3. Explica qué ocurre al borrar el contenedor.

  4. Clasifica tres errores como red, proceso o persistencia.

Error frecuente: decir que EXPOSE crea una ruta pública. Corrección: diferencia documentación del puerto y publicación efectiva.

Comprueba tu resultado

Tu respuesta debe indicar que la petición entra por 8080, llega a 5000, falla si el proceso no escucha y conserva solo los datos ubicados en el volumen. Comprueba la explicación con una ejecución local.

Tres diagnósticos con respuesta

Red: el proceso escucha en 5000 y el host publica 8080; consulta http://127.0.0.1:8080, con el servidor escuchando en 0.0.0.0 dentro del contenedor. Proceso: una excepción al cargar un modelo deja el contenedor detenido; consulta sus logs. Persistencia: guardar una salida en una capa interna y eliminar el contenedor pierde ese archivo, mientras el volumen permanece. EXPOSE es metadato y no sustituye a -p.

docker run imagen sh crea otro contenedor; no abre los archivos generados en uno anterior. Para inspeccionar el anterior, conserva su nombre y usa herramientas que lo consulten, o guarda el artefacto en el montaje de salida. Las etiquetas identifican versiones por convención pero pueden reasignarse; un digest identifica exactamente el contenido. Estas diferencias deben aparecer en la explicación, junto con las pruebas que observaste.

Secuencia de código, imagen de contenedor, pruebas, registro y despliegue de instancias idénticas.
CursaloMapa de práctica
Del código al despliegue

El código se empaqueta en una imagen y se prueba antes de publicarlo. Esa misma imagen se guarda en un registro y se usa en el despliegue. Comprobar la salud de las instancias permite detectar un fallo sin reconstruir el artefacto.

Ver la infografía en tamaño completo ↗

Tipo de lección: Quiz

Concepto clave

Docker es una plataforma de containerización que permite empaquetar aplicaciones y sus dependencias en unidades estandarizadas llamadas contenedores. Imagina que eres un científico de datos que necesita enviar un modelo de machine learning a un colega. En lugar de enviar un documento largo con instrucciones sobre cómo configurar Python, instalar bibliotecas específicas y configurar variables de entorno, simplemente le envías un paquete que contiene todo lo necesario para ejecutar el modelo, listo para usar en cualquier computadora. Eso es lo que hace Docker: crea un entorno aislado y reproducible que garantiza que tu código funcione de la misma manera en cualquier lugar, desde tu laptop hasta un servidor en la nube.

Los contenedores son ligeros porque comparten el kernel del sistema operativo del host, a diferencia de las máquinas virtuales que requieren un sistema operativo completo. Esto los hace ideales para desplegar modelos de ML, donde la eficiencia y la portabilidad son cruciales. Por ejemplo, si desarrollas un modelo en TensorFlow con Python 3.8 en tu máquina local, Docker asegura que ese mismo entorno se replique exactamente en producción, evitando problemas como "funciona en mi máquina".

Cómo funciona en la práctica

Para containerizar un modelo de ML con Docker, sigues un flujo paso a paso que comienza con la creación de un Dockerfile, un archivo de texto que define cómo construir la imagen del contenedor. Primero, especificas una imagen base, como una versión oficial de Python. Luego, instalas las dependencias necesarias, como scikit-learn o pandas, copias tu código y configuras el punto de entrada para ejecutar el modelo. Una vez que tienes el Dockerfile, usas el comando docker build para crear una imagen, que es una plantilla inmutable del contenedor. Finalmente, ejecutas la imagen con docker run para iniciar un contenedor en vivo.

Veamos un ejemplo básico: supongamos que tienes un script de Python llamado modelo.py que entrena un clasificador simple. El proceso implica escribir un Dockerfile, construir la imagen y ejecutarla. Esto te permite probar el modelo en un entorno aislado antes de desplegarlo en Kubernetes. La clave es que cada paso es reproducible; si alguien más clona tu repositorio, puede reconstruir la imagen exacta y obtener los mismos resultados.

Código en acción

Aquí tienes un ejemplo funcional de un Dockerfile para un modelo de ML básico. Primero, el antes: un script de Python sin containerizar que podría fallar en otra máquina debido a dependencias faltantes.

# modelo.py
import pandas as pd
from sklearn.linear_model import LogisticRegression
import pickle

# Cargar datos y entrenar modelo
data = pd.read_csv('datos.csv')
X = data.drop('target', axis=1)
y = data['target']
model = LogisticRegression()
model.fit(X, y)

# Guardar modelo
with open('modelo.pkl', 'wb') as f:
    pickle.dump(model, f)
print("Modelo entrenado y guardado")

Ahora, el después: un Dockerfile que containeriza este script, asegurando que funcione en cualquier entorno.

# Dockerfile
# Usar una imagen base oficial de Python
FROM python:3.8-slim

# Establecer el directorio de trabajo en el contenedor
WORKDIR /app

# Copiar el archivo de requisitos e instalar dependencias
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# Copiar el script de Python
COPY modelo.py .
COPY datos.csv .

# Comando para ejecutar el script
CMD ["python", "modelo.py"]

Para construir y ejecutar: docker build -t modelo-ml . y luego docker run modelo-ml. Esto crea un contenedor que ejecuta el modelo de forma aislada.

Errores comunes

  • No optimizar el tamaño de la imagen: Usar imágenes base grandes como python:latest puede resultar en imágenes de varios GB. Solución: usa versiones slim (e.g., python:3.8-slim) y limpia cachés después de instalar paquetes.
  • Olvidar exponer puertos: Si tu modelo sirve predicciones via API (e.g., con Flask), no configurar EXPOSE en el Dockerfile puede evitar que el contenedor sea accesible. Solución: añade EXPOSE 5000 si usas el puerto 5000.
  • Copiar archivos innecesarios: Incluir datos grandes o archivos temporales en la imagen aumenta su tamaño. Solución: usa un .dockerignore para excluir archivos como __pycache__ o datasets crudos.
  • No usar variables de entorno para configuraciones: Hardcodear rutas o parámetros en el código limita la flexibilidad. Solución: usa ENV en el Dockerfile o pasa variables al ejecutar con -e.
  • Ignorar el contexto de build: Ejecutar docker build desde un directorio incorrecto puede causar errores al copiar archivos. Solución: siempre verifica que el Dockerfile y los archivos necesarios estén en el mismo directorio o ajusta las rutas en el COPY.

Checklist de dominio

  1. ¿Puedes explicar la diferencia entre una imagen Docker y un contenedor en una analogía simple?
  2. ¿Sabes escribir un Dockerfile básico que instale Python, dependencias y ejecute un script de ML?
  3. ¿Entiendes cómo usar docker build y docker run para crear y ejecutar contenedores?
  4. ¿Puedes listar al menos tres mejores prácticas para optimizar imágenes Docker en proyectos de ML?
  5. ¿Eres capaz de depurar un error común como "puerto no expuesto" o "dependencia faltante" en un contenedor?
  6. ¿Conoces la utilidad de un archivo .dockerignore y cómo crearlo?
  7. ¿Puedes containerizar un modelo simple y verificar que funcione en un entorno aislado?

Containeriza un modelo de clasificación con Docker

En este ejercicio práctico, containerizarás un modelo de machine learning básico usando Docker, simulando un escenario real donde necesitas empaquetar tu trabajo para compartirlo con un equipo. Sigue estos pasos:

  1. Prepara tu entorno: Asegúrate de tener Docker instalado en tu máquina. Crea un nuevo directorio para el proyecto y navega a él en tu terminal.
  2. Crea los archivos necesarios: Dentro del directorio, crea un script de Python llamado train_model.py que cargue un dataset simple (puedes usar sklearn.datasets.load_iris), entrene un modelo de clasificación (e.g., RandomForestClassifier), y guarde el modelo entrenado en un archivo model.pkl usando pickle.
  3. Escribe un Dockerfile: Crea un archivo llamado Dockerfile (sin extensión) que:
    • Use la imagen base python:3.8-slim.
    • Establezca un directorio de trabajo, por ejemplo, /app.
    • Copie un archivo requirements.txt (que debes crear con al menos scikit-learn y pandas) e instale las dependencias.
    • Copie el script train_model.py.
    • Defina el comando para ejecutar el script al iniciar el contenedor.
  4. Construye y ejecuta la imagen: En la terminal, ejecuta docker build -t ml-classifier . para construir la imagen. Luego, ejecuta docker run ml-classifier para iniciar el contenedor y ver la salida del entrenamiento.
  5. Verifica el resultado: Confirma que el contenedor se ejecutó correctamente y que el archivo model.pkl se generó dentro del contenedor (puedes inspeccionar con docker run -it ml-classifier sh para entrar al contenedor y listar archivos).

Este ejercicio te prepara para containerizar flujos más complejos de ML y desplegarlos en Kubernetes.

Pistas
  • Recuerda que el archivo requirements.txt debe listar scikit-learn y pandas con versiones específicas si es necesario, por ejemplo: scikit-learn==1.0.2.
  • Si encuentras un error al construir la imagen, verifica que todos los archivos (Dockerfile, requirements.txt, train_model.py) estén en el mismo directorio desde donde ejecutas docker build.
  • Para ver los logs del contenedor si falla, usa docker logs después de ejecutarlo, o añade prints en tu script para depurar.

Evalua tu comprension

Completa el quiz interactivo de arriba para ganar XP.

Sigue con Containerización y Despliegue de Modelos de ML con Docker y Kubernetes

Esta lección forma parte de un curso de Cursalo. Revisa su programa y elige entre la compra individual o el acceso a toda la escuela.

Si ya tenías acceso a este curso, entra con tu cuenta: tus derechos y tu progreso se conservan. No necesitas comprarlo de nuevo.

01 / ELEGIR UNA RUTA

El próximo paso

Aprende IA mientras construyes algo que sí necesitas.

Empieza por el curso inicial o explora el catálogo para encontrar una práctica alineada con tu trabajo.