Sección Escenarios

La sección Escenarios es donde compones y operas tus escenarios. En el lateral tienes la lista de escenarios; en el centro, cuatro vistas del escenario activo.

Crear y editar

• Nuevo escenario abre el editor: nombre + los micros que lo forman.
• Editar (barra superior) vuelve a ese editor para cambiar su composición.
• Eliminar (menú del ítem en el lateral) borra el escenario; pide confirmación.

Las cuatro vistas

• Tarjetas — una tarjeta por micro con su estado, puerto y modo (conmutador nativo/contenedor).
• Tabla — la misma información en filas: estado, inicio, endpoints y modo. Los conmutadores y enlaces de cada fila quedan inline.
• Grafo — el grafo de llamadas quién-llama-a-quién, con el color de cada arista según su resolución (local, nube o mock). Se puede acercar, alejar y ajustar a la vista.

Las tres ofrecen el mismo menú de acciones sobre un micro: se abre con el «⋮» de la tarjeta o de la fila, y con el clic derecho en cualquiera de las tres (en el grafo, sobre el nodo). Lleva abrir la configuración, ver los logs de ese micro, reiniciarlo solo a él con el escenario en marcha, abrir cada endpoint publicado (API, Swagger, health), abrir la carpeta de su repositorio y copiar el comando efectivo con el que se inicia.

• Dependencias — el selector local/nube/mock por dependencia, con el aviso de «requiere conexión» si algo apunta a la nube. Ver Dependencias.

Operar el escenario

Desde la barra superior:

• ▶ Iniciar / ■ Detener — un único botón que arranca o para según el estado. Arranca la infra, resuelve puertos, reescribe URLs y levanta cada micro; al parar, detiene micros, contenedores e infra.
• Limpiar — termina procesos nativos huérfanos y elimina los contenedores aseptic-* residuales. Útil si algo quedó colgado.
• Sembrar datos (menú del escenario en el lateral, con el escenario en marcha) — ejecuta los pasos post-migrate de sus micros (por ejemplo, un seed) tras la primera migración. Solo aparece si algún micro los declara.

Depurar un micro

Depurar (menú de acciones del micro, en cualquiera de las tres vistas) lo deja arrancando con su depurador abierto en 127.0.0.1; si el escenario está en marcha, reinicia solo ese micro. Se guarda en el escenario, como el modo, y no viaja al exportar ni al publicarlo en el catálogo del equipo.

• Spring Boot y Quarkus — JDWP, en un puerto propio que se remapea si está ocupado (por defecto 5005).
• Node — el inspector, en el proceso que sirve la app y no en npm (por defecto 9229).
• .NET — se engancha por PID: el del proceso que escucha en el puerto del micro.
• Python — debugpy (por defecto 5678): el micro arranca a través de él, así que su comando tiene que empezar por python o por un servidor que también se lanza como módulo (uvicorn, flask, gunicorn, fastapi, hypercorn). debugpy lo instalas tú en el .venv del repo (pip install debugpy).
• Go — Delve (por defecto 2345), con un comando go run <paquete>: compila sin optimizar para que se vean las variables, y el binario va a la carpeta temporal, no al repo. Delve lo instalas tú (go install github.com/go-delve/delve/cmd/dlv@latest).

Si falta debugpy o Delve, o el comando no tiene una de esas formas, Depurar lo dice en vez de encenderse, y el chequeo del escenario avisa con el comando para instalarlo.

Solo en modo nativo. La tarjeta enseña el puerto (o el PID) del depurador, y Copiar configuración del depurador deja en el portapapeles la entrada para el launch.json de VS Code. Desde la terminal: aseptic debug <micro> on|off, y sin argumento dice cómo engancharse, también desde IntelliJ.

Historial de ejecuciones

Cada vez que inicias un escenario queda guardada una ejecución hasta que lo paras: cuándo fue, cuánto duró, cómo acabó (correcta, con micros caídos o no llegó a iniciarse), el último estado de cada micro con sus errores y las llamadas que atendieron los mocks. Historial de ejecuciones (menú del escenario en el lateral) las enseña con sus logs, filtrables por micro y por errores: es lo que hay que mirar cuando «ayer funcionaba» y ya no queda nada arrancado.

Se conservan las 20 últimas; Fijar una evita que se borre al podar. Desde la terminal: aseptic runs, aseptic runs logs <id>.

Salud de un vistazo

El resumen de salud del escenario (sin incidencias / iniciando / con errores) está en la barra superior y abre la pestaña Estado del dock. Cada micro pasa por los estados Stopped → Starting → Healthy (o Unhealthy / Crashed). Ver Estados de un micro.

Compartir

Exportar/importar un escenario completo se hace desde el menú del lateral. Ver Compartir un escenario.