To install Maistra Service Mesh, first install the required Operators on OpenShift Container Platform and then create a ServiceMeshControlPlane
resource to deploy the control plane.
Read the Preparing to install Maistra Service Mesh process.
An account with the cluster-admin
role. If you use Red Hat OpenShift Dedicated, you must have an account with the dedicated-admin
role.
The following steps show how to install a basic instance of Maistra Service Mesh on OpenShift Container Platform.
Maistra Service Mesh requires the following four Operators:
OpenShift Elasticsearch - (Optional) Provides database storage for tracing and logging with Jaeger. It is based on the open source Elasticsearch project.
Jaeger - Provides tracing to monitor and troubleshoot transactions in complex distributed systems. It is based on the open source Jaeger project.
Kiali - Provides observability for your service mesh. Allows you to view configurations, monitor traffic, and analyze traces in a single console. It is based on the open source Kiali project.
Maistra Service Mesh - Allows you to connect, secure, control, and observe the microservices that comprise your applications. The Maistra Operator defines and monitors the ServiceMeshControlPlane
resources that manage the deployment, updating, and deletion of the Maistra components. It is based on the open source Istio project.
To install Maistra Service Mesh, install following Operators in this order. Repeat the procedure for each Operator.
Optional: OpenShift Elasticsearch
Jaeger
Kiali
Maistra Service Mesh
Log in to the OpenShift Container Platform web console as a user with the cluster-admin
role.
In the OpenShift Container Platform web console, click Operators → OperatorHub.
Type the name of the Operator into the filter box and select the Red Hat version of the Operator. Community versions of the Operators are not supported.
Click Install.
On the Install Operator page, select installation options.
For the OpenShift Elasticsearch Operator, in the Update Channel section, select stable-5.x.
For the Jaeger, Kiali, and Maistra Service Mesh Operators, accept the defaults.
The Jaeger, Kiali and Maistra Service Mesh are installed in the openshift-operators
namespace. The OpenShift Elasticsearch Operator is installed in the openshift-operators-redhat
namespace.
Click Install. Wait until the Operator has installed before repeating the steps for the next Operator in the list.
After all you have installed all four Operators, click Operators → Installed Operators to verify that your Operators installed.
Create a ServiceMeshControlPlane
resource to configure the components of Maistra. For more information, see Creating the ServiceMeshControlPlane.