Create Configure Knative Networking page

docs/snippets/dns.md

@@ -1,7 +1,6 @@
-You can configure DNS to prevent the need to run curl commands with a host header.
+You can configure DNS to avoid specifying the host header in curl commands, or to access the content with a web browser.
 
-The following tabs expand to show instructions for configuring DNS.
-Follow the procedure for the DNS of your choice:
+The following tabs show instructions for configuring DNS. Follow the procedure for the DNS of your choice:
 
 === "Magic DNS (sslip.io)"
 
@@ -11,10 +10,5 @@ Follow the procedure for the DNS of your choice:
     kubectl apply -f {{artifact(repo="serving",file="serving-default-domain.yaml")}}
     ```
 
-    !!! warning
-        This will only work if the cluster `LoadBalancer` Service exposes an
-        IPv4 address or hostname, so it will not work with IPv6 clusters or local setups
-        like minikube unless [`minikube tunnel`](https://minikube.sigs.k8s.io/docs/commands/tunnel/)
-        is running.
+    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 the [`minikube tunnel`](https://minikube.sigs.k8s.io/docs/commands/tunnel/) is running.
 
-        In these cases, see the "Real DNS" or "No DNS" tabs.

docs/snippets/netadapter-contour.md

@@ -0,0 +1,28 @@
+Use the following steps to install and enable Contour and set it as the ingress conroller.
+
+1. Install the Knative Contour configuration:
+
+    ```bash
+    kubectl apply -f {{ artifact(repo="net-contour",org="knative-extensions",file="contour.yaml")}}
+    ```
+
+1. Install the Knative Contour integration controller:
+
+    ```bash
+    kubectl apply -f {{ artifact(repo="net-contour",org="knative-extensions",file="net-contour.yaml")}}
+    ```
+
+1. Configure Knative Serving to use Contour:
+
+    ```bash
+      kubectl patch configmap/config-network \
+      --namespace knative-serving \
+      --type merge \
+      --patch '{"data":{"ingress-class":"contour.ingress.networking.knative.dev"}}'
+    ```
+
+1. Get the external IP address (FQDN) to later configure DNS:
+
+    ```bash
+    kubectl --namespace contour-external get service envoy
+    ```

docs/snippets/netadapter-gatewayapi.md

@@ -0,0 +1,74 @@
+Use the following steps to install and configure the Knative Gateway API adapter.  Note that you need to have a [Gateway API implementation](https://gateway-api.sigs.k8s.io/implementations/) installed in your cluster.  The Knative team currently tests the Istio, Contour, and Envoy-Gateway implementations of Gateway API.
+
+1. Clone the Gateway API repo:
+
+    ```bash
+    git clone https://github.com/knative-extensions/net-gateway-api.git
+    cd net-gateway-api
+    ```
+
+1. Set environment variables:
+
+    ```bash
+    export KO_DOCKER_REPO=kind.local
+    export KIND_CLUSTER_NAME=knative  # (keep this if your cluster is named "knative")
+    ```
+
+1. Deploy Gateway API resources:
+
+    ```bash
+    ko apply -f config/
+    ```
+
+1. Install the Knative Gateway API:
+
+    ```bash
+      kubectl apply -f {{ artifact(repo="net-gateway-api",org="knative-extensions",file="net-gateway-api.yaml") }}
+    ```
+
+1. Configure Knative Serving to use the Knative Gateway API ingress class:
+
+    ```bash
+    kubectl patch configmap/config-network \
+      --namespace knative-serving \
+      --type merge \
+      --patch '{"data":{"ingress-class":"gateway-api.ingress.networking.knative.dev"}}'
+    ```
+
+1. Edit the `config-gateway` ConfigMap in the knative-serving namespace to specify gateway resources for external and local traffic. For the `external-gateways` key, specify the value for `name` and for `service` as needed. Do the same for the `local gateways`. The `namespace` should be kept at `knative-serving`.
+
+    ```bash
+    cat <<EOF | kubectl apply -f -
+    apiVersion: v1
+    kind: ConfigMap
+    metadata:
+      name: config-gateway
+      namespace: knative-serving
+      labels:
+        app.kubernetes.io/component: net-gateway-api
+        app.kubernetes.io/name: knative-serving
+    data:
+      external-gateways: |
+        - name: knative-ingress-gateway  # Name of the external Gateway resource
+          namespace: knative-serving     # Namespace where the Gateway is deployed
+          service: knative-ingress-service.knative-serving.svc.cluster.local  # backing Service FQDN
+      local-gateways: |
+        - name: knative-local-gateway    # Name of the local Gateway resource
+          namespace: knative-serving     # Namespace where the Gateway is deployed
+          service: knative-local-service.knative-serving.svc.cluster.local    # backing Service FQDN
+    EOF
+    ```
+
+1. Verify the `config-gateway` ConfigMap:
+
+    ```bash
+    kubectl get configmap config-gateway -n knative-serving -o yaml
+    ```
+
+1. Get the external IP address (FQDN) to configure DNS records:
+
+    ```bash
+    kubectl get gateway --all-namespaces
+    ```
+
+    Look for the external Gateway (`knative-ingress-gateway`) to get status and address for DNS configuration.

docs/snippets/netadapter-istio.md

@@ -0,0 +1,33 @@
+Use the following steps to install Istio and set it as the ingress conroller.
+
+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") }}
+    kubectl apply -f {{ artifact(repo="net-istio",org="knative-extensions",file="istio.yaml") }}
+    ```
+
+1. Install the Knative Istio controller:
+
+    ```bash
+    kubectl apply -f {{ artifact(repo="net-istio",org="knative-extensions", file="net-istio.yaml") }}
+    ```
+
+    <!-- ```bash
+    kubectl apply -f https://github.com/knative/net-istio/releases/download/knative-v1.20.1/net-istio.yaml
+    ``` -->
+
+1. Configure the `config-network` ConfigMap to use Istio:
+
+    ```bash
+      kubectl patch configmap/config-network \
+      --namespace knative-serving \
+      --type merge \
+      --patch '{"data":{"ingress-class":"istio.ingress.networking.knative.dev"}}'
+    ```
+
+1. Get the external IP address (FQDN) to later configure DNS:
+
+    ```bash
+    kubectl --namespace istio-system get service istio-ingressgateway
+    ```

