Set up Ingress on Minikube with the NGINX Ingress Controller

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

    This tutorial assumes that you are using to run a local Kubernetes cluster. Visit to learn how to install minikube.

    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:

    Your Kubernetes server must be at or later than version 1.19. To check the version, enter kubectl version. If you are using an older Kubernetes version, switch to the documentation for that version.

    If you haven’t already set up a cluster locally, run minikube start to create a cluster.

    Enable the Ingress controller

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

    2. Verify that the NGINX Ingress controller is running

      1. kubectl get pods -n ingress-nginx

      Note: It can take up to a minute before you see these pods running OK.

      The output is similar to:

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

    1. Create a Deployment using the following command:

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

      The output should be:

      1. deployment.apps/web created

    2. Expose the Deployment:

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

      The output should be:

      1. service/web exposed

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

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

    4. Visit the Service via NodePort:

      1. minikube service web --url

      The output is similar to:

      The output is similar to:

      1. Hello, world!
      2. Hostname: web-55b8c6998d-8k564

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

    Create an Ingress

    The following manifest defines an Ingress that sends traffic to your Service via hello-world.info.

    1. Create example-ingress.yaml from the following file:

      1. apiVersion: networking.k8s.io/v1
      2.    kind: Ingress
      3.    metadata:
      4.      name: example-ingress
      6.        nginx.ingress.kubernetes.io/rewrite-target: /$1
      7.    spec:
      8.      rules:
      9.        - host: hello-world.info
      10.          http:
      11.            paths:
      12.              - path: /
      13.                pathType: Prefix
      14.                backend:
      15.                  service:
      16.                    name: web
      17.                    port:
      18.                      number: 8080

    2. Create the Ingress object by running the following command:

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

      The output should be:

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

    3. Verify the IP address is set:

      1. kubectl get ingress

      Note: This can take a couple of minutes.

      You should see an IPv4 address in the ADDRESS column; for example:

      1. NAME              CLASS    HOSTS              ADDRESS        PORTS   AGE
      2. example-ingress   <none>   hello-world.info   172.17.0.15    80      38s

    4. Verify that the Ingress controller is directing traffic:

      1. curl --resolve "hello-world.info:80:$( minikube ip )" -i http://hello-world.info

      You should see:

      1. Hello, world!
      2. Version: 1.0.0

      • Optionally Look up the external IP address as reported by minikube:

        1. minikube ip

        Add line similar to the following one to the bottom of the file on your computer (you will need administrator access):

        Note: Change the IP address to match the output from minikube ip.

        After you make this change, your web browser sends requests for hello-world.info URLs to Minikube.

    1. Create another Deployment using the following command:

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

      The output should be:

      1. deployment.apps/web2 created

    2. Expose the second Deployment:

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

      The output should be:

      1. service/web2 exposed

    Edit the existing Ingress

    1. Edit the existing example-ingress.yaml manifest, and add the following lines at the end:

      1. - path: /v2
      2.   pathType: Prefix
      3.   backend:
      4.     service:
      5.       name: web2
      6.       port:
      7.         number: 8080

    2. Apply the changes:

      1. kubectl apply -f example-ingress.yaml

      You should see:

      1. ingress.networking/example-ingress configured

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

      1. curl --resolve "hello-world.info:80:$( minikube ip )" -i http://hello-world.info

      The output is similar to:

      1. Hello, world!
      2. Version: 1.0.0
      3. Hostname: web-55b8c6998d-8k564

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

      1. Hello, world!
      2. Version: 2.0.0
      3. Hostname: web2-75cd47646f-t8cjk

      Note: If you did the optional step to update /etc/hosts, you can also visit hello-world.info and from your browser.

    What’s next