🐳 Hello Docker

Mini aplicación web en Python + Streamlit creada para aprender Docker paso a paso.

🎯 Objetivo del ejercicio

Con este proyecto aprenderás a:

✅ Ejecutar una aplicación web en Python en local
✅ Crear tu propio Dockerfile
✅ Construir una imagen Docker
✅ Ejecutar un contenedor
✅ Etiquetar tu imagen para Docker Hub
✅ Subir tu imagen a Docker Hub
✅ Ejecutar la app desde Docker Hub

🌿 Ramas del repositorio

Este repositorio contiene dos ramas con objetivos distintos:

🔹 Rama `main` (ejercicio para realizarlo)

Es la rama que deben clonar para realizar el ejercicio
Contiene la aplicación en Python + Streamlit
Presentación Docker en PDF
NO incluye Dockerfile
El objetivo es que el alumno:
- cree su propio Dockerfile
- construya la imagen Docker
- ejecute el contenedor
- trabaje con volúmenes
- suba su imagen a Docker Hub

👉 Esta es la rama que se debe usar para realizar el ejercicio.

🔹 Rama `docker_solution` (solución completa)

Contiene el proyecto completamente terminado
Incluye:
- Dockerfile
- proyecto listo para ejecutarse
- guía de instalación de Docker Desktop
Pensada como referencia o solución final

👉 Para acceder a esta rama:

git checkout docker_solution

📁 Estructura del proyecto

hello_docker/
│
├── app.py              # Aplicación Streamlit
├── requirements.txt    # Dependencias Python
├── Dockerfile          # Instrucciones para Docker
└── README.md          # Este archivo

🚀 PARTE 1: Ejecutar la aplicación en local

Antes de dockerizar, vamos a probar que todo funciona correctamente.

1️⃣ Crear entorno virtual

python -m venv venv

2️⃣ Activar el entorno virtual

Windows:

venv\Scripts\activate

Mac / Linux:

source venv/bin/activate

3️⃣ Instalar dependencias

pip install -r requirements.txt

4️⃣ Ejecutar la aplicación

streamlit run app.py

🎉 La aplicación debería abrirse automáticamente en http://localhost:8501

🐳 PARTE 2: Dockerizar la aplicación

Ahora vamos a crear un contenedor Docker para que la aplicación pueda ejecutarse en cualquier lugar.

📝 Paso 1: Crear el Dockerfile

Crea un archivo llamado Dockerfile (sin extensión) en la raíz del proyecto y añade el siguiente contenido:

# Imagen base de Python
FROM python:3.11-slim

# Establecer directorio de trabajo dentro del contenedor
WORKDIR /app

# Copiar el archivo de dependencias
COPY requirements.txt .

# Instalar las dependencias
RUN pip install --no-cache-dir -r requirements.txt

# Copiar el código de la aplicación
COPY app.py .

# Exponer el puerto 8501 (puerto por defecto de Streamlit)
EXPOSE 8501

# Comando para ejecutar la aplicación
CMD ["streamlit", "run", "app.py", "--server.address=0.0.0.0"]

🔍 ¿Qué hace cada línea?

FROM python:3.11-slim → Usa una imagen ligera de Python 3.11
WORKDIR /app → Crea y establece /app como directorio de trabajo
COPY requirements.txt . → Copia el archivo de dependencias al contenedor
RUN pip install... → Instala las dependencias de Python
COPY app.py . → Copia el código de la aplicación
EXPOSE 8501 → Indica que el contenedor escucha en el puerto 8501
CMD [...] → Comando que se ejecuta al iniciar el contenedor

🏗️ Paso 2: Construir la imagen Docker

Abre una terminal en la carpeta del proyecto y ejecuta:

docker build -t hello_docker .

¿Qué hace este comando?

docker build → Construye una imagen Docker
-t hello_docker → Asigna un nombre (tag) a la imagen
. → Indica que el Dockerfile está en el directorio actual

▶️ Paso 3: Ejecutar el contenedor

Una vez construida la imagen, ejecuta:

docker run -p 8501:8501 hello_docker

¿Qué hace este comando?

docker run → Ejecuta un contenedor desde una imagen
-p 8501:8501 → Mapea el puerto 8501 del contenedor al puerto 8501 de tu máquina
hello_docker → Nombre de la imagen a ejecutar

🎉 Abre tu navegador en http://localhost:8501 y verás tu aplicación corriendo en Docker.

💾 PARTE 2.5: Persistencia de datos con volúmenes (MUY IMPORTANTE)

Nuestra aplicación guarda los nombres introducidos por el usuario en un archivo:

data/nombres.txt

Este archivo se crea automáticamente cuando ejecutas la app por primera vez.

❌ Ejecutar el contenedor SIN volumen (los datos se pierden)

Ejecuta el contenedor de forma normal:

docker run -p 8501:8501 hello_docker

Escribe varios nombres en la aplicación
Verás que aparecen en la tabla
Detén y elimina el contenedor:

docker ps
docker rm -f

Vuelve a ejecutar el contenedor:

