Implementar en Google Cloud Run

Descripción General

Esta guía lo lleva a través de la implementación de CaseBender en Google Cloud Run utilizando nuestras imágenes Docker precompiladas.

Prerrequisitos

Paso 1: Configuración Inicial

Instalar CLI de Google Cloud

# Usando Homebrew
brew install google-cloud-sdk

# Iniciar sesión en Google Cloud

gcloud auth login

# Configurar Docker para usar Google Cloud

gcloud auth configure-docker

# Descargar el archivo
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-VERSION-linux-x86_64.tar.gz

# Extraer el archivo
tar -xf google-cloud-cli-VERSION-linux-x86_64.tar.gz

# Ejecutar el script de instalación
./google-cloud-sdk/install.sh

# Iniciar sesión en Google Cloud
gcloud auth login

# Configurar Docker para usar Google Cloud
gcloud auth configure-docker

# Descargar y ejecutar el instalador
# https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe

# Iniciar sesión en Google Cloud
gcloud auth login

# Configurar Docker para usar Google Cloud
gcloud auth configure-docker

Inicializar Proyecto

# Establecer su ID de proyecto
gcloud config set project SU_ID_DE_PROYECTO

# Habilitar APIs requeridas
gcloud services enable \
  cloudbuild.googleapis.com \
  run.googleapis.com \
  secretmanager.googleapis.com \
  cloudresourcemanager.googleapis.com \
  artifactregistry.googleapis.com

Paso 2: Configurar Infraestructura en la Nube

Conectar buckets de Cloud Storage existentes

CaseBender usa buckets GCS de propiedad del cliente. No crea, vacía ni elimina buckets. Aprovisione buckets separados quarantine, records y ephemeral antes de esta implementación. Use la identidad del servicio de Cloud Run o Workload Identity de GKE con Application Default Credentials. No descargue una clave de cuenta de servicio para una implementación de producción nueva.

gcloud storage buckets describe gs://casebender-storage

gcloud iam service-accounts create casebender-storage \
  --display-name "CaseBender Storage Service Account"

STORAGE_SA_EMAIL=$(gcloud iam service-accounts list \
  --filter="displayName:CaseBender Storage Service Account" \
  --format="value(email)")

gcloud storage buckets add-iam-policy-binding gs://casebender-storage \
  --member="serviceAccount:${STORAGE_SA_EMAIL}" \
  --role="roles/storage.objectUser"

Las variables canónicas son STORAGE_PROVIDER=gcs, GCS_BUCKET y, de forma opcional, GCS_PROJECT_ID. GOOGLE_STORAGE_BUCKET no es una variable de almacenamiento de CaseBender. Consulte Descripción general del almacenamiento y Línea base de seguridad del almacenamiento.

Configurar Cloud SQL (PostgreSQL)

# Crear instancia PostgreSQL
gcloud sql instances create casebender-db \
  --database-version=POSTGRES_14 \
  --cpu=2 \
  --memory=4GB \
  --region=us-central1 \
  --root-password="SU_CONTRASEÑA_SEGURA"

# Crear base de datos
gcloud sql databases create casebender \
  --instance=casebender-db

# Crear usuario
gcloud sql users create casebender \
  --instance=casebender-db \
  --password="SU_CONTRASEÑA_SEGURA"

Configurar Memorystore (Redis)

# Crear instancia Redis
gcloud redis instances create casebender-redis \
  --size=2 \
  --region=us-central1 \
  --redis-version=redis_6_x

Configurar Secret Manager

# Crear y almacenar variables de entorno
cat << EOF | gcloud secrets create casebender-env --data-file=-
AUTH_SECRET=su-secreto-de-autenticacion
AUTH_SALT=su-sal-de-autenticacion
POSTGRES_PRISMA_URL="postgresql://casebender:SU_CONTRASEÑA_SEGURA@/casebender?host=/cloudsql/SU_ID_DE_PROYECTO:us-central1:casebender-db"
REDIS_URL="redis://DIRECCIÓN_IP_REDIS:6379"
STORAGE_PROVIDER=gcs
GCS_BUCKET=casebender-storage
EOF

Paso 3: Extraer y Subir Imágenes Docker

# Crear repositorio de Artifact Registry
gcloud artifacts repositories create casebender \
  --repository-format=docker \
  --location=us-central1

# Configurar Docker para Artifact Registry
gcloud auth configure-docker us-central1-docker.pkg.dev

# Extraer imágenes de CaseBender
docker pull casebender/casebender:latest
docker pull casebender/workflow-processor:latest
docker pull casebender/misp-processor:latest

# Etiquetar imágenes para Google Artifact Registry
docker tag casebender/casebender:latest us-central1-docker.pkg.dev/$PROJECT_ID/casebender/app:latest
docker tag casebender/workflow-processor:latest us-central1-docker.pkg.dev/$PROJECT_ID/casebender/workflow-processor:latest
docker tag casebender/misp-processor:latest us-central1-docker.pkg.dev/$PROJECT_ID/casebender/misp-processor:latest

# Subir imágenes
docker push us-central1-docker.pkg.dev/$PROJECT_ID/casebender/app:latest
docker push us-central1-docker.pkg.dev/$PROJECT_ID/casebender/workflow-processor:latest
docker push us-central1-docker.pkg.dev/$PROJECT_ID/casebender/misp-processor:latest

Paso 4: Implementar Servicios

Implementar Aplicación Principal

