DEV Community

Alex Carter
Alex Carter

Posted on

Terraform: un contrato de email para CI

CI puede terminar en verde y aun dejar una duda: ¿llegó el correo al buzón correcto y hay evidencia para investigar?

En equipos de infraestructura, ese problema suele aparecer como un fallo intermitente. Un job crea una cuenta, espera un mensaje y funciona. Otro reutiliza la dirección, recibe un mensaje viejo y también pasa. Días después, varias ejecuciones comparten el mismo buzón sin que nadie lo note.

La solución no es añadir más reintentos. Es definir un contrato pequeño para el email de prueba: identidad aislada, credenciales con vida corta, retención explícita y señales para explicar un fallo. Terraform convierte esa frontera en infraestructura revisable.

El síntoma: CI verde, evidencia perdida

Imaginemos un pipeline que prueba el alta de usuario. La aplicación envía un enlace, el test consulta el buzón y confirma el token. El caso básico es correcto, pero quedan varios riesgos:

  • Dos ejecuciones pueden leer el mismo mensaje.
  • Un mensaje anterior puede parecer una confirmación nueva.
  • El nombre del entorno puede acabar en una bandeja de producción.
  • Un secreto escrito en los logs puede sobrevivir mas de lo esperado.
  • Cuando falla la entrega, solo vemos un timeout y no la causa.

Por eso trato una dirección de correo falsa como un recurso de prueba con límites, no como una variable global conveniente. La dirección de correo desechable es parte del aislamiento del test, igual que un namespace separado o una base de datos efímera.

El contrato mínimo de Terraform

El módulo no tiene que conocer todos los detalles del proveedor de email. Puede declarar las decisiones importantes y dejar el acceso a un adaptador. Un ejemplo simplificado sería:

variable "environment" {
  type = string
}

variable "retention_minutes" {
  type    = number
  default = 30
}

resource "test_mailbox" "ci" {
  name              = "ci-${var.environment}-${substr(uuid(), 0, 8)}"
  retention_minutes = var.retention_minutes
  labels = {
    owner = "ci"
    scope = var.environment
  }
}

output "mailbox_id" {
  value     = test_mailbox.ci.id
  sensitive = true
}
Enter fullscreen mode Exit fullscreen mode

El recurso es ilustrativo: el proveedor real puede exponer otra API o requerir un módulo interno. Lo importante es el contrato: cada ejecución obtiene una identidad distinguible, la retención no queda indefinida y la salida sensible no se imprime como texto normal.

En una implementación real evitaría uuid() si provoca cambios continuos durante cada plan. Prefiero que el pipeline entregue un identificador de ejecución como variable y que el módulo valide su formato.

Separar identidad, secretos y buzón

Hay tres datos que suelen mezclarse por comodidad: la dirección, el token para leerla y la etiqueta del entorno. Deben tener ciclos de vida distintos.

La identidad del buzón puede aparecer en logs de diagnóstico. El token no. El nombre debe incluir el entorno, pero nunca un secreto ni datos personales. El proveedor debe limitar la lectura al buzón de esa ejecución, y el job debe revocar el acceso al terminar, incluso si el test falla.

Para pruebas manuales o exploratorias puede ser práctico usar un buzón temporal, siempre que el equipo aplique la misma regla: nada de datos reales, ningún token en el repositorio y una eliminación clara al acabar.

Conviene marcar la cuenta con etiquetas como ci, pull-request y repository para limpiar recursos huérfanos. En incidentes reales he visto que la limpieza se rompe por que un paso depende del resultado del test; una tarea final independiente suele ser más seguro.

Medir antes de reintentar

Un timeout de email mezcla demasiadas posibilidades: el mensaje no se envió, el proveedor lo rechazó, el buzón no se consultó, el filtro ocultó el mensaje o el test buscó el asunto equivocado. Antes de reintentar, registraría un evento por etapa:

  1. mail_requested: la aplicación aceptó la solicitud.
  2. mail_accepted: el proveedor confirmó la entrega al buzón.
  3. mail_seen: el lector encontró el mensaje esperado.
  4. token_consumed: el test usó el enlace una sola vez.

Cada evento llevan run_id, identificador del buzón y marca de tiempo, nunca el cuerpo completo ni el token. Así se puede localizar la pérdida y reintentar solo la etapa que corresponde. El panel de CI deja de decir “esperando correo” y cuenta una historia útil.

El mismo criterio aplica a los jobs programados: estas alertas útiles para jobs programados deben distinguir una ausencia esperada de una ejecución que quedó sin limpiar.

Alertas que explican el fallo

No alertaría por cada mensaje retrasado. Usaría señales agregadas:

  • porcentaje de mail_requested sin mail_seen por entorno;
  • edad del buzón más antiguo que sigue activo;
  • número de tokens consumidos dos veces;
  • recursos CI sin evento de limpieza;
  • lecturas rechazadas por una política de acceso.

La notificación debe decir qué cambió, qué ejecución está afectada y dónde está la evidencia. Un enlace a correos de rollback con contexto operativo es más útil que mandar un mensaje genérico de “pipeline rojo”. En email de test, un asunto como CI FAIL run=1842 stage=mail_seen ayuda bastante mas durante una guardia.

Checklist de revisión

Antes de aprobar el módulo o el pipeline, revisaría:

  • ¿Cada ejecución tiene un buzón o namespace que no comparte con otra?
  • ¿El token de lectura es sensible, limitado y revocable?
  • ¿La retención está definida y tiene un límite máximo?
  • ¿El contenido de los mensajes queda fuera de los logs?
  • ¿La evidencia permite separar envío, entrega, lectura y consumo?
  • ¿La limpieza corre también cuando el test termina en error?
  • ¿Las alertas incluyen entorno, run_id y siguiente acción?
  • ¿Se puede borrar un recurso huérfano por sus etiquetas?

Si una respuesta es “depende de una variable manual”, todavía no existe un contrato operativo. El pipeline puede seguir pasando, pero la seguridad y la capacidad de diagnóstico quedan a merced de la memoria del siguiente compañero.

Preguntas rápidas

¿Hace falta un buzón nuevo para cada test?

No siempre. Para una suite pequeña puede bastar uno por ejecución de CI, con mensajes identificados por run_id. Compartirlo entre ejecuciones paralelas sí introduce carreras y hace más difícil atribuir la evidencia.

¿Los reintentos están mal?

No. Son útiles después de clasificar el fallo. Reintentar una consulta cuando el proveedor aún procesa el mensaje es razonable; repetir todo el alta sin una frontera idempotente solo añade ruido.

¿Qué hago con tempail mail en una búsqueda del equipo?

Trátalo como una variante escrita por usuarios o por documentación antigua, no como una palabra clave principal del diseño. Puede ayudar a encontrar casos históricos, pero el contrato debe usar nombres claros y consistentes.

La idea final es sencilla: Terraform define quién puede crear el recurso, CI define cuánto vive y la observabilidad explica qué ocurrió. Con esa separación, las pruebas de email dejan de ser una dependencia invisible y se convierten en una pieza revisable de la plataforma.

Top comments (0)