Commandes par groupe

Toutes les commandes acceptent --json et -p <chemin>. Ajoutez -h à n’importe laquelle pour son aide complète.

Créer le projet

aseptic init [chemin]               # .aseptic/ avec sa configuration et le catalogue vide

Tout le reste a besoin d’un projet —le dossier qui contient .aseptic/—. Sur le bureau, l’installateur le sème la première fois ; depuis le terminal (une CI, un clone tout neuf) on le crée avec ceci. Il n’écrase rien : sur un dossier à moitié fait, il complète ce qui manque.

État et cycle de vie du scénario

aseptic status                      # moteur actif, Docker, scénario actif et micros
aseptic doctor [scénario]           # vérification de l'environnement avant de lancer (et comment obtenir ce qui manque)
aseptic start <scénario> [flags]    # démarre (lance le daemon si besoin) et attend healthy
aseptic stop                        # arrête le scénario actif
aseptic restart <micro>             # redémarre un micro seul
aseptic debug <micro> [on|off]      # ouvre ou ferme son débogueur ; sans on/off, comment s’y attacher
aseptic runs [show|logs|pin|delete] # historique des exécutions du scénario
aseptic restart-all                 # arrête et relance le scénario entier
aseptic metrics [micro]             # dernier échantillon de métriques (--json = historique)
aseptic set-resolution <dep> <local|cloud|mock>   # change la résolution à chaud
aseptic cleanup [scénario]          # nettoyage défensif (orphelins, ports)
aseptic prep <scénario> --when <pre-boot|post-migrate>
aseptic console <service>           # psql/redis-cli dans son conteneur
aseptic kafka topics|consume|produce   # topics et messages du Kafka de l’infra
aseptic logs [micro] [-f] [-n N] [--errors] [-g motif]
aseptic call <micro> [chemin] [-X méthode] [-d corps] [-H k=v...]
aseptic diagnose <micro> [-n N]     # ce qui ne va pas avec un micro, en un coup

Flags de start : -r/--resolve <dep=mode> (override ponctuel de résolution), -m/--mode <micro=mode> (native|container), --no-wait, --no-docker, --timeout <s> (par défaut 600). start démarre Docker tout seul sauf --no-docker.

Scénarios

aseptic scenario list | show <n> | graph <n> | save --file <yml> | delete <n>
aseptic scenario add-service <scénario> <micro>      # sans renvoyer le document entier
aseptic scenario remove-service <scénario> <micro>
aseptic scenario set-resolution <scénario> <dep> <local|cloud|mock>   # fixe celle qui est enregistrée
aseptic scenario from-folder <dossier> <nom>          # importe le dossier et crée le scénario
aseptic scenario export <n> [-o fichier] [--include-run]
aseptic scenario import <fichier> [--apply] [politiques]

add-service et remove-service modifient ce qui est enregistré : inutile de renvoyer le scénario entier pour toucher un micro. Et attention aux deux set-resolution : celui du haut (aseptic set-resolution) change la résolution à chaud, sur le scénario en cours ; celui-ci la fixe dans le scénario enregistré.

from-folder est le raccourci pour démarrer : il importe tous les micros d’un dossier et crée le scénario avec eux, d’un coup.

Micros

aseptic service list | show <id> | add <chemin-repo> | save --file <yml> | delete <id>
aseptic service detect <chemin>     # quel manifeste Aseptic voit là, SANS l'enregistrer
aseptic service clone <url> [--alta]            # clone et, avec --alta, l'enregistre
aseptic service clone-all <url...>  # clone en lot et autodétecte chaque micro
aseptic service import-all <dossier>            # enregistre tous ceux d'un dossier
aseptic service export <id> [--include-run] | import <yml...>
aseptic service drift <id>          # le manifeste diverge-t-il du repo ? (exit 1 si drift)
aseptic service rescan <id>         # réconcilie depuis le repo (préserve la personnalisation)
aseptic service rescan-all          # pareil pour TOUT le catalogue
aseptic service effective-config <id>           # valeur finale de chaque clé et sa couche d'origine
aseptic service frontend-info <id>  # front : comment il sert, s'il reçoit --proxy-config et ce que contient le repo
aseptic service branch <id> | branches <id> | checkout <id> <branche> | fetch <id> | pull <id>
aseptic service fetch-all           # récupère les nouveautés de TOUS les repos du catalogue
aseptic service switch-branch <id> <branche>    # change de branche et réconcilie le manifeste
aseptic service hot-switch-branch <id> <branche>  # pareil avec le micro en marche : n'arrête que lui
aseptic dependency rename <de> <vers>  # renomme la dépendance dans les services, scénarios et mocks
aseptic service files <id> [motif] [-d <sous-dossier>]    # liste les fichiers du repo du micro
aseptic service read-file <id> <chemin>                   # affiche un fichier texte du repo
aseptic service write-file <id> <chemin> [--from <fich>]  # en écrit un (ou depuis l'entrée standard)

