Before you can install Red Hat OpenShift Service Mesh, you must subscribe to OpenShift Container Platform and install OpenShift Container Platform in a supported configuration.
Maintain an active OpenShift Container Platform subscription on your Red Hat account. If you do not have a subscription, contact your sales representative for more information.
Review the OpenShift Container Platform 4.12 overview.
Install OpenShift Container Platform 4.12. If you are installing Red Hat OpenShift Service Mesh on a restricted network, follow the instructions for your chosen OpenShift Container Platform infrastructure.
Install the version of the OpenShift Container Platform command line utility (the
oc client tool) that matches your OpenShift Container Platform version and add it to your path.
If you are using OpenShift Container Platform 4.12, see About the OpenShift CLI.
For additional information about Red Hat OpenShift Service Mesh lifecycle and supported platforms, refer to the Support Policy.
The following configurations are supported for the current release of Red Hat OpenShift Service Mesh.
The Red Hat OpenShift Service Mesh Operator supports multiple versions of the
ServiceMeshControlPlane resource. Version 2.4 Service Mesh control planes are supported on the following platform versions:
Red Hat OpenShift Container Platform version 4.10 or later.
Red Hat OpenShift Dedicated version 4.
Azure Red Hat OpenShift (ARO) version 4.
Red Hat OpenShift Service on AWS (ROSA).
Explicitly unsupported cases include:
OpenShift Online is not supported for Red Hat OpenShift Service Mesh.
Red Hat OpenShift Service Mesh does not support the management of microservices outside the cluster where Service Mesh is running.
Red Hat OpenShift Service Mesh supports the following network configurations.
OVN-Kubernetes is available on all supported versions of OpenShift Container Platform.
Third-Party Container Network Interface (CNI) plugins that have been certified on OpenShift Container Platform and passed Service Mesh conformance testing. See Certified OpenShift CNI Plug-ins for more information.
This release of Red Hat OpenShift Service Mesh is only available on OpenShift Container Platform x86_64, IBM Z, and IBM Power.
IBM Z is only supported on OpenShift Container Platform 4.10 and later.
IBM Power is only supported on OpenShift Container Platform 4.10 and later.
Configurations where all Service Mesh components are contained within a single OpenShift Container Platform cluster.
Configurations that do not integrate external services such as virtual machines.
Red Hat OpenShift Service Mesh does not support
EnvoyFilter configuration except where explicitly documented.
The Kiali console is only supported on the two most recent releases of the Google Chrome, Microsoft Edge, Mozilla Firefox, or Apple Safari browsers.
openshift authentication strategy is the only supported authentication configuration when Kiali is deployed with Red Hat OpenShift Service Mesh (OSSM). The
openshift strategy controls access based on the individual’s role-based access control (RBAC) roles of the OpenShift Container Platform.
Jaeger agent as a sidecar is the only supported configuration for Jaeger. Jaeger as a daemonset is not supported for multitenant installations or OpenShift Dedicated.
Install Red Hat OpenShift Service Mesh in your OpenShift Container Platform environment.