# Implementar en Cloud Run
gcloud run deploy casebender \
  --image us-central1-docker.pkg.dev/$PROJECT_ID/casebender/app:latest \
  --platform managed \
  --region us-central1 \
  --allow-unauthenticated \
  --set-env-vars STORAGE_PROVIDER=gcs,GCS_BUCKET=casebender-storage \
  --service-account=$STORAGE_SA_EMAIL \
  --add-cloudsql-instances $PROJECT_ID:us-central1:casebender-db \
  --set-secrets "/app/.env=casebender-env:latest"

Implementar Procesador de Flujo de Trabajo

# Implementar procesador de flujo de trabajo
gcloud run deploy workflow-processor \
  --image us-central1-docker.pkg.dev/$PROJECT_ID/casebender/workflow-processor:latest \
  --platform managed \
  --region us-central1 \
  --no-allow-unauthenticated \
  --service-account=$STORAGE_SA_EMAIL \
  --add-cloudsql-instances $PROJECT_ID:us-central1:casebender-db \
  --set-secrets "/app/.env=casebender-env:latest"

Implementar Procesador MISP

# Implementar procesador MISP
gcloud run deploy misp-processor \
  --image us-central1-docker.pkg.dev/$PROJECT_ID/casebender/misp-processor:latest \
  --platform managed \
  --region us-central1 \
  --no-allow-unauthenticated \
  --service-account=$STORAGE_SA_EMAIL \
  --add-cloudsql-instances $PROJECT_ID:us-central1:casebender-db \
  --set-secrets "/app/.env=casebender-env:latest"

Paso 5: Configurar Dominio y SSL

Mapear Dominio Personalizado

# Añadir mapeo de dominio
gcloud run domain-mappings create \
  --service casebender \
  --domain su-dominio.com \
  --region us-central1

Siga los pasos de verificación de DNS en la Consola de Google Cloud para completar el mapeo de dominio.

Monitoreo y Mantenimiento

Configurar Monitoreo

# Habilitar Cloud Monitoring
gcloud services enable monitoring.googleapis.com

# Configurar alertas para Cloud Run
gcloud alpha monitoring policies create \
  --policy-from-file=monitoring-policy.json

Configurar Registros

# Ver registros de la aplicación
gcloud logging read "resource.type=cloud_run_revision AND resource.labels.service_name=casebender" --limit=10

Solución de Problemas

Problemas Comunes

Errores de Conexión a Base de Datos:
- Verifique que la instancia de Cloud SQL esté en ejecución
- Confirme que las credenciales sean correctas
- Asegúrese de que la conexión de Cloud SQL esté configurada correctamente
Problemas de Permisos:
- Verifique que la cuenta de servicio tenga los permisos adecuados
- Confirme que los secretos estén accesibles para el servicio
Errores de Implementación:
- Revise los registros de implementación para mensajes de error
- Verifique que las imágenes Docker estén correctamente etiquetadas y subidas

Siguientes Pasos

Configure monitoreo y alertas adicionales
Implemente un pipeline de CI/CD para actualizaciones automáticas
Configure respaldos programados para la base de datos
Establezca políticas de escalado para manejar cargas variables

Primeros Pasos

Implementación

Gestión de Alertas

Gestión de Casos

Gestión de Tareas

Analítica

Auditorías

Configuración

Implementar en Google Cloud Run

Descripción General

Prerrequisitos

Paso 1: Configuración Inicial

Instalar CLI de Google Cloud

Inicializar Proyecto

Paso 2: Configurar Infraestructura en la Nube

Conectar buckets de Cloud Storage existentes

Configurar Cloud SQL (PostgreSQL)

Configurar Memorystore (Redis)

Configurar Secret Manager

Paso 3: Extraer y Subir Imágenes Docker

Paso 4: Implementar Servicios

Implementar Aplicación Principal

Implementar Procesador de Flujo de Trabajo

Implementar Procesador MISP

Paso 5: Configurar Dominio y SSL

Mapear Dominio Personalizado

Monitoreo y Mantenimiento

Configurar Monitoreo

Configurar Registros

Solución de Problemas

Problemas Comunes

Siguientes Pasos

​Descripción General

​Prerrequisitos

​Paso 1: Configuración Inicial

​Instalar CLI de Google Cloud

​Inicializar Proyecto

​Paso 2: Configurar Infraestructura en la Nube

​Conectar buckets de Cloud Storage existentes

​Configurar Cloud SQL (PostgreSQL)

​Configurar Memorystore (Redis)

​Configurar Secret Manager

​Paso 3: Extraer y Subir Imágenes Docker

​Paso 4: Implementar Servicios

​Implementar Aplicación Principal

​Implementar Procesador de Flujo de Trabajo

​Implementar Procesador MISP

​Paso 5: Configurar Dominio y SSL

​Mapear Dominio Personalizado

​Monitoreo y Mantenimiento

​Configurar Monitoreo

​Configurar Registros

​Solución de Problemas

​Problemas Comunes

​Siguientes Pasos

Descripción General

Prerrequisitos

Paso 1: Configuración Inicial

Instalar CLI de Google Cloud

Inicializar Proyecto

Paso 2: Configurar Infraestructura en la Nube

Conectar buckets de Cloud Storage existentes

Configurar Cloud SQL (PostgreSQL)

Configurar Memorystore (Redis)

Configurar Secret Manager

Paso 3: Extraer y Subir Imágenes Docker

Paso 4: Implementar Servicios

Implementar Aplicación Principal

Implementar Procesador de Flujo de Trabajo

Implementar Procesador MISP

Paso 5: Configurar Dominio y SSL

Mapear Dominio Personalizado

Monitoreo y Mantenimiento

Configurar Monitoreo

Configurar Registros

Solución de Problemas

Problemas Comunes

Siguientes Pasos