docs/snippets/netadapter-kourier.md

@@ -0,0 +1,22 @@
+Use the following steps to install Kourier and set it as the ingress controller.
+
+1. Install the Knative Kourier controller:
+
+    ```bash
+     kubectl apply -f {{ artifact(repo="net-kourier",org="knative-extensions", file="kourier.yaml") }}
+    ```
+
+1. Configure Knative Serving to use Kourier by default:
+
+    ```bash
+    kubectl patch configmap/config-network \
+    --namespace knative-serving \
+    --type merge \
+    --patch '{"data":{"ingress-class":"kourier.ingress.networking.knative.dev"}}'
+    ```
+
+1. Get the external IP address (FQDN) to later configure DNS:
+
+    ```bash
+    kubectl --namespace kourier-system get service kourier
+    ```

docs/versioned/.nav.yml

@@ -267,7 +267,8 @@ nav:
         - Configure high-availability components: serving/config-ha.md
         - Exclude namespaces from the Knative webhook: serving/webhook-customizations.md
         - Networking Options:
-          - Configure the ingress gateway: serving/setting-up-custom-ingress-gateway.md
+          - Configure Knative networking: serving/config-network-adapters.md
+          - Configure Istio's ingress gateway: serving/setting-up-custom-ingress-gateway.md
           - Configure domain names: serving/using-a-custom-domain.md
           - Istio Authorization: serving/istio-authorization.md
           - Extending Queue Proxy image with QPOptions: serving/queue-extensions.md

docs/versioned/install/yaml-install/serving/install-serving-with-yaml.md

@@ -41,104 +41,23 @@ To install the Knative Serving component:
 
 ## Install a networking layer
 
