Comandi per gruppo

Tutti i comandi accettano --json e -p <percorso>. Aggiungi -h a uno qualsiasi per il suo aiuto completo.

Creare il progetto

aseptic init [percorso]             # .aseptic/ con la sua configurazione e il catalogo vuoto

Tutto il resto ha bisogno di un progetto —la cartella che contiene .aseptic/—. Sul desktop lo semina l’installer la prima volta; da terminale (una CI, un clone appena fatto) si crea con questo. Non calpesta nulla: su una cartella a metà completa ciò che manca.

Stato e ciclo di vita dello scenario

aseptic status                      # motore attivo, Docker, scenario attivo e micro
aseptic doctor [scenario]           # verifica dell'ambiente prima di avviare (e come ottenere ciò che manca)
aseptic start <scenario> [flag]     # avvia (avvia il daemon se serve) e aspetta healthy
aseptic stop                        # ferma lo scenario attivo
aseptic restart <micro>             # riavvia un micro singolo
aseptic debug <micro> [on|off]      # apre o chiude il suo debugger; senza on/off, come agganciarsi
aseptic runs [show|logs|pin|delete] # cronologia delle esecuzioni dello scenario
aseptic restart-all                 # ferma e riavvia l'intero scenario
aseptic metrics [micro]             # ultimo campione di metriche (--json = cronologia)
aseptic set-resolution <dep> <local|cloud|mock>   # cambia la risoluzione a caldo
aseptic cleanup [scenario]          # pulizia difensiva (orfani, porte)
aseptic prep <scenario> --when <pre-boot|post-migrate>
aseptic console <servizio>          # psql/redis-cli dentro il suo container
aseptic kafka topics|consume|produce   # topic e messaggi del Kafka dell’infra
aseptic logs [micro] [-f] [-n N] [--errors] [-g pattern]
aseptic call <micro> [percorso] [-X metodo] [-d corpo] [-H k=v...]
aseptic diagnose <micro> [-n N]     # cosa non va in un micro, in un colpo

Flag di start: -r/--resolve <dep=modalità> (override puntuale di risoluzione), -m/--mode <micro=modalità> (native|container), --no-wait, --no-docker, --timeout <s> (predefinito 600). start avvia Docker da solo tranne con --no-docker.

Scenari

aseptic scenario list | show <n> | graph <n> | save --file <yml> | delete <n>
aseptic scenario add-service <scenario> <micro>      # senza reinviare l'intero documento
aseptic scenario remove-service <scenario> <micro>
aseptic scenario set-resolution <scenario> <dep> <local|cloud|mock>   # fissa quella salvata
aseptic scenario from-folder <cartella> <nome>        # importa la cartella e crea lo scenario
aseptic scenario export <n> [-o file] [--include-run]
aseptic scenario import <file> [--apply] [politiche]

add-service e remove-service modificano ciò che è salvato: non serve reinviare l’intero scenario per toccare un micro. E attenzione ai due set-resolution: quello in alto (aseptic set-resolution) cambia la risoluzione a caldo, sullo scenario in esecuzione; questo la fissa nello scenario salvato.

from-folder è la scorciatoia per iniziare: importa tutti i micro di una cartella e crea lo scenario con loro, in un colpo.

Micro

aseptic service list | show <id> | add <percorso-repo> | save --file <yml> | delete <id>
aseptic service detect <percorso>   # quale manifesto vede Aseptic lì, SENZA salvarlo
aseptic service clone <url> [--alta]            # clona e, con --alta, lo registra
aseptic service clone-all <url...>  # clona in blocco e autorileva ogni micro
aseptic service import-all <cartella>           # registra tutti quelli di una cartella
aseptic service export <id> [--include-run] | import <yml...>
aseptic service drift <id>          # il manifesto diverge dal repo? (exit 1 se c'è drift)
aseptic service rescan <id>         # riconcilia dal repo (preserva la curatela)
aseptic service rescan-all          # lo stesso per TUTTO il catalogo
aseptic service effective-config <id>           # valore finale di ogni chiave e da quale livello viene
aseptic service frontend-info <id>  # front: come serve, se riceve --proxy-config e cosa porta il repo
aseptic service branch <id> | branches <id> | checkout <id> <ramo> | fetch <id> | pull <id>
aseptic service fetch-all           # scarica le novità di TUTTI i repo del catalogo
aseptic service switch-branch <id> <ramo>       # cambia ramo e riconcilia il manifesto
aseptic service hot-switch-branch <id> <ramo>   # lo stesso con il micro attivo: ferma solo lui
aseptic dependency rename <da> <a>  # rinomina la dipendenza in servizi, scenari e mock
aseptic service files <id> [pattern] [-d <sottocartella>]   # elenca i file del repo del micro
aseptic service read-file <id> <percorso>                   # stampa un file di testo del repo
aseptic service write-file <id> <percorso> [--from <file>]  # ne scrive uno (o dallo standard input)