clone-all et import-all intègrent une équipe entière : cloner vingt repos et les enregistrer un par un, c’est l’après-midi que cela économise le premier jour.

effective-config répond à « d’où sort cette valeur ? » sans rien démarrer, ce qui est la question de tout micro qui démarre avec la mauvaise configuration.

Bases de données

aseptic db list | save --file <yml> | delete <id>
aseptic db test <hôte> <port>       # accessibilité TCP (exit 1 si pas de réponse)

Mocks

aseptic mock services | catalog [service] | calls | events | clear-calls
aseptic mock save <service> --file <json> | delete <service> --method GET --path /x
aseptic mock set-active <service> --method GET --path /x --variant 1
aseptic mock capture|uncapture <service> --method GET --path /x   # appelle le vrai service et enregistre la réponse
aseptic mock operations <service> | skeleton <service> <méthode> <chemin>
aseptic mock set-openapi <service> [origine]    # d'où viennent les corps (sans origine, la retire)
aseptic mock set-service <groupe> --prefix /x [--openapi <origine>] [--base-url <url>] [--rename-from <id>]
aseptic mock regroup <groupe> [--from <service>]   # déplace dans le groupe les stubs sous son préfixe
aseptic mock delete-service <service> --yes     # efface le catalogue de mocks ENTIER du service
aseptic mock from-call <méthode> <chemin>
aseptic mock probe <méthode> <chemin> [-H 'Nom : valeur'] [-d '<corps>']  # ce qui serait servi, et par quelle règle
aseptic mock put-file <service> <fichier>  # copie un fichier dans mocks/files/ pour le servir comme corps
aseptic mock export|import <service> [fichier] | export-all|import-all [fichier]
aseptic mock request [chemin] [-X méthode] [-d corps] [-H k=v]   # appelle la passerelle de mocks (moteur actif)

En capture, un endpoint cesse de servir sa variante : il appelle le vrai service et enregistre la réponse comme variante Real <status>, qui devient active. Une fois la capture retirée (uncapture), il continue de servir ce qu’il a enregistré.

Démarrage personnalisé

aseptic run show <id> | set <id> [options] | clear <id> | preview <id>
aseptic run export <id> [-o fichier] | import <id> <fichier>

run set accepte --profile, --prop k=v, --toggle <id>, --extra-args, --command, --datasource-ref <id>, --datasource local|cloud|custom [--url ...] et --tools auto|local|container.

--tools décide d’où viennent les outils du démarrage natif : auto (par défaut) utilise ceux de votre machine et, s’il en manque un et que Docker est démarré, le conteneur d’outils ; local et container le fixent, et auto retire le réglage du micro. Voir Mode natif vs conteneur.

Paramètres

aseptic config show | get <clé> | set <clé> <valeur> | unset <clé>

Clés : workspace, composeFile (bundled ou chemin), mockPort, caBundle (l’AC de votre entreprise, PEM ou DER), toolchainRegistry (préfixe d’un miroir pour les images d’outils) et credentials.<nom>.

Outils de développement

aseptic toolchain list                   # ce qu'il sait installer et ce qui est installé
aseptic toolchain install java 21        # pour java, la version majeure
aseptic toolchain install node 22.22.3   # pour le reste, l'exacte (ou un préfixe : 22)
aseptic toolchain remove maven 3.10.0    # la supprime du cache d'Aseptic

Il installe le JDK, Maven, Gradle, Node, Go ou le SDK .NET qui manque dans le cache d’Aseptic (~/.aseptic/toolchains/) : sans administrateur, sans toucher au PATH de la machine et en vérifiant la somme de contrôle avant d’extraire. Celui que vous avez déjà installé reste prioritaire. aseptic doctor indique ce qui manque et quelle commande le récupère.

