OS2mo Helm Chart

OS2mo Helm Chart is a Helm chart to deploy OS2mo.

Requirements

Helm 3+

Installation & Usage

Assuming kubectl and helm are already installed and cluster access is configured:

$ helm install mo os2mo/
$ helm install mo -f kind-override-values.yaml os2mo/

Which should bring up an OS2mo stack.

For a more detailed walk-through checkout the "Getting Started" section.

Development

We try to follow best practices as much as possible, including defining structure on the chart values using JSON Schema in the values.schema.json file.

For a proper development environment, you will need to install:

• docker
• kind
• kubectl
• helm
• k9s
• flux
• flux plugin for k9s

If you use NixOS, all of this is included in the shell.nix file in salt-automation.

First time setup

1. Start the cluster with ./start.sh.
2. Look at the cluster with k9s -A until the cluster is ready
3. Run helm install mo -f kind-override-values.yaml os2mo/ to install this chart

Continually development

After making changes, you need to re-deploy the chart. This is done with:

$ helm upgrade mo -f kind-override-values.yaml os2mo

Ingress

To test ingress, you will need to modify your /etc/hosts. The following entries should provide a good basis:

127.0.0.1 os2mo.example.com
127.0.0.1 orgviewer-med.example.com
127.0.0.1 orgviewer-adm.example.com

Teardown

To teardown the cluster completely, run kind delete cluster --name os2mo.

License

This project is licensed under the terms of the MPL-2.0 license.