k8s-gatekeeper-troubleshooting
Use when OPA Gatekeeper blocks, warns about or fails to police resources in Kubernetes: "admission webhook \"validation.gatekeeper.sh\" denied the request: [constraint] message", warnings from constraints in warn mode, a constraint that should block but only shows violations in audit (dryrun), a ConstraintTemplate that does not compile (ingest_error, rego_parse_error), "no matches for kind" when applying a constraint, referential policies that never fire (sync), mutations that do not apply, or Gatekeeper that stopped enforcing because its webhook is down. Investigates with kubectl get, describe and logs, and proposes fixes. Reads first and asks before changing anything.
- License
- Apache-2.0
Pinned to revision ce7de97330d7, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/k8s-gatekeeper-troubleshooting/SKILL.md
- skills/k8s-gatekeeper-troubleshooting/.claude-plugin/plugin.json
- skills/k8s-gatekeeper-troubleshooting/references/constraints.md
- skills/k8s-gatekeeper-troubleshooting/references/templates.md
- skills/k8s-gatekeeper-troubleshooting/references/webhook-sync-mutation.md
Every link opens the file at its source, pinned to the revision this page describes.