Chapter 1. Requirements and recommendations
Before you install the multicluster engine for Kubernetes operator, review the following system configuration requirements and settings:
Important: You must install multicluster engine for Kubernetes on a cluster that does not have Red Hat Advanced Cluster Management for Kubernetes earlier than 2.5 installed. The multicluster engine for Kubernetes cannot co-exist with Red Hat Advanced Cluster Management for Kubernetes on versions earlier than 2.5 because they provide some of the same management components. It is recommended that you install multicluster engine for Kubernetes on a cluster that has never previously installed Red Hat Advanced Cluster Management. If you are using Red Hat Advanced Cluster Management for Kubernetes at version 2.5.0 or later then multicluster engine for Kubernetes will already be installed on the cluster with it.
1.1. Supported operating systems and platforms for multicluster engine for Kubernetes clusters and managed clusters
See the following table for supported operating systems:
| Platform | Supported for multicluster engine for Kubernetes cluster | Supported for managed cluster |
| Red Hat OpenShift Container Platform 3.11.200, and later 3.11.x releases | No | Yes |
| Red Hat OpenShift Container Platform 4.8.2, and later | Yes | Yes |
| Red Hat OpenShift Container Platform on Amazon Web Services | Yes | Yes |
| Red Hat OpenShift Container Platform on Microsoft Azure | Yes | Yes |
| Red Hat OpenShift Container Platform on Google Cloud Platform | Yes | Yes |
| Red Hat OpenShift Kubernetes Engine | No | Yes |
| Google Kubernetes Engine (Google GKE) (Kubernetes 1.17, and later) | No | Yes |
| Amazon Elastic Kubernetes Service (Amazon EKS) (Kubernetes 1.17.6, and later) | No | Yes |
| Microsoft Azure Kubernetes Service (Microsoft AKS) (Kubernetes 1.19.6, and later) | No | Yes |
1.2. Network configuration
Configure your network settings to allow the connections in the following sections:
1.2.1. The multicluster engine for Kubernetes operator cluster networking requirements
For the multicluster engine for Kubernetes cluster networking requirements, see the following table:
| Direction | Connection | Port (if specified) |
|---|---|---|
| Outbound | API of the cloud provider | |
| Outbound | (Optional) Kubernetes API server of the provisioned managed cluster | 6443 |
| Outbound and inbound |
The | 443 |
| Inbound | The Kubernetes API server of the multicluster engine for Kubernetes cluster from the managed cluster | 6443 |
| Inbound | Post-commit hook from GitHub to the multicluster engine for Kubernetes cluster. This setting is only required when you use certain application management functions. | 6443 |
1.2.2. Managed cluster networking requirements
For the managed cluster networking requirements, see the following table:
| Direction | Connection | Port (if specified) |
|---|---|---|
| Outbound and inbound | Kubernetes API server of the multicluster engine for Kubernetes cluster | 6443 |
1.2.3. Hosted control planes networking requirements (Technology Preview)
When you use hosted control planes, the HypershiftDeployment resource must have connectivity to the endpoints listed in the following table:
| Direction | Connection | Port (if specified) |
|---|---|---|
| Outbound | OpenShift Container Platform control plane and worker nodes | |
| Outbound | For hosted clusters on Amazon Web Services only: Outbound connection to AWS API and S3 API | |
| Outbound | For hosted clusters on Microsoft Azure cloud services only: Outbound connection to Azure API | |
| Outbound | OpenShift Container Platform image repositories that store the ISO images of the coreOS and the image registry for OpenShift Container Platform pods |