docker run -p 8501:8501 hello_docker

❌ Resultado: Los nombres se han perdido.

🧠 ¿Por qué? Los datos estaban dentro del contenedor, y los contenedores son temporales.

✅ Ejecutar el contenedor CON volumen (los datos se conservan)

Ahora ejecuta el contenedor usando un volumen Docker:

docker run -p 8501:8501 -v datos_app:/app/data hello_docker

¿Qué hace este comando?

-v datos_app:/app/data → Crea un volumen llamado datos_app y lo monta en /app/data del contenedor

Prueba:

Escribe varios nombres en la aplicación
Verás que aparecen en la tabla
Detén y elimina el contenedor:

docker ps
docker rm -f

Vuelve a ejecutar el contenedor con el mismo comando:

docker run -p 8501:8501 -v datos_app:/app/data hello_docker

✅ Resultado: Los nombres siguen apareciendo.

🧠 Explicación: El volumen datos_app guarda los datos fuera del contenedor, por eso no se pierden.

🛠️ Comandos útiles para volúmenes

# Ver todos los volúmenes
docker volume ls

# Ver detalles de un volumen específico
docker volume inspect datos_app

# Eliminar un volumen (CUIDADO: borra todos los datos)
docker volume rm datos_app

# Eliminar todos los volúmenes no usados
docker volume prune

💡 Importante: Si eliminas el volumen con docker volume rm datos_app, perderás todos los datos guardados.

🌍 PARTE 3: Subir tu imagen a Docker Hub

Para compartir tu imagen con otros o ejecutarla en cualquier máquina, necesitas subirla a Docker Hub.

Paso 0: Crear cuenta en Docker Hub (si no la tienes)

Ve a hub.docker.com
Crea una cuenta gratuita
Anota tu nombre de usuario (lo necesitarás en los siguientes pasos)

1️⃣ Iniciar sesión en Docker Hub

docker login

Introduce tu usuario y contraseña de Docker Hub.

2️⃣ Etiquetar la imagen con tu usuario y versión

Antes de subir la imagen, necesitas etiquetarla con tu nombre de usuario de Docker Hub y una versión:

docker tag hello_docker TU_USUARIO/hello_docker:v1.0
docker tag hello_docker TU_USUARIO/hello_docker:latest

Ejemplos:

Si tu usuario es gema:

  docker tag hello_docker gema/hello_docker:v1.0
  docker tag hello_docker gema/hello_docker:latest

Si tu usuario es juan123:

  docker tag hello_docker juan123/hello_docker:v1.0
  docker tag hello_docker juan123/hello_docker:latest

🔍 ¿Por qué hacer esto?

Usuario: Docker Hub organiza las imágenes por usuario (como GitHub con los repositorios). El formato es: usuario/nombre-imagen:version
Versión (v1.0): Identifica versiones específicas de tu aplicación. Útil para mantener diferentes releases.
Tag latest: Apunta siempre a la versión más reciente. Es la que se descarga por defecto si no especificas versión.

💡 Buena práctica: Siempre etiqueta con una versión específica (v1.0, v2.0) Y con latest. Así los usuarios pueden elegir una versión concreta o usar siempre la última.

3️⃣ Subir las imágenes

docker push TU_USUARIO/hello_docker:v1.0
docker push TU_USUARIO/hello_docker:latest

Ejemplo:

docker push gema/hello_docker:v1.0
docker push gema/hello_docker:latest

✅ Tu imagen ya está disponible públicamente en Docker Hub con ambas etiquetas.

⬇️ PARTE 4: Ejecutar la app desde Docker Hub

Cualquier persona puede ejecutar tu aplicación de estas formas:

Usando la versión específica:

docker run -p 8501:8501 -v datos_app:/app/data TU_USUARIO/hello_docker:v1.0

Usando la última versión (latest):

docker run -p 8501:8501 -v datos_app:/app/data TU_USUARIO/hello_docker:latest

Sin especificar versión (descarga latest por defecto):

docker run -p 8501:8501 -v datos_app:/app/data TU_USUARIO/hello_docker

Ejemplo:

docker run -p 8501:8501 -v datos_app:/app/data gema/hello_docker:v1.0

Docker descargará automáticamente la imagen desde Docker Hub y la ejecutará.

💡 Tip: Si haces cambios en tu app y quieres subir una nueva versión, cambia el número de versión (ej: v2.0) y repite los pasos de etiquetado y push.

🛠️ Comandos útiles de Docker

# Ver imágenes locales
docker images

# Ver contenedores en ejecución
docker ps

# Ver todos los contenedores (incluyendo detenidos)
docker ps -a

# Detener un contenedor
docker stop <container_id>

# Eliminar un contenedor
docker rm <container_id>

# Eliminar una imagen
docker rmi <image_name>

# Ver logs de un contenedor
docker logs <container_id>

# Ejecutar contenedor en segundo plano (detached mode)
docker run -d -p 8501:8501 hello_docker

📊 Resumen del flujo completo

1. Crear Dockerfile
   ↓
