Un pipeline puede estar en verde y aun así dejar un problema serio detrás: una credencial de correo visible en los logs, un buzón de pruebas compartido entre ejecuciones o un token que sobrevive más tiempo del necesario. Lo he visto aparecer después de cambiar un test, no después de un gran rediseño. Por eso conviene tratar los emails de CI como una frontera de seguridad, no como un detalle del script.

En Kubernetes, esta frontera tiene piezas bastante concretas: un Secret con alcance limitado, un namespace aislado, una identidad de workload y una política de retención para los datos del buzón. El objetivo no es hacer que cada prueba sea complicada. Es que un fallo sea fácil de localizar y dificil de convertir en una fuga.

El síntoma: un test de email que expone demasiado

El primer síntoma suele ser una alerta aparentemente inocente. Un test de registro no encuentra el correo de verificación y alguien añade el contenido completo del mensaje al log para depurar. Después, el mismo job imprime la dirección del buzón, el identificador del usuario y parte del enlace. Si el runner conserva los logs durante semanas, la información temporal deja de ser temporal.

Otro síntoma es la contaminación entre ejecuciones. Dos pods usan la misma dirección, uno lee el mensaje del otro y el equipo empieza a aumentar los reintentos. La latencia parece el problema, pero la causa real es que no existe una identidad clara por ejecución. En ese punto un correo temporal desechable ayuda solo si el fixture también tiene un ciclo de vida definido.

La pregunta útil durante el incidente no es solamente “¿llegó el email?”. También es: ¿qué workload lo pidió, qué entorno lo recibió y quién podía leer el secreto? Las alertas de rollback con contexto real aplican la misma idea: una señal sin contexto hace perder tiempo.

La causa raíz: tratar el secreto como configuración común

En muchos repositorios, la URL del proveedor, el usuario del buzón y el token se mezclan en variables de entorno genéricas. Eso funciona localmente, pero en CI acaba copiado a manifiestos, artefactos o mensajes de error. El problema no es usar variables; es no distinguir configuración pública, credenciales y datos de prueba.

Una clasificación pequeña suele bastar:

  • Configuración: región, nombre del proveedor y timeouts, sin valor sensible.
  • Credenciales: token de API y claves de acceso, guardados en el sistema de secretos del CI y entregados al pod solo cuando arranca.
  • Datos efímeros: dirección, identificador de ejecución y mensaje recibido, con retención corta.

Si el pipeline necesita contratos para correos temporales en CI, el contrato debe describir estados y tiempos, no pedir que cada test conozca la credencial. Esa separación tambien reduce el radio de impacto cuando una prueba falla.

Diseñar la frontera en Kubernetes

Un patrón sencillo consiste en crear un namespace por entorno de pruebas y dar al ServiceAccount del runner solo el acceso que necesita. El pod de la prueba recibe el secreto como archivo montado o como variable, pero la aplicación de test nunca lo imprime. En los clusters donde el proveedor lo permite, conviene usar un gestor externo de secretos y sincronizar únicamente un secreto de corta duración.

La rotación debe ser aburrida. El job solicita una credencial para la ejecución, la usa, y la revoca o deja que expire al terminar. No hay que compartir un token de desarrollo con todos los branches para ahorrar unos minutos. Si un servicio no soporta credenciales tan cortas, al menos separa por entorno y limita los permisos a leer y enviar los mensajes de prueba.

También ayuda incluir un identificador de correlación que no contenga datos del usuario:

ci-<run-id>-<random-suffix> 

Ese identificador puede viajar en el asunto o en los metadatos del fixture. Nunca debe ser el token ni una dirección personal. Un nombre como temp mailid puede servir para detectar fixtures antiguos en una búsqueda, pero no debe terminar en una URL pública ni en un log con credenciales.

Qué registrar y qué nunca registrar

Para investigar un fallo, registra el hash o identificador de la ejecución, el namespace, el nombre del test, el instante de solicitud, el instante de recepción y el motivo de expiración. Con esos datos se puede distinguir un timeout del proveedor, un selector roto o una política de red mal aplicada.

Evita guardar el cuerpo completo del mensaje, enlaces de verificación, tokens, cookies y cabeceras de autenticación. Si necesitas comprobar el contenido, guarda una aserción resumida: asunto esperado, remitente validado y presencia de un campo no sensible. Cuando el diagnóstico termine, elimina el buzón y sus artefactos. Parece una tarea menor, pero es la que mantiene útil la palabra temporal.

Para un flujo que necesita obtener correo temporal, define también qué datos devuelve el proveedor y quién los puede consultar. El enlace debe ser una herramienta contextual, no una invitación a poner credenciales reales en una prueba automatizada.

Checklist operativa antes del merge

  • ¿Cada ejecución tiene una dirección o buzón aislado?
  • ¿El token llega desde un gestor de secretos y no desde el repositorio?
  • ¿El ServiceAccount puede leer solo el secreto y namespace necesarios?
  • ¿Los logs excluyen cuerpo, enlaces, tokens y cabeceras?
  • ¿Existe un timeout explícito y un motivo de expiración?
  • ¿El cleanup corre incluso cuando el test falla?
  • ¿La rotación se ha probado en un branch, no solo documentado?
  • ¿Los artefactos tienen una retención corta y conocida?

Si una respuesta es “todavia no”, no hace falta bloquear todo el despliegue. Registra el riesgo, asigna un dueño y evita ampliar el acceso mientras se corrige. En operaciones, una frontera incompleta pero visible es mejor que una frontera supuestamente segura que nadie ha verificado.

Preguntas frecuentes sobre secretos de email en CI

¿Debo usar siempre un namespace por ejecución?

No necesariamente. Es útil para jobs con privilegios o datos especialmente sensibles, pero un namespace por entorno combinado con una identidad por ejecución puede ser suficiente. La decisión depende del coste operativo y del radio de impacto aceptable.

¿Puedo guardar el email recibido como artefacto?

Solo si existe una razón de diagnóstico clara, con redacción de tokens y una retención muy corta. En la mayoría de los tests basta con guardar el resultado de las aserciones. Guardar más datos no hace que la evidencia sea automaticamente mejor.

¿Qué métrica vigilo primero?

Mide el tiempo desde la solicitud hasta la recepción, separado por proveedor y entorno. Añade el porcentaje de cleanup exitoso. Una métrica de latencia sin el estado del cleanup puede ocultar el riesgo que realmente te preocupa.

La lección práctica es simple: un email de CI tiene identidad, permisos y ciclo de vida, igual que cualquier otro recurso de producción. Kubernetes aporta las fronteras; el equipo debe definirlas y comprobarlas en cada ejecución.