Befehle nach Gruppe

Alle Befehle akzeptieren --json und -p <Pfad>. Fügen Sie einem beliebigen -h für seine vollständige Hilfe hinzu.

Das Projekt anlegen

aseptic init [Pfad]                 # .aseptic/ mit seiner Konfiguration und leerem Katalog

Alles andere braucht ein Projekt —den Ordner, der .aseptic/ enthält—. Auf dem Desktop legt der Installer es beim ersten Mal an; vom Terminal aus (eine CI, ein frischer Klon) erstellt man es hiermit. Es überschreibt nichts: auf einem halb fertigen Ordner ergänzt es, was fehlt.

Status und Lebenszyklus des Szenarios

aseptic status                      # aktive Engine, Docker, aktives Szenario und Micros
aseptic doctor [Szenario]           # Umgebungsprüfung vor dem Start (und wie man Fehlendes holt)
aseptic start <Szenario> [Flags]    # startet (startet Daemon bei Bedarf) und wartet healthy
aseptic stop                        # stoppt das aktive Szenario
aseptic restart <micro>             # startet einen einzelnen Micro neu
aseptic debug <micro> [on|off]      # öffnet oder schließt seinen Debugger; ohne on/off, wie man sich anhängt
aseptic runs [show|logs|pin|delete] # Laufverlauf des Szenarios
aseptic restart-all                 # stoppt und startet das ganze Szenario neu
aseptic metrics [micro]             # letzter Metrik-Messwert (--json = Verlauf)
aseptic set-resolution <dep> <local|cloud|mock>   # ändert die Auflösung heiß
aseptic cleanup [Szenario]          # defensive Bereinigung (Verwaiste, Ports)
aseptic prep <Szenario> --when <pre-boot|post-migrate>
aseptic console <dienst>            # psql/redis-cli in seinem Container
aseptic kafka topics|consume|produce   # Topics und Nachrichten des Infra-Kafka
aseptic logs [micro] [-f] [-n N] [--errors] [-g Muster]
aseptic call <micro> [Pfad] [-X Methode] [-d Body] [-H k=v...]
aseptic diagnose <micro> [-n N]     # was mit einem Micro los ist, auf einen Schlag

Flags von start: -r/--resolve <dep=Modus> (punktuelles Override der Auflösung), -m/--mode <micro=Modus> (native|container), --no-wait, --no-docker, --timeout <s> (Standard 600). start startet Docker von selbst außer bei --no-docker.

Szenarien

aseptic scenario list | show <n> | graph <n> | save --file <yml> | delete <n>
aseptic scenario add-service <Szenario> <micro>      # ohne das ganze Dokument neu zu senden
aseptic scenario remove-service <Szenario> <micro>
aseptic scenario set-resolution <Szenario> <dep> <local|cloud|mock>   # legt die gespeicherte fest
aseptic scenario from-folder <Ordner> <Name>          # importiert den Ordner und legt das Szenario an
aseptic scenario export <n> [-o Datei] [--include-run]
aseptic scenario import <Datei> [--apply] [Richtlinien]

add-service und remove-service bearbeiten das Gespeicherte: Um einen Micro zu ändern, muss nicht das ganze Szenario neu gesendet werden. Und Vorsicht bei den beiden set-resolution: Das obere (aseptic set-resolution) ändert die Auflösung heiß, am laufenden Szenario; dieses hier legt sie fest im gespeicherten Szenario.

from-folder ist die Abkürzung zum Einstieg: Es importiert alle Micros eines Ordners und legt das Szenario mit ihnen an, in einem Schritt.

Micros

aseptic service list | show <id> | add <Repo-Pfad> | save --file <yml> | delete <id>
aseptic service detect <Pfad>       # welches Manifest Aseptic dort sieht, OHNE es zu speichern
aseptic service clone <url> [--alta]            # klont und registriert es mit --alta
aseptic service clone-all <url...>  # klont gesammelt und erkennt jeden Micro automatisch
aseptic service import-all <Ordner>             # registriert alle Micros eines Ordners
aseptic service export <id> [--include-run] | import <yml...>
aseptic service drift <id>          # weicht das Manifest vom Repo ab? (exit 1 bei Drift)
aseptic service rescan <id>         # gleicht vom Repo ab (bewahrt die Kuratierung)
aseptic service rescan-all          # dasselbe für den GANZEN Katalog
aseptic service effective-config <id>           # Endwert jedes Schlüssels und aus welcher Ebene er kommt
aseptic service frontend-info <id>  # Frontend: wie es ausliefert, ob es --proxy-config annimmt und was das Repo mitbringt
aseptic service branch <id> | branches <id> | checkout <id> <Branch> | fetch <id> | pull <id>
aseptic service fetch-all           # holt Neuigkeiten ALLER Repos des Katalogs
aseptic service switch-branch <id> <Branch>     # wechselt den Branch und gleicht das Manifest ab
aseptic service hot-switch-branch <id> <Branch> # dasselbe bei laufendem Micro: stoppt nur ihn
aseptic dependency rename <von> <nach>  # benennt die Abhängigkeit in Diensten, Szenarien und Mocks um
aseptic service files <id> [Muster] [-d <Unterordner>]   # listet Dateien im Repo des Micros
aseptic service read-file <id> <Pfad>                    # gibt eine Textdatei des Repos aus
aseptic service write-file <id> <Pfad> [--from <Datei>]  # schreibt eine (oder über die Standardeingabe)

