Section Scénarios

La section Scénarios est là où vous composez et opérez vos scénarios. Sur le côté, vous avez la liste des scénarios ; au centre, quatre vues du scénario actif.

Créer et éditer

Nouveau scénario ouvre l’éditeur : nom + les micros qui le composent.
Éditer (barre supérieure) revient à cet éditeur pour changer sa composition.
Supprimer (menu de l’élément sur le côté) supprime le scénario ; demande confirmation.

Les quatre vues

Cartes — une carte par micro avec son état, son port et son mode (basculement natif/conteneur).
Tableau — la même information en lignes : état, démarrage, endpoints et mode. Les basculements et liens de chaque ligne restent inline.
Graphe — le graphe d’appels qui-appelle-qui, avec la couleur de chaque arête selon sa résolution (local, cloud ou mock). On peut zoomer, dézoomer et ajuster à la vue.

Les trois offrent le même menu d’actions sur un micro : il s’ouvre depuis le « ⋮ » de la carte ou de la ligne, et avec un clic droit sur l’une des trois (dans le graphe, sur le nœud). Il porte ouvrir la configuration, voir les logs de ce micro, le redémarrer lui seul quand le scénario tourne, ouvrir chaque endpoint publié (API, Swagger, health), ouvrir le dossier de son dépôt et copier la commande effective avec laquelle il démarre.

Dépendances — le sélecteur local/cloud/mock par dépendance, avec l’avis « nécessite une connexion » si quelque chose pointe vers le cloud. Voir Dépendances.

Opérer le scénario

Depuis la barre supérieure :

▶ Démarrer / ■ Arrêter — un seul bouton qui démarre ou arrête selon l’état. Il démarre l’infra, résout les ports, réécrit les URLs et lance chaque micro ; à l’arrêt, il arrête micros, conteneurs et infra.
Nettoyer — termine les processus natifs orphelins et supprime les conteneurs aseptic-* résiduels. Utile si quelque chose est resté bloqué.
Injecter les données (menu du scénario dans le panneau latéral, scénario démarré) — exécute les étapes post-migrate de ses micros (par exemple, un seed) après la première migration. N’apparaît que si un micro en déclare.

Déboguer un micro

Déboguer (menu d’actions du micro, dans n’importe laquelle des trois vues) le fait démarrer avec son débogueur ouvert sur 127.0.0.1 ; si le scénario tourne, seul ce micro redémarre. C’est enregistré dans le scénario, comme le mode, et ne part pas à l’export ni à la publication dans le catalogue de l’équipe.

Spring Boot et Quarkus — JDWP, sur un port à lui, réaffecté s’il est occupé (5005 par défaut).
Node — l’inspecteur, dans le processus qui sert l’app et non dans npm (9229 par défaut).
.NET — attachement par PID : celui du processus qui écoute sur le port du micro.
Python — debugpy (5678 par défaut) : le micro démarre à travers lui, donc sa commande doit commencer par python ou par un serveur qui se lance aussi comme module (uvicorn, flask, gunicorn, fastapi, hypercorn). C’est à vous d’installer debugpy dans le .venv du dépôt (pip install debugpy).
Go — Delve (2345 par défaut), avec une commande go run <paquet> : il compile sans optimisations pour que les variables soient visibles, et le binaire va dans le dossier temporaire, pas dans le dépôt. C’est à vous d’installer Delve (go install github.com/go-delve/delve/cmd/dlv@latest).

S’il manque debugpy ou Delve, ou si la commande n’a pas l’une de ces formes, Déboguer le dit au lieu de s’activer, et la vérification du scénario prévient avec la commande pour l’installer.

Mode natif uniquement. La carte affiche le port (ou le PID) du débogueur, et Copier la configuration du débogueur met dans le presse-papiers l’entrée du launch.json de VS Code. Depuis le terminal : aseptic debug <micro> on|off ; sans argument, il indique comment s’attacher, y compris depuis IntelliJ.

Historique des exécutions

Chaque démarrage d’un scénario est conservé comme exécution jusqu’à son arrêt : quand, combien de temps, comment il s’est terminé (réussie, avec des micros tombés ou n’a jamais démarré), le dernier état de chaque micro avec ses erreurs et les appels servis par les mocks. Historique des exécutions (menu du scénario dans le panneau latéral) les affiche avec leurs logs, filtrables par micro et par erreurs : c’est là qu’il faut regarder quand « ça marchait hier » et que plus rien ne tourne.

Les 20 dernières sont conservées ; Épingler l’une d’elles évite qu’elle soit supprimée. Depuis le terminal : aseptic runs, aseptic runs logs <id>.

Santé en un coup d’œil

Le résumé de santé du scénario (aucun incident / démarrage / avec erreurs) est dans la barre supérieure et ouvre l’onglet État du dock. Chaque micro passe par les états Stopped → Starting → Healthy (ou Unhealthy / Crashed). Voir États d’un micro.

Partage

L’export/import d’un scénario complet se fait depuis le menu latéral. Voir Partager un scénario.