Create Configure Knative Networking page #6518

iRaindrop · 2025-11-19T05:58:48Z

The content for the Kourier, Contour, Gateway API, and Istio is could be helpful consolidated as opposed to separate install and config topics.

Proposed Changes

Create "Configure network adapters" under "Administration->Configuring Knative->Networking options

Create file - table test

netlify · 2025-11-19T05:58:54Z

✅ Deploy Preview for knative ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	`6240ade`
🔍 Latest deploy log	https://app.netlify.com/projects/knative/deploys/69376831ea78a700083486e5
😎 Deploy Preview	https://deploy-preview-6518--knative.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Added Nav and fixed H1

Formatting test

More writing

Snippet testing

snippet testing

Snippet name fix

Formatting tests

Formatting fix

Test

Rebuild

Formmating

Typo fix

Formatting

Updates

Snippet formatting

Misc edits

Link issue fix

Added tabs for Network layer setup

Minor edit to rebuild

Format fix

docs/versioned/serving/config-network-adapters.md

iRaindrop · 2025-12-01T20:01:02Z

docs/snippets/netadapter-istio.md

@@ -0,0 +1,35 @@
+Use the following steps to install Istio and set it as the ingress conroller.
+
+1. Install a properly configured Istio:


The artifact "macros" are not rendering to provide the URL. I wasn't able to find this one.

You may need a space between ) }} for the macro to work. I can take a look this weekend.

Yep, I see this not working, but I haven't yet figured out why. I'm guessing it's the combination of macros and snippets that is doing it.

docs/snippets/netadapter-istio.md

Cali0707 · 2025-12-01T20:25:40Z

/assign @dprotaso @evankanderson

Updated Gateway API steps

knative-prow · 2025-12-01T23:53:51Z

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: iRaindrop
Once this PR has been reviewed and has the lgtm label, please ask for approval from dprotaso. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

docs/snippets/netadapter-gatewayapi.md

Fixed typos and tweaking

Minor edit to rebuild

Consistency edits

iRaindrop · 2025-12-04T18:06:45Z

docs/versioned/serving/config-network-adapters.md

+
+Review the following tabs to determine the optimal networking layer for your cluster. For most users, the Kourier ingress controller is sufficient in conjunction the default Istio gateway, which is also included in the Knative Serving installation. You can expand your capabilities with the Contour ingress, a full-feature service mesh with Istio, and the Kubernetes Gateway API.
+
+=== "Kourier"


A little context on these mermaid charts. Evan created the one for Gateway API and I did the others with AI help and I also added the Controller to the Gateway API.

Hence, they need tech reviewed as they could be misleading!

evankanderson

I got to this much later than I intended to (and I need to update the charts). A few corrections to the first half, and I may need to actually get out a cluster and cycle through the gateways for the details on each one.

docs/snippets/dns.md

docs/snippets/netadapter-contour.md

docs/snippets/netadapter-gatewayapi.md

evankanderson · 2025-12-06T00:19:38Z

docs/snippets/netadapter-istio.md

@@ -0,0 +1,35 @@
+Use the following steps to install Istio and set it as the ingress conroller.
+
+1. Install a properly configured Istio:


You may need a space between ) }} for the macro to work. I can take a look this weekend.

docs/snippets/netadapter-istio.md

docs/versioned/serving/config-network-adapters.md

Link fix

Co-authored-by: Evan Anderson <evan.k.anderson@gmail.com>

Moved page up in Nav, moved 'Detect current state' section down. Also format edits.

H3 to H2 - Determine current state

iRaindrop · 2025-12-08T06:23:57Z

Moved the page up a level next to the Networking options node.

evankanderson

Sorry for the bit of a left-turn on this review. I'd been reviewing this in isolation, but then I realized that some of the content looked familiar from the YAML install documentation, and I'd really prefer not to duplicate those docs.

This current document seems to partially duplicate the "installing with YAML" document, but adds some additional context. The DNS bit seems unnecessary, as it's simply the same as the existing "installing with YAML" content, so I'd avoid duplicating that.

I think the diagrams and what the different installations are good explanation content, but I'd be concerned about mixing the how-to and explanation into the same document. Maybe rather than including the "Install and configure" sections (which mostly cover install without configure), we could add details on the configuration options for each ingress option. Off the top of my head:

Contour
- config-contour has settings for visibility, CORS policy, timeouts, and TLS secrets
Gateway
- config-gateway has the two external-gateways and local-gateways lists
Istio
- config-istio has similar (but not identical) external-gateways and local-gateways lists
Kourier
- Doesn't really have any settings, because it's lightweight and Knative-only

evankanderson · 2025-12-08T21:37:10Z

docs/snippets/dns.md

-        is running.
-
-        In these cases, see the "Real DNS" or "No DNS" tabs.
+    This configuration works only if the cluster `LoadBalancer` Service exposes an IPv4 address or hostname. It does not work with IPv6 clusters or local setups such as minikube, unless [`minikube tunnel`](https://minikube.sigs.k8s.io/docs/commands/tunnel/) is running, and should consider using the "Real DNS" or "No DNS" tabs.


"It does not work with ...., and should consider" seems to have changed the subject of the sentence.

evankanderson · 2025-12-08T21:39:11Z

docs/versioned/.nav.yml

+        - Configure Knative networking: serving/config-network-adapters.md
        - Networking Options:
          - Configure the ingress gateway: serving/setting-up-custom-ingress-gateway.md


It's odd to have this up one level from "Networking options" and "Configure the ingress gateway", which feel like related tasks.

I see your point. I'll put it back.

evankanderson · 2025-12-08T21:46:43Z

docs/versioned/serving/config-network-adapters.md

+      look: neo
+    ---
+    flowchart LR
+    K1["Knative<br>net-kourier"] -- creates --> K2["KIngress&nbsp;objects"]


net-kourier doesn't create KIngress objects; it reads objects created by serving. I think a more accurate diagram would have two parts. One is common for all network layers:

flowchart LR route["Route object"] -- "read by" --> serving-core("Serving controller") -- creates --> KIngress["Ingress object networking.internal.knative.dev (KIngress)"]

Loading

And then for Kourier, the chart would look like

flowchart LR KIngress["KIngress Class:kourier.ingress.networking.knative.dev"] -- "read by" --> controller("net-kourier controller") -- programs --> envoy("Envoy deployment kourier-system namespace")

Loading

I'll update the other diagrams with just the second-part diagrams.

evankanderson · 2025-12-08T21:48:08Z

docs/versioned/serving/config-network-adapters.md

+    K2 --> K3["Class: kourier.ingress.networking.knative.dev"]
+    ```
+
+    The Kourier ingress controller, `net-kourier`, is installed with Knative Serving. Kourier is a lightweight alternative for the Istio ingress as its deployment consists only of an envoy proxy and a control plane. If Kourier is satisfactory, no further configurations are required.


I believe that Kourier is installed by the quickstart, but other installations need to explicitly install it.

I wouldn't say it's an alternative for the Istio ingress so much as it's a lightweight implementation of the KIngress resource for clusters which don't need other ingress features.

docs/versioned/serving/config-network-adapters.md

evankanderson · 2025-12-08T23:01:15Z

docs/snippets/netadapter-istio.md

+1. Install a properly configured Istio:
+
+    ```bash
+    kubectl apply -l knative.dev/crd-install=true -f {{ artifact(repo="net-istio",org="knative-extensions",file="istio.yaml") }}


@dprotaso -- do we still need our own istio.yaml?

evankanderson · 2025-12-08T23:02:16Z

docs/snippets/netadapter-istio.md

+    kubectl apply -f {{ artifact(repo="net-istio",file="net-istio.yaml") }}
+    ```
+
+1. Set the `config-network` ConfigMap to use Istio:


Elsewhere, we call this "Configure...". Can we use the same language in each tab for this step?

evankanderson · 2025-12-08T23:04:05Z

docs/versioned/serving/config-network-adapters.md

+=== "Ingress Gateway"
+
+    ```mermaid
+    ---
+    config:
+      layout: elk
+      theme: default
+      look: neo
+    ---
+    flowchart LR
+        Client["External&nbsp;Client"] --> CGW["Custom&nbsp;Ingress&nbsp;Gateway"]
+        CGW --> KIGW["Knative&nbsp;Ingress&nbsp;Gateway"] & Client
+        KIGW --> Revision["Knative&nbsp;Revision"] & CGW
+        Revision --> KIGW
+    ```
+
+    Knative has a default Istio integration without the full-feature service mesh. The `knative-ingress-gateway` in the `knative-serving` namespace is a shared Istio gateway resource that handles all incoming (north-south) traffic to Knative services. This gateway points to the underlying `istio-ingressgateway` service in the `istio-system` namespace. You can replace this gateway with one of your own.
+
+    **Install and configure Ingress Gateway**
+
+    See [Configuring the Ingress gateway](setting-up-custom-ingress-gateway.md).


The referenced document contains configuration details for customizing the Istio configuration. It's not separate from the "Istio" configuration, but instead provides additional configuration detail.

evankanderson · 2025-12-08T23:06:26Z

docs/versioned/serving/config-network-adapters.md

+
+    The Knative `net-gateway-api` is a KIngress implementation and testing for Knative integration with the [Kubernetes Gateway API](https://gateway-api.sigs.k8s.io/). Good for teams adopting the Gateway API to unify ingress across Kubernetes.
+
+    The Kubernetes Gateway API requires a controller or service mesh. Istio and Contour implementations are tested though other Gateway API implementations should work. Currently, there is no native Gateway API support for Kourier. For more information see [Tested Gateway API version and Ingress](https://github.com/knative-extensions/net-gateway-api/blob/main/docs/test-version.md).


We test Istio, Contour, and Envoy Gateway implementation at this point. I don't think we ever intend to implement Gateway API support for Kourier. (Also, Envoy Gateway and other Gateway API implementations will probably never get a separate support path like Istio and Contour did -- that was basically a stepping stone before Gateway API existed.)

evankanderson · 2025-12-08T23:06:56Z

docs/versioned/serving/config-network-adapters.md

+
+    The Kubernetes Gateway API requires a controller or service mesh. Istio and Contour implementations are tested though other Gateway API implementations should work. Currently, there is no native Gateway API support for Kourier. For more information see [Tested Gateway API version and Ingress](https://github.com/knative-extensions/net-gateway-api/blob/main/docs/test-version.md).
+
+    The controller that Knative uses is determined by which Gateway API-compatible controller you install and configure in your cluster. 


In particular, it's determined by the configuration in config-gateway, that I described in an earlier comment.

Co-authored-by: Evan Anderson <evan.k.anderson@gmail.com>

dsimansk · 2025-12-09T16:45:54Z

docs/snippets/netadapter-kourier.md

+1. Install the Knative Kourier controller:
+
+    ```bash
+    kubectl apply -f https://github.com/knative/net-kourier/releases/latest/download/kourier.yaml


Same placeholder pattern should be usable here:

Suggested change

kubectl apply -f https://github.com/knative/net-kourier/releases/latest/download/kourier.yaml

kubectl apply -f {{ artifact(repo="net-kourier",file="kourier.yaml") }}

Create config-network-adapters.md

cbc1aa6

Create file - table test

knative-prow bot requested review from mmejia02 and nainaz November 19, 2025 05:58

knative-prow bot added the size/S Denotes a PR that changes 10-29 lines, ignoring generated files. label Nov 19, 2025

iRaindrop marked this pull request as draft November 19, 2025 05:59

knative-prow bot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Nov 19, 2025

iRaindrop added 3 commits November 18, 2025 22:00

Added Nav

14b81f4

Added Nav and fixed H1

Update config-network-adapters.md

3b315cb

Formatting test

Update config-network-adapters.md

9a212b2

More writing

knative-prow bot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. and removed size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Nov 19, 2025

iRaindrop added 10 commits November 19, 2025 23:58

Added snippet file for Kourier

2300e4f

Snippet testing

Update config-network-adapters.md

e6167d0

snippet testing

Update config-network-adapters.md

d283146

Snippet name fix

Snippet fix

5062101

Formatting tests

Update config-network-adapters.md

916f3b4

Formatting fix

Update config-network-adapters.md

81fd46e

Test

Update config-network-adapters.md

d10ab27

Rebuild

Added Contour snippet

9aec3ac

Formmating

Update config-network-adapters.md

1c48767

Typo fix

Added istio and gateway api snippet files

205ecae

Formatting

knative-prow bot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Nov 22, 2025

iRaindrop added 6 commits November 22, 2025 19:19

Writing and snippet work

310d9eb

Updates

Misc fixes

84f0b03

Snippet formatting

Link fixes

92d24f1

Misc edits

Update netadapter-istio.md

55a8c41

Link issue fix

Tab work

e35130c

Added tabs for Network layer setup

Update config-network-adapters.md

77cb4b8

Minor edit to rebuild

Update config-network-adapters.md

9059d0d

Format fix

iRaindrop commented Dec 1, 2025

View reviewed changes

docs/versioned/serving/config-network-adapters.md Outdated Show resolved Hide resolved

iRaindrop commented Dec 1, 2025

View reviewed changes

docs/versioned/serving/config-network-adapters.md Outdated Show resolved Hide resolved

iRaindrop commented Dec 1, 2025

View reviewed changes

docs/snippets/netadapter-istio.md Outdated Show resolved Hide resolved

iRaindrop marked this pull request as ready for review December 1, 2025 20:08

knative-prow bot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Dec 1, 2025

knative-prow bot requested review from Cali0707 and skonto December 1, 2025 20:08

knative-prow bot assigned dprotaso and evankanderson Dec 1, 2025

Update netadapter-gatewayapi.md

1d76ef9

Updated Gateway API steps

iRaindrop commented Dec 2, 2025

View reviewed changes

docs/snippets/netadapter-gatewayapi.md Show resolved Hide resolved

iRaindrop added 3 commits December 2, 2025 09:20

Update config-network-adapters.md

7c0cb5d

Fixed typos and tweaking

Update config-network-adapters.md

d21ff02

Minor edit to rebuild

Update config-network-adapters.md

89a5b3c

Consistency edits

iRaindrop commented Dec 4, 2025

View reviewed changes

evankanderson reviewed Dec 6, 2025

View reviewed changes

Update config-network-adapters.md

e1b403e

Link fix

iRaindrop changed the title ~~Create Configure Network Adapters page~~ Create Configure Knative Networking page Dec 6, 2025

iRaindrop and others added 4 commits December 6, 2025 15:45

Update docs/snippets/dns.md

39b879a

Co-authored-by: Evan Anderson <evan.k.anderson@gmail.com>

Processed reviewer edits

96c2e5d

Misc edits

de084ee

Moved page up in Nav, moved 'Detect current state' section down. Also format edits.

Update config-network-adapters.md

4de8810

H3 to H2 - Determine current state

evankanderson reviewed Dec 8, 2025

View reviewed changes

Update docs/versioned/serving/config-network-adapters.md

6240ade

Co-authored-by: Evan Anderson <evan.k.anderson@gmail.com>

dsimansk reviewed Dec 9, 2025

View reviewed changes

		@@ -0,0 +1,35 @@
		Use the following steps to install Istio and set it as the ingress conroller.

		1. Install a properly configured Istio:


		Review the following tabs to determine the optimal networking layer for your cluster. For most users, the Kourier ingress controller is sufficient in conjunction the default Istio gateway, which is also included in the Knative Serving installation. You can expand your capabilities with the Contour ingress, a full-feature service mesh with Istio, and the Kubernetes Gateway API.

		=== "Kourier"


		The Knative `net-gateway-api` is a KIngress implementation and testing for Knative integration with the [Kubernetes Gateway API](https://gateway-api.sigs.k8s.io/). Good for teams adopting the Gateway API to unify ingress across Kubernetes.

		The Kubernetes Gateway API requires a controller or service mesh. Istio and Contour implementations are tested though other Gateway API implementations should work. Currently, there is no native Gateway API support for Kourier. For more information see [Tested Gateway API version and Ingress](https://github.com/knative-extensions/net-gateway-api/blob/main/docs/test-version.md).


		The Kubernetes Gateway API requires a controller or service mesh. Istio and Contour implementations are tested though other Gateway API implementations should work. Currently, there is no native Gateway API support for Kourier. For more information see [Tested Gateway API version and Ingress](https://github.com/knative-extensions/net-gateway-api/blob/main/docs/test-version.md).

		The controller that Knative uses is determined by which Gateway API-compatible controller you install and configure in your cluster.

	kubectl apply -f https://github.com/knative/net-kourier/releases/latest/download/kourier.yaml
	kubectl apply -f {{ artifact(repo="net-kourier",file="kourier.yaml") }}

Create Configure Knative Networking page #6518

Are you sure you want to change the base?

Create Configure Knative Networking page #6518

Uh oh!

Conversation

iRaindrop commented Nov 19, 2025

Proposed Changes

Uh oh!

netlify bot commented Nov 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for knative ready!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Cali0707 commented Dec 1, 2025

Uh oh!

knative-prow bot commented Dec 1, 2025

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

evankanderson left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

iRaindrop commented Dec 8, 2025

Uh oh!

evankanderson left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

netlify bot commented Nov 19, 2025 •

edited

Loading