Skip to content

On Kubernetes#

This document contains instructions for installing, uninstalling, and configuring Multi Tenant Operator on Kubernetes.

  1. Installing via Helm CLI
  2. Uninstall

Requirements#

  • A Kubernetes cluster (v1.24 or higher)
  • Helm CLI
  • kubectl

  • To run on Kubernetes, two certificates are needed in the operator namespace for the operator to be up and running, named:

    1. quota-template-intconfig-server-cert pointing to multi-tenant-operator-quota-template-intconfig-webhook-service.{{ .Release.Namespace }}.svc.cluster.local
    2. webhook-server-cert pointing to multi-tenant-operator-webhook-service.{{ .Release.Namespace }}.svc.cluster.local

    If you are using Cert Manager, these certificates will be handled by templates in the Helm Chart

Installing via Helm CLI#

  • The public Helm Chart for MTO is available at Stakater ghcr Packages, and available Helm options can be seen at MTO Helm Chart Options

  • Use the helm install command to install the MTO helm chart. Here, bypassedGroups has the names of groups which are designated as Cluster Admins in your cluster. For this example, we will use system:masters

helm install tenant-operator oci://ghcr.io/stakater/public/charts/multi-tenant-operator --version 0.12.62 --namespace multi-tenant-operator --create-namespace --set bypassedGroups=system:masters'

Note

It is better to install MTO in its preferred namespace, multi-tenant-operator

Wait for the pods to be up:

kubectl get pods -n multi-tenant-operator --watch

After all pods come in running state, you can follow the Tutorials.

Enterprise License Configuration#

For the Enterprise version, you need to have a configmap named license created in MTO's namespace multi-tenant-operator. You will get this configmap when purchasing the Enterprise version. It would look like this:

apiVersion: v1
kind: ConfigMap
metadata:
  name: license
  namespace: multi-tenant-operator
data:
  payload.json: |
    {
        "metaData": {
            "tier" : "paid",
            "company": "<company name here>"
        }
    }
  signature.base64.txt: <base64 signature here>

Uninstall via Helm CLI#

MTO can be uninstalled using Helm CLI if Helm was used to install it earlier.

  • Use the helm uninstall command to remove the previously created Helm Release in the multi-tenant-operator namespace:
helm uninstall tenant-operator --namespace multi-tenant-operator

Notes#