ACCESSING CLUSTERS
The available clusters are dev, integration, and live. Use the coresponding kube context for access.
Common kubectl Patterns
| Command | Purpose |
|---|---|
kubectl get pods -n <ns> |
List pods in a namespace |
kubectl get pods -A |
List pods across all namespaces |
kubectl describe pod <pod> -n <ns> |
Detailed pod info with events |
kubectl logs <pod> -n <ns> --tail=100 |
Recent logs from a pod |
kubectl logs <pod> -n <ns> --previous |
Logs from previous container instance |
kubectl get events -n <ns> --sort-by='.lastTimestamp' |
Recent events timeline |
kubectl top pods -n <ns> |
CPU/memory usage per pod |
kubectl top nodes |
CPU/memory usage per node |
kubectl get ns <ns> --show-labels |
Namespace labels (network policy profiles) |
kubectl explain <resource> |
API schema reference for a resource type |
Flux GitOps Commands
# Check status
flux --context <cluster> get all
flux --context <cluster> get kustomizations
flux --context <cluster> get helmreleases -A
# Trigger reconciliation
flux --context <cluster> reconcile source git flux-system
flux --context <cluster> reconcile kustomization <name>
flux --context <cluster> reconcile helmrelease <name> -n <namespace>
Flux Status Interpretation
| Status | Meaning | Action |
|---|---|---|
Ready: True |
Reconciled and healthy | None |
Ready: False |
Failed to reconcile | Check the message/reason |
Stalled: True |
Stopped retrying after repeated failures | Suspend/resume to reset (see sre skill) |
Suspended: True |
Intentionally paused | Resume: flux resume <type> <name> |
Reconciling |
Actively being applied | Wait for completion |
Researching Unfamiliar Services
When investigating unknown services, spawn a haiku agent to research documentation:
Task tool:
- subagent_type: "general-purpose"
- model: "haiku"
- prompt: "Research [service] troubleshooting docs. Focus on:
1. Common failure modes
2. Health indicators
3. Configuration gotchas
Start with: [docs-url]"
Chart URL to Docs mapping:
| Chart Source | Documentation |
|---|---|
charts.jetstack.io |
cert-manager.io/docs |
charts.longhorn.io |
longhorn.io/docs |
grafana.github.io |
grafana.com/docs |
prometheus-community.github.io |
prometheus.io/docs |
Common Confusions
BAD: Use helm list to check Helm release status
GOOD: Use kubectl get helmrelease -A — Flux manages releases via CRDs, not Helm CLI