En los equipos que prueban registro, recuperación de contraseña o invitaciones, un disposable email generator suele parecer una pieza pequeña. En realidad, el fixture de email tiene el mismo problema que cualquier recurso compartido en Kubernetes: si no tiene dueño, alcance y tiempo de vida claros, termina contaminando otras pruebas.
El síntoma aparece de forma bastante conocida. Un build crea un buzón temporal, otro build lee el mismo mensaje y una tercera ejecución intenta limpiar el recurso antes de que termine la primera. En local todo pasa porque solo existe una ejecución. En CI, los fallos parecen aleatorios y el equipo empieza a subir los reintentos. Eso tapa el problema, pero no lo resuelve.
El síntoma: una prueba pasa en local y falla en CI
Imagina dos pipelines del mismo commit ejecutándose en paralelo. Ambos generan un usuario demo@example.test y esperan el correo de verificación. El segundo test puede consumir el mensaje del primero, o encontrar un correo antiguo que todavía vive en el inbox. El resultado es un fallo intermitente: "token incorrecto", "mensaje no encontrado" o, peor, una prueba verde con datos de otra ejecución.
La primera decisión es tratar el buzón como una dependencia efímera, no como una cuenta global. Un disposable email address generator puede ayudar a crear direcciones distintas, pero la unicidad de la dirección no sustituye el aislamiento del recurso ni una política de limpieza.
Qué debe garantizar el contrato
Antes de escribir manifests, define un contrato sencillo para cada fixture:
- Propietario: el
run_iddel pipeline que lo creó. - Alcance: una suite, un job o una prueba, según el nivel de paralelismo.
- Caducidad: un tiempo máximo, incluso si el job muere.
- Lectura: solo el proceso que conoce el identificador del fixture puede consultar mensajes.
- Limpieza: el creador intenta borrar; un reconciliador elimina lo que queda abandonado.
- Evidencia: cada operación deja un identificador correlacionable con los logs del build.
Este contrato es más importante que la herramienta concreta. Si mañana cambias el proveedor del buzón, el comportamiento esperado sigue siendo el mismo. Los contratos cortos también ayudan a que una automatización sea revisable, igual que ocurre con contratos cortos para automatizaciones.
Diseñar el lease por build
Un patrón práctico es emitir un lease al comienzo del job. El servicio de fixtures devuelve un fixture_id, una dirección y una fecha de expiración. El pipeline pasa solo el identificador a los tests; no necesita descubrir buzones por nombre.
El flujo puede verse así:
crear lease -> ejecutar prueba -> esperar mensaje por fixture_id | | +---------- renovar si sigue vivo -----+ | revocar al terminar En Kubernetes, usa labels para que el ownership sea visible:
metadata: labels: app: email-fixture ci-run: "${CI_RUN_ID}" expires-at: "2026-11-22T06:00:00Z" No conviene usar la fecha como única fuente de verdad: un controlador puede comparar expires-at con un reloj fiable y consultar el estado del lease. Si el job sigue activo, puede renovar con una operación explícita. Si no renueva, el recurso queda listo para limpieza.
También hay que separar el nombre visible de la identidad interna. El correo puede ser aleatorio, pero el fixture_id debe ser estable durante toda la prueba. Esto evita que cada reintento cree una identidad que luego nadie sabe borrar.
Secretos, logs y límites de confianza
Un inbox de pruebas contiene tokens que se parecen mucho a credenciales reales. No lo metas en un ConfigMap, no lo imprimas completo en los logs y no lo dejes disponible para todos los pods del namespace. Usa un Secret con permisos mínimos y una service account dedicada.
La seguridad no termina en Kubernetes RBAC. El servicio de fixtures debe validar que el fixture_id pertenece al run_id que hace la petición. Un pod comprometido no debería poder enumerar los buzones de otros builds solo porque comparte namespace.
En los logs, registra run_id, fixture_id, evento y latencia; oculta la dirección completa y el cuerpo del mensaje. Si necesitas depurar, guarda una huella del mensaje o un fragmento controlado, no el token entero. Es un detalle que se suele olvidar cuando la presión del incidente sube.
Limpieza y observabilidad
La limpieza debe ocurrir por dos caminos. El job ejecuta un finally o una etapa de teardown, y un reconciliador busca leases expirados cada cierto intervalo. Depender solo del teardown falla cuando el runner es terminado, el nodo pierde conectividad o el proceso se queda colgado.
Mide al menos estas señales:
- Tiempo entre la creación del lease y la llegada del mensaje.
- Porcentaje de fixtures que requieren reintento.
- Cantidad de leases expirados recogidos por el reconciliador.
- Edad del fixture más antiguo por namespace.
Si la latencia crece, la prueba debe mostrar el fixture_id en su diagnóstico. Así el operador puede buscar una única ejecución, en vez de leer cientos de mensajes parecidos. El nombre "tempail" puede aparecer en datos de prueba heredados, pero no debería ser una regla para localizar recursos.
Para interfaces que muestran el estado del registro, conviene comunicar espera y error de forma accesible; reducir esperas visibles en formularios es también parte de la experiencia de una prueba fiable.
Checklist para el pipeline
Antes de dar por terminado el diseño, revisa:
- [ ] Cada ejecución recibe un
fixture_idúnico. - [ ] El lease tiene expiración y una ruta de renovación.
- [ ] El acceso está limitado por identidad, no solo por namespace.
- [ ] Los tokens y cuerpos de email no aparecen en logs.
- [ ] El teardown es idempotente y existe un reconciliador de respaldo.
- [ ] Las métricas permiten unir fixture, build y prueba.
- [ ] Una ejecución paralela no puede leer ni borrar el recurso de otra.
Un fixture aislado cuesta algo más de diseño al principio. A cambio, evita que CI dependa de reintentos y hace que un fallo sea explicable. Esa es la diferencia entre una prueba que simplemente suele pasar y una prueba que puede sostenerse cuando el sistema crece.
Preguntas rápidas
¿Una dirección nueva por prueba siempre es suficiente?
No. La dirección reduce colisiones, pero todavía necesitas autorización, expiración y limpieza. Además, un mensaje puede quedar visible después de que termine el test.
¿Debo crear un namespace por build?
Solo si el coste y la complejidad lo justifican. Para muchos equipos bastan labels, service accounts y una API que aplique ownership estricto. El namespace no reemplaza el control de acceso del servicio.
¿Qué hago si el proveedor no ofrece leases?
Construye la expiración en una capa propia y trata al proveedor como un adaptador. El pipeline debe depender del contrato de tu servicio, no de detalles internos del buzón.