clone-all und import-all sind das Onboarding eines ganzen Teams: Zwanzig Repos zu klonen und einzeln zu registrieren ist der Nachmittag, den das am ersten Tag spart.

effective-config beantwortet „Woher kommt dieser Wert?“, ohne etwas zu starten – die Frage hinter jedem Micro, der mit der falschen Konfiguration startet.

Datenbanken

aseptic db list | save --file <yml> | delete <id>
aseptic db test <Host> <Port>       # TCP-Erreichbarkeit (exit 1 wenn keine Antwort)

Mocks

aseptic mock services | catalog [Dienst] | calls | events | clear-calls
aseptic mock save <Dienst> --file <json> | delete <Dienst> --method GET --path /x
aseptic mock set-active <Dienst> --method GET --path /x --variant 1
aseptic mock capture|uncapture <Dienst> --method GET --path /x   # ruft den echten Dienst auf und zeichnet die Antwort auf
aseptic mock operations <Dienst> | skeleton <Dienst> <Methode> <Pfad>
aseptic mock set-openapi <Dienst> [Quelle]      # woher die Bodies kommen (ohne Quelle wird sie entfernt)
aseptic mock set-service <Gruppe> --prefix /x [--openapi <Quelle>] [--base-url <url>] [--rename-from <id>]
aseptic mock regroup <Gruppe> [--from <Dienst>]    # verschiebt die Stubs unter ihrem Präfix in die Gruppe
aseptic mock delete-service <Dienst> --yes      # löscht den GANZEN Mock-Katalog des Dienstes
aseptic mock from-call <Methode> <Pfad>
aseptic mock probe <Methode> <Pfad> [-H 'Name: Wert'] [-d '<Body>']  # was geliefert würde, und durch welche Regel
aseptic mock put-file <Dienst> <Datei>  # kopiert eine Datei nach mocks/files/, um sie als Body auszuliefern
aseptic mock export|import <Dienst> [Datei] | export-all|import-all [Datei]
aseptic mock request [Pfad] [-X Methode] [-d Body] [-H k=v]   # ruft das Mock-Gateway auf (aktive Engine)

Im Aufzeichnungsmodus liefert ein Endpoint seine Variante nicht mehr aus: Er ruft den echten Dienst auf und speichert die Antwort als Variante Real <status>, die aktiv wird. Nach dem Ausschalten (uncapture) liefert er weiter das Aufgezeichnete aus.

Benutzerdefinierter Start

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

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

--tools entscheidet, woher die Werkzeuge des nativen Starts kommen: auto (Standard) nutzt die deiner Maschine und, wenn eines fehlt und Docker läuft, den Werkzeug-Container; local und container legen es fest, und auto entfernt die Einstellung des Micros. Siehe Nativer Modus vs. Container.

Einstellungen

aseptic config show | get <Schlüssel> | set <Schlüssel> <Wert> | unset <Schlüssel>

Schlüssel: workspace, composeFile (bundled oder Pfad), mockPort, caBundle (die CA deines Unternehmens, PEM oder DER), toolchainRegistry (Präfix eines Spiegels für die Werkzeug-Images) und credentials.<Name>.

Entwicklungswerkzeuge

aseptic toolchain list                   # was es installieren kann und was installiert ist
aseptic toolchain install java 21        # bei java die Hauptversion
aseptic toolchain install node 22.22.3   # beim Rest die genaue (oder ein Präfix: 22)
aseptic toolchain remove maven 3.10.0    # löscht sie aus dem Cache von Aseptic

Es installiert das fehlende JDK, Maven, Gradle, Node, Go oder .NET SDK im Cache von Aseptic (~/.aseptic/toolchains/): ohne Administrator, ohne den PATH der Maschine anzufassen und mit Prüfung der Prüfsumme vor dem Entpacken. Was du bereits installiert hast, behält Vorrang. aseptic doctor sagt, was fehlt und mit welchem Befehl man es holt.

