Merge pull request #4043 from rayowang/updateIngress

update ingress docs

site/content/docs/user/ingress.md

@@ -8,133 +8,62 @@ menu:
 description: |-
   This guide covers setting up [ingress](https://kubernetes.io/docs/concepts/services-networking/ingress/) on a kind cluster.
 ---
-## Setting Up An Ingress Controller
+## Compatibility：
+This guide applies to [cloud-provider-kind](https://github.com/kubernetes-sigs/cloud-provider-kind) v0.9.0+. For older versions, refer to historical docs.
+
+## Setting Up Ingress
 
 Ingress exposes HTTP and HTTPS routes from outside the cluster to services within the cluster.
 
-1. [Create a cluster](#create-cluster): There are two primary methods to direct external traffic to Services inside the cluster:
+Since cloud-provider-kind v0.9.0, it natively supports Ingress. No third-party ingress controllers are required by default.
-    1. using a [LoadBalancer].
-    2. leverage KIND's `extraPortMapping` config option when creating a cluster to forward ports from the host.
 
-2. Deploy an Ingress controller, we document [Ingress NGINX](#ingress-nginx) here but other ingresses may work including [Contour](https://projectcontour.io/docs/main/guides/kind/) and Kong, you should follow their docs if you choose to use them.
+For third-party ingress solutions (e.g., Ingress NGINX, Contour), please follow their official documentation.
 
-> **NOTE**: You may also want to consider using [Gateway API](https://gateway-api.sigs.k8s.io/) instead of Ingress.
+> **NOTE**: Gateway API is also natively supported (along with Ingress). See the official [Ingress migration guide](https://gateway-api.sigs.k8s.io/guides/migrating-from-ingress/) for details.
-> Gateway API has an [Ingress migration guide](https://gateway-api.sigs.k8s.io/guides/migrating-from-ingress/).
 
-### Create Cluster
+## Create Cluster
 
-#### Option 1: LoadBalancer
+Create a kind cluster and run [Cloud Provider KIND] that automatically enables LoadBalancer support for Ingress. Create a cluster as follows.
-
-Create a kind cluster and run [Cloud Provider KIND]
-to enable the loadbalancer controller which ingress-nginx will use through the loadbalancer API.
 
 {{< codeFromInline lang="bash" >}}
 kind create cluster
 {{< /codeFromInline >}}
 
-#### Option 2: extraPortMapping
-
-Create a single node kind cluster with `extraPortMappings` to allow the local host to make requests to the Ingress controller over ports 80/443.
-
-{{< codeFromInline lang="bash" >}}
-cat <<EOF | kind create cluster --config=-
-kind: Cluster
-apiVersion: kind.x-k8s.io/v1alpha4
-nodes:
-- role: control-plane
-  extraPortMappings:
-  - containerPort: 80
-    hostPort: 80
-    protocol: TCP
-  - containerPort: 443
-    hostPort: 443
-    protocol: TCP
-EOF
-{{< /codeFromInline >}}
-
-If you want to run with multiple nodes you must ensure that your ingress-controller is deployed on the same node where you have configured the PortMapping, in this example you can use a [nodeSelector](https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/) to specify the control-plane node name.
-
-{{< codeFromInline lang="yaml" >}}
-nodeSelector:
-  kubernetes.io/hostname: "kind-control-plane"
-{{< /codeFromInline >}}
-
-### Ingress NGINX
-
-{{< codeFromInline lang="bash" >}}
-kubectl apply -f {{< absURL "examples/ingress/deploy-ingress-nginx.yaml" >}}
-{{< /codeFromInline >}}
-
-Now the Ingress is all setup. Wait until is ready to process requests running:
-
-{{< codeFromInline lang="bash" >}}
-kubectl wait --namespace ingress-nginx \
-  --for=condition=ready pod \
-  --selector=app.kubernetes.io/component=controller \
-  --timeout=90s
-{{< /codeFromInline >}}
-
-Refer [Using Ingress](#using-ingress) for a basic example usage.
-
 ## Using Ingress
 
-The following example creates simple http-echo services
+The following example creates simple http-echo services and an Ingress object to route to these services.
-and an Ingress object to route to these services.
 
 ```yaml
 {{% readFile "static/examples/ingress/usage.yaml" %}}
 ```
 
-Apply the contents
+Apply the configuration:
 
 {{< codeFromInline lang="bash" >}}
 kubectl apply -f {{< absURL "examples/ingress/usage.yaml" >}}
 {{< /codeFromInline >}}
 
-Now verify that the ingress works
+### Verify Ingress Works
 
-#### Option 1: LoadBalancer
+Check the External IP assigned to the Ingress by the built-in LoadBalancer.
-
-Check the External IP assigned to the Ingress controller by the LoadBalancer
 
 {{< codeFromInline lang="bash" >}}
-kubectl -n ingress-nginx get services
+kubectl get ingress
-NAME                                 TYPE           CLUSTER-IP     EXTERNAL-IP   PORT(S)                      AGE
+NAME              CLASS     HOSTS         ADDRESS        PORTS   AGE
-ingress-nginx-controller             LoadBalancer   10.96.33.233   192.168.8.5   80:31753/TCP,443:30288/TCP   27d
+example-ingress   <none>    example.com   172.18.0.5     80      10m
-ingress-nginx-controller-admission   ClusterIP      10.96.80.178   <none>        443/TCP                      27d
 {{< /codeFromInline >}}
 
 {{< codeFromInline lang="bash" >}}
+# get the Ingress IP
 
-# get the loadalancer IP
+INGRESS_IP=$(kubectl get ingress example-ingress -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
-
-LOADBALANCER_IP=$(kubectl get services \
-   --namespace ingress-nginx \
-   ingress-nginx-controller \
-   --output jsonpath='{.status.loadBalancer.ingress[0].ip}')
 
 # should output "foo-app"
 
-curl ${LOADBALANCER_IP}/foo
+curl ${INGRESS_IP}/foo
 
 # should output "bar-app"
-
+curl ${INGRESS_IP}/bar
-curl ${LOADBALANCER_IP}/bar
-{{< /codeFromInline >}}
-
-#### Option 2: extraPortMapping
-
-The Ingress controller ports will be exposed in your `localhost` address
-
-{{< codeFromInline lang="bash" >}}
-
-# should output "foo-app"
-
-curl localhost/foo
-
-# should output "bar-app"
-
-curl localhost/bar
 {{< /codeFromInline >}}
 
 [LoadBalancer]: /docs/user/loadbalancer/