Using Workspaces

Related Documentation

Kong Ingress Controller can manage configuration in multiple Workspaces when running in DB-backed mode. Each Workspace needs a different Kong Ingress Controller instance with the --watch-namespace and --kong-workspace flags set.

  • --watch-namespace: Namespace(s) to watch for Kubernetes resources. Defaults to all namespaces. To watch multiple namespaces, use a comma-separated list of namespaces.
  • --kong-workspace: Kong Gateway Workspace to configure. Leave this empty if not using Kong Workspaces.

Use this values.yaml when you install Kong Ingress Controller using Helm to configure the namespace and Workspace:

gateway:
  ingressController:
    env:
      watch_namespace: mynamespacehere
      kong_workspace: workspacename

Kong Ingress Controller watches for resources in the defined namespace and send them to the configured Workspace. This allows teams to manage their own resources in Kubernetes and send them to their own Workspace within Kong Gateway.

Something wrong?

Help us make these docs great!

Kong Developer docs are open source. If you find these useful and want to make them better, contribute today!