From 89a6dd98ecc2e3769548230cc797e6fbd0b7df90 Mon Sep 17 00:00:00 2001 From: Lucie Milan Date: Mon, 5 Jan 2026 12:42:04 +0100 Subject: [PATCH 1/8] remove gateway API install --- app/_how-tos/operator-get-started-kic-install.md | 7 ------- 1 file changed, 7 deletions(-) diff --git a/app/_how-tos/operator-get-started-kic-install.md b/app/_how-tos/operator-get-started-kic-install.md index 2b4cd9536d..802c470f44 100644 --- a/app/_how-tos/operator-get-started-kic-install.md +++ b/app/_how-tos/operator-get-started-kic-install.md @@ -36,13 +36,6 @@ tags: - install - helm --- -{% assign gwapi_version = "1.3.0" %} - -## Install CRDs - -```shell -kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v{{ gwapi_version }}/standard-install.yaml -``` {% include k8s/kong-namespace.md %} From 9a2a06e08002ef04cf760319ef7f73e5f9d9c300 Mon Sep 17 00:00:00 2001 From: Lucie Milan Date: Mon, 5 Jan 2026 12:42:19 +0100 Subject: [PATCH 2/8] test --- app/_includes/prereqs/products/operator.md | 1 + 1 file changed, 1 insertion(+) diff --git a/app/_includes/prereqs/products/operator.md b/app/_includes/prereqs/products/operator.md index c9ad8bc13d..90341db51f 100644 --- a/app/_includes/prereqs/products/operator.md +++ b/app/_includes/prereqs/products/operator.md @@ -32,6 +32,7 @@ --set env.ENABLE_CONTROLLER_KONNECT=true{% if prereqs.operator.controllers %} \{% for controller in prereqs.operator.controllers %} --set env.ENABLE_CONTROLLER_{{ controller | upcase }}=true{% unless forloop.last %} \{% endunless %}{% endfor %}{% endif %} ``` + {:data-deployment-topology='konnect'} {% endif %} From e9f6940c37c6c82cbdbc7785f45baa44c5fb5b51 Mon Sep 17 00:00:00 2001 From: Lucie Milan Date: Mon, 5 Jan 2026 13:00:39 +0100 Subject: [PATCH 3/8] add deployment topology --- app/_includes/prereqs/products/operator.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/app/_includes/prereqs/products/operator.md b/app/_includes/prereqs/products/operator.md index 90341db51f..72c01c21e9 100644 --- a/app/_includes/prereqs/products/operator.md +++ b/app/_includes/prereqs/products/operator.md @@ -22,6 +22,14 @@ --set env.ENABLE_CONTROLLER_KONNECT=true{% if prereqs.operator.controllers %} \{% for controller in prereqs.operator.controllers %} --set env.ENABLE_CONTROLLER_{{ controller | upcase }}=true{% unless forloop.last %} \{% endunless %}{% endfor %}{% endif %} ``` + {:data-deployment-topology='konnect'} + + ```bash + helm upgrade --install kgo kong/gateway-operator -n kong-system \ + --create-namespace{% if prereqs.operator.controllers %} \{% for controller in prereqs.operator.controllers %} + --set env.ENABLE_CONTROLLER_{{ controller | upcase }}=true{% unless forloop.last %} \{% endunless %}{% endfor %}{% endif %} + ``` + {:data-deployment-topology='on-prem'} {% else %} @@ -34,6 +42,14 @@ ``` {:data-deployment-topology='konnect'} + ```bash + helm upgrade --install kong-operator kong/kong-operator -n kong-system \ + --create-namespace \ + --set image.tag={{ site.data.operator_latest.release }}{% if prereqs.operator.controllers %} \{% for controller in prereqs.operator.controllers %} + --set env.ENABLE_CONTROLLER_{{ controller | upcase }}=true{% unless forloop.last %} \{% endunless %}{% endfor %}{% endif %} + ``` + {:data-deployment-topology='on-prem'} + {% endif %} {% include k8s/cert-manager.md %} From 015b0928efc3cf33aab32b9c7e4d4ec2a38ace3d Mon Sep 17 00:00:00 2001 From: Lucie Milan Date: Mon, 5 Jan 2026 13:54:08 +0100 Subject: [PATCH 4/8] Update operator-get-started-hybrid-install.md --- app/_how-tos/operator-get-started-hybrid-install.md | 10 ---------- 1 file changed, 10 deletions(-) diff --git a/app/_how-tos/operator-get-started-hybrid-install.md b/app/_how-tos/operator-get-started-hybrid-install.md index 7961414d43..dae0db4646 100644 --- a/app/_how-tos/operator-get-started-hybrid-install.md +++ b/app/_how-tos/operator-get-started-hybrid-install.md @@ -41,20 +41,10 @@ tags: - helm --- -{% assign gwapi_version = "1.3.0" %} - ## Deploying Data Planes {{ site.operator_product_name }} can deploy and manage Data Planes attached to a {{ site.konnect_short_name }} Control Plane. All the Services, Routes, and plugins are configured in {{ site.konnect_short_name }} and sent to the Data Planes automatically. -## Install CRDs - -If you want to use Gateway API resources, run this command: - -```shell -kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v{{ gwapi_version }}/standard-install.yaml -``` - ## Install {{ site.operator_product_name }} {% include prereqs/products/operator.md raw=true v_maj=2 %} From d37470bac4490b5ac34562e734405d3c7347c619 Mon Sep 17 00:00:00 2001 From: Lucie Milan Date: Mon, 5 Jan 2026 14:03:53 +0100 Subject: [PATCH 5/8] Update operator.md --- app/_includes/prereqs/products/operator.md | 27 ++++++++++++++-------- 1 file changed, 18 insertions(+), 9 deletions(-) diff --git a/app/_includes/prereqs/products/operator.md b/app/_includes/prereqs/products/operator.md index 72c01c21e9..d785f8a33d 100644 --- a/app/_includes/prereqs/products/operator.md +++ b/app/_includes/prereqs/products/operator.md @@ -3,6 +3,19 @@ {% if prereqs.enterprise %} {% assign summary = summary | append:' (with an Enterprise license)' %} {% endif %} + +{% capture license %} +``` +echo " +apiVersion: configuration.konghq.com/v1alpha1 +kind: KongLicense +metadata: + name: kong-license +rawLicenseString: '$(cat ./license.json)' +" | kubectl apply -f - +``` +{% endcapture %} + {% capture details_content %} 1. Add the Kong Helm charts: @@ -57,16 +70,12 @@ {% if prereqs.enterprise %} 1. Apply a `KongLicense`. This assumes that your license is available in `./license.json` +{{license | indent: 3}} + +{% else %} +This tutorial doesn't require a license, but you can add one using `KongLicense`. This assumes that your license is available in `./license.json`. +{{license}} - ``` - echo " - apiVersion: configuration.konghq.com/v1alpha1 - kind: KongLicense - metadata: - name: kong-license - rawLicenseString: '$(cat ./license.json)' - " | kubectl apply -f - - ``` {% endif %} {% endcapture %} From 76fb37ac8a012379fa613525b0869678cdf118d8 Mon Sep 17 00:00:00 2001 From: Lucie Milan Date: Mon, 5 Jan 2026 15:57:55 +0100 Subject: [PATCH 6/8] Update operator.md --- app/_includes/prereqs/products/operator.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/app/_includes/prereqs/products/operator.md b/app/_includes/prereqs/products/operator.md index d785f8a33d..32cb104d21 100644 --- a/app/_includes/prereqs/products/operator.md +++ b/app/_includes/prereqs/products/operator.md @@ -16,6 +16,10 @@ rawLicenseString: '$(cat ./license.json)' ``` {% endcapture %} +{% capture cert %} +{% include k8s/cert-manager.md %} +{% endcapture %} + {% capture details_content %} 1. Add the Kong Helm charts: @@ -65,7 +69,7 @@ rawLicenseString: '$(cat ./license.json)' {% endif %} -{% include k8s/cert-manager.md %} +{{cert | indent: 3}} {% if prereqs.enterprise %} From 2dcba041a0d6d7eeb0611b1acaa5294f458c82ce Mon Sep 17 00:00:00 2001 From: Lucie Milan Date: Wed, 7 Jan 2026 09:59:27 +0100 Subject: [PATCH 7/8] Update operator-get-started-hybrid-install.md --- app/_how-tos/operator-get-started-hybrid-install.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/app/_how-tos/operator-get-started-hybrid-install.md b/app/_how-tos/operator-get-started-hybrid-install.md index dae0db4646..8fbfb664fd 100644 --- a/app/_how-tos/operator-get-started-hybrid-install.md +++ b/app/_how-tos/operator-get-started-hybrid-install.md @@ -23,10 +23,7 @@ works_on: - konnect min_version: - kgo: '1.6.1' - - -entities: [] + operator: '1.6.1' tldr: q: How do I install {{ site.operator_product_name }} in {{ site.konnect_short_name }} hybrid mode? From 3117c071107b8a2809003b4246f1c5104f995e5d Mon Sep 17 00:00:00 2001 From: Lucie Milan Date: Wed, 7 Jan 2026 09:59:48 +0100 Subject: [PATCH 8/8] test fix for duplicated block --- app/_includes/prereqs/products/operator.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/app/_includes/prereqs/products/operator.md b/app/_includes/prereqs/products/operator.md index 32cb104d21..6ab9c6263d 100644 --- a/app/_includes/prereqs/products/operator.md +++ b/app/_includes/prereqs/products/operator.md @@ -33,6 +33,8 @@ rawLicenseString: '$(cat ./license.json)' {% if include.v_maj == 1 %} + {% if page.works_on contains "konnect"%} + ```bash helm upgrade --install kgo kong/gateway-operator -n kong-system \ --create-namespace \ @@ -41,6 +43,10 @@ rawLicenseString: '$(cat ./license.json)' ``` {:data-deployment-topology='konnect'} + {% endif %} + + {% if page.works_on contains "on-prem"%} + ```bash helm upgrade --install kgo kong/gateway-operator -n kong-system \ --create-namespace{% if prereqs.operator.controllers %} \{% for controller in prereqs.operator.controllers %} @@ -48,8 +54,12 @@ rawLicenseString: '$(cat ./license.json)' ``` {:data-deployment-topology='on-prem'} + {% endif %} + {% else %} + {% if page.works_on contains "konnect"%} + ```bash helm upgrade --install kong-operator kong/kong-operator -n kong-system \ --create-namespace \ @@ -59,6 +69,10 @@ rawLicenseString: '$(cat ./license.json)' ``` {:data-deployment-topology='konnect'} + {% endif %} + + {% if page.works_on contains "on-prem"%} + ```bash helm upgrade --install kong-operator kong/kong-operator -n kong-system \ --create-namespace \ @@ -67,6 +81,7 @@ rawLicenseString: '$(cat ./license.json)' ``` {:data-deployment-topology='on-prem'} + {% endif %} {% endif %} {{cert | indent: 3}}