Tu primera App de Python en Producción con Antigravity y Google Cloud Run

Matriz de Decisión Arquitectónica para Despliegues en GCP

Comparativa entre los diferentes modelos de ejecución para cargas de trabajo en Python según el nivel de abstracción y los requerimientos operacionales:

Implementación Técnica: Transformación y Despliegue

A continuación se detalla la arquitectura generada por el agente de Antigravity: la envoltura del script en una API REST, el empaquetado del contenedor y la orquestación mediante Terraform.

1. Código de la Aplicación con Adaptación HTTP (`app.py`)

import os
import requests
from flask import Flask, jsonify

app = Flask(__name__)

def obtener_precio_btc():
    url = "https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT"
    headers = {"User-Agent": "Mozilla/5.0"}
    try:
        response = requests.get(url, headers=headers, timeout=5)
        response.raise_for_status()
        data = response.json()
        return float(data.get("price", 0.0))
    except Exception as e:
        return {"error": str(e)}

@app.route("/", methods=["GET"])
@app.route("/health", methods=["GET"])
def health_check():
    return jsonify({"status": "healthy", "service": "btc-monitor"}), 200

@app.route("/price", methods=["GET"])
def get_price():
    precio = obtener_precio_btc()
    if isinstance(precio, dict) and "error" in precio:
        return jsonify({"status": "error", "message": precio["error"]}), 502
    return jsonify({
        "status": "success",
        "symbol": "BTCUSDT",
        "price_usd": precio
    }), 200

if __name__ == "__main__":
    port = int(os.environ.get("PORT", 8080))
    app.run(host="0.0.0.0", port=port)

2. Definición del Contenedor Multi-Stage (`Dockerfile`)

FROM python:3.11-slim

ENV PYTHONUNBUFFERED=1 \
    PYTHONDONTWRITEBYTECODE=1 \
    PORT=8080

WORKDIR /app

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

COPY . .

# Cloud Run inyecta dinámicamente $PORT
CMD exec gunicorn --bind 0.0.0.0:$PORT --workers 1 --threads 8 --timeout 0 app:app

3. Infraestructura como Código (`main.tf`)

terraform {
  required_version = ">= 1.5.0"
  required_providers {
    google = {
      source  = "hashicorp/google"
      version = "~> 5.0"
    }
  }
}

provider "google" {
  project = var.project_id
  region  = var.region
}

# Habilitación de APIs requeridas
resource "google_project_service" "services" {
  for_each = toset([
    "run.googleapis.com",
    "artifactregistry.googleapis.com",
    "cloudbuild.googleapis.com"
  ])
  project = var.project_id
  service = each.key
  disable_on_destroy = false
}

# Repositorio en Artifact Registry
resource "google_artifact_registry_repository" "repo" {
  depends_on    = [google_project_service.services]
  location      = var.region
  repository_id = var.repository_id
  description   = "Docker repository para btc-monitor"
  format        = "DOCKER"
}

# Servicio en Cloud Run (v2)
resource "google_cloud_run_v2_service" "default" {
  depends_on = [google_artifact_registry_repository.repo]
  name       = var.service_name
  location   = var.region
  ingress    = "INGRESS_TRAFFIC_ALL"

  template {
    containers {
      image = "${var.region}-docker.pkg.dev/${var.project_id}/${var.repository_id}/btc-monitor:latest"
      resources {
        limits = {
          cpu    = "1"
          memory = "512Mi"
        }
      }
    }
  }
}

# Acceso Público No Autenticado
resource "google_cloud_run_v2_service_iam_member" "public_access" {
  name     = google_cloud_run_v2_service.default.name
  location = google_cloud_run_v2_service.default.location
  role     = "roles/run.invoker"
  member   = "allUsers"
}

output "service_url" {
  value       = google_cloud_run_v2_service.default.uri
  description = "URL pública del servicio Cloud Run"
}

Preguntas Frecuentes de Arquitectura