Comandos por grupo

Todos os comandos aceitam --json e -p <caminho>. Acrescente -h a qualquer um para a sua ajuda completa.

Criar o projeto

aseptic init [caminho]              # .aseptic/ com a sua configuração e o catálogo vazio

Tudo o resto precisa de um projeto —a pasta que contém .aseptic/—. No ambiente de trabalho o instalador semeia-o da primeira vez; a partir do terminal (uma CI, um clone acabado de fazer) cria-se com isto. Não pisa nada: sobre uma pasta a meio, completa o que falta.

Estado e ciclo de vida do cenário

aseptic status                      # motor vivo, Docker, cenário ativo e micros
aseptic doctor [cenário]            # verificação do ambiente antes de arrancar (e como obter o que falta)
aseptic start <cenário> [flags]     # inicia (lança daemon se preciso) e espera healthy
aseptic stop                        # detém o cenário ativo
aseptic restart <micro>             # reinicia um micro solto
aseptic debug <micro> [on|off]      # abre ou fecha o seu depurador; sem on/off, como ligar-se
aseptic runs [show|logs|pin|delete] # histórico de execuções do cenário
aseptic restart-all                 # para e volta a arrancar o cenário inteiro
aseptic metrics [micro]             # última amostra de métricas (--json = histórico)
aseptic set-resolution <dep> <local|cloud|mock>   # muda a resolução a quente
aseptic cleanup [cenário]           # limpeza defensiva (órfãos, portas)
aseptic prep <cenário> --when <pre-boot|post-migrate>
aseptic console <serviço>           # psql/redis-cli dentro do seu contentor
aseptic kafka topics|consume|produce   # topics e mensagens do Kafka da infra
aseptic logs [micro] [-f] [-n N] [--errors] [-g padrão]
aseptic call <micro> [caminho] [-X método] [-d corpo] [-H k=v...]
aseptic diagnose <micro> [-n N]     # o que se passa com um micro, de uma vez

Flags de start: -r/--resolve <dep=modo> (override pontual de resolução), -m/--mode <micro=modo> (native|container), --no-wait, --no-docker, --timeout <s> (por predefinição 600). start arranca o Docker por sua conta exceto com --no-docker.

Cenários

aseptic scenario list | show <n> | graph <n> | save --file <yml> | delete <n>
aseptic scenario add-service <cenário> <micro>       # sem reenviar o documento inteiro
aseptic scenario remove-service <cenário> <micro>
aseptic scenario set-resolution <cenário> <dep> <local|cloud|mock>   # fixa a guardada
aseptic scenario from-folder <pasta> <nome>           # importa a pasta e cria o cenário
aseptic scenario export <n> [-o ficheiro] [--include-run]
aseptic scenario import <ficheiro> [--apply] [políticas]

add-service e remove-service editam sobre o que está guardado: não é preciso reenviar o cenário inteiro para mexer num micro. E atenção aos dois set-resolution: o de cima (aseptic set-resolution) muda a resolução a quente, sobre o cenário em execução; este deixa-a fixada no cenário guardado.

from-folder é o atalho para começar: importa todos os micros de uma pasta e cria o cenário com eles, de uma vez.

Micros

aseptic service list | show <id> | add <caminho-repo> | save --file <yml> | delete <id>
aseptic service detect <caminho>    # que manifesto o Aseptic vê ali, SEM o guardar
aseptic service clone <url> [--alta]            # clona e, com --alta, regista-o
aseptic service clone-all <url...>  # clona em lote e autodeteta cada micro
aseptic service import-all <pasta>              # regista todos os de uma pasta
aseptic service export <id> [--include-run] | import <yml...>
aseptic service drift <id>          # o manifesto diverge do repo? (exit 1 se houver drift)
aseptic service rescan <id>         # reconcilia a partir do repo (preserva a curadoria)
aseptic service rescan-all          # o mesmo para TODO o catálogo
aseptic service effective-config <id>           # valor final de cada chave e de que camada vem
aseptic service frontend-info <id>  # front: como serve, se recebe --proxy-config e o que o repo já traz
aseptic service branch <id> | branches <id> | checkout <id> <ramo> | fetch <id> | pull <id>
aseptic service fetch-all           # traz novidades de TODOS os repos do catálogo
aseptic service switch-branch <id> <ramo>       # muda de ramo e reconcilia o manifesto
aseptic service hot-switch-branch <id> <ramo>   # o mesmo com o micro vivo: para só esse
aseptic dependency rename <de> <para>  # renomeia a dependência em serviços, cenários e mocks
aseptic service files <id> [padrão] [-d <subpasta>]         # lista ficheiros do repo do micro
aseptic service read-file <id> <caminho>                    # mostra um ficheiro de texto do repo
aseptic service write-file <id> <caminho> [--from <fich>]   # escreve um (ou pela entrada padrão)

clone-all e import-all são a entrada de uma equipa inteira: clonar vinte repos e registá-los um a um é a tarde que isto poupa no primeiro dia.

effective-config responde a «de onde sai este valor?» sem arrancar nada, que é a pergunta de todo o micro que arranca com a configuração errada.

Bases de dados

aseptic db list | save --file <yml> | delete <id>
aseptic db test <host> <porta>      # alcance TCP (exit 1 se não responder)

Mocks

aseptic mock services | catalog [serviço] | calls | events | clear-calls
aseptic mock save <serviço> --file <json> | delete <serviço> --method GET --path /x
aseptic mock set-active <serviço> --method GET --path /x --variant 1
aseptic mock capture|uncapture <serviço> --method GET --path /x   # chama o serviço real e grava a resposta
aseptic mock operations <serviço> | skeleton <serviço> <método> <caminho>
aseptic mock set-openapi <serviço> [origem]     # de onde saem os corpos (sem origem, retira-a)
aseptic mock set-service <grupo> --prefix /x [--openapi <origem>] [--base-url <url>] [--rename-from <id>]
aseptic mock regroup <grupo> [--from <serviço>]    # move para o grupo os stubs sob o seu prefixo
aseptic mock delete-service <serviço> --yes     # apaga o catálogo de mocks INTEIRO do serviço
aseptic mock from-call <método> <caminho>
aseptic mock probe <método> <caminho> [-H 'Nome: valor'] [-d '<corpo>']  # o que serviria, e por que regra
aseptic mock put-file <serviço> <ficheiro>  # copia um ficheiro para mocks/files/ para o servir como corpo
aseptic mock export|import <serviço> [ficheiro] | export-all|import-all [ficheiro]
aseptic mock request [caminho] [-X método] [-d corpo] [-H k=v]   # chama o gateway de mocks (motor vivo)

Em captura, um endpoint deixa de servir a sua variante: chama o serviço real e guarda a resposta como variante Real <status>, que fica ativa. Ao desligá-la (uncapture), continua a servir o que gravou.

Arranque personalizado

aseptic run show <id> | set <id> [opções] | clear <id> | preview <id>
aseptic run export <id> [-o ficheiro] | import <id> <ficheiro>

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

--tools decide de onde saem as ferramentas do arranque nativo: auto (por predefinição) usa as da sua máquina e, se faltar alguma e o Docker estiver iniciado, o contentor de ferramentas; local e container fixam-no, e auto retira a definição do micro. Ver Modo nativo vs contentor.

Definições

aseptic config show | get <chave> | set <chave> <valor> | unset <chave>

Chaves: workspace, composeFile (bundled ou caminho), mockPort, caBundle (a CA da sua empresa, PEM ou DER), toolchainRegistry (prefixo de um espelho para as imagens de ferramentas) e credentials.<nome>.

Ferramentas de desenvolvimento

aseptic toolchain list                   # o que sabe instalar e o que está instalado
aseptic toolchain install java 21        # em java, a versão maior
aseptic toolchain install node 22.22.3   # no resto, a exata (ou um prefixo: 22)
aseptic toolchain remove maven 3.10.0    # apaga-a da cache do Aseptic

Instala o JDK, Maven, Gradle, Node, Go ou o SDK de .NET que falte na cache do Aseptic (~/.aseptic/toolchains/): sem administrador, sem tocar no PATH da máquina e verificando o checksum antes de extrair. A que já tiver instalada continua a mandar. aseptic doctor diz o que falta e com que comando se obtém.

Docker, pacote do catálogo 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 ficheiro] | import <ficheiro> [--overwrite]
aseptic daemon start | stop | status

Diagnóstico, consentimento e autodescoberta

aseptic telemetry info | on | off | dismiss | test [--note <texto>]
aseptic telemetry report <mensagem> # relatório de incidente REAL (agrupa-se como issue)
aseptic report <mensagem> [-n N]    # relatório LOCAL em .aseptic/.runtime/reports/
aseptic consent info | history | accept --yes | sync
aseptic access sync                 # envia os acessos pendentes para o histórico da conta
aseptic info                        # versão, caminhos efetivos e cenário ativo
aseptic ops [--json]                # a superfície completa do motor
aseptic mcp                         # inicia o servidor MCP por stdio

Os dois relatórios não são o mesmo. telemetry report envia o teu, por isso precisa da telemetria ligada e de rede; report escreve um ficheiro no teu disco, funciona sem uma coisa nem outra e dá-te o caminho para o anexares onde quiseres. Ambos vão saneados.

Bibliotecas locais

aseptic library list | show <id> | add <caminho> | delete <id>
aseptic library clone <url>         # clona o repo e devolve o seu caminho
aseptic library detect <caminho>    # que biblioteca o Aseptic vê ali
aseptic library build <id>          # executa o seu comando de construção
aseptic library link <id>           # constrói e põe o artefacto onde o consumidor o veja
aseptic library unlink <id>         # retira a ligação em todos os consumidores
aseptic library watch <id> | unwatch <id>       # reconstruir e religar ao mudar (opt-in)
aseptic library status [id]         # consumidores resolvidos e se está ligada (sem id: todas)
aseptic library branch <id> | branches <id> | checkout <id> <ramo> | fetch <id> | pull <id>

watch é opt-in de propósito: reconstruir a cada mudança custa, e nem sempre é o que queres enquanto mexes na biblioteca. Ver Bibliotecas.

Catálogo da equipa

aseptic team list                   # o que a equipa partilha
aseptic team status                 # o que está aqui ainda é o da equipa?
aseptic team adopt <id> [--apply]   # trá-lo e adota-o aqui
aseptic team fetch <id> [-o fich.]  # só descarregar o pacote
aseptic team publish <cenário> [-d "para que serve"]
aseptic team unpublish <id> --yes   # tira-o a TODA a equipa

Sem --apply, adopt só mostra o plano e o que falta nesta máquina. Exige que o projeto tenha catálogo configurado. Ver Equipa.

Conta, plano e definições pessoais

aseptic plan                        # plano, estado, período e lugares
aseptic sync status                 # revisão publicada vs. a que esta cópia conhece
aseptic sync pull | push            # trazer ou publicar as definições pessoais
aseptic sync key-create | key-set <chave>       # a chave que as cifra
aseptic sync forget                 # deixa de sincronizar e apaga o publicado

Comprar não está no CLI de propósito: faz-se no portal web ou a partir das Definições. O que o sync sincroniza são as tuas definições (tema, paleta, disposição, idioma), nunca nada do projeto.

Tarefas, dependências e superfície MCP

aseptic tasks                       # tarefas longas em curso do motor
aseptic tasks --history             # as últimas terminadas, com o seu resultado
aseptic tasks --output <id>         # a saída de uma, já sanitizada
aseptic install <micro>             # instala as dependências de um micro Node/Angular
aseptic logs-export [-o ficheiro]   # pacote de diagnóstico, já saneado
aseptic mcp-surface                 # que superfície MCP está ativa
aseptic mcp-usage                   # como está a ser usada nesta máquina
aseptic mcp-tune                    # o que falha nessa superfície, com a sua evidência

O pacote de logs-export vai saneado: as credenciais declaradas não viajam nele, que é precisamente para o que se anexa a um relatório de falha.

Ver também

• O CLI num relance · Fluxos típicos · MCP