Coolify Python Deployment

Despliegue de Proyectos Python en Coolify desde GitHub

Esta guía detalla cómo configurar y desplegar una aplicación Python en Coolify extrayendo el código directamente desde un repositorio de GitHub.

1. Requisitos Previos

• Tener Coolify instalado y accesible.
• Un repositorio en GitHub con tu proyecto Python.
• Un archivo de dependencias en la raíz: requirements.txt, pyproject.toml (Poetry) o setup.py.

2. Despliegue con Nixpacks (Recomendado)

Nixpacks es el constructor por defecto en Coolify. Detecta automáticamente Python e instala las dependencias.

Pasos:

1. Crear Recurso: En Coolify, ve a tu Proyecto -> Add New Resource -> Git Repository.
2. Conectar GitHub: Selecciona tu cuenta de GitHub y el repositorio deseado.
3. Build Pack: Asegúrate de que Nixpacks esté seleccionado (es el predeterminado).
4. Configurar Puerto: En la sección de Network, define el puerto en el que escucha tu app (ej. 8000 para FastAPI/Uvicorn).
5. Comandos Personalizados:
   • Si necesitas un comando de inicio específico, edita el campo Start Command.
   • Ejemplo: uvicorn main:app --host 0.0.0.0 --port $PORT

3. Despliegue con Dockerfile (Control Total)

Si tienes una configuración compleja, usa un Dockerfile en la raíz de tu repo.

Ejemplo de Dockerfile base:

FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
EXPOSE 8000
CMD ["python", "run.py"]

Pasos:

1. Al crear el recurso, elige Dockerfile como Build Pack.
2. Coolify leerá automáticamente el archivo Dockerfile de tu repositorio.

4. Variables de Envorno

Puedes configurar variables de entorno (.env) directamente en la pestaña Environment Variables del recurso en Coolify.

• Copia y pega el contenido de tu .env local.
• Asegúrate de marcar aquellas que sean sensibles como "Secret".

5. Solución de Problemas (Troubleshooting)

• Puerto Incorrecto: El error más común es que el puerto configurado en Coolify no coincida con el puerto en el que la aplicación escucha dentro del contenedor.
• Dependencias de Sistema: Si tu proyecto necesita librerías de sistema (ej. libpq-dev para PostgreSQL), Nixpacks suele detectarlo, pero en un Dockerfile deberás instalarlas manualmente vía apt-get.
• Poetry: Si usas Poetry, Nixpacks lo soporta, pero a veces es más robusto generar un requirements.txt antes de subir el código.