CI/CD y DevOps

📐 Fundamento

Ramas (branches):

main ─────────────────────────────────────────── ▶ producción
        │                              │
        └── feature/login ─ PR ──────── merge
               │
               └── commit1 ─ commit2 ─ commit3

Comandos de flujo diario:

# 1. Actualizar main antes de empezar
git checkout main
git pull origin main

# 2. Crear rama de feature
git checkout -b feature/agregar-pago-tarjeta

# 3. Trabajar (commits frecuentes, mensajes claros)
git add src/pagos.py tests/test_pagos.py
git commit -m "feat: agregar soporte para pago con tarjeta de crédito"

# 4. Subir la rama
git push origin feature/agregar-pago-tarjeta

# 5. Abrir Pull Request en GitHub
# 6. Peer review + CI automático
# 7. Merge a main
# 8. Borrar la rama
git branch -d feature/agregar-pago-tarjeta

Convención de mensajes de commit (Conventional Commits):

tipo(scope): descripción breve

Ejemplos:

• feat(pedidos): implementar envío en tiempo real a cocina
• fix(auth): corregir sesión que no expiraba en móviles
• test(fiscal): agregar casos límite para cálculo de IVA

Pull Requests — buenas prácticas:

• Una PR = una funcionalidad o fix. No mezclar.
• PRs pequeñas (< 400 líneas de cambios). Fáciles de revisar.
• Descripción clara: qué cambiaste y por qué.
• Ligar a la historia de usuario correspondiente.
• Al menos un revisor aprueba antes de mergear.

📐 Fundamento

GitHub Actions — CI integrado en GitHub:

Se configura en archivos YAML en .github/workflows/.

Pipeline CI básico para La Esquina:

# .github/workflows/ci.yml
name: CI — Tests y Linting

on:
  push:
    branches: [ main, "feature/*" ]
  pull_request:
    branches: [ main ]

jobs:
  test:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout código
        uses: actions/checkout@v4

      - name: Configurar Python 3.11
        uses: actions/setup-python@v4
        with:
          python-version: "3.11"

      - name: Instalar dependencias
        run: |
          pip install -r requirements.txt
          pip install pytest pytest-cov

      - name: Linting con flake8
        run: flake8 src/ tests/

      - name: Ejecutar pruebas con cobertura
        run: |
          pytest --cov=src --cov-fail-under=80

      - name: Publicar reporte de cobertura
        uses: codecov/codecov-action@v3

--cov-fail-under=80: Si la cobertura baja del 80%, el CI falla. Esto previene que se agregue código sin pruebas.

Pasos típicos de un pipeline CI:

1. Checkout del código
2. Setup del entorno (lenguaje, versión)
3. Instalar dependencias (pip install, npm install)
4. Lint (verificar estilo de código)
5. Pruebas unitarias
6. Pruebas de integración (si aplica)
7. Análisis de cobertura
8. (Opcional) Análisis de seguridad (bandit, snyk)
9. (Opcional) Análisis de deuda técnica (SonarQube)

📐 Fundamento

Pipeline CD básico:

# .github/workflows/deploy.yml (se ejecuta solo en main)
name: CD — Deploy a Producción

on:
  push:
    branches: [ main ]

