Deploy a static web page using helm and traefik

The purpose of this lab is to develop a full provisioned pipeline to deploy a static web page.

You can clone this repository to get some of the files that are we going to use during the lab.

Objectives

1. Build your own Docker image that can serve a static "Hello World" HTML page

2. Deploy that image as a container in a Kubernetes cluster running locally on your machine using helm and writing your own chart

3. Deploy a Traefik container in the same local Kubernetes cluster using helm

4. Make Traefik an ingress point to access the "Hello World" page

5. Make the "Hello World" page accessible locally at http://hello-world.local

Requirements

For the purpose of this lab we are going to use a CentOS 7.

Pre-requisite tools

We are going to use the following tools (click in the link to see how to install each tool):

• Docker

• Kubernetes

• Helm

Build of the components

All required files and scripts for this deployment are included in this project.

• How to create the docker image: ./docker/README.md

• How to create the helm chart: ./helm/README.md

Deploy the app (manual steps)

References:

• https://doc.traefik.io/traefik/v2.3/routing/providers/kubernetes-ingress/

• https://doc.traefik.io/traefik/v1.7/user-guide/kubernetes/ (this is from a previous version of trafik but the idea is basically the same)

These are the required steps, assuming you already have all required tools already installed.

1. Clone this project in an empty directory

   git clone https://github.com/rjrpaz/deploy-using-helm.git

2. Change location to the new directory

   cd deploy-using-helm

3. Assure that ingress addon for minikube is already installed

   minikube addons enable ingress

4. Create a namespace

   kubectl create namespace tr-webapp-ns

5. Install the app:

   1. Add helm repo for the app

      helm repo add tr-webapp https://www.robertopaz.com.ar/deploy-using-helm/

   2. If required, update helm

      helm repo update

   3. Install the app

      helm install tr-webapp tr-webapp/tr-webapp --namespace tr-webapp-ns

6. Install traefik

   1. Add helm repo for traefik

      helm repo add traefik https://helm.traefik.io/traefik

   2. If required, update helm

      helm repo update

   3. Install traefik

      helm install traefik traefik/traefik --namespace tr-webapp-ns

7. List pods in the namespace to check status

   kubectl get pods --namespace tr-webapp-ns

   It should return at least two running pods (our app and traefik service):

   NAME                         READY   STATUS    RESTARTS   AGE
   tr-webapp-86b97d69cc-znpvl   1/1     Running   0          4m6s
   traefik-7594596bbc-6mzg9     1/1     Running   0          39s

   Wait until both containers are in Running STATUS.

8. Apply the ingress file:

   kubectl apply -f helm/ingress.yaml --namespace tr-webapp-ns

9. Check service resources

   kubectl get svc --namespace tr-webapp-ns

   It should return something like this:

   NAME        TYPE           CLUSTER-IP      EXTERNAL-IP   PORT(S)                      AGE
   tr-webapp   NodePort       10.103.93.206   <none>        8080:32422/TCP               9m53s
   traefik     LoadBalancer   10.96.143.228   <pending>     80:31004/TCP,443:31250/TCP   8m16s

10. Check ingress resources

    kubectl get ingress --namespace tr-webapp-ns

    It should return something like this:

    NAME        CLASS    HOSTS               ADDRESS        PORTS   AGE
    myingress   <none>   hello-world.local   192.168.49.2   80      6m24s

    (you should wait a few seconds until "ADDRESS" list an IP address for the ingress resource)

11. Create a static entry in /etc/hosts to point to the new hostname hello-world.local

    echo "$(minikube ip) hello-world.local" | sudo tee -a /etc/hosts

12. Check reachability to the url:

    curl hello-world.local

    You should get a "Hello World" message

Deploy the app using terraform

References:

• https://registry.terraform.io/providers/hashicorp/kubernetes/latest/docs

• https://registry.terraform.io/providers/hashicorp/helm/latest/docs/resources/release

• https://registry.terraform.io/providers/hashicorp/kubernetes/latest/docs/resources/ingress

1. You should have terraform installed. You can install terraform in CentOS using packet manager:

   sudo yum -y install terraform

2. Assure that ingress addon for minikube is already installed

   minikube addons enable ingress

3. Clone this project in an empty directory

   git clone https://github.com/rjrpaz/deploy-using-helm.git

4. Change location where terraform code is located:

   cd deploy-using-helm/terraform

5. Init terraform

   terraform init

6. Apply terraform code

   terraform apply --auto-approve

7. Check ingress resources

   kubectl get ingress --namespace tr-webapp-ns

   It should return something like this:

   NAME        CLASS    HOSTS               ADDRESS        PORTS   AGE
   myingress   <none>   hello-world.local   192.168.49.2   80      6m24s

   (you should wait a few seconds until "ADDRESS" list an IP address for the ingress resource)

8. Create a static entry in /etc/hosts to point to the new hostname hello-world.local

   echo "$(minikube ip) hello-world.local" | sudo tee -a /etc/hosts

9. Check reachability to the url:

   curl hello-world.local

   You should get a "Hello World" message

Alternative solutions to apply ingress entry point

While I was investigating this, I tried some alternative solutions listed below:

• Use nginx ingress here

• Use traefik + yaml files here

Next steps

• Get ingress plugin to work with a newest version of minikube (Current version: 1.23.0).

• Configure all services using a custom helm chart (remove yaml content).