Skip to content
SHC Docs

shc cluster reconcile

re-ensure the modules

Re-ensure the cluster’s modules, postgres, keycloak, openobserve and traefik, without a full re-init. Idempotent: already-present modules are skipped, missing ones are installed, so a deleted master deployment can be restored at any time. Honours the daemon’s SHC_MODULES; override with --modules. Requires a running daemon.

This is also how a capacity-deferred deployment is recovered. A module other than traefik whose rendered CPU ceiling exceeds every node’s measured CPUs is skipped by init rather than attempted, reported as [X200916SYSCAP], and recorded as deferred. traefik is the edge nodes join through on 443, so a node that cannot host it fails init with [X409146EDGCAP] instead of finishing without it. Add capacity, by joining or resizing a node, or lower the ceiling with shc config set deploy.limit_ratio <ratio>, and re-run reconcile from any node: it measures the whole cluster again and installs exactly the deferrals that now fit, on a node that fits them, even though init already completed. Deployments you uninstalled on purpose are never re-offered.

shc cluster reconcile [flags]
-h, --help help for reconcile
--modules string override which modules to re-ensure while init's module pass is unfinished or a module waits on capacity; comma-separated, e.g. 'postgres,keycloak'. traefik is always in the selection because nodes join through it on 443, so empty means traefik alone. Defaults to the daemon's SHC_MODULES.
--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)