Skip to content

CLI

Command Overview:

Usage: tc <COMMAND>

  • build — Build layers, extensions and pack function code
  • changelog — Generate changelog for topology
  • compose — Compose a Topology
  • create — Create a sandboxed topology
  • delete — Delete a sandboxed topology
  • freeze — Freeze a sandbox and make it immutable
  • invoke — Invoke a topology synchronously or asynchronously
  • list — List resources in a topology
  • prune — Prune all resources in given sandbox
  • resolve — Resolve a topology
  • route — Route traffic to the given sandbox
  • scaffold — Scaffold functions
  • snapshot — Snapshot of current sandbox and env
  • test — Run tests in topology
  • tag — Create semver tags scoped by a topology
  • unfreeze — Unfreeze a sandbox and make it mutable
  • update — Update entity and components
  • upgrade — upgrade tc version
  • version — display current tc version

Build layers, extensions and pack function code

Usage: tc build [OPTIONS]

  • -e, --profile <PROFILE>
  • -n, --name <NAME>
  • -k, --kind <KIND>
  • -i, --image <IMAGE>
  • -l, --layer <LAYER>
  • -v, --version <VERSION>
  • --clean
  • -r, --recursive
  • -t, --trace
  • -p, --publish
  • --promote
  • --shell
  • -s, --sync
  • --parallel
  • --remote

Generate changelog for topology

Usage: tc changelog [OPTIONS]

  • -b, --between <BETWEEN>
  • -s, --search <SEARCH>
  • -v, --verbose

Compose a Topology

Usage: tc compose [OPTIONS]

  • --versions
  • -r, --recursive
  • --root
  • -c, --entity <ENTITY>
  • -d, --dir <DIR>
  • -f, --format <FORMAT>
  • -t, --trace

Create a sandboxed topology

Usage: tc create [OPTIONS]

  • -e, --profile <PROFILE>
  • -R, --role <ROLE>
  • -s, --sandbox <SANDBOX>
  • -T, --topology <TOPOLOGY>
  • --notify
  • -r, --recursive
  • --cache
  • -t, --trace
  • -d, --dirty

Delete a sandboxed topology

Usage: tc delete [OPTIONS]

  • -e, --profile <PROFILE>
  • -R, --role <ROLE>
  • -s, --sandbox <SANDBOX>
  • -c, --entity <ENTITY>
  • -r, --recursive
  • --cache
  • -t, --trace

Freeze a sandbox and make it immutable

Usage: tc freeze [OPTIONS]

  • -e, --profile <PROFILE>
  • -s, --sandbox <SANDBOX>
  • -t, --trace

Invoke a topology synchronously or asynchronously

Usage: tc invoke [OPTIONS]

  • -p, --payload <PAYLOAD>
  • -e, --profile <PROFILE>
  • -R, --role <ROLE>
  • -s, --sandbox <SANDBOX>
  • -c, --entity <ENTITY>
  • -d, --dir <DIR>
  • --local
  • --dumb
  • -t, --trace

List resources in a topology

Usage: tc list [OPTIONS]

  • -e, --profile <PROFILE>
  • -s, --sandbox <SANDBOX>
  • -c, --entity <ENTITY>
  • -f, --format <FORMAT>
  • -v, --versions
  • -t, --trace

Prune all resources in given sandbox

Usage: tc prune [OPTIONS]

  • -e, --profile <PROFILE>
  • -s, --sandbox <SANDBOX>
  • -f, --filter <FILTER>
  • --dry-run
  • -t, --trace

Resolve a topology

Usage: tc resolve [OPTIONS]

  • -e, --profile <PROFILE>
  • -R, --role <ROLE>
  • -s, --sandbox <SANDBOX>
  • -c, --entity <ENTITY>
  • -q, --quiet
  • -r, --recursive
  • --diff
  • --cache
  • -t, --trace

Route traffic to the given sandbox

Usage: tc route [OPTIONS] --service <SERVICE>

  • -e, --profile <PROFILE>
  • -E, --event <EVENT>
  • -s, --sandbox <SANDBOX>
  • -S, --service <SERVICE>
  • -r, --rule <RULE>
  • --list
  • -t, --trace

Scaffold functions

Usage: tc scaffold [OPTIONS]

  • -k, --kind <KIND>
  • -d, --dir <DIR>

Snapshot of current sandbox and env

Usage: tc snapshot [OPTIONS]

  • -e, --profile <PROFILE>
  • -s, --sandbox <SANDBOX>
  • -f, --format <FORMAT>
  • -m, --manifest
  • -S, --save <SAVE>
  • --target-profile <TARGET_PROFILE>

Run tests in topology

Usage: tc test [OPTIONS]

  • -d, --dir <DIR>
  • -l, --lang <LANG>
  • --with-deps
  • -t, --trace

Create semver tags scoped by a topology

Usage: tc tag [OPTIONS]

  • -n, --next <NEXT>
  • -s, --service <SERVICE>
  • --dry-run
  • --push
  • --unwind
  • -S, --suffix <SUFFIX>
  • -t, --trace

Unfreeze a sandbox and make it mutable

Usage: tc unfreeze [OPTIONS]

  • -e, --profile <PROFILE>
  • -s, --sandbox <SANDBOX>
  • -t, --trace

Update entity and components

Usage: tc update [OPTIONS]

  • -e, --profile <PROFILE>
  • -R, --role <ROLE>
  • -s, --sandbox <SANDBOX>
  • -c, --entity <ENTITY>
  • -a, --asset <ASSET>
  • --notify
  • -r, --recursive
  • --cache
  • -t, --trace

upgrade tc version

Usage: tc upgrade [OPTIONS]

  • -v, --version <VERSION>
  • -t, --trace

display current tc version

Usage: tc version