CLI (acctl)

acctl és la interfície de línia de comandes per a operadors i desenvolupadors d’Asset Core. Envolta fluxos de treball comuns per executar daemons, diagnòstics, reproducció i gestió d’adaptadors.

Requisits previs

Conjunt d’eines Rust (estable)
Binari d’Asset Core construït (cargo build --release)

Pas 1 - Instal·lar acctl

Construeix la CLI des del repositori:

cargo build --release -p acctl

El binari es troba a target/release/acctl.

Pas 2 - Veure els comandaments disponibles

acctl --help

Comandes disponibles:

Comandament	Descripció
`run`	Llançar el daemon amb descobriment de configuració
`tail`	Transmetre esdeveniments del registre de compromisos
`replay`	Reproduir esdeveniments fora de línia per a l’anàlisi
`snapshot`	Crear o restaurar instantànies
`diag`	Executar diagnòstics de l’entorn
`adapters`	Llançar adaptadors de protocol
`bundle-debug`	Crear un arxiu de depuració per a incidents

Pas 3 - Executar diagnòstics

Comproveu el vostre entorn i configuració:

acctl diag --print-config

Això valida:

Rutes del fitxer de configuració
Accessibilitat del registre de compromisos
Versions de la cadena d’eines

Pas 4 - Ajustar el registre de commits

Transmitre esdeveniments a mesura que es confirmen:

acctl tail --commit-log /path/to/commit_log.log

Opcions:

Flag	Descripció
`--follow`	Continuar transmetent nous esdeveniments
`--format`	Format de sortida: `json` o `summary`
`--from`	Començar des d’una seqüència específica

Pas 5 - Reproducció per a l’anàlisi

Reproduir esdeveniments fora de línia per analitzar l’estat:

acctl replay \
  --commit-log /path/to/commit_log.log \
  --from 0 \
  --to 1000

Replay produeix resums deterministes sense executar el daemon complet.

Pas 6 - Crear instantànies

Exporta l’estat actual com un instantani JSON:

acctl snapshot create \
  --commit-log /path/to/commit_log.log \
  --output snapshot.json

Restaura des de la instantània:

acctl snapshot restore \
  --input snapshot.json \
  --commit-log /path/to/commit_log.log

Pas 7 - Llançament d’adaptadors

Inicieu el servidor MCP per a la integració d’eines d’IA:

acctl adapters \
  --config /path/to/write.toml \
  --read-config /path/to/read.toml \
  --transport stdio

Opcions:

Bandera	Descripció
`--transport`	Protocol: `stdio` o `sse`
`--port`	Port d’escolta SSE (només SSE)

Pas 8 - Crear paquets de depuració

Paquet d’artefactes per a la triatge d’incidents:

acctl bundle-debug \
  --config /path/to/write.toml \
  --output debug-bundle.tar.gz

El paquet inclou:

Fitxers de configuració
Segments del registre de compromisos

Punts de control

Extracció de mètriques de Prometheus
Manifest amb caràcters temporals

Resolució de problemes

”Fitxer de configuració no trobat”

Especifiqueu la ruta completa a la vostra configuració:

acctl run --config /absolute/path/to/config.toml

“Registre de compromisos no accessible”

Comproveu els permisos del fitxer i que el camí existeix:

ls -la /path/to/commit_log.log

“Adaptador binari no trobat”

Construeix primer els adaptadors:

cargo build --release -p assetcore-adapters

Variables d’entorn

acctl respecta aquestes variables d’entorn:

Variable	Descripció
`ASSETCORE_WRITE_URL`	Substituir URL del daemon d’escriptura
`ASSETCORE_READ_URL`	Substituir URL del daemon de lectura

Properes passes

Conceptes bàsics de desplegament - Executant daemons en producció
Salut i Mètriques - Monitorització d’endpoint
Integració MCP - Utilitzant l’adaptador MCP