Skip to main content

Overview

Deploy CodeWolf agents in your Kubernetes clusters to monitor applications, collect metrics, and analyze containerized workloads.

Prerequisites

  • Kubernetes cluster (1.19+)
  • kubectl configured with cluster access
  • Helm 3.0+ installed
  • CodeWolf account and API key

Installation

1

Add CodeWolf Helm repository

helm repo add codewolf https://charts.codewolf.ai
helm repo update
2

Create namespace

kubectl create namespace codewolf
3

Install CodeWolf agent

helm install codewolf-agent codewolf/codewolf-agent \
  --namespace codewolf \
  --set apiKey=YOUR_API_KEY \
  --set cluster.name=production
Replace YOUR_API_KEY with your actual CodeWolf API key from the dashboard.

Configuration

Basic configuration

apiKey: "your-api-key"
cluster:
  name: "production"
  environment: "prod"

agent:
  replicas: 3
  resources:
    requests:
      memory: "256Mi"
      cpu: "100m"
    limits:
      memory: "512Mi"
      cpu: "500m"

monitoring:
  enabled: true
  interval: 60s

logs:
  enabled: true
  format: json
Apply custom configuration:
helm upgrade codewolf-agent codewolf/codewolf-agent \
  --namespace codewolf \
  -f values.yaml

Advanced options

rbac:
  create: true
  rules:
    - apiGroups: [""]
      resources: ["pods", "services"]
      verbs: ["get", "list", "watch"]

Monitoring

CodeWolf monitors your Kubernetes cluster for:
  • Pod health and status
  • Resource utilization (CPU, memory)
  • Container restarts and crashes
  • Deployment rollout status
  • ConfigMap and Secret changes
  • Network policies and ingress rules

Deployment strategies

DaemonSet deployment

Deploy CodeWolf agent on every node:
helm install codewolf-agent codewolf/codewolf-agent \
  --set deployment.type=daemonset

Sidecar injection

Automatically inject CodeWolf sidecar into pods:
apiVersion: v1
kind: Pod
metadata:
  annotations:
    codewolf.ai/inject: "true"

Troubleshooting

Check pod logs:
kubectl logs -n codewolf -l app=codewolf-agent
Common issues:
  • Invalid API key
  • Insufficient RBAC permissions
  • Resource constraints
Verify the agent has permissions to access cluster resources:
kubectl auth can-i list pods --as=system:serviceaccount:codewolf:codewolf-agent
Reduce monitoring interval or adjust resource limits:
helm upgrade codewolf-agent codewolf/codewolf-agent \
  --set monitoring.interval=120s \
  --set agent.resources.limits.memory=256Mi

Upgrade

Update to the latest version:
helm repo update
helm upgrade codewolf-agent codewolf/codewolf-agent \
  --namespace codewolf

Uninstall

Remove CodeWolf from your cluster:
helm uninstall codewolf-agent --namespace codewolf
kubectl delete namespace codewolf