Docker, Katalogpaket und Daemon

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

Diagnose, Einwilligung und Selbstentdeckung

aseptic telemetry info | on | off | dismiss | test [--note <Text>]
aseptic telemetry report <Nachricht> # ECHTER Vorfallsbericht (als Issue gruppiert)
aseptic report <Nachricht> [-n N]   # LOKALER Bericht in .aseptic/.runtime/reports/
aseptic consent info | history | accept --yes | sync
aseptic access sync                 # sendet ausstehende Anmeldungen an den Kontoverlauf
aseptic info                        # Version, effektive Pfade und aktives Szenario
aseptic ops [--json]                # die vollständige Oberfläche der Engine
aseptic mcp                         # startet den MCP-Server über stdio

Die beiden Berichte sind nicht derselbe. telemetry report sendet deinen, braucht also eingeschaltete Telemetrie und Netz; report schreibt eine Datei auf deine Platte, funktioniert ohne beides und gibt dir ihren Pfad, damit du sie anhängen kannst, wo du willst. Beide sind bereinigt.

Lokale Bibliotheken

aseptic library list | show <id> | add <Pfad> | delete <id>
aseptic library clone <url>         # klont das Repo und gibt seinen Pfad zurück
aseptic library detect <Pfad>       # welche Bibliothek Aseptic dort sieht
aseptic library build <id>          # führt ihren Build-Befehl aus
aseptic library link <id>           # baut und legt das Artefakt dorthin, wo der Verbraucher es sieht
aseptic library unlink <id>         # entfernt die Verknüpfung bei allen Verbrauchern
aseptic library watch <id> | unwatch <id>       # bei Änderung neu bauen und verknüpfen (opt-in)
aseptic library status [id]         # aufgelöste Verbraucher und ob sie verknüpft ist (ohne id: alle)
aseptic library branch <id> | branches <id> | checkout <id> <Branch> | fetch <id> | pull <id>

watch ist absichtlich opt-in: bei jeder Änderung neu zu bauen kostet, und es ist nicht immer das, was du willst, während du an der Bibliothek arbeitest. Siehe Bibliotheken.

Team-Katalog

aseptic team list                   # was das Team teilt
aseptic team status                 # ist das hier noch das des Teams?
aseptic team adopt <id> [--apply]   # hol es her und übernimm es hier
aseptic team fetch <id> [-o Datei]  # nur das Paket herunterladen
aseptic team publish <Szenario> [-d "wofür es gut ist"]
aseptic team unpublish <id> --yes   # nimmt es dem GANZEN Team weg

Ohne --apply zeigt adopt nur den Plan und was auf dieser Maschine fehlt. Es setzt voraus, dass das Projekt einen Katalog konfiguriert hat. Siehe Team.

Konto, Tarif und persönliche Einstellungen

aseptic plan                        # Tarif, Status, Zeitraum und Plätze
aseptic sync status                 # veröffentlichte Revision vs. die, die diese Kopie kennt
aseptic sync pull | push            # persönliche Einstellungen holen oder veröffentlichen
aseptic sync key-create | key-set <Schlüssel>   # der Schlüssel, der sie verschlüsselt
aseptic sync forget                 # nicht mehr synchronisieren und Veröffentlichtes löschen

Kaufen steht absichtlich nicht im CLI: das geht im Web-Portal oder aus den Einstellungen. Was sync synchronisiert, sind deine Einstellungen (Thema, Palette, Layout, Sprache), nie etwas aus dem Projekt.

Aufgaben, Abhängigkeiten und MCP-Oberfläche

aseptic tasks                       # laufende lange Aufgaben der Engine
aseptic tasks --history             # die zuletzt beendeten, mit ihrem Ergebnis
aseptic tasks --output <id>         # die Ausgabe einer davon, bereits bereinigt
aseptic install <micro>             # installiert die Abhängigkeiten eines Node-/Angular-Micros
aseptic logs-export [-o Datei]      # Diagnosepaket, bereits bereinigt
aseptic mcp-surface                 # welche MCP-Oberfläche aktiv ist
aseptic mcp-usage                   # wie sie auf dieser Maschine genutzt wird
aseptic mcp-tune                    # was an dieser Oberfläche scheitert, mit Belegen

Das Paket von logs-export ist bereinigt: deklarierte Zugangsdaten reisen nicht darin mit, was genau der Grund ist, warum man es an einen Fehlerbericht hängt.

Siehe auch

• Das CLI auf einen Blick · Typische Abläufe · MCP