@qubiit/lmagent 2.5.0

package/skills/devops-engineer/references/ci-cd-patterns.md

@@ -0,0 +1,265 @@
+# CI/CD Patterns Reference — DevOps Engineer
+
+> Patrones y mejores prácticas de CI/CD para GitHub Actions y pipelines de despliegue.
+
+## Pipeline Estándar
+
+```
+┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐   ┌──────────┐
+│  COMMIT  │──▶│   LINT   │──▶│   TEST   │──▶│  BUILD   │──▶│  DEPLOY  │
+└──────────┘   └──────────┘   └──────────┘   └──────────┘   └──────────┘
+                                                               │
+                                               ┌───────────────┤
+                                               ▼               ▼
+                                          ┌────────┐     ┌────────┐
+                                          │STAGING │     │  PROD  │
+                                          └────────┘     └────────┘
+```
+
+## GitHub Actions: Patrones Recomendados
+
+### 1. CI Básico (Pull Request)
+
+```yaml
+# .github/workflows/ci.yml
+name: CI
+
+on:
+  pull_request:
+    branches: [main, dev]
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: "pip"
+      - run: pip install ruff mypy
+      - run: ruff check .
+      - run: mypy .
+
+  test:
+    runs-on: ubuntu-latest
+    needs: lint
+    services:
+      postgres:
+        image: postgres:16
+        env:
+          POSTGRES_DB: test_db
+          POSTGRES_USER: test_user
+          POSTGRES_PASSWORD: test_pass
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: "pip"
+      - run: pip install -r requirements-dev.txt
+      - run: pytest --cov --cov-report=xml
+        env:
+          DATABASE_URL: postgresql://test_user:test_pass@localhost:5432/test_db
+      - uses: codecov/codecov-action@v4
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+      - uses: docker/setup-buildx-action@v3
+      - uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: false
+          tags: app:${{ github.sha }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+```
+
+### 2. CD con Deploy Automático
+
+```yaml
+# .github/workflows/deploy.yml
+name: Deploy
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+
+jobs:
+  deploy-staging:
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    environment: staging
+    steps:
+      - uses: actions/checkout@v4
+      - name: Deploy to Staging
+        run: |
+          echo "Deploying to staging..."
+          # ssh, docker compose, or cloud CLI
+
+  deploy-production:
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    environment: production
+    needs: deploy-staging
+    steps:
+      - uses: actions/checkout@v4
+      - name: Deploy to Production
+        run: |
+          echo "Deploying to production..."
+```
+
+## Docker: Mejores Prácticas
+
+### Dockerfile Multi-Stage Optimizado
+
+```dockerfile
+# Stage 1: Builder
+FROM python:3.12-slim AS builder
+
+WORKDIR /app
+RUN pip install --no-cache-dir --upgrade pip
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir --user -r requirements.txt
+
+# Stage 2: Runtime
+FROM python:3.12-slim
+
+# Security: non-root user
+RUN groupadd -r appuser && useradd -r -g appuser appuser
+
+WORKDIR /app
+COPY --from=builder /root/.local /root/.local
+COPY . .
+
+# Security: set ownership
+RUN chown -R appuser:appuser /app
+USER appuser
+
+ENV PATH=/root/.local/bin:$PATH
+ENV PYTHONUNBUFFERED=1
+ENV PYTHONDONTWRITEBYTECODE=1
+
+EXPOSE 8000
+
+HEALTHCHECK --interval=30s --timeout=5s --retries=3 \
+  CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')"
+
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
+```
+
+### Docker Compose para Desarrollo
+
+```yaml
+# docker-compose.yml
+services:
+  api:
+    build:
+      context: ./backend
+      dockerfile: Dockerfile
+    ports:
+      - "${API_PORT:-8000}:8000"
+    env_file: .env
+    depends_on:
+      db:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+    volumes:
+      - ./backend:/app  # Hot reload
+    restart: unless-stopped
+
+  frontend:
+    build:
+      context: ./frontend
+      dockerfile: Dockerfile
+    ports:
+      - "${FRONTEND_PORT:-3000}:3000"
+    env_file: .env
+    depends_on:
+      - api
+    restart: unless-stopped
+
+  db:
+    image: postgres:16-alpine
+    environment:
+      POSTGRES_DB: ${DB_NAME}
+      POSTGRES_USER: ${DB_USER}
+      POSTGRES_PASSWORD: ${DB_PASSWORD}
+    ports:
+      - "${DB_PORT:-5432}:5432"
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${DB_USER}"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    restart: unless-stopped
+
+  redis:
+    image: redis:7-alpine
+    ports:
+      - "${REDIS_PORT:-6379}:6379"
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    restart: unless-stopped
+
+volumes:
+  pgdata:
+```
+
+## Rollback Strategy
+
+### Rolling Update (Kubernetes)
+
+```yaml
+spec:
+  strategy:
+    type: RollingUpdate
+    rollingUpdate:
+      maxSurge: 1
+      maxUnavailable: 0
+```
+
+### Blue-Green (Docker Compose)
+
+```bash
+# Deploy new version alongside old
+docker compose -f docker-compose.prod.yml up -d --no-deps --build api-new
+# Test new version
+curl http://localhost:8001/health
+# Switch traffic (update nginx upstream)
+# Remove old version
+docker compose -f docker-compose.prod.yml stop api-old
+```
+
+## Checklist Pre-Deploy
+
+- [ ] Tests passing en CI
+- [ ] Docker build exitoso
+- [ ] Environment variables configuradas
+- [ ] Database migrations preparadas
+- [ ] Rollback plan documentado
+- [ ] Monitoring/alertas configuradas
+- [ ] Health check endpoint funcional
+- [ ] Backup de DB antes de migración destructiva

