Integrations
Kubernetes
Pod management, deployment scaling, and service orchestration
The Kubernetes connector provides 30 actions for managing pods, deployments, services, and cluster resources.
Setup
Connect via Kubeconfig
- Go to Settings → Integrations → Kubernetes
- Click Connect
- Upload your kubeconfig file or paste contents
- Select the cluster context
- Choose namespaces to access
- Test connection and save
Connect via Service Account
- Create a ServiceAccount in your cluster
- Bind appropriate RBAC roles
- Extract the token and CA certificate
- Enter cluster URL, token, and CA in Keva
RBAC Requirements
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
name: keva-support
rules:
- apiGroups: ["", "apps"]
resources: ["pods", "deployments", "services"]
verbs: ["get", "list", "watch", "update", "patch"]
- apiGroups: [""]
resources: ["pods/log"]
verbs: ["get"]Available Actions (30)
Pods
| Action | Description |
|---|---|
| List pods | Get pods in namespace |
| Get pod | Pod details and status |
| Get pod logs | Container output |
| Delete pod | Remove pod (triggers restart) |
| Exec command | Run command in pod |
Deployments
| Action | Description |
|---|---|
| List deployments | Get all deployments |
| Get deployment | Deployment details |
| Scale deployment | Adjust replica count |
| Restart deployment | Rolling restart |
| Update image | Change container image |
| Rollback deployment | Revert to previous |
Services
| Action | Description |
|---|---|
| List services | Get all services |
| Get service | Service details |
| Get endpoints | Service endpoints |
ConfigMaps & Secrets
| Action | Description |
|---|---|
| List configmaps | Get config maps |
| Get configmap | Config values |
| Update configmap | Modify config |
| List secrets | Get secret names |
Cluster
| Action | Description |
|---|---|
| List namespaces | Get all namespaces |
| List nodes | Cluster nodes |
| Get node | Node details and capacity |
| Get events | Cluster events |
Use Cases
Pod Crash Loop
Customer: "Our payment service keeps restarting"
AI:
1. Calls get_pod(payment-service-xyz)
2. Sees: restartCount=15, CrashLoopBackOff
3. Calls get_pod_logs(previous: true)
4. Reports: "DB connection timeout"
5. Checks DB service is runningScale for Traffic
Customer: "Expecting high traffic, scale up API"
AI:
1. Calls get_deployment(api-deployment)
2. Current: 3 replicas
3. Calls scale_deployment(replicas: 10)
4. Reports: "Scaled to 10 replicas"Deploy New Version
Customer: "Roll out v2.5 of the web app"
AI:
1. Calls update_image(web-deploy, image:v2.5)
2. Monitors rollout status
3. Reports: "Rollout complete, all pods healthy"
4. Watches for errors, ready to rollbackConfiguration
- Cluster access: Kubeconfig or service account
- Namespace scope: Which namespaces AI can access
- Write permissions: Enable scale/restart operations
- Secret access: Allow reading secret names (not values)