Kubernetes Build

The Mint System collection of Helm charts.

• 🚀 Install: Install Helm repository and get started with Odoo.
• 🛠️ Develop: Deploy Odoo and Postgres to a local Kubernetes cluster.
• 🏗️ Build: Fork and build your own Helm charts.
• 🚀 Deploy: Configure and deploy Helm charts to remote clusters.

Usage

Add this Helm repository.

helm repo add kubernetes-build https://kubernetes.build

Install a chart.

helm install "$NAME" "kubernetes-build/$NAME"

Charts

List of charts:

• clusterIssuer
• odoo
• postgres
• vshnPostgres
• hugo
• deploymentUpdater
• forgejoRunner

Develop

Setup a local Kubernetes cluster and deploy the Helm charts.

Requirements

• Install Helm and kubectl
• Setup kind or minikube
• Optional: bash/zsh alias task='./task' with completion.

Clone the repository:

git clone git@github.com:Mint-System/Kubernetes-Build.git
cd Kubernetes-Build

Start Kubernetes cluster

Start Kubernetes with kind.

task start-kind

Or start Kubernetes with minikube.

task start-minikube

Deploy Odoo chart

Ensure you have kubectl installed and can access the cluster.

Add chart dependencies.

task add-repos

If not already done setup the local hostnames.

task setup-hosts

Template the .env file.

task template-dotenv

Install the CloudNativePG chart:

task install-chart cnpg

Install the Odoo chart:

task install-chart odoo

The Odoo database will be initialized automtically.

Once the pod is ready, run this command to port forward the service:

task forward odoo

Setup ingress nginx

Install ingress-nginx in the current cluster.

task install-chart ingress-nginx

Forward the ingress-nginx port.

task forward ingress-nginx

Setup haproxy ingress

Install haproxy-ingress in the current cluster.

task install-chart haproxy-ingress

Forward the haproxy-ingress port.

task forward haproxy-ingress

Release charts

Adjust the version in the Chart.yaml files.

Create new packages for all charts.

task package-repo

Commit and push the files.

Usage

You can use this project to deploy to these Kubernetes clusters:

• APPUiO
• Infomaniak
• K3s

APPUiO

Setup and deploy the Helm charts with APPUiO.

Login with OpenShift

Open the OpenShift console in your zone.

Click on the username on the top right and select Copy login command.

In the new tab click Display token and copy the Login with this token command.

Run the command in your shell.

Setup project

If not alrady done, create a project with the oc cli.

oc new-project odoo

Create Odoo release

Add this Helm repo to the local index.

task add-repos

Install the Helm release.

task install-chart odoo axo

Publish Helm charts

In your zone open Helm > Tab Repositories > Create > Repository and enter:

• Name: kubernetes-build
• Display name: Kubernetes Build
• Description: The Mint System collection of Helm charts.
• URL: https://kubernetes.build

Create release from web console

In your zone open Helm > Tab Helm Releases > Create > Helm Release and filter Odoo. Click on the Helm chart and select Create.

Change these values:

ingress:
  host: odoo.axo.mintcloud.ch
  secure: true
vshnPostgres:
  enabled: true
postgres:
  enabled: false

Confirm with Create.

Infomaniak

Deploy the Helm charts to Infomaniak Managed Kubernetes service.

Setup project

Create new Kubernetes cluster in the Infomaniak manager. Then add an instance group.

Download the Kubeconfig file and move it.

mv ~/Downloads/pck-XXXXXXX-kubeconfig ~/.kube/config.chk
export KUBECONFIG=~/.kube/config.chk
kubectl get namespaces

Setup ingress nginx

Add all repos and install the ingress nginx.

task add-repos
task install-chart ingress-nginx

Setup cert manager

Create an api token with domain scope: https://manager.infomaniak.com/v3/infomaniak-api

ACME_EMAIL="sysadmin@example.com"
INFOMANIAK_API_TOKEN="YOUR_API_TOKEN"

Install cert manager with Infomaniak webhook.

task install-chart cert-manager

Install cluster issuer.

task install-chart clusterIssuer

Create Odoo release

Install the Odoo chart.

task install-chart odoo

K3s

Setup project

Setup K3s cluster with Ansible: https://ansible.build/roles/k3s/

Setup Kubeconfig with alias rpi.

Setup ingress nginx

Add all repos and install the ingress nginx.

task add-repos
task install-chart ingress-nginx

Setup cert manager

Setup .env config.

ACME_EMAIL="sysadmin@example.com"

Install cert manager with Infomaniak webhook.

task install-chart cert-manager

Install cluster issuer.

task install-chart clusterIssuer

Create Hugo release

Install the Hugo chart.

task install-chart hugo

Troubleshooting

Reset the postgres password

The postgres data is persisted on the host. Removing the pvc will not deleted the postgres data. To update the password, enter the container and run:

psql -c "ALTER USER $PGUSER WITH PASSWORD '$PGPASSWORD';"