package/skills/devops-engineer/scripts/docker_healthcheck.py

@@ -0,0 +1,125 @@
+#!/usr/bin/env python3
+"""
+LMAgent - Docker Healthcheck Script
+Verifica la salud de servicios Docker: API, DB, Redis.
+
+Uso:
+    python docker_healthcheck.py --service api --url http://localhost:8000/health
+    python docker_healthcheck.py --service postgres --host localhost --port 5432
+    python docker_healthcheck.py --service redis --host localhost --port 6379
+    python docker_healthcheck.py --all
+"""
+
+import argparse
+import json
+import socket
+import subprocess
+import sys
+import urllib.request
+from datetime import datetime
+
+
+def check_http(url: str, timeout: int = 5) -> dict:
+    """Verifica un endpoint HTTP."""
+    try:
+        req = urllib.request.Request(url, method="GET")
+        with urllib.request.urlopen(req, timeout=timeout) as resp:
+            body = resp.read().decode()
+            return {
+                "status": "healthy",
+                "code": resp.status,
+                "response": body[:200],
+            }
+    except Exception as e:
+        return {"status": "unhealthy", "error": str(e)}
+
+
+def check_tcp(host: str, port: int, timeout: int = 5) -> dict:
+    """Verifica conectividad TCP a un servicio."""
+    try:
+        sock = socket.create_connection((host, port), timeout=timeout)
+        sock.close()
+        return {"status": "healthy", "host": host, "port": port}
+    except Exception as e:
+        return {"status": "unhealthy", "host": host, "port": port, "error": str(e)}
+
+
+def check_docker_containers() -> dict:
+    """Verifica el estado de contenedores Docker."""
+    try:
+        result = subprocess.run(
+            ["docker", "ps", "--format", "{{.Names}}\t{{.Status}}\t{{.Ports}}"],
+            capture_output=True, text=True, timeout=10
+        )
+        containers = []
+        for line in result.stdout.strip().split("\n"):
+            if line:
+                parts = line.split("\t")
+                containers.append({
+                    "name": parts[0] if len(parts) > 0 else "unknown",
+                    "status": parts[1] if len(parts) > 1 else "unknown",
+                    "ports": parts[2] if len(parts) > 2 else "",
+                })
+        return {"status": "ok", "containers": containers}
+    except Exception as e:
+        return {"status": "error", "error": str(e)}
+
+
+def check_disk_space() -> dict:
+    """Verifica espacio en disco disponible."""
+    try:
+        result = subprocess.run(
+            ["docker", "system", "df", "--format", "{{json .}}"],
+            capture_output=True, text=True, timeout=10
+        )
+        return {"status": "ok", "output": result.stdout.strip()[:500]}
+    except Exception as e:
+        return {"status": "error", "error": str(e)}
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="LMAgent Docker Healthcheck — Verifica salud de servicios"
+    )
+    parser.add_argument("--service", "-s", choices=["api", "postgres", "redis", "docker"])
+    parser.add_argument("--url", default="http://localhost:8000/health")
+    parser.add_argument("--host", default="localhost")
+    parser.add_argument("--port", type=int, default=5432)
+    parser.add_argument("--all", action="store_true", help="Verificar todos los servicios")
+
+    args = parser.parse_args()
+
+    results = {"timestamp": datetime.now().isoformat(), "checks": {}}
+
+    if args.all or args.service == "api":
+        results["checks"]["api"] = check_http(args.url)
+
+    if args.all or args.service == "postgres":
+        results["checks"]["postgres"] = check_tcp(args.host, 5432)
+
+    if args.all or args.service == "redis":
+        results["checks"]["redis"] = check_tcp(args.host, 6379)
+
+    if args.all or args.service == "docker":
+        results["checks"]["docker"] = check_docker_containers()
+        results["checks"]["disk"] = check_disk_space()
+
+    if args.all and not args.service:
+        results["checks"]["api"] = check_http(args.url)
+        results["checks"]["postgres"] = check_tcp(args.host, 5432)
+        results["checks"]["redis"] = check_tcp(args.host, 6379)
+        results["checks"]["docker"] = check_docker_containers()
+
+    # Output
+    print(json.dumps(results, indent=2, ensure_ascii=False))
+
+    # Exit code
+    all_healthy = all(
+        c.get("status") in ("healthy", "ok")
+        for c in results["checks"].values()
+    )
+    sys.exit(0 if all_healthy else 1)
+
+
+if __name__ == "__main__":
+    main()