Skip to content
SHC Docs

shc cluster fabric explain

explain why one fabric endpoint can or cannot reach another

Judge a flow against the compiled fabric reachability policy and show the working: both resolved ends, every chain on every node that decided, the rule’s nft line, and why. A flow is granted by the same deployment, by a port the destination service declares when both ends are in one tenant, by a system-tier role or by an ingress route. An integration edge grants none. Each end is a fabric address or [:]. Both ends are in the tenant from -t and the environment from -e (the estate default when neither is named). --target-tenant and --target-environment place the end in another tenant or environment. A destination deployment that pins several services needs its service named.

With --port the one flow is judged. Without it the answer lists every protocol and port open from to .

The last line says whether this node’s kernel already holds the compiled ruleset.

shc cluster fabric explain <from> <to> [flags]
shc -t acme -e prod cluster fabric explain webapp mydb --port 5432
shc -t acme -e prod cluster fabric explain webapp mydb:postgres
shc cluster fabric explain 10.84.1.130 10.84.2.130 --port 53 --proto udp
-h, --help help for explain
--port int destination port to judge; omit to list what is open
--proto string protocol of the flow: tcp or udp (default "tcp")
--target-environment string environment of the <to> end
--target-tenant string tenant of the <to> end
--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)