orcadev

Overview ¶

Package orcadev implements the `orcadev` developer / debug tool.

orcadev is a multi-purpose CLI for working with a running orca dev cluster. It subsumes the older `orcaseed` tool: every orcaseed capability (synthetic-blob generation, single-file upload, origin listing, bulk delete) is reachable here as a subcommand, plus a broader debugging surface:

upload     - seed the origin (file or N synthetic blobs); both
             azureblob and awss3 drivers supported
list       - enumerate origin objects
delete     - bulk delete origin objects
roundtrip  - upload data -> request through orca -> compare
             SHA-256 of source vs response; the headline
             correctness check
cache      - inspect / clear the chunk cachestore
  list       - enumerate cachestore objects (raw chunk paths)
  inspect    - given (bucket, key), show which chunks are
               present in the cachestore
  clear      - bulk delete chunks
bench      - parallel GET throughput / latency benchmark with
             JSON output and log-spaced latency histogram
scenario   - canned end-to-end scenarios (cold-warm, range-stress,
             empty-object, etag-change)

All subcommands accept --config <path> to point at an orca YAML (the same shape internal/orca/config consumes); per-flag overrides let the operator point at a different origin or cachestore without editing the YAML. The default `--preset=dev` bundles the dev-install coordinates (azureblob origin against in-cluster Azurite, S3 cachestore against in-cluster Garage, edge URL http://localhost:8443), and orcadev auto-opens kubectl port-forwards to svc/orca, svc/azurite, svc/garage as needed. This works on any cluster reachable via kubectl - kind, AKS, EKS, k3d. For the full install + driving recipe, see hack/orca/README.md.