Plugin: Kourier #6456

iRaindrop · 2025-10-17T06:54:38Z

Need topic to install the Kourier plugin. Source: https://github.com/knative-extensions/net-kourier

Proposed Changes

Create Installing Kourier to include in the Plugin section for Installing Knative.

Initial write up

knative-prow · 2025-10-17T06:54:48Z

[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 assign zainabhusain227 for approval. 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

netlify · 2025-10-17T06:55:23Z

✅ Deploy Preview for knative ready!

Built without sensitive environment variables

Name	Link
🔨 Latest commit	`e5956c0`
🔍 Latest deploy log	https://app.netlify.com/projects/knative/deploys/68f5e19482d1860008d06769
😎 Deploy Preview	https://deploy-preview-6456--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.

Finished bringing over content

Misc edits

dprotaso

Curious - we cover this stuff here already given it's related to serving - are these pages meant to be duplicated or are we cleaning out the sections?

https://knative.dev/docs/install/yaml-install/serving/install-serving-with-yaml/#install-a-networking-layer

dprotaso · 2025-10-20T13:57:23Z

docs/versioned/install/installing-kourier.md

+1. Install Knative Serving if not already installed:
+
+    ``` bash
+    kubectl apply -f https://github.com/knative/serving/releases/latest/download/serving-crds.yaml
+    kubectl apply -f https://github.com/knative/serving/releases/latest/download/serving-core.yaml
+    ```


Link to Serving installation page?

Thanks Dave - yes we should link to installing a network layer for both kourier and Contour. Will consult with Evan.

Yeah, I'd link this to ./yaml-install/serving/install-serving-with-yaml.md, rather than including inline instructions.

Also, we say that having Knative Serving installed is a pre-requisite, so it's weird to also have install instructions here.

I don't recall what the equivalent Operator version is, so you might want to leave a  somewhere in this file.

dprotaso · 2025-10-20T13:57:51Z

docs/versioned/install/installing-kourier.md

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


latest should be a release version - we have a macro somewhere for that

Suggested change

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

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

(Taken from the install-serving-with-yaml.md instructions.)

evankanderson

Thanks for collecting this documentation! A few comments, but it's nice to have the documentation gathered in one place.

It looks like most of the configuration information was surfaced from outside the existing docs tree, so thanks for digging that up!

evankanderson · 2025-10-21T19:23:52Z

docs/versioned/install/installing-kourier.md

+1. Install Knative Serving if not already installed:
+
+    ``` bash
+    kubectl apply -f https://github.com/knative/serving/releases/latest/download/serving-crds.yaml
+    kubectl apply -f https://github.com/knative/serving/releases/latest/download/serving-core.yaml
+    ```


Yeah, I'd link this to ./yaml-install/serving/install-serving-with-yaml.md, rather than including inline instructions.

Also, we say that having Knative Serving installed is a pre-requisite, so it's weird to also have install instructions here.

I don't recall what the equivalent Operator version is, so you might want to leave a  somewhere in this file.

evankanderson · 2025-10-21T19:26:04Z

docs/versioned/install/installing-kourier.md

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


Suggested change

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

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

(Taken from the install-serving-with-yaml.md instructions.)

evankanderson · 2025-10-21T19:27:44Z

docs/versioned/install/installing-kourier.md

+1. Optional - Set your desired domain (replace `127.0.0.1.nip.io` to your preferred domain):
+
+    ```bash
+    kubectl patch configmap/config-domain \
+      -n knative-serving \
+      --type merge \
+      -p '{"data":{"127.0.0.1.nip.io":""}}'
+    ```


This is not Kourier-specific, though we should describe how to find Kourier's external IP address (from install-serving-with-yaml.md):

kubectl --namespace kourier-system get service kourier

I would put this in a separate section (since we have its own page). Something like "DNS configuration"

evankanderson · 2025-10-21T19:28:18Z

docs/versioned/install/installing-kourier.md

+    ```bash
+    cat <<-EOF | kubectl apply -f -
+    apiVersion: serving.knative.dev/v1
+    kind: Service
+    metadata:
+      name: helloworld-go
+    spec:
+      template:
+        spec:
+          containers:
+          - image: gcr.io/knative-samples/helloworld-go
+            env:
+            - name: TARGET
+              value: Go Sample v1
+    EOF
+    ```


Again, I would either omit this, or put it in a "verification" section, since it's not required for the installation.

evankanderson · 2025-10-21T19:30:58Z

docs/versioned/install/installing-kourier.md

+1. Optional - For testing purposes, you can use port-forwarding to make requests to Kourier from your machine:
+
+    ```bash
+    kubectl port-forward --namespace kourier-system $(kubectl get pod -n kourier-system -l "app=3scale-kourier-gateway" --output=jsonpath="{.items[0].metadata.name}") 8080:8080 19000:9000 8443:8443
+
+    curl -v -H "Host: helloworld-go.default.127.0.0.1.nip.io" http://localhost:8080
+    ```


I probably wouldn't include this at all. If we do want to include these commands, I'd put them under verification / troubleshooting, with the detail that these commands can help take external DNS resolution and cluster loadbalancing out of the picture if you think you're having trouble with those components. But I'd expect most administrators to be able to check those components themselves, since we're assuming that they have cluster administration experience, and a cluster with malfunctioning load balancing or DNS is probably going to have problems beyond Knative Serving.

evankanderson · 2025-10-21T19:31:14Z

docs/versioned/install/installing-kourier.md

+
+By default, the deployment of the Kourier components is split between two different namespaces:
+
+- `knative-serving` - Namespace where Kourier control is deployed.


Suggested change

- `knative-serving` - Namespace where Kourier control is deployed.

- `knative-serving` - Namespace where Kourier controlle is deployed.

evankanderson · 2025-10-21T19:32:47Z

docs/versioned/install/installing-kourier.md

+- External Authorization support.
+- Proxy Protocol (AN EXPERIMENTAL / ALPHA FEATURE)
+
+## Setup TLS certificate


I would put this and the remaining topics under a "Configuration" header, and move e.g. h2 elements to h3, and h3 to h4.

evankanderson · 2025-10-21T19:35:27Z

/assign

dprotaso · 2025-10-21T20:21:06Z

/assign @dsimansk

As the resident Kourier expert

iRaindrop · 2025-10-25T05:08:28Z

This content will now be under Configuring Knative->Networking Options->Plugin: Kourier

Create installing-kourier.md

e1b40e7

Initial write up

knative-prow bot requested review from dsimansk and pierDipi October 17, 2025 06:54

knative-prow bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Oct 17, 2025

iRaindrop marked this pull request as draft October 17, 2025 06:55

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 Oct 17, 2025

iRaindrop changed the title ~~Add Installing-Kourier to Knative installation documentation~~ Add Installing Kourier to Knative installation documentation Oct 17, 2025

iRaindrop changed the title ~~Add Installing Kourier to Knative installation documentation~~ Add Installing Kourier to docs Oct 17, 2025

iRaindrop added 3 commits October 17, 2025 00:18

Added to nav and small edit

0f64acf

Update installing-kourier.md

c31c34b

Finished bringing over content

Update installing-kourier.md

e5956c0

Misc edits

iRaindrop marked this pull request as ready for review October 20, 2025 07:20

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 Oct 20, 2025

knative-prow bot requested a review from zainabhusain227 October 20, 2025 07:21

dprotaso reviewed Oct 20, 2025

View reviewed changes

evankanderson reviewed Oct 21, 2025

View reviewed changes

knative-prow bot assigned evankanderson Oct 21, 2025

knative-prow bot assigned dsimansk Oct 21, 2025

iRaindrop marked this pull request as draft October 24, 2025 18:52

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 Oct 24, 2025

iRaindrop changed the title ~~Add Installing Kourier to docs~~ Plugin: Kourier Oct 25, 2025

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


		By default, the deployment of the Kourier components is split between two different namespaces:

		- `knative-serving` - Namespace where Kourier control is deployed.

Plugin: Kourier #6456

Are you sure you want to change the base?

Plugin: Kourier #6456

Uh oh!

Conversation

iRaindrop commented Oct 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Proposed Changes

Uh oh!

knative-prow bot commented Oct 17, 2025

Uh oh!

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

Uh oh!

✅ Deploy Preview for knative ready!

Uh oh!

dprotaso 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!

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!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

evankanderson commented Oct 21, 2025

Uh oh!

dprotaso commented Oct 21, 2025

Uh oh!

iRaindrop commented Oct 25, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

iRaindrop commented Oct 17, 2025 •

edited

Loading

netlify bot commented Oct 17, 2025 •

edited

Loading