Deployment

Creates and manages Kubernetes Deployments with rolling updates, health probes, and resource limits.

​

Config

​

Container Config

​

Probe Config

​

Resource Requirements

​

Outputs

​

Dependencies

• kubernetes/config (required) — access to the target cluster

• agno/runner creates Kubernetes Deployments internally

​

Example

provider: kubernetes
resource: deployment
name: my-app
config:
  config:
    provider: kubernetes
    resource: config
    name: my-cluster
  namespace: production
  replicas: 3
  selector:
    app: my-app
  containers:
    - name: app
      image: gcr.io/my-project/my-app:latest
      ports:
        - container_port: 8080
          name: http
      env:
        APP_ENV: production
      resources:
        cpu: "500m"
        memory: "512Mi"
        cpu_limit: "1"
        memory_limit: "1Gi"
      readiness_probe:
        http_get:
          path: /health
          port: 8080
        period_seconds: 5
  strategy: RollingUpdate

​

Notes

• Create and update wait up to 5 minutes for all replicas to become ready before timing out. Delete waits until the Deployment is gone.
• The config, namespace, and selector fields are immutable — changing them requires deleting and recreating the resource.
• Environment variables from Kubernetes Secrets use the format "secret_name.key" in env_from_secret.
• Rolling updates use 25% max surge and 25% max unavailable by default.