Reference

astractl CLI

astractl CLI

astractl is the public operator and developer CLI for Astra.

Usage

astractl --endpoint http://127.0.0.1:2379 [--bearer-token TOKEN] <command> [args]

Global flags

  • --endpoint: target API endpoint (default http://127.0.0.1:2379)
  • --bearer-token: optional JWT bearer token for auth-enabled clusters

Commands

  • put <key> <value>: write a key/value
  • get <key> [--prefix]: read one key or prefix set
  • watch <key> [--prefix] [--from-revision N]: stream watch events
  • blast [--prefix /blast] [--count N] [--payload-size bytes]: PUT load generator
  • watch-crucible ...: high-fanout watch harness
  • bulk-load <manifest> ...: submit bulk-load job
  • bulk-load-job <job-id>: poll bulk-load state
  • oidc-proxy --listen-addr <addr> --upstream <endpoint>...: local refresh-capable bearer-token proxy for apps that cannot attach Astra JWTs themselves on the etcd gRPC path

Typical flows

astractl put /demo/key value
astractl get /demo/key
astractl watch /registry/ --prefix --from-revision 0