| name | kubernetes-helm |
| description | Kubernetes manifests, Helm charts, Kustomize, Argo CD, kubectl, helm, GitOps, or cluster rollout checks. Not for Docker-only files. |
Kubernetes, Helm, and GitOps Workflow
Boundary
Use kubernetes-helm for cluster deployment contracts and GitOps validation. Use docker for image build and Compose-only work. Use terraform for cluster infrastructure provisioning.
Core Principles
- Prefer immutable, Git-tracked image tags or digests. Avoid mutable
latest style deployment inputs.
- Treat branch, environment, namespace, and Argo CD application mapping as a contract. Do not change it casually or infer a new mapping from naming alone.
- Keep reusable chart and manifest source separate from private values, kubeconfigs, sealed secrets source material, and tenant-specific credentials.
Validation Checklist
- Run chart or manifest validation in CI or the same local commands CI uses.
- Confirm the intended image identity: registry, repository, tag or digest, and build provenance from the deployment source.
- Verify Argo CD sync status and health for the application when GitOps is in scope.
- Check rollout status for changed workloads.
- Inspect events for scheduling, image pull, probe, admission, or policy failures.
- Check logs for changed pods or controllers before declaring the deployment healthy.
Quick Commands
| Purpose | Commands |
|---|
| Render Helm | helm template <release> <chart> -f <values> |
| Lint Helm | helm lint <chart> |
| Diff rendered YAML | kubectl diff -f <rendered.yaml> |
| Rollout status | kubectl rollout status deploy/<name> -n <namespace> |
| Events | kubectl get events -n <namespace> --sort-by=.lastTimestamp |
| Logs | kubectl logs -n <namespace> deploy/<name> |
Anti-patterns
- Claiming success from CI alone when Argo CD sync, health, rollout, events, or logs were not checked.
- Changing environment or branch mapping without updating the documented deployment contract.
- Deploying mutable image tags in GitOps flows.
- Mixing secret values into reusable chart defaults or examples.