Skip to content

Deploy & Verify

Deploy the Chart

helm install ap-gateway oci://ghcr.io/wso2/api-platform/helm-charts/gateway \
  --version 1.1.2 \
  --namespace ap-gateway \
  --create-namespace \
  --values ./values.yaml \
  --wait \
  --timeout 5m

helm install ap-gateway ./kubernetes/helm/gateway-helm-chart \
  --namespace ap-gateway \
  --create-namespace \
  --values ./values.yaml \
  --wait \
  --timeout 5m

Verify the Deployment

Check all pods are running:

kubectl get pods -n ap-gateway

Check all services:

kubectl get svc -n ap-gateway

Controller health check:

kubectl exec -n ap-gateway deploy/ap-gateway-controller -- \
  wget -qO- http://localhost:9094/api/admin/v0.9/health

Upgrade Procedure

Pull latest chart values to see what changed:

helm show values oci://ghcr.io/wso2/api-platform/helm-charts/gateway --version <new-version>

Diff current release vs the new chart (requires the helm-diff plugin):

helm diff upgrade ap-gateway oci://ghcr.io/wso2/api-platform/helm-charts/gateway \
  --version <new-version> \
  --namespace ap-gateway \
  --values ./values.yaml

Upgrade:

helm upgrade ap-gateway oci://ghcr.io/wso2/api-platform/helm-charts/gateway \
  --version <new-version> \
  --namespace ap-gateway \
  --values ./values.yaml \
  --wait \
  --timeout 5m

Rollback if needed:

helm rollback ap-gateway --namespace ap-gateway

Note

The controller pod restarts on upgrade. Because the gateway runtime syncs policy configuration via xDS from the controller, keep replicaCount at ≥ 2 for the runtime so in-flight requests continue to be served during controller restarts.

← Resources & Scaling  |  Control Plane Connection → (optional)