Supported Compatibility Matrix Cluster Types (Beta)

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.

Type	Description
Supported Kubernetes Versions	1.25.11, 1.26.6, 1.27.3, 1.28.0
Supported Instance Types	See Replicated Instance Types
Nodes	Supports a single node.
Limitations	See Limitations
Common Use Cases	Smoke tests

k3s

The compatibility matrix supports creating k3s clusters.

Type	Description
Supported k3s Versions	The upstream k8s version that matches the Kubernetes version requested.
Supported Kubernetes Versions	1.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.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.26.0, 1.26.1, 1.26.2, 1.26.3, 1.26.4, 1.26.5, 1.26.6, 1.26.7, 1.27.1, 1.27.2, 1.27.3, 1.27.4
Supported Instance Types	See Replicated Instance Types
Nodes	Supports a single node.
Limitations	See 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).

Type	Description
Supported OpenShift Version	4.13.0-okd
Supported Instance Types	See Replicated Instance Types
Nodes	Supports a single node.
Limitations	OpenShift does not support r1.small instance types. 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 less than one minute. OpenShift clusters from the pool are limited to the default specifications using the CLI: r1.large instance type and 50 GiB disk. For additional limitations that apply to all distributions, see Limitations.
Common Use Cases	Customer release tests

HelmVM

The compatibility matrix supports creating HelmVM clusters, which is a version of Kubernetes that has a Helm chart embedded and runs as a single binary.

Type	Description
Supported HelmVM Version	1.27
Supported Instance Types	See Replicated Instance Types
Nodes	Supports a single node.
Limitations	See Limitations
Common Use Cases	Customer release tests

kURL

The compatibility matrix supports creating kURL clusters.

Type	Description
Supported kURL Versions	Any kURL installer ID. For more information, see Creating a Kubernetes Installer.
Supported Instance Types	See Replicated Instance Types
Nodes	Supports a single node.
Limitations	Does not work with the Longhorn add-on. For additional limitations that apply to all distributions, see Limitations.
Common Use Cases	Customer release tests

Cloud Clusters

This section lists the supported cloud clusters for compatibility testing.

EKS

The compatibility matrix supports creating AWS EKS clusters.

Type	Description
Supported Kubernetes Versions	1.23, 1.24, 1.25, 1.26, 1.27
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
Nodes	Supports 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 Cases	Customer release tests

GKE

The compatibility matrix supports creating Google GKE clusters.

Type	Description
Supported Kubernetes Versions	1.22, 1.23, 1.24, 1.25, 1.26, 1.27
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.
Nodes	Supports 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 Cases	Customer release tests

Replicated Instance Types

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

Type	Memory (GiB)	VCPU Count
r1.small	8 GB	2 VCPUs
r1.medium	16 GB	4 VCPUs
r1.large	32 GB	8 VCPUs
r1.xlarge	64 GB	16 VCPUs
r1.2xlarge	128 GB	32 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.