Get Started with Operators in Kubeapps

This guide will walk you through the process of enabling support for Operators in Kubeapps and deploy an Operator instance.

In this tutorial we will be using the the Operator Lifecycle Manager (OLM) to expose the Operators from the OperatorHub.

Prerequisites

Kubeapps assumes a working Kubernetes cluster (v1.12+) and kubectl installed and configured to talk to your Kubernetes cluster. Users following this tutorial require to have admin privileges in the cluster in order to install and manage Operators.

Step 1: Install the Operator Lifecycle Manager (OLM)

Since Kubeapps 2.0, Operators are available by default. Once you access to the dashboard, if you click on the menu icon and select "Operators", you will see a message alerting that the OLM is not installed:

OLM Not Intalled

Follow the instructions to install the latest OLM version. For example:

curl -L https://github.com/operator-framework/operator-lifecycle-manager/releases/download/0.16.1/install.sh -o install.sh
chmod +x install.sh
./install.sh 0.16.1

Note that you will need special permissions to manage Operators. If you receive a Forbidden error, apply the following ClusterRole to your admin user:

kubectl create clusterrolebinding kubeapps-operator-cluster-admin --clusterrole=cluster-admin --serviceaccount kubeapps:kubeapps-operator

NOTE: replace the kubeapps:kubeapps-operator with the service account you are using or the cluster user.

Step 2: Install an Operator

After some minutes, you should be able to see the full list of Operators available:

Operators Available

Let's deploy the "Akka Cluster Operator". When clicking on it, the information about the Operator is displayed:

Operators View

When clicking on the Deploy button, a form to deploy the operator will be displayed. There are two type of Operators: Global and namespaced. Namespaced Operators will be available in a single namespace while global Operators across the cluster. In this case, we are installing a global Operator:

Operator Deployment Form

Once the Operator is installed it would be listed like that and after a minute or two, you can start deploy instances of that Operator:

Installed Operators

Step 3: Deploy Resources Managed by an Operator

Now, available applications related to an Operator are listed in the Catalog along with the existing Helm Charts:

Operators Catalog

You can filter out Charts and select the Akka Cluster example. That would render the YAML form in which you can modify any setting in order to deploy a custom instance:

Operator Form

Finally, when the application or resource gets deployed, after some minutes, you will be able to inspect its status and resources:

Operator Instance View

You can also click in the Update button to modify the instance or in the Delete button to remove it.

Step 4: Provide Feedback

We need your feedback to improve this integration! If you find any issue or have a suggestion please open an issue in GitHub or contact us in the #kubeapps channel in Slack.