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 --noEmityjestsobre los componentes reutilizables. - Preview por nube:
pulumi preview --policy-pack acme-guardrailsen cada stack. - Drift check: el script anterior contra el estado actual.
- Deploy:
pulumi up --yes --policy-pack acme-guardrailssolo 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
advisoryamandatorypor 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.
comentarios(0)
$ dejar comentario