To install Red Hat OpenShift Service Mesh, first install the required Operators on OpenShift Container Platform and then create a
ServiceMeshControlPlane resource to deploy the control plane.
This basic installation is configured based on the default OpenShift settings and is not designed for production use. Use this default installation to verify your installation, and then configure your service mesh for your specific environment.
Read the Preparing to install Red Hat OpenShift Service Mesh process.
An account with the
cluster-admin role. If you use Red Hat OpenShift Dedicated, you must have an account with the
The following steps show how to install a basic instance of Red Hat OpenShift Service Mesh on OpenShift Container Platform.
Red Hat OpenShift Service Mesh requires the following four Operators:
OpenShift Elasticsearch - (Optional) Provides database storage for tracing and logging with the distributed tracing platform. It is based on the open source Elasticsearch project.
Red Hat OpenShift distributed tracing platform - Provides distributed 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.
Red Hat OpenShift Service Mesh - Allows you to connect, secure, control, and observe the microservices that comprise your applications. The Service Mesh Operator defines and monitors the
ServiceMeshControlPlane resources that manage the deployment, updating, and deletion of the Service Mesh components. It is based on the open source Istio project.
Do not install Community versions of the Operators. Community Operators are not supported.
To install Red Hat OpenShift Service Mesh, install following Operators in this order. Repeat the procedure for each Operator.
Red Hat OpenShift distributed tracing platform
Red Hat OpenShift Service Mesh
Log in to the OpenShift Container Platform web console as a user with the
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.
If you have already installed the OpenShift Elasticsearch Operator as part of OpenShift Logging, you do not need to install the OpenShift Elasticsearch Operator again. The Red Hat OpenShift distributed tracing platform Operator will create the Elasticsearch instance using the installed OpenShift Elasticsearch Operator.
On the Install Operator page, select installation options.
For the OpenShift Elasticsearch Operator, in the Update Channel section, select stable-5.x.
For the Red Hat OpenShift distributed tracing platform, Kiali, and Red Hat OpenShift Service Mesh Operators, accept the defaults.
The Kiali and Red Hat OpenShift Service Mesh Operators are installed in the
openshift-operators namespace. The Red Hat OpenShift distributed tracing platform is installed in the
openshift-distributed-tracing namespace. The OpenShift Elasticsearch Operator is installed in the
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.
ServiceMeshControlPlane resource to configure the components of Service Mesh. For more information, see Creating the ServiceMeshControlPlane.