Ir al contenido

Compartir un escenario con un compañero

Objetivo: pasar un escenario reproducible a otra persona sin pisar su catálogo.

Desde el menú del escenario (o Ajustes para el catálogo completo), Exportar genera un fichero autocontenido <escenario>.aseptic.yml con:

  • El escenario.
  • Los manifiestos de sus micros (con la rama en la que está cada repo).
  • Los mocks referenciados.
  • Opcionalmente, la configuración de arranque de cada micro (activa el interruptor «Incluir la configuración de arranque»), saneada: las credenciales viajan como referencia ${creds.x} y las rutas absolutas se omiten.

No viajan tu settings.local.yml ni el estado de .runtime/.

En la otra máquina, Importar escenarios abre un diálogo de reconciliación: el import nunca sobrescribe a lo bruto, resuelve conflicto a conflicto con la opción recomendada preseleccionada.

El diálogo va por pasos —Escenario, Servicios, Mocks y arranque, Entorno y Resumen— y se salta los que no tienen nada que decidir. Los pasos ya hechos se pueden reabrir; el botón de importar está en el último.

  • Un escenario que ya existe entra como copia (nunca se pisa).
  • Un manifiesto que difiere: conservar local (por defecto), usar el entrante, o ver el diff.
  • Los mocks: unión por endpoint+variante.

Si faltan repos referenciados en el espacio de trabajo, Aseptic avisa: el escenario se importa, pero no arrancará hasta clonarlos.

Si el escenario necesita infraestructura que el docker-compose.yml de esta máquina no declara (un Redis, un Kafka), el paso Entorno también lo dice, con el trozo de YAML que la cubre listo para pegar. Aseptic no escribe el compose: suele ser del equipo y vivir en otro repositorio.

aseptic scenario export <nombre> [--include-run] y aseptic scenario import <fichero> [--apply] [políticas] (sin --apply imprime el plan de conflictos).

Cuando se comparte a menudo, el fichero sobra

Sección titulada «Cuando se comparte a menudo, el fichero sobra»

Pasar un fichero está bien para una vez. Si el equipo se pasa escenarios a menudo, lo que toca es un catálogo de equipo: el escenario se publica una vez y cada cual lo adopta cuando le hace falta, viendo antes qué le falta a su máquina.