🐳 Cómo construir un Dockerfile básico para Flask 🚀

Jorge Garcia — Fri, 05 Sep 2025 15:30:00 +0000

Cuando empiezas con Docker y Flask, lo más útil es aprender los pasos esenciales para levantar tu aplicación en un contenedor. Aquí te muestro cómo hacerlo, sin complicaciones, y listo para correr con Gunicorn.

Paso 1 — Imagen base ligera

Usa una versión oficial de Python, preferiblemente slim para que la imagen sea más pequeña.

FROM python:3.11-slim

💡 Esto te da un entorno limpio y mantenido oficialmente.

Paso 2 — Directorio de trabajo

Define dónde se ejecutará tu app dentro del contenedor.

WORKDIR /app

Paso 3 — Dependencias

Primero copiamos solo requirements.txt para aprovechar la caché de Docker, luego las instalamos:

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

Paso 4 — Copiar tu aplicación

Ahora sí, copia el resto de tu código al contenedor.

COPY . .

Paso 5 — Exponer el puerto

Esto le dice a Docker en qué puerto escuchará tu app.

EXPOSE 5000

Paso 6 — Arranque con Gunicorn

Para producción, nunca uses flask run. Gunicorn es más estable.

CMD ["gunicorn", "--bind", "0.0.0.0:5000", "app:app"]

💡 app:app asume que tu archivo principal se llama app.py y contiene app = Flask(__name__).

Bonus: Versionando tu aplicación

Para mantener control de versiones y despliegues:

# Build con versión
docker build -t flask-app:v1.0.0 .

# Tag adicional
docker tag flask-app:v1.0.0 flask-app:latest

Esto te permite versionar releases y mantener la imagen actualizada sin romper tu entorno de producción.

🔑 Conclusión

Con estos 6 pasos básicos puedes:

Construir tu Dockerfile de forma clara
Levantar tu app Flask en contenedor
Versionar la aplicación con tags
Prepararla para producción de manera sencilla

Cómo desplegar tu primera aplicación Docker en Railway (y evitar problemas con variables de entorno)

Jorge Garcia — Mon, 01 Sep 2025 17:14:50 +0000

Subir tu primera app a producción puede ser un dolor de cabeza, sobre todo cuando tu contenedor se cae al arrancar. 😅

Después de investigar, descubrí que el problema más común era simple pero crítico: no configurar las variables de entorno antes del deploy.

Aquí te comparto un flujo general para cualquier aplicación Docker, sin importar el lenguaje o framework:

1️⃣ Crear un proyecto vacío en Railway

Lo primero es iniciar con un proyecto limpio, así evitas conflictos con configuraciones anteriores.

Ingresa a Railway
y haz clic en New Project → Start from Scratch.

Esto crea un proyecto vacío listo para agregar tu servicio.

2️⃣ Agregar un nuevo servicio desde GitHub

Ahora conectamos nuestro repositorio para que Railway pueda construir la APP:

Haz clic en Add Service → Deploy from GitHub Repo.

Selecciona el repositorio de tu proyecto.

Nota: Asegúrate de que tu repositorio tenga un Dockerfile listo, con todos los pasos para instalar dependencias y correr la APP.

3️⃣ Configurar las variables de entorno

Este fue el punto crítico que me causó problemas:

Antes de hacer deploy, entra al proyecto y ve a la pestaña Variables.

Agrega todas las variables que tu app necesita, como FLASK_ENV, DATABASE_URL, SECRET_KEY, etc.

# Ejemplo de variables de entorno
FLASK_ENV=production
DATABASE_URL=postgresql://user:password@host:port/dbname
SECRET_KEY=mi_super_secreto

Sin estas variables, tu contenedor se construye, pero la APP no puede arrancar correctamente.

4️⃣ Hacer deploy

Con las variables configuradas, ahora sí:

Haz clic en Deploy.

Espera a que Railway construya la imagen y levante el contenedor.

Tu app debería estar corriendo correctamente y accesible desde la URL que Railway proporciona. 🐳

Moraleja

💡 Nunca subestimes las variables de entorno… o tu app te lo hará saber a gritos 😅

Consejos adicionales:

Mantén secretos y credenciales fuera del repositorio.

Usa docker-compose si tu app depende de otros servicios como PostgreSQL o Redis.

Revisa los logs de Railway para debugging rápido (railway logs).

Pregunta para ti

¿Tienes algún flujo favorito para desplegar tus BackEnd? Comparte tu experiencia en los comentarios, ¡me encantaría aprender de otros desarrolladores!

DEV Community: Jorge Garcia

🐳 Cómo construir un Dockerfile básico para Flask 🚀

Cómo desplegar tu primera aplicación Docker en Railway (y evitar problemas con variables de entorno)