Learn Kubernetes 101 - Part 5 - Using Ingress - Rafay Product Documentation

Part 5: Using Ingress

This is Part 5 of a multi-part, self-paced quick start exercise.

Note
This exercise requires MicroK8s. If you do not have these already installed and running, see Prerequisites.

What Will You Do

In part 5, you will:

Use Ingress to access an application from outside the cluster.

Estimated Time
Estimated time for this exercise is 20 minutes. Watch a video of the exercise below.

Kubernetes 101 -Ingress - YouTube

Using Ingress

Ingress exposes HTTP and HTTPS routes from outside the cluster to services within the cluster. Traffic routing is controlled by rules defined on the Ingress resource.

Ingress YAML file

Create an ingress service using a YAML file, which is a configuration file. You could create a YAML file from the command line, but for this exercise, you can just use a text editor. Or you can download the ingress YAML file from this public Git repository.

Open the Terminal.
Enable Ingress in MicroK8s. When Ingress is enabled, MicroK8s adds an Ingress namespace.

microk8s enable ingress

3. Verify that the NGINX Ingress controller is running.

microk8s kubectl get pods -n ingress

4. Navigate to the Downloads folder.

cd ./Downloads

5. Use the following command to create an empty YAML file in your Downloads folder.

touch ingress.yaml

6. Use the nano text editor in the Terminal.

nano ingress.yaml

7. Copy and paste the configuration below into the text editor.
8. Press **Cmd + X**, then type **Y** and press **Return** to save the ingress.yaml file.

---

### Add an Ingress service  
1. In the Terminal or Command Prompt, add the ingress service to your environment using a YAML file.

microk8s kubectl create -f ingress.yaml

2. List the ingress services. You will need the NodePort port number. Example: 30007.

microk8s kubectl get ingress

3. Add the IP address and the hostname to the **_hosts_** file. This imitates a domain name system (DNS).

- For macOS and Linux:
     
     ```
sudo nano /etc/hosts

For Windows:
- Open Notepad as an administrator.
- Open the hosts file. Path: C:\Windows\System32\drivers\etc

Test that the service is available using the hostname and the NodePort. A message should display and include the pod name; this is from the Deployment YAML file ("Hello from...").

curl http://training-app.gorafay.net:30007


---

## ingress.yaml  
```yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: example-ingress
  annotations:
    kubernetes.io/ingress.class: "nginx"
spec:
  rules:
  - host: training-app.gorafay.net
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: test-service
            port:
              number: 4000

Recap

Congratulations! At this point, you have successfully used Namespaces, Pods, Deployments, Services, and Ingress. You are ready to progress to the next part.