Docker, paquet du catalogue et daemon

aseptic docker status | start [--no-wait] [--timeout <s>]
aseptic containers | docker-clean | infra <n> | infra-up <n> | infra-down
aseptic bundle export [-o fichier] | import <fichier> [--overwrite]
aseptic daemon start | stop | status

Diagnostic, consentement et autodécouverte

aseptic telemetry info | on | off | dismiss | test [--note <texte>]
aseptic telemetry report <message> # rapport d'incident RÉEL (regroupé en issue)
aseptic report <message> [-n N]     # rapport LOCAL dans .aseptic/.runtime/reports/
aseptic consent info | history | accept --yes | sync
aseptic access sync                 # envoie les accès en attente à l'historique du compte
aseptic info                        # version, chemins effectifs et scénario actif
aseptic ops [--json]                # la surface complète du moteur
aseptic mcp                         # démarre le serveur MCP en stdio

Les deux rapports ne sont pas le même. telemetry report envoie le vôtre, il lui faut donc la télémétrie activée et le réseau ; report écrit un fichier sur votre disque, fonctionne sans l’une ni l’autre et vous donne son chemin pour que vous l’attachiez où vous voulez. Les deux sont expurgés.

Bibliothèques locales

aseptic library list | show <id> | add <chemin> | delete <id>
aseptic library clone <url>         # clone le dépôt et renvoie son chemin
aseptic library detect <chemin>     # quelle bibliothèque Aseptic voit là
aseptic library build <id>          # exécute sa commande de construction
aseptic library link <id>           # construit et place l'artefact là où le consommateur le voit
aseptic library unlink <id>         # retire le lien chez tous les consommateurs
aseptic library watch <id> | unwatch <id>       # reconstruire et relier au changement (opt-in)
aseptic library status [id]         # consommateurs résolus et si elle est liée (sans id : toutes)
aseptic library branch <id> | branches <id> | checkout <id> <branche> | fetch <id> | pull <id>

watch est opt-in exprès : reconstruire à chaque changement coûte, et ce n’est pas toujours ce que vous voulez pendant que vous touchez à la bibliothèque. Voir Bibliothèques.

Catalogue de l’équipe

aseptic team list                   # ce que l'équipe partage
aseptic team status                 # ce qui est ici est-il toujours celui de l'équipe ?
aseptic team adopt <id> [--apply]   # le rapatrier et l'adopter ici
aseptic team fetch <id> [-o fich.]  # télécharger le paquet seulement
aseptic team publish <scénario> [-d "à quoi ça sert"]
aseptic team unpublish <id> --yes   # le retire à TOUTE l'équipe

Sans --apply, adopt ne montre que le plan et ce qui manque sur cette machine. Il exige que le projet ait un catalogue configuré. Voir Équipe.

Compte, forfait et paramètres personnels

aseptic plan                        # forfait, état, période et sièges
aseptic sync status                 # révision publiée vs. celle que connaît cette copie
aseptic sync pull | push            # récupérer ou publier vos paramètres personnels
aseptic sync key-create | key-set <clé>         # la clé qui les chiffre
aseptic sync forget                 # arrête de synchroniser et efface ce qui a été publié

Acheter n’est pas dans le CLI, exprès : cela se fait dans le portail web ou depuis les Paramètres. Ce que sync synchronise, ce sont vos paramètres (thème, palette, disposition, langue), jamais rien du projet.

Tâches, dépendances et surface MCP

aseptic tasks                       # tâches longues en cours du moteur
aseptic tasks --history             # les dernières terminées, avec leur résultat
aseptic tasks --output <id>         # la sortie de l'une d'elles, déjà assainie
aseptic install <micro>             # installe les dépendances d'un micro Node/Angular
aseptic logs-export [-o fichier]    # paquet de diagnostic, déjà expurgé
aseptic mcp-surface                 # quelle surface MCP est active
aseptic mcp-usage                   # comment elle est utilisée sur cette machine
aseptic mcp-tune                    # ce qui cloche dans cette surface, avec ses preuves

Le paquet de logs-export est expurgé : les identifiants déclarés n’y voyagent pas, ce qui est précisément la raison pour laquelle on le joint à un rapport de bug.

Voir aussi

• Le CLI en un coup d’œil · Flux typiques · MCP