2. docker build -t hello_docker .
   ↓
3. docker run -p 8501:8501 -v datos_app:/app/data hello_docker
   ↓
4. docker login
   ↓
5. docker tag hello_docker TU_USUARIO/hello_docker:v1.0
   docker tag hello_docker TU_USUARIO/hello_docker:latest
   ↓
6. docker push TU_USUARIO/hello_docker:v1.0
   docker push TU_USUARIO/hello_docker:latest
   ↓
7. Cualquiera puede ejecutar: 
   docker run -p 8501:8501 -v datos_app:/app/data TU_USUARIO/hello_docker:v1.0
   o
   docker run -p 8501:8501 -v datos_app:/app/data TU_USUARIO/hello_docker

❓ Preguntas frecuentes

¿Qué es Docker?

Docker es una plataforma que permite empaquetar aplicaciones y sus dependencias en contenedores, asegurando que funcionen igual en cualquier entorno.

¿Qué es una imagen Docker?

Es una plantilla de solo lectura que contiene todo lo necesario para ejecutar una aplicación (código, dependencias, configuración).

¿Qué es un contenedor Docker?

Es una instancia en ejecución de una imagen Docker. Es ligero, aislado y portable.

¿Por qué necesito etiquetar mi imagen antes de subirla?

Docker Hub organiza las imágenes por usuario. Al etiquetar con usuario/nombre, Docker sabe a qué cuenta pertenece la imagen.

¿Puedo tener varias versiones de la misma imagen?

Sí, puedes usar tags adicionales:

docker tag hello_docker gema/hello_docker:v1.0
docker tag hello_docker gema/hello_docker:latest

¿Por qué usar Docker?

✅ Mismo entorno en desarrollo, testing y producción
✅ Fácil distribución de aplicaciones
✅ Aislamiento entre aplicaciones
✅ Escalabilidad y eficiencia

📚 Recursos adicionales

💡 Consejos para principiantes

¿Error al construir? → Asegúrate de estar en la carpeta correcta (donde está el Dockerfile)
¿Puerto ocupado? → Cambia el puerto: docker run -p 8502:8501 hello_docker
¿Cambios no se reflejan? → Reconstruye la imagen: docker build -t hello_docker .
¿Contenedor no se detiene? → Usa Ctrl+C o docker stop <container_id>
¿Olvidaste tu container_id? → Usa docker ps para verlo

💪 ¡Enhorabuena!

Si has llegado hasta aquí, ya sabes cómo dockerizar una aplicación Python. Este conocimiento es fundamental en el desarrollo de software moderno.

Proyecto realizado por Gema Yébenes con ❤️ para aprender Docker

Name		Name	Last commit message	Last commit date
Latest commit History 9 Commits
docs		docs
.gitignore		.gitignore
README.md		README.md
app.py		app.py
requirements.txt		requirements.txt

gemayc/hello_docker

Folders and files

Latest commit

History

Repository files navigation

🐳 Hello Docker

🎯 Objetivo del ejercicio

🌿 Ramas del repositorio

🔹 Rama main (ejercicio para realizarlo)

🔹 Rama docker_solution (solución completa)

📁 Estructura del proyecto

🚀 PARTE 1: Ejecutar la aplicación en local

1️⃣ Crear entorno virtual

2️⃣ Activar el entorno virtual

3️⃣ Instalar dependencias

4️⃣ Ejecutar la aplicación

🐳 PARTE 2: Dockerizar la aplicación

📝 Paso 1: Crear el Dockerfile

🔍 ¿Qué hace cada línea?

🏗️ Paso 2: Construir la imagen Docker

¿Qué hace este comando?

▶️ Paso 3: Ejecutar el contenedor

¿Qué hace este comando?

💾 PARTE 2.5: Persistencia de datos con volúmenes (MUY IMPORTANTE)

❌ Ejecutar el contenedor SIN volumen (los datos se pierden)

✅ Ejecutar el contenedor CON volumen (los datos se conservan)

¿Qué hace este comando?

🛠️ Comandos útiles para volúmenes

🌍 PARTE 3: Subir tu imagen a Docker Hub

Paso 0: Crear cuenta en Docker Hub (si no la tienes)

1️⃣ Iniciar sesión en Docker Hub

2️⃣ Etiquetar la imagen con tu usuario y versión

🔍 ¿Por qué hacer esto?

3️⃣ Subir las imágenes

⬇️ PARTE 4: Ejecutar la app desde Docker Hub

🛠️ Comandos útiles de Docker

📊 Resumen del flujo completo

❓ Preguntas frecuentes

¿Qué es Docker?

¿Qué es una imagen Docker?

¿Qué es un contenedor Docker?

¿Por qué necesito etiquetar mi imagen antes de subirla?

¿Puedo tener varias versiones de la misma imagen?

¿Por qué usar Docker?

📚 Recursos adicionales

💡 Consejos para principiantes

💪 ¡Enhorabuena!

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

🔹 Rama `main` (ejercicio para realizarlo)

🔹 Rama `docker_solution` (solución completa)

Packages