Set up Ingress on Minikube with the NGINX Ingress Controller

An Ingress is an API object that defines rules which allow external access to services in a cluster. An Ingress controller fulfills the rules set in the Ingress.

This page shows you how to set up a simple Ingress which routes requests to Service web or web2 depending on the HTTP URI.

Before you begin

You need to have a Kubernetes cluster, and the kubectl command-line tool must be configured to communicate with your cluster. It is recommended to run this tutorial on a cluster with at least two nodes that are not acting as control plane hosts. If you do not already have a cluster, you can create one by using minikube or you can use one of these Kubernetes playgrounds:

To check the version, enter kubectl version.

Create a Minikube cluster

  1. Click Launch Terminal

  2. (Optional) If you installed Minikube locally, run the following command:

    minikube start

Enable the Ingress controller

  1. To enable the NGINX Ingress controller, run the following command:

    minikube addons enable ingress

  2. Verify that the NGINX Ingress controller is running

kubectl get pods -n ingress-nginx
Note: This can take up to a minute.

Output:

NAME                                        READY   STATUS      RESTARTS    AGE
ingress-nginx-admission-create-g9g49        0/1     Completed   0          11m
ingress-nginx-admission-patch-rqp78         0/1     Completed   1          11m
ingress-nginx-controller-59b45fb494-26npt   1/1     Running     0          11m


kubectl get pods -n kube-system
Note: This can take up to a minute.

Output:

NAME                                        READY     STATUS    RESTARTS   AGE
default-http-backend-59868b7dd6-xb8tq       1/1       Running   0          1m
kube-addon-manager-minikube                 1/1       Running   0          3m
kube-dns-6dcb57bcc8-n4xd4                   3/3       Running   0          2m
kubernetes-dashboard-5498ccf677-b8p5h       1/1       Running   0          2m
nginx-ingress-controller-5984b97644-rnkrg   1/1       Running   0          1m
storage-provisioner                         1/1       Running   0          2m

```shell
kubectl get pods -n ingress-nginx
```



  
Note: This can take up to a minute.




Output:

```shell
NAME                                        READY   STATUS      RESTARTS   AGE
ingress-nginx-admission-create-2tgrf        0/1     Completed   0          3m28s
ingress-nginx-admission-patch-68b98         0/1     Completed   0          3m28s
ingress-nginx-controller-59b45fb494-lzmw2   1/1     Running     0          3m28s
```

Deploy a hello, world app

  1. Create a Deployment using the following command:

    kubectl create deployment web --image=gcr.io/google-samples/hello-app:1.0

    Output:

    deployment.apps/web created

  2. Expose the Deployment:

    kubectl expose deployment web --type=NodePort --port=8080

    Output:

    service/web exposed

  3. Verify the Service is created and is available on a node port:

    kubectl get service web

    Output:

    NAME      TYPE       CLUSTER-IP       EXTERNAL-IP   PORT(S)          AGE
web       NodePort   10.104.133.249   <none>        8080:31637/TCP   12m

  4. Visit the service via NodePort:

    minikube service web --url

    Output:

    http://172.17.0.15:31637
    Note: Katacoda environment only: at the top of the terminal panel, click the plus sign, and then click Select port to view on Host 1. Enter the NodePort, in this case 31637, and then click Display Port.

    Output:

    Hello, world!
Version: 1.0.0
Hostname: web-55b8c6998d-8k564

    You can now access the sample app via the Minikube IP address and NodePort. The next step lets you access the app using the Ingress resource.

Create an Ingress resource

The following file is an Ingress resource that sends traffic to your Service via hello-world.info.

  1. Create example-ingress.yaml from the following file:
service/networking/example-ingress.yaml 
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: example-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /$1
spec:
  rules:
    - host: hello-world.info
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: web
                port:
                  number: 8080

  1. Create the Ingress resource by running the following command:

    kubectl apply -f https://k8s.io/examples/service/networking/example-ingress.yaml

    Output:

    ingress.networking.k8s.io/example-ingress created

  2. Verify the IP address is set:

    kubectl get ingress
    Note: This can take a couple of minutes.
    NAME              CLASS    HOSTS              ADDRESS        PORTS   AGE
example-ingress   <none>   hello-world.info   172.17.0.15    80      38s

  3. Add the following line to the bottom of the /etc/hosts file.

    Note: If you are running Minikube locally, use minikube ip to get the external IP. The IP address displayed within the ingress list will be the internal IP.
    172.17.0.15 hello-world.info

    This sends requests from hello-world.info to Minikube.

  4. Verify that the Ingress controller is directing traffic:

    curl hello-world.info

    Output:

    Hello, world!
Version: 1.0.0
Hostname: web-55b8c6998d-8k564
    Note: If you are running Minikube locally, you can visit hello-world.info from your browser.

Create Second Deployment

  1. Create a v2 Deployment using the following command:

    kubectl create deployment web2 --image=gcr.io/google-samples/hello-app:2.0

    Output:

    deployment.apps/web2 created

  2. Expose the Deployment:

    kubectl expose deployment web2 --port=8080 --type=NodePort

    Output:

    service/web2 exposed

Edit Ingress

  1. Edit the existing example-ingress.yaml and add the following lines:

          - path: /v2
        pathType: Prefix
        backend:
          service:
            name: web2
            port:
              number: 8080

  2. Apply the changes:

    kubectl apply -f example-ingress.yaml

    Output:

    ingress.networking/example-ingress configured

Test Your Ingress

  1. Access the 1st version of the Hello World app.

    curl hello-world.info

    Output:

    Hello, world!
Version: 1.0.0
Hostname: web-55b8c6998d-8k564

  2. Access the 2nd version of the Hello World app.

    curl hello-world.info/v2

    Output:

    Hello, world!
Version: 2.0.0
Hostname: web2-75cd47646f-t8cjk
    Note: If you are running Minikube locally, you can visit hello-world.info and hello-world.info/v2 from your browser.

What's next

Last modified September 03, 2021 at 2:24 PM PST : Use correct namespace (2aca8f917)