clone-all e import-all sono l’ingresso di un intero team: clonare venti repo e registrarli uno per uno è il pomeriggio che questo fa risparmiare il primo giorno.

effective-config risponde a «da dove viene questo valore?» senza avviare nulla, che è la domanda di ogni micro che parte con la configurazione sbagliata.

Database

aseptic db list | save --file <yml> | delete <id>
aseptic db test <host> <porta>      # raggiungibilità TCP (exit 1 se non risponde)

Mock

aseptic mock services | catalog [servizio] | calls | events | clear-calls
aseptic mock save <servizio> --file <json> | delete <servizio> --method GET --path /x
aseptic mock set-active <servizio> --method GET --path /x --variant 1
aseptic mock capture|uncapture <servizio> --method GET --path /x   # chiama il servizio reale e registra la risposta
aseptic mock operations <servizio> | skeleton <servizio> <metodo> <percorso>
aseptic mock set-openapi <servizio> [origine]   # da dove escono i corpi (senza origine, la rimuove)
aseptic mock set-service <gruppo> --prefix /x [--openapi <origine>] [--base-url <url>] [--rename-from <id>]
aseptic mock regroup <gruppo> [--from <servizio>]  # sposta nel gruppo gli stub sotto il suo prefisso
aseptic mock delete-service <servizio> --yes    # cancella l'INTERO catalogo di mock del servizio
aseptic mock from-call <metodo> <percorso>
aseptic mock probe <metodo> <percorso> [-H 'Nome: valore'] [-d '<corpo>']  # cosa servirebbe, e per quale regola
aseptic mock put-file <servizio> <file>  # copia un file in mocks/files/ per servirlo come corpo
aseptic mock export|import <servizio> [file] | export-all|import-all [file]
aseptic mock request [percorso] [-X metodo] [-d corpo] [-H k=v]   # chiama il gateway dei mock (motore attivo)

In cattura, un endpoint smette di servire la sua variante: chiama il servizio reale e salva la risposta come variante Real <status>, che diventa attiva. Una volta spenta (uncapture), continua a servire ciò che ha registrato.

Avvio personalizzato

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

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

--tools decide da dove escono gli strumenti dell’avvio nativo: auto (predefinito) usa quelli della tua macchina e, se ne manca uno e Docker è avviato, il container degli strumenti; local e container lo fissano, e auto rimuove l’impostazione del micro. Vedi Modalità nativa vs container.

Impostazioni

aseptic config show | get <chiave> | set <chiave> <valore> | unset <chiave>

Chiavi: workspace, composeFile (bundled o percorso), mockPort, caBundle (la CA della tua azienda, PEM o DER), toolchainRegistry (prefisso di un mirror per le immagini degli strumenti) e credentials.<nome>.

Strumenti di sviluppo

aseptic toolchain list                   # cosa sa installare e cosa è installato
aseptic toolchain install java 21        # in java, la versione major
aseptic toolchain install node 22.22.3   # negli altri, quella esatta (o un prefisso: 22)
aseptic toolchain remove maven 3.10.0    # la cancella dalla cache di Aseptic

Installa il JDK, Maven, Gradle, Node, Go o l’SDK .NET che manca nella cache di Aseptic (~/.aseptic/toolchains/): senza amministratore, senza toccare il PATH della macchina e verificando il checksum prima di estrarre. Quello che hai già installato continua a prevalere. aseptic doctor dice cosa manca e con quale comando si ottiene.

Docker, pacchetto del catalogo e daemon

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

Diagnostica, consenso e autoscoperta

aseptic telemetry info | on | off | dismiss | test [--note <testo>]
aseptic telemetry report <messaggio> # rapporto di incidente REALE (raggruppato come issue)
aseptic report <messaggio> [-n N]   # rapporto LOCALE in .aseptic/.runtime/reports/
aseptic consent info | history | accept --yes | sync
aseptic access sync                 # invia gli accessi in sospeso alla cronologia dell'account
aseptic info                        # versione, percorsi effettivi e scenario attivo
aseptic ops [--json]                # la superficie completa del motore
aseptic mcp                         # avvia il server MCP via stdio

I due rapporti non sono lo stesso. telemetry report invia il tuo, quindi gli servono la telemetria accesa e la rete; report scrive un file sul tuo disco, funziona senza né l’una né l’altra e ti dà il suo percorso per allegarlo dove vuoi. Entrambi sono ripuliti.

Librerie locali

aseptic library list | show <id> | add <percorso> | delete <id>
aseptic library clone <url>         # clona il repo e restituisce il suo percorso
aseptic library detect <percorso>   # quale libreria Aseptic vede lì
aseptic library build <id>          # esegue il suo comando di costruzione
aseptic library link <id>           # costruisce e mette l'artefatto dove il consumatore lo veda
aseptic library unlink <id>         # rimuove il collegamento in tutti i consumatori
aseptic library watch <id> | unwatch <id>       # ricostruire e ricollegare al cambiamento (opt-in)
aseptic library status [id]         # consumatori risolti e se è collegata (senza id: tutte)
aseptic library branch <id> | branches <id> | checkout <id> <ramo> | fetch <id> | pull <id>

watch è opt-in di proposito: ricostruire a ogni cambiamento costa, e non è sempre ciò che vuoi mentre metti mano alla libreria. Vedi Librerie.

Catalogo del team

aseptic team list                   # cosa condivide il team
aseptic team status                 # quello che c'è qui è ancora quello del team?
aseptic team adopt <id> [--apply]   # portalo qui e adottalo
aseptic team fetch <id> [-o file]   # solo scaricare il pacchetto
aseptic team publish <scenario> [-d "a cosa serve"]
aseptic team unpublish <id> --yes   # lo toglie a TUTTO il team

Senza --apply, adopt mostra solo il piano e cosa manca su questa macchina. Richiede che il progetto abbia un catalogo configurato. Vedi Team.

Account, piano e impostazioni personali

aseptic plan                        # piano, stato, periodo e postazioni
aseptic sync status                 # revisione pubblicata vs. quella che conosce questa copia
aseptic sync pull | push            # portare o pubblicare le impostazioni personali
aseptic sync key-create | key-set <chiave>      # la chiave che le cifra
aseptic sync forget                 # smette di sincronizzare e cancella il pubblicato

Comprare non è nella CLI di proposito: si fa nel portale web o dalle Impostazioni. Ciò che sync sincronizza sono le tue impostazioni (tema, palette, disposizione, lingua), mai nulla del progetto.

Attività, dipendenze e superficie MCP

aseptic tasks                       # attività lunghe in corso del motore
aseptic tasks --history             # le ultime terminate, con il loro esito
aseptic tasks --output <id>         # l'output di una, già ripulito
aseptic install <micro>             # installa le dipendenze di un micro Node/Angular
aseptic logs-export [-o file]       # pacchetto di diagnostica, già ripulito
aseptic mcp-surface                 # quale superficie MCP è attiva
aseptic mcp-usage                   # come viene usata su questa macchina
aseptic mcp-tune                    # cosa non funziona in quella superficie, con prove

Il pacchetto di logs-export è ripulito: le credenziali dichiarate non ci viaggiano dentro, che è esattamente il motivo per cui lo si allega a una segnalazione di bug.

Vedi anche

• La CLI a colpo d’occhio · Flussi tipici · MCP