jobs:
  deploy:
    needs: test  # solo si el job 'test' del CI pasó
    runs-on: ubuntu-latest
    environment: production  # requiere aprobación manual en GitHub

    steps:
      - uses: actions/checkout@v4

      - name: Build imagen Docker
        run: docker build -t laesquina-backend:${{ github.sha }} .

      - name: Push a Registry
        run: |
          echo <span class="katex"><span class="katex-mathml"><math xmlns="http://www.w3.org/1998/Math/MathML"><semantics><mrow><mrow><mi>s</mi><mi>e</mi><mi>c</mi><mi>r</mi><mi>e</mi><mi>t</mi><mi>s</mi><mi mathvariant="normal">.</mi><mi>R</mi><mi>E</mi><mi>G</mi><mi>I</mi><mi>S</mi><mi>T</mi><mi>R</mi><msub><mi>Y</mi><mi>P</mi></msub><mi>A</mi><mi>S</mi><mi>S</mi><mi>W</mi><mi>O</mi><mi>R</mi><mi>D</mi></mrow><mi mathvariant="normal">∣</mi><mi>d</mi><mi>o</mi><mi>c</mi><mi>k</mi><mi>e</mi><mi>r</mi><mi>l</mi><mi>o</mi><mi>g</mi><mi>i</mi><mi>n</mi><mo>−</mo><mi>u</mi></mrow><annotation encoding="application/x-tex">{{ secrets.REGISTRY_PASSWORD }} | docker login -u </annotation></semantics></math></span><span class="katex-html" aria-hidden="true"><span class="base"><span class="strut" style="height:1em;vertical-align:-0.25em;"></span><span class="mord"><span class="mord"><span class="mord mathnormal" style="margin-right:0.0278em;">secr</span><span class="mord mathnormal">e</span><span class="mord mathnormal">t</span><span class="mord mathnormal">s</span><span class="mord">.</span><span class="mord mathnormal" style="margin-right:0.0077em;">R</span><span class="mord mathnormal" style="margin-right:0.0576em;">E</span><span class="mord mathnormal">G</span><span class="mord mathnormal" style="margin-right:0.0785em;">I</span><span class="mord mathnormal" style="margin-right:0.0576em;">S</span><span class="mord mathnormal" style="margin-right:0.1389em;">T</span><span class="mord mathnormal" style="margin-right:0.0077em;">R</span><span class="mord"><span class="mord mathnormal" style="margin-right:0.2222em;">Y</span><span class="msupsub"><span class="vlist-t vlist-t2"><span class="vlist-r"><span class="vlist" style="height:0.3283em;"><span style="top:-2.55em;margin-left:-0.2222em;margin-right:0.05em;"><span class="pstrut" style="height:2.7em;"></span><span class="sizing reset-size6 size3 mtight"><span class="mord mathnormal mtight" style="margin-right:0.1389em;">P</span></span></span></span><span class="vlist-s">​</span></span><span class="vlist-r"><span class="vlist" style="height:0.15em;"><span></span></span></span></span></span></span><span class="mord mathnormal">A</span><span class="mord mathnormal" style="margin-right:0.0576em;">S</span><span class="mord mathnormal" style="margin-right:0.0576em;">S</span><span class="mord mathnormal" style="margin-right:0.1389em;">W</span><span class="mord mathnormal" style="margin-right:0.0278em;">O</span><span class="mord mathnormal" style="margin-right:0.0077em;">R</span><span class="mord mathnormal" style="margin-right:0.0278em;">D</span></span></span><span class="mord">∣</span><span class="mord mathnormal">d</span><span class="mord mathnormal">oc</span><span class="mord mathnormal" style="margin-right:0.0315em;">k</span><span class="mord mathnormal" style="margin-right:0.0278em;">er</span><span class="mord mathnormal" style="margin-right:0.0197em;">l</span><span class="mord mathnormal">o</span><span class="mord mathnormal" style="margin-right:0.0359em;">g</span><span class="mord mathnormal">in</span><span class="mspace" style="margin-right:0.2222em;"></span><span class="mbin">−</span><span class="mspace" style="margin-right:0.2222em;"></span></span><span class="base"><span class="strut" style="height:0.4306em;"></span><span class="mord mathnormal">u</span></span></span></span>{{ secrets.REGISTRY_USER }} --password-stdin
          docker push laesquina-backend:${{ github.sha }}

      - name: Deploy al servidor
        uses: appleboy/ssh-action@master
        with:
          host: ${{ secrets.SERVER_HOST }}
          username: ${{ secrets.SERVER_USER }}
          key: ${{ secrets.SSH_KEY }}
          script: |
            docker pull laesquina-backend:${{ github.sha }}
            docker stop laesquina-backend || true
            docker run -d --name laesquina-backend \
              -p 8000:8000 \
              --env-file /etc/laesquina/.env \
              laesquina-backend:${{ github.sha }}

Secrets en GitHub: Las credenciales (contraseñas, SSH keys) se guardan en Settings → Secrets, nunca en el código.

Estrategias de deploy:

📐 Fundamento

Conceptos clave:

• Imagen: Plantilla inmutable que define el contenido del contenedor. Se construye desde un Dockerfile.
• Contenedor: Instancia en ejecución de una imagen. Es efímero (se puede crear y destruir).
• Registry: Repositorio de imágenes (Docker Hub, GitHub Container Registry).
• Docker Compose: Herramienta para definir y correr múltiples contenedores juntos (ej: backend + BD + Redis).

Dockerfile para La Esquina (Python/FastAPI):

# Dockerfile
FROM python:3.11-slim

# Directorio de trabajo dentro del contenedor
WORKDIR /app

# Instalar dependencias primero (aprovecha el caché de Docker)
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# Copiar el código
COPY src/ ./src/

# Variable de entorno para el modo de producción
ENV ENVIRONMENT=production

# Puerto que expone el contenedor
EXPOSE 8000

# Comando para iniciar la aplicación
CMD ["uvicorn", "src.main:app", "--host", "0.0.0.0", "--port", "8000"]

docker-compose.yml para desarrollo:

# docker-compose.yml
version: "3.8"

services:
  backend:
    build: .
    ports:
      - "8000:8000"
    environment:
      - DATABASE_URL=mysql://laesquina:password@db:3306/laesquina
    depends_on:
      - db
    volumes:
      - ./src:/app/src  # hot reload en desarrollo

  db:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=rootpassword
      - MYSQL_DATABASE=laesquina
      - MYSQL_USER=laesquina
      - MYSQL_PASSWORD=password
    volumes:
      - mysql_data:/var/lib/mysql

volumes:
  mysql_data:

Comandos básicos:

# Construir imagen
docker build -t laesquina .

# Correr contenedor
docker run -p 8000:8000 laesquina

# Con Docker Compose (levanta backend + BD juntos)
docker compose up        # foreground
docker compose up -d     # background (daemon)
docker compose down      # parar y eliminar contenedores
docker compose logs -f   # ver logs en tiempo real

📐 Fundamento

Los tres caminos de DevOps (Gene Kim):

1. Flow: Maximizar el flujo de trabajo de izquierda a derecha (Dev → Ops → Cliente). Eliminar cuellos de botella.
2. Feedback: Crear loops de retroalimentación rápidos de derecha a izquierda (monitoreo → alerta → corrección).
3. Continual Learning: Experimentación, aprendizaje de fallos, mejora continua.

Prácticas DevOps:

Métricas DORA (DevOps Research and Assessment):

Las cuatro métricas que predicen la performance de equipos de alto rendimiento:

(Informe State of DevOps 2023 — Google Cloud / DORA)