-The following tabs expand to show instructions for installing a networking layer.
-Follow the procedure for the networking layer of your choice:
+Expand the following tabs for instructions on installing network layers. For an overview of network layer options, architecture, and configurations see [Configure Knative networking](../../../serving/config-network-adapters.md).
 
-!!! note
-    **Only Kourier network plugin supported for IBM Z and IBM Power platform.** 
-    Follow the below steps to install Kourier. Post installation, patch the envoy image based on RedHat Maistra as described in [this link](./install-serving-with-yaml-on-IBM-Z-and-IBM-P.md).
-
-<!-- TODO: Link to document/diagram describing what is a networking layer.  -->
-<!-- This indentation is important for things to render properly. -->
-
-=== "Kourier (Choose this if you are not sure)"
-
-    The following commands install Kourier and enable its Knative integration.
-
-    1. Install the Knative Kourier controller by running the command:
-    ```bash
-    kubectl apply -f {{ artifact(repo="net-kourier",org="knative-extensions",file="kourier.yaml")}}
-    ```
-
-    1. Configure Knative Serving to use Kourier by default by running the command:
-      ```bash
-      kubectl patch configmap/config-network \
-        --namespace knative-serving \
-        --type merge \
-        --patch '{"data":{"ingress-class":"kourier.ingress.networking.knative.dev"}}'
-      ```
-
-    1. Fetch the External IP address or CNAME by running the command:
-
-        ```bash
-        kubectl --namespace kourier-system get service kourier
-        ```
-
-        !!! tip
-            Save this to use in the following [Configure DNS](#configure-dns) section.
-
-
-=== "Istio"
-
-    The following commands install Istio and enable its Knative integration.
-
-    1. Install a properly configured Istio by following the
-    [Advanced Istio installation](../../installing-istio.md) instructions or by running the command:
-
-        ```bash
-        kubectl apply -l knative.dev/crd-install=true -f {{ artifact(repo="net-istio",org="knative-extensions",file="istio.yaml")}}
-        kubectl apply -f {{ artifact(repo="net-istio",org="knative-extensions",file="istio.yaml")}}
-        ```
-
-    1. Install the Knative Istio controller by running the command:
-
-        ```bash
-        kubectl apply -f {{ artifact(repo="net-istio",file="net-istio.yaml")}}
-        ```
-
-    1. Fetch the External IP address or CNAME by running the command:
-
-        ```bash
-        kubectl --namespace istio-system get service istio-ingressgateway
-        ```
-
-        !!! tip
-            Save this to use in the following [Configure DNS](#configure-dns) section.
+=== "Kourier"
 
+    {% include "netadapter-kourier.md" %}
 
 === "Contour"
 
-    The following commands install Contour and enable its Knative integration.
+    {% include "netadapter-contour.md" %}
 
-    1. Install a properly configured Contour by running the command:
-
-        ```bash
-        kubectl apply -f {{ artifact(repo="net-contour",org="knative-extensions",file="contour.yaml")}}
-        ```
-        <!-- TODO(https://github.com/knative-extensions/net-contour/issues/11): We need a guide on how to use/modify a pre-existing install. -->
-
-    1. Install the Knative Contour controller by running the command:
-      ```bash
-      kubectl apply -f {{ artifact(repo="net-contour",org="knative-extensions",file="net-contour.yaml")}}
-      ```
-
-    1. Configure Knative Serving to use Contour by default by running the command:
-      ```bash
-      kubectl patch configmap/config-network \
-        --namespace knative-serving \
-        --type merge \
-        --patch '{"data":{"ingress-class":"contour.ingress.networking.knative.dev"}}'
-      ```
-
-    1. Fetch the External IP address or CNAME by running the command:
+=== "Istio"
 
-        ```bash
-        kubectl --namespace contour-external get service envoy
-        ```
+    --8<-- "netadapter-istio.md"
 
-        !!! tip
-            Save this to use in the following [Configure DNS](#configure-dns) section.
+=== "Gateway API"
 
+    {% include "netadapter-gatewayapi.md" %}
 
 ## Verify the installation