Files
distributor/docs/cli.md

1.5 KiB

Distributor CLI

Shortest useful command

go run ./cmd/distributor validate examples/source-bundle

This validates a local source bundle fixture.

Command overview

distributor --help
distributor version
distributor run
distributor validate
distributor inspect

version prints the application name and version. The default development version is dev; release builds may replace it at build time.

run --config <path> --dry-run loads and validates configuration, then prints a concise summary of configured pipelines and destinations. It does not discover bundles or publish files yet.

validate <path> validates a local source bundle directory or a local tree containing source bundles.

inspect <path> validates discovered local source bundles and prints a concise normalized summary.

run without --dry-run intentionally fails with a clear not implemented error until execution behavior exists.

Flag reference

The root command supports:

  • --help, -h: print root help.

Each subcommand supports:

  • --help, -h: print command-specific help.

run supports:

  • --config <path>: config file to load.
  • --dry-run: validate config and print the resolved summary without publishing.

Common workflows

Validate a source bundle:

go run ./cmd/distributor validate examples/source-bundle

Inspect a source bundle:

go run ./cmd/distributor inspect examples/source-bundle

Validate a config file without publishing:

go run ./cmd/distributor run --config examples/local-to-local.yml --dry-run