Skip to content
SHC Docs

shc catalog build

build a catalog root from an apps tree

build every package under --apps, number each revision against the index the catalog served last (--prior), and write the catalog root to --out: index.yaml and each new archive at /<app_version>+/-.app. Archive URLs in the index are under --archive-base, the URL the root is served at. --out must be absent or empty.

shc catalog build [flags]
--apps string apps tree to package, one package per directory holding an app.yaml (default "apps")
--archive-base string URL the catalog root is served at (required)
--commit string the git commit the catalog is built from, stamped as built_from_commit
--deny string space-separated app names that never enter the catalog
-h, --help help for build
--keep int versions per app kept in the index, newest first (default 50)
--now string published_at for new versions, RFC3339 (default: the current time)
--out string catalog root to write, absent or empty (required)
--prior string the index this catalog served last; empty for its first publish
--raises string YAML map of <name>@<version> to the requires_shc a published version is raised to
--config stringArray extra YAML config file to layer on top of auto-discovered config; repeatable, later files win
-d, --debug enable debug mode (default: $SHC_DEBUG)
-e, --environment string environment name (default: "prod", or "default" on an estate with no licence and no trial; $SHC_ENVIRONMENT and shc ctx -e override it, and the "master" tenant is always "default")
--exclude string comma-separated dotted paths to drop
--fields string comma-separated columns/keys to show (and their order)
--filter string comma-separated dotted paths to keep (drops everything else)
-o, --output string output format: tty|text|json|yaml (default: $SHC_OUTPUT)
-s, --stack string stack name (default: $SHC_STACK)
-t, --tenant string tenant name (default: $SHC_TENANT)
-v, --verbose verbose output (default: $SHC_VERBOSE)
  • shc catalog - browse what the registered repositories publish