Install the Agent Gateway KrakenD Operator

This guide walks you through installing the KrakenD Agent Gateway Operator on your Kubernetes cluster.

Prerequisites

  • A running Kubernetes cluster with kubectl configured.

  • cert-manager installed for webhook TLS. Install it if you have not already:

    kubectl apply -f https://github.com/cert-manager/cert-manager/releases/latest/download/cert-manager.yaml
kubectl wait --for=condition=ready pod -l app.kubernetes.io/name=cert-manager -n cert-manager --timeout=60s

    Browse all cert-manager releases at https://github.com/cert-manager/cert-manager/releases.

  • Agent Runtime Operator installed (provides the required AgentGateway and AgentGatewayClass CRDs).

Install with kubectl

# Install the operator (always pulls the latest release)
kubectl apply -f https://github.com/agentic-layer/agent-gateway-krakend-operator/releases/latest/download/install.yaml
# Wait for the operator to be ready
kubectl wait --for=condition=Available --timeout=60s -n agent-gateway-krakend-operator-system deployment/agent-gateway-krakend-operator-controller-manager

Browse all releases at https://github.com/agentic-layer/agent-gateway-krakend-operator/releases.

Install with Flux

If you are using Flux for GitOps, install the operator via its OCI repository:

apiVersion: source.toolkit.fluxcd.io/v1
kind: OCIRepository
metadata:
  name: agent-gateway-krakend-operator
  namespace: flux-system
spec:
  interval: 5m
  url: oci://ghcr.io/agentic-layer/manifests/agent-gateway-krakend-operator
  ref:
    semver: ">= 0, < 1"
---
apiVersion: kustomize.toolkit.fluxcd.io/v1
kind: Kustomization
metadata:
  name: agent-gateway-krakend-operator
  namespace: flux-system
spec:
  sourceRef:
    kind: OCIRepository
    name: agent-gateway-krakend-operator
  interval: 10m
  path: ./
  prune: true
  wait: true
  dependsOn:
    # Ensure cert-manager is installed first (if you install it with Flux as well)
    - name: cert-manager

Verify

# Check that the operator is running
kubectl get pods -n agent-gateway-krakend-operator-system

You should see the operator pod running in the agent-gateway-krakend-operator-system namespace.

Related