FAQ

Uses: Kong Gateway Operator
Related Documentation

Managing Konnect entities with Kong Gateway Operator is an actively developed feature. This page answers frequently asked questions.

I’m a Kong Ingress Controller user. How much do I need to learn?

Kong Gateway Operator uses the same custom resources as Kong Ingress Controller. A KongConsumer is the same no matter which product you’re using.

By default, all Kong* custom resources will be reconciled by Kong Ingress Controller. To make Kong Gateway Operator reconcile them with Konnect, you must provide a spec.controlPlaneRef.type of konnectNamespacedRef.

Can I use HTTPRoute and Ingress definitions?

Not yet. The initial release uses a 1:1 mapping between custom resources and Konnect entities. Use KongService and KongRoute instead of HTTPRoute or Ingress.

Support for standard Kubernetes resources is planned for the future.

How often does the reconcile loop run?

  • New resources are created immediately via the Konnect API.
  • Existing resources are reconciled every 60 seconds by default.

This is customizable, but we recommend keeping the default value so that you do not hit the Konnect API rate limit.

For more information, see how it works.

I deleted a resource in the UI, but it wasn’t recreated by the operator. Why?

The reconciliation loop runs once per minute. Wait 60 seconds, then refresh the UI.

Can I use Secrets for Consumer credentials like in Kong Ingress Controller?

Kong Gateway Operator uses new Credential CRDs for managing consumer credentials. We plan to support Kubernetes Secret resources in a future release. #618.

Can I adopt existing Konnect entities?

Adopting existing entities is planned, but not yet available. Only resources created by the operator can be managed using CRDs at this time. #460

How do I create a global plugin?

It is not yet possible to create a global plugin. This is due to Konnect resources being namespaced in Kong Gateway Operator, while global plugins are cluster scoped. We are investigating options in #440

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!