Skip to content
SHC Docs

shc constraint explain

explain which constraints and labels shape a deployment’s eligible nodes

Print a deployment’s eligible nodes and every constraint that shaped them, with its source and scope: resource constraints from its volumes, its integrations, the constraints on its scope ladder (cluster, tenant, deployment), reserved label values and the node condition. The deployment is the global -s, with -t and -e.

--what-if-node explains one node as the only candidate. --where and --prefer evaluate as if those constraints were set and change nothing.

shc constraint explain [flags]
shc constraint explain -s nextcloud -t acme -e prod
shc constraint explain -s wiki --where 'site=ogden' -o json
-h, --help help for explain
--history int bound the history rows (default 10)
--prefer string evaluate as if this prefer constraint were set
--service string explain one service of the deployment
--what-if-node string explain this node as the only candidate
--where string evaluate as if this where constraint were set
--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)