Skip to main content

Supported Compatibility Matrix Cluster Types

This topic describes the supported Kubernetes distributions, Kubernetes versions, instance types, nodes, limitations, and common use cases for clusters created with the Replicated compatibility matrix.

The compatibility matrix provisions cloud-based or virtual machine (VM) clusters.

VM Clusters

This section lists the supported VM cluster distributions for clusters created with the compatiblity matrix.

kind

The compatibility matrix supports creating kind clusters.

TypeDescription
Supported Kubernetes Versions1.23.17, 1.24.17, 1.25.16, 1.26.14, 1.27.11, 1.28.7, 1.29.2
Supported Instance TypesSee Replicated Instance Types
Node GroupsNo
NodesSupports a single node.
LimitationsSee Limitations
Common Use CasesSmoke tests

k3s

The compatibility matrix supports creating k3s clusters.

TypeDescription
Supported k3s VersionsThe upstream k8s version that matches the Kubernetes version requested.
Supported Kubernetes Versions1.24.1, 1.24.2, 1.24.3, 1.24.4, 1.24.6, 1.24.7, 1.24.8, 1.24.9, 1.24.10, 1.24.11, 1.24.12, 1.24.13, 1.24.14, 1.24.15, 1.24.16, 1.24.17, 1.25.0, 1.25.2, 1.25.3, 1.25.4, 1.25.5, 1.25.6, 1.25.7, 1.25.8, 1.25.9, 1.25.10, 1.25.11, 1.25.12, 1.25.13, 1.25.14, 1.25.15, 1.25.16, 1.26.0, 1.26.1, 1.26.2, 1.26.3, 1.26.4, 1.26.5, 1.26.6, 1.26.7, 1.26.8, 1.26.9, 1.26.10, 1.26.11, 1.26.12, 1.27.1, 1.27.2, 1.27.3, 1.27.4, 1.27.5, 1.27.6, 1.27.7, 1.27.8, 1.27.9, 1.28.1, 1.28.2, 1.28.3, 1.28.4, 1.28.5, 1.29.0
Supported Instance TypesSee Replicated Instance Types
Node GroupsNo
NodesSupports multiple nodes.
LimitationsSee Manual Upgrades in the k3s documentation.

For additional limitations that apply to all distributions, see Limitations.
Common Use Cases
  • Smoke tests
  • Customer release tests

OpenShift OKD

The compatibility matrix supports creating Red Hat OpenShift OKD clusters, which is the community distribution of OpenShift, using CodeReady Containers (CRC).

OpenShift clusters are provisioned with two users:

  • (Default) A kubeadmin user with cluster-admin priviledges. Use the kubeadmin user only for administrative tasks such as creating new users or setting roles.
  • A developer user with namespace-scoped priviledges. The developer user can be used to better simulate access in end-customer environments.

By default, kubeconfig context is set to the kubeadmin user. To switch to the developer user, run the command oc login --username developer.

TypeDescription
Supported OpenShift Versions4.10.0-okd, 4.11.0-okd, 4.12.0-okd, 4.13.0-okd, 4.14.0-okd
Supported Instance TypesSee Replicated Instance Types
Node GroupsNo
NodesSupports multiple nodes for versions 4.13.0-okd and later.
Limitations
  • OpenShift does not support r1.small instance types.
  • OpenShift versions earlier than 4.13-okd do not have a registry mirror and so may be subject to rate limiting from Docker Hub. For information about Docker Hub rate limiting, see Docker Hub rate limit. To increase limits, Replicated recommends that you configure an image pull secret to pull public Docker Hub images as an authenticated user. For more information about how to configure image pull secrets, see Pull an Image from a Private Registry in the Kubernetes documentation.
  • OpenShift builds take approximately 17 minutes.

    note

    Due to the time it takes to start an OpenShift cluster, a warm pool of OpenShift clusters is maintained. When available, an OpenShift cluster from the pool starts in approximately two minutes with default disks. When starting a cluster with a disk size different than the default, an additional four minutes is added to the warm cluster start time.

For additional limitations that apply to all distributions, see Limitations.

Common Use CasesCustomer release tests

kURL

The compatibility matrix supports creating kURL clusters.

TypeDescription
Supported kURL VersionsAny kURL installer ID. For more information, see Creating a Kubernetes Installer.
Supported Instance TypesSee Replicated Instance Types
Node GroupsNo
NodesSupports multiple nodes.
Limitations

Does not work with the Longhorn add-on.

For additional limitations that apply to all distributions, see Limitations.

Common Use CasesCustomer release tests

Cloud Clusters

This section lists the supported cloud clusters for compatibility testing.

EKS

The compatibility matrix supports creating AWS EKS clusters.

TypeDescription
Supported Kubernetes Versions1.23, 1.24, 1.25, 1.26, 1.27, 1.28
Supported Instance Types

m6i.large, m6i.xlarge, m6i.2xlarge, m6i.4xlarge, m6i.8xlarge, m7i.large, m7i.xlarge, m7i.2xlarge, m7i.4xlarge, m7i.8xlarge, m7g.large, m7g.xlarge, m7g.2xlarge, m7g.4xlarge, m7g.8xlarge, g4dn.xlarge, g4dn.2xlarge, g4dn.4xlarge, g4dn.8xlarge, g4dn.12xlarge, g4dn.16xlarge

g4dn instance types depend on available capacity.

Node GroupsYes
NodesSupports multiple nodes.
Limitations

You can only choose a minor version, not a patch version. The EKS installer chooses the latest patch for that minor version.

For additional limitations that apply to all distributions, see Limitations.

Common Use CasesCustomer release tests

GKE

The compatibility matrix supports creating Google GKE clusters.

TypeDescription
Supported Kubernetes Versions1.25, 1.26, 1.27, 1.28
Supported Instance Types

n2-standard-2, n2-standard-4, n2-standard-8, n2-standard-16, n2-standard-32

You can specify more than one node.

Node GroupsYes
NodesSupports multiple nodes.
Limitations

You can choose only a minor version, not a patch version. The GKE installer chooses the latest patch for that minor version.

For additional limitations that apply to all distributions, see Limitations.

Common Use CasesCustomer release tests

AKS

The compatibility matrix supports creating Azure AKS clusters.

TypeDescription
Supported Kubernetes Versions1.25, 1.26, 1.27, 1.28
Supported Instance Types

Standard_B2ms, Standard_B4ms, Standard_B8ms, Standard_B16ms, Standard_D2ps_v5, Standard_D4ps_v5, Standard_D8ps_v5, Standard_D16ps_v5, Standard_D32ps_v5, Standard_D48ps_v5

You can specify more than one node.

Node GroupsYes
NodesSupports multiple nodes.
Limitations

You can choose only a minor version, not a patch version. The AKS installer chooses the latest patch for that minor version.

For additional limitations that apply to all distributions, see Limitations.

Common Use CasesCustomer release tests

Replicated Instance Types

When creating a VM-based cluster with the compatibility matrix, you must specify a Replicated instance type.

TypeMemory (GiB)VCPU Count
r1.small8 GB2 VCPUs
r1.medium16 GB4 VCPUs
r1.large32 GB8 VCPUs
r1.xlarge64 GB16 VCPUs
r1.2xlarge128 GB32 VCPUs

Kubernetes Version Support Policy

We do not maintain forks or patches of the supported distributions. When a Kubernetes version in the compatibility matrix is out of support (EOL), Replicated will attempt to continue to support this version for six months for compatibility testing to support customers who are running out-of-date versions of Kubernetes. In the event that a critical security issue or bug is found and unresolved, we might discontinue support for EOL versions of Kubernetes prior to 6 months post EOL.