Kubernetes Build

Appearance

Kubernetes Build ​

Vercel

.github/workflows/test.yml

matrix-badge

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 ​

You can use this project as any other Helm chart repository.

Add this Helm repository.

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

Install a chart.

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

Charts ​

List of charts:

Develop ​

Setup a local Kubernetes cluster and deploy the Helm charts.

Requirements ​

Setup the required tools:

Clone the repository:

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

Start Kubernetes cluster ​

Start cluster with kind.

bash
task start-kind

Or start cluster with minikube.

bash
task start-minikube

Deploy Odoo chart ​

Add Helm chart repos.

bash
task add-repos

Ssetup the local hostnames.

bash
task setup-hosts

Install the CloudNativePG chart:

bash
task install-chart cnpg

Install the Odoo chart:

bash
task install-chart odoo

The Odoo database will be initialized automatically.

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

bash
task forward odoo

Setup ingress nginx ​

Install ingress-nginx in the current cluster.

bash
task install-chart ingress-nginx

Forward the ingress-nginx port.

bash
task forward ingress-nginx

Setup haproxy ingress ​

Install haproxy-ingress in the current cluster.

bash
task install-chart haproxy-ingress

Forward the haproxy-ingress port.

bash
task forward haproxy-ingress

Deploy ​

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

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.

bash
oc new-project odoo

Create Odoo release ​

Add Helm repos to the local index.

bash
task add-repos

Switch context to axo.

bash
task switch-context axo

Install the Helm release.

bash
task install-chart odoo

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.

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

Switch context to chk.

bash
task switch-context chk

Setup ingress nginx ​

Add all repos and install the ingress nginx.

bash
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

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

Install cert manager with Infomaniak webhook.

bash
task install-chart cert-manager

Install cluster issuer.

bash
task install-chart clusterIssuer

Create Odoo release ​

Install the Odoo chart.

bash
task install-chart odoo

K3s ​

Setup project ​

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

Setup Kubeconfig with alias rpi.

Switch context to rpi.

bash
task switch-context rpi

Setup ingress nginx ​

Add all repos and install the ingress nginx.

bash
task add-repos
task install-chart ingress-nginx

Setup cert manager ​

Setup .env config.

bash
ACME_EMAIL="sysadmin@example.com"

Install cert manager with Infomaniak webhook.

bash
task install-chart cert-manager

Install cluster issuer.

bash
task install-chart clusterIssuer

Create Hugo release ​

Install the Hugo chart.

bash
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:

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