VU2022_XM_0091

Project for the course Software Containerization (CS Master) at VU

Prerequisites:

• microk8s with dns, helm3, registry, storage, ingress

Setup:

1. (On GKE, run export PROJECT=$(gcloud config get-value project) && export INGRESS_CLASS=nginx REGISTRY=gcr.io/$PROJECT)
2. (On GKE, create and/or connect to the cluster)
3. (On GKE, install the nginx ingress controller and run export APP_HOSTNAME="<IP>.nip.io")
4. Build container images
5. Push container images
6. Generate TLS certificate
7. Create namespace
8. Update helm chart dependencies
9. Install helm chart

(!) The app is deployed locally on http://127.0.0.1.nip.io or on http://<IP>.nip.io on GKE

Folders:

• /backend contains the backend of the app
• /database contains the compose file for local development using MongoDB
• /frontend contains the frontend of the app
• /helm contains the files for deploying the application on a cluster
• /scripts contains useful scripts to cut down the amount of cli interaction

Scripts:

Use:

• build-and-push.sh to update the images for kubernetes
• download-dependencies.sh to get external helm charts
• gen-secrets.sh to create kubernetes secrets used by helm
• gen-tls.sh to create a rootCA and the host certificate used by helm
• app.sh to manage the deployment of the app through helm
• create-namespace.sh to create the namespace `development'
• test-net-policies.sh to challenge the network policy restrictions
• clean-ctr.sh to evict all images from the cache of the local container registries
• canary-frontend.sh to manage the release of a new frontend
• install-nginx-ingress-ctrl.sh to install nginx ingress controller
• gke-connect-cluster.sh to create or connect to the GKE cluster
• gke-nginx-ingress-ctrl.sh to install the nginx ingress controller
• gke-rbac.sh to set up cluster roles for Google Users (see values.yaml)
  (RBAC for microk8s is implemented on this (unused) branch)
• scale.sh to horizontally scale the stateless components of the application

Patching:

• Change the theme by running patch -p0 < theme.patch
• Undo the change by running the same command including the -R flag