Initial commit: Complete MLOps project setup

Author: LiliGC

.dockerignore

@@ -0,0 +1,25 @@
+# Excluir archivos de caché y bytecode de Python
+__pycache__/
+*.pyc
+*.log
+
+# Excluir artefactos generados, ya que se manejan con volúmenes
+artifacts/
+
+# Excluir configuraciones y caché de herramientas de desarrollo
+.vscode/
+.idea/
+
+# Excluir entornos virtuales de Python
+.venv/
+venv/
+env/
+
+# Excluir documentación y archivos de CI/CD
+.github/
+docs/
+README.md
+DEVELOPMENT_GUIDE.md # Si estuviera en la raíz
+
+# Excluir tests, ya que se montan como volumen para el servicio 'tester'
+tests/

.github/workflows/ci-cd.yml

@@ -0,0 +1,98 @@
+# .github/workflows/ci-cd.yml
+
+name: CI/CD - Build and Deploy to Google Cloud
+
+# 1. Control de Concurrencia: Evita despliegues simultáneos.
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+on:
+  push:
+    branches:
+      - main
+    # Opcional: Ejecutar también con tags para releases
+    tags:
+      - 'v*.*.*'
+
+jobs:
+  test-and-build:
+    # Cambiamos el nombre para reflejar la nueva función
+    name: Continuous Integration - Test and Build
+    runs-on: ubuntu-latest
+    
+    permissions:
+      contents: 'read'
+      id-token: 'write'
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+
+      # 2. Caché para dependencias de Python
+      - name: Cache Python dependencies
+        uses: actions/cache@v3
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements/*.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v2
+
+      - name: Run Model Training
+        run: |
+          pip install -r requirements/dev.txt
+          python breast_cancer_app/model/train_model.py
+
+      - name: Run Integration Tests
+        run: |
+          docker-compose up -d api
+          docker-compose run --rm tester
+
+      - name: Build Docker Images (no push)
+        uses: docker/build-push-action@v4
+        with:
+          context: .
+          # Construye todas las etapas, pero no sube las imágenes
+          push: false
+          # Especificamos los targets para que se construyan
+          # y se almacenen en la caché local de la ejecución.
+          target: |
+            api
+            frontend
+
+  # --- El job de despliegue está comentado por defecto ---
+  # deploy:
+  #   name: Deploy to Cloud Run
+  #   needs: test-and-build
+  #   runs-on: ubuntu-latest
+  #   if: github.ref == 'refs/heads/main' # Only deploy on push to main
+
+  #   permissions:
+  #     contents: 'read'
+  #     id-token: 'write'
+
+  #   steps:
+  #     - name: Authenticate to Google Cloud
+  #       uses: 'google-github-actions/auth@v1'
+  #       with:
+  #         workload_identity_provider: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}
+  #         service_account: ${{ secrets.GCP_SERVICE_ACCOUNT }}
+
+  #     - name: Deploy API to Cloud Run
+  #       uses: 'google-github-actions/deploy-cloudrun@v1'
+  #       with:
+  #         service: ${{ env.API_SERVICE_NAME }}
+  #         region: ${{ env.REGION }}
+  #         image: ${{ env.GAR_LOCATION }}-docker.pkg.dev/${{ env.PROJECT_ID }}/${{ env.API_REPOSITORY }}/${{ env.API_SERVICE_NAME }}:main
+
+  #     - name: Deploy Frontend to Cloud Run
+  #       uses: 'google-github-actions/deploy-cloudrun@v1'
+  #       with:
+  #         service: ${{ env.FRONTEND_SERVICE_NAME }}
+  #         region: ${{ env.REGION }}
+  #         image: ${{ env.GAR_LOCATION }}-docker.pkg.dev/${{ env.PROJECT_ID }}/${{ env.FRONTEND_REPOSITORY }}/${{ env.FRONTEND_SERVICE_NAME }}:main
+  #         env_vars: |
+  #           API_URL=https://$(gcloud run services describe ${{ env.API_SERVICE_NAME }} --platform managed --region ${{ env.REGION }} --format 'value(status.url)' | sed 's|https://||')

.gitignore

@@ -0,0 +1,30 @@
+# Entornos virtuales de Python
+.venv/
+venv/
+env/
+
+# Archivos de caché y compilados de Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+
+# Archivos generados por el entrenamiento del modelo
+# Estos se crean al ejecutar el script y no deben ser versionados
+artifacts/
+
+# Archivos de log
+*.log
+
+# Configuraciones de IDE/Editor
+.vscode/
+.idea/
+
+# Archivos de sistema operativo
+.DS_Store
+Thumbs.db
+
+# Archivos de distribución/build de Python
+dist/
+build/
+*.egg-info/

Dockerfile

@@ -0,0 +1,52 @@
+# === Etapa 1: Base ===
+# Imagen común con Python y dependencias base.
+FROM python:3.9-slim-bullseye AS base
+WORKDIR /app
+# Instala dependencias del sistema y limpia la caché para mantener la imagen ligera.
+RUN apt-get update && apt-get install -y curl && rm -rf /var/lib/apt/lists/*
+
+# Copia e instala las dependencias comunes.
+COPY requirements/common.txt .
+RUN pip install --no-cache-dir -r common.txt
+
+
+# === Etapa 2: Builder de Dependencias de Desarrollo ===
+# Etapa para instalar TODAS las dependencias (dev, api, frontend).
+# Usada por 'training' y 'tester' en docker-compose.
+FROM base AS dev_builder
+COPY requirements/ ./requirements/
+RUN pip install --no-cache-dir -r requirements/dev.txt
+
+
+# === Etapa 3: Imagen Final de la API ===
+# Imagen de producción para la API. Ligera y específica.
+FROM base AS api
+# Copia las dependencias instaladas de la etapa 'dev_builder'.
+COPY --from=dev_builder /usr/local/lib/python3.9/site-packages /usr/local/lib/python3.9/site-packages
+# ¡CORRECCIÓN CLAVE! Copia también los ejecutables como 'waitress-serve'.
+COPY --from=dev_builder /usr/local/bin /usr/local/bin
+# Copia solo el código de la API. La imagen NO debe contener artefactos.
+COPY breast_cancer_app/api /app/breast_cancer_app/api
+EXPOSE 5000
+# Comando para ejecutar la API en producción con Waitress.
+CMD ["waitress-serve", "--host=0.0.0.0", "--port=5000", "breast_cancer_app.api.api:app"]
+
+# === Etapa 5: Imagen Final del Frontend ===
+# Imagen de producción para el Frontend.
+FROM base AS frontend
+COPY --from=dev_builder /usr/local/lib/python3.9/site-packages /usr/local/lib/python3.9/site-packages
+# ¡CORRECCIÓN CLAVE! Copia también los ejecutables como 'streamlit'.
+COPY --from=dev_builder /usr/local/bin /usr/local/bin
+COPY breast_cancer_app/frontend /app/breast_cancer_app/frontend
+EXPOSE 8501
+CMD ["streamlit", "run", "breast_cancer_app/frontend/frontend.py", "--server.port=8501", "--server.address=0.0.0.0"]
+
+
+# === Etapa 6: Imagen de Desarrollo ===
+# Imagen que contiene todo el código y todas las dependencias.
+# Ideal para los servicios 'training' y 'tester'.
+FROM base AS dev
+COPY --from=dev_builder /usr/local/lib/python3.9/site-packages /usr/local/lib/python3.9/site-packages
+# ¡CORRECCIÓN CLAVE! Copia también los ejecutables como 'pytest'.
+COPY --from=dev_builder /usr/local/bin /usr/local/bin
+COPY . .