meshctl check: Validate Gloo Mesh Health
meshctl check runs health and config validations against a Gloo installation and reports each check as OK or a failure.
For Gloo Mesh and Gloo Gateway, meshctl check is the equivalent of linkerd check or cilium status: one command that tells you if the install is healthy enough to proceed.
What it does
meshctl check inspects the Gloo management components (the management server, agents, and CRDs), verifies the deployments are ready, and validates that the applied Gloo config has no reported errors, printing a checklist with OK or a failure reason for each item and exiting non-zero on failure.
Common usage
meshctl check
# point at a specific kubeconfig/context
meshctl check --kubeconfig $KUBECONFIG --kubecontext mgmtOptions
| Flag | What it does |
|---|---|
| --kubeconfig <path> | Kubeconfig file to use |
| --kubecontext <name> | Context to run the checks against |
| -n, --namespace <ns> | Namespace Gloo is installed in |
In CI
Run meshctl check after installing Gloo and after applying gateway or mesh config; a non-zero exit means a component is unhealthy or the config has errors, so the deploy should stop. Pass --kubecontext explicitly in multi-cluster pipelines so you check the intended cluster.
Common errors in CI
A failing line reads like "X Gloo ... deployment is not ready" or lists a config resource with a rejected/pending status. "failed to find any Gloo ... in namespace" means Gloo is not installed there; set -n. "error: no configuration has been provided ... KUBECONFIG" means the kube context is not set for the runner.