CLI (acctl)

acctl és la interfície d’operador autoritzada per a Asset Core. Envolta els fluxos de treball que necessiteu per validar la governança, realitzar diagnòstics, reproduir estats i recuperar-vos de fallades quan l’automatització no és suficient.

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

La llista de comandes a continuació és una referència. Per a orientació centrada en tasques, consulteu la Guia de l’Operador ACCTL.

Comandes disponibles:

Comandament	Descripció
`adapters`	Llançar adaptadors de protocol (MCP/OpenAI/Gemini)
`auth`	Autenticar, inspeccionar permisos i gestionar tokens
`run`	Llançar daemons amb descoberta de configuració i inicialització
`namespaces`	Llistar, provisionar i actualitzar espais de noms
`read-stream`	Transmetre compromisos de daemon de lectura a través de SSE
`tail`	Transmetre sobres del registre de sobres
`replay`	Reproduir sobres fora de línia per a anàlisi
`query-commits`	Consultar l’historial de compromisos a través de daemon de lectura
`query-container-commits`	Historial de compromisos per a un contenidor
`list-containers`	Llistar contenidors amb filtres
`get-container-contents`	Obtenir balances, slots o continguts de la graella
`get-container-grid`	Inspeccionar l’ocupació de la graella (regió opcional)
`find-grid-free`	Trobar ancoratges de graella lliures per a una forma
`list-instances`	Llistar instàncies amb filtres
`get-instance`	Obtenir metadades de la instància
`owner-summary`	Agregar dades per a un propietari
`snapshot`	Crear o restaurar instantànies
`diag`	Executar diagnòstics de l’entorn i comprovacions d’endpoint
`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 - Seguir el registre de l’envolupant

Transmitre esdeveniments a mesura que es confirmen:

acctl tail --envelope-log /path/to/envelope.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 \
  --envelope-log /path/to/envelope.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 \
  --envelope-log /path/to/envelope.log \
  --output snapshot.json

Restaura des de la instantània:

acctl snapshot restore \
  --input snapshot.json \
  --envelope-log /path/to/envelope.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

Solució 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
`ACCTL_ALLOW_PLAINTEXT_TOKEN_STORE`	Permetre l’emmagatzematge de tokens en text pla quan el keyring no està disponible
`ASSETCORE_BASE_DIR`	Substituir el directori base per a rutes resoltes

Properes passes

Conceptes bàsics de desplegament - Executant daemons en producció
Salut i Mètriques - Monitorització de punts finals
Tooling Guide - Superfície d’eines de l’adaptador canònic