DevOps ·

Pulumi con TypeScript: drift detection y policy-as-code en CI/CD multi-nube

La infraestructura como código dejó de ser una promesa hace años, pero el verdadero reto aparece cuando tu organización opera simultáneamente en AWS, Azure y GCP. Terraform domina gran parte del mercado, pero Pulumi con TypeScript ofrece algo que muchos equipos de plataforma valoran cada vez más: la posibilidad de aplicar los mismos patrones de ingeniería de software (tipos, tests, refactorización, librerías internas) sobre la definición de infraestructura. En este artículo exploramos dos capacidades críticas cuando la escala crece: drift detection y policy-as-code, integradas en un pipeline CI/CD multi-nube.

Por qué Pulumi y TypeScript cambian las reglas

Pulumi compila tu programa en un grafo de recursos y lo compara contra el estado real usando su motor. A diferencia de los DSL declarativos puros, TypeScript te permite abstraer, tipar y componer. Eso significa que puedes escribir una librería interna como @acme/infra que exporte funciones como createSecureBucket() o provisionGkeCluster(), y reutilizarla entre proyectos en distintas nubes sin duplicar YAML.

El motor de Pulumi rastrea el estado en un backend (Pulumi Cloud, S3, Azure Blob o GCS). Cada pulumi up compara el estado deseado con el estado observado. Ahí es donde entra el drift detection: el estado real puede haber cambiado por intervenciones manuales, scripts ad-hoc o acciones de otros equipos.

Drift detection: detectar la realidad que se escapó del código

El drift es cualquier diferencia entre lo que tu programa declara y lo que existe realmente en el proveedor. Pulumi lo detecta durante pulumi preview, pero en CI/CD conviene ir más allá: un job dedicado que corra periódicamente y falle si hay desviaciones.

Comando base de detección

pulumi preview --diff --non-interactive --json > preview.json

El flag --json devuelve un objeto estructurado con las operaciones planificadas. Puedes parsearlo en el pipeline y decidir si el drift es aceptable o bloqueante.

Script de drift detection en Node

import { execSync } from "child_process";

const raw = execSync( “pulumi preview —diff —non-interactive —json”, { encoding: “utf-8” } ); const preview = JSON.parse(raw); const changes = preview.steps.filter( (s: any) => s.op !== “same” && s.op !== “create” );

if (changes.length > 0) { console.error(“Drift detectado en recursos existentes:”); for (const c of changes) { console.error( - ${c.op}: ${c.urn}); } process.exit(1); } console.log(“Sin drift. Infraestructura alineada.”);

Este script se ejecuta en un cronjob de GitHub Actions, GitLab CI o Azure Pipelines. Si algo cambió fuera de Pulumi, el pipeline falla y notifica al canal de Slack del equipo de plataforma.

Estrategia multi-nube

En un entorno multi-nube conviene tener stacks separados por proveedor: prod-aws, prod-azure, prod-gcp. Cada stack tiene su propio estado, pero el script de drift detection se reutiliza apuntando a cada uno con pulumi stack select:

for stack in prod-aws prod-azure prod-gcp; do
  pulumi stack select $stack
  node scripts/detect-drift.ts || exit 1
done

Policy-as-code: reglas que viajan con el repositorio

Pulumi permite definir políticas en TypeScript con @pulumi/policy. Se ejecutan durante preview y up, y pueden ser advisory (solo advertencia) o mandatory (bloquean el despliegue). Este es el corazón del governance multi-nube: una regla escrita una vez aplica a AWS, Azure y GCP.

Ejemplo: prohibir buckets S3 sin cifrado

import { PolicyPack, validateResourceOfType } from "@pulumi/policy";
import * as aws from "@pulumi/aws";

new PolicyPack(“acme-guardrails”, { policies: [ { name: “s3-encryption-required”, description: “Todo bucket S3 debe tener cifrado habilitado.”, enforcementLevel: “mandatory”, validateResource: validateResourceOfType( aws.s3.Bucket, (bucket, args, reportViolation) => { if (!bucket.serverSideEncryptionConfiguration) { reportViolation(“Bucket sin cifrado SSE.”); } } ), }, ], });

El pack se publica con:

pulumi policy publish acme-guardrails

Y se aplica al stack con:

pulumi up --policy-pack acme-guardrails

Reglas cross-cloud en un mismo pack

Un pack puede contener validaciones para varios proveedores. Por ejemplo, exigir etiquetas obligatorias owner y cost-center en recursos de AWS, Azure y GCP:

const requiredTags = ["owner", "cost-center"];

const checkTags = (resource: any, reportViolation: any) => { const tags = resource.tags ?? {}; for (const t of requiredTags) { if (!tags[t]) reportViolation(Falta tag obligatorio: ${t}); } };

Esta política se puede reutilizar en las tres nubes porque los recursos exponen la propiedad tags de forma homogénea en Pulumi.

Integración en CI/CD multi-nube

Un pipeline típico en GitHub Actions tiene cuatro etapas:

  • Lint y tests: tsc --noEmit y jest sobre los componentes reutilizables.
  • Preview por nube: pulumi preview --policy-pack acme-guardrails en cada stack.
  • Drift check: el script anterior contra el estado actual.
  • Deploy: pulumi up --yes --policy-pack acme-guardrails solo si las tres etapas anteriores pasan.
- name: Preview AWS
  run: pulumi preview --stack prod-aws --policy-pack acme-guardrails --non-interactive
- name: Preview Azure
  run: pulumi preview --stack prod-azure --policy-pack acme-guardrails --non-interactive
- name: Preview GCP
  run: pulumi preview --stack prod-gcp --policy-pack acme-guardrails --non-interactive
- name: Drift detection
  run: node scripts/detect-drift.ts

El uso de credenciales efímeras (OIDC en AWS, Workload Identity en GCP, federación en Azure) evita secretos estáticos en el runner y es hoy un requisito de compliance en la mayoría de auditorías.

Buenas prácticas que marcan la diferencia

  • Versiona los policy packs: cada cambio de regla es un PR, no un ajuste en consola.
  • Empieza advisory: migrar reglas de advisory a mandatory por fases evita romper despliegues legítimos.
  • Etiqueta todo: los tags son la única forma razonable de hacer cost allocation multi-nube.
  • Ejecuta drift detection en horario valle: reduce falsos positivos por despliegues en curso.
  • Un stack por entorno y nube: mezclar entornos en un mismo stack complica el drift y la revisión de cambios.

Conclusión

Pulumi con TypeScript no es solo una alternativa a Terraform: es una forma distinta de pensar la infraestructura, donde los mismos patrones que aplicas al código de aplicación (tipado, tests, librerías compartidas, políticas automatizadas) se aplican al aprovisionamiento. Con drift detection periódica y policy-as-code embebido en el pipeline, un equipo pequeño puede gobernar cientos de recursos distribuidos entre AWS, Azure y GCP sin recurrir a revisiones manuales. La inversión inicial en una librería interna y un pack de políticas se amortiza en la primera auditoría.