| name | kubernetes-integration |
| description | Integrate Go CLIs with Kubernetes using client-go. Automatic config detection works on laptops, CI runners, and cluster pods with minimal RBAC setup. |
Kubernetes Integration
When to Use This Skill
A well-designed Kubernetes CLI works seamlessly both on developer laptops and inside cluster pods. This section covers:
- Client Configuration - Automatic config detection for all environments
- RBAC Setup - Service accounts and permissions
- Common Operations - List, patch, and restart resources
Implementation
See examples.md for detailed code examples.
Key Principles
| Practice | Description |
|---|---|
| Use contexts everywhere | Pass context.Context to all Kubernetes operations |
| Handle cancellation | Respect context cancellation for clean shutdowns |
| Wrap errors with context | Include resource type and name in error messages |
| Default to current namespace | Match kubectl behavior for namespace resolution |
| Support both configs | Always handle in-cluster and out-of-cluster scenarios |
| Minimal RBAC | Request only the permissions your CLI needs |
Build clients that work everywhere: laptop, CI runner, or pod.
Examples
See examples.md for code examples.