Installing the Anjuna Seaglass Operator

For OpenShift on Google Cloud, Anjuna relies on its RedHat Certified Anjuna Seaglass Operator to manage the installation of the Anjuna Kubernetes Toolset Runtime.

This guide walks you through the steps to install the Anjuna Seaglass Operator on your cluster.

This guide assumes that you have access to your OpenShift web console. All actions performed here can be done via the oc cli utility.

Search for and Install the Anjuna Seaglass Operator

Log in to your Cluster’s web console, and click on the OperatorHub menu option. Search for the Anjuna Seaglass Operator by typing anjuna in the search box:

OperatorHubSearchForAnjuna

Select the Anjuna Seaglass Operator for OpenShift, and choose the channel stable and the version 2.x.x.

OperatorHubInstallAnjuna21
The Anjuna Seaglass Operator currently requires a cluster-level installation. Contact [email protected] if you need a namespaced installation strategy.

Upgrades of the Anjuna Seaglass Operator currently require the cluster admin to perform a series of steps (more details on the next page). With that in mind, choose the Manual strategy for upgrade approvals, and click the Install button:

OperatorHubInstallAnjuna24

With the Manual installation strategy, you will be prompted to review and approve the installation of the Anjuna Seaglass Operator:

OperatorHubInstallAnjuna3

The operator installation should take about one minute. Once ready, click on the View Operator button:

OperatorHubInstallAnjuna4

Create an AnjunaConfig

The Anjuna Seaglass Operator is triggered by the creation of an Anjuna Config operand. An Anjuna Config informs the Anjuna Seaglass Operator which components need to be installed and on which Nodes.

To install the Anjuna Config operand from the Anjuna Seaglass Operator page, navigate to the Anjuna Config tab, and click on the Create AnjunaConfig button:

OperatorHubInstallAnjuna5

The creation form will allow you to configure the new Anjuna Config that you want to add to this cluster. The following options are available:

  • Name: Specifies the name of the Anjuna Config resource.

  • Labels: Allows you to attach labels to this resource.

  • runtimeImage: A container image with the Anjuna Custom Container Runtime. This image has the software needed to properly configure and install the Anjuna Kubernetes Toolset on your cluster Nodes. Changing this value is not recommended, though it is possible to change in case you have an internal mirror of the same image and are required to use it.

  • nodeSelector: Allows you to specify Node selector rules that determine on which Nodes the Anjuna Kubernetes Toolset should be installed.

After configuring the Anjuna Config, click on the Create button:

OperatorHubInstallAnjuna6

You should now see a new entry in the Anjuna Config tab:

OperatorHubInstallAnjuna7
Due to a technical limitation, the Status field above will display a dash (-), regardless of the actual installation status of the Anjuna Config. The section below provides instructions on how to validate the installation of the Anjuna Seaglass Operator.

Validating the Anjuna Seaglass Operator installation

In your OpenShift web console, navigate to the DaemonSets menu option under Workloads. Select the project where you installed the Anjuna Seaglass Operator. You should see the following:

OperatorHubValidate
The number of running anjuna-operator-install-daemon Pods should equal the number of Nodes that satisfy the Node selector rules that you set in the previous step.

A new Kubernetes Runtime Class called anjuna-remote should now be available to use in your Pod specs. It can be confirmed by running the following command:

$ oc get runtimeclass
NAME            HANDLER         AGE
anjuna-remote   anjuna-remote   60m

What’s next

In order for the anjuna-remote Runtime Class you installed to be able to launch Anjuna Confidential Pods (Confidential Pods) as CVMs, additional tooling is required to be installed along with the Anjuna Seaglass Operator.

The Anjuna Kubernetes Toolset archive that you downloaded on the previous page provides a Helm Chart to assist in installing this additional tooling. Instructions are available on the next page.