Documentation
Support Matrix ¶
The following topic provides details of the supported operating systems, infrastructure providers, and Kubernetes versions.
Note: The following information relates to a management/workload cluster deployment which provides a full-featured, scalable Kubernetes implementation suitable for a development or production environment. If you are interested in quickly spinning up a lightweight cluster for a development/experimental environment, see Create Unmanaged Clusters.
Local Client/Bootstrap Machine Prerequisites ¶
Before you install the Tanzu CLI, one of the following operating system and hardware/software configurations is required on your local machine.
Linux Local Bootstrap Machine Prerequisites ¶
| Arch: x86; ARM is currently unsupported |
| RAM: 6 GB |
| CPU: 2 |
| Docker In Docker, you must create the docker group and add your user before you attempt to create a management cluster. Complete steps 1 to 4 in the Manage Docker as a non-root user procedure in the Docker documentation. |
| Kubectl |
| Latest version of Chrome, Firefox, Safari, Internet Explorer, or Edge |
| System time is synchronized with a Network Time Protocol (NTP) server. |
| Ensure your bootstrap machine is using cgroup v1. For more information, see Check and set the cgroup. |
Mac Local Bootstrap Machine Prerequisites ¶
| Arch: x86; ARM (M1) currently unsupported |
| RAM: 6 GB |
| CPU: 2 |
| Docker Desktop for Mac; Version <= 4.2.0 |
| Kubectl |
| Latest version of Chrome, Firefox, Safari, Internet Explorer, or Edge |
| Ensure your bootstrap machine is using cgroup v1. (Docker Desktop for Mac versions prior to 4.3.0 use cgroup1). For more information, see Check and set the cgroup. |
Windows Local Bootstrap Machine Prerequisites ¶
| RAM: 8 GB |
| CPU: 2 |
| Docker Desktop for Windows |
| Kubectl |
| Latest version of Chrome, Firefox, Safari, Internet Explorer, or Edge |
| Ensure your bootstrap machine is using cgroup v1. (Docker Desktop for Windows versions prior to 4.3.0 use cgroup1). For more information, see Check and set the cgroup. |
Note: Bootstrapping a cluster to Docker from a Windows bootstrap machine is currently experimental, for more information, see Docker-based Clusters on Windows.
Infrastructure Providers (Target Platforms) ¶
After you install the Tanzu CLI Edition on your local machine, you can use it to deploy a cluster to one of the following infrastructure providers:
| Cloud Infrastructure Provider | Local Infrastructure Provider |
|---|---|
| Amazon Web Services (AWS) | Docker |
| Microsoft Azure | |
| vSphere |
The Cloud Infrastructure providers support the following infrastructure platforms and operating systems (OSs):
| vSphere | AWS | Azure | |
|---|---|---|---|
| Infrastructure Platform | vSphere 6.7U3 and later, vSphere 7 | Native AWS | Native Azure |
| Kubernetes node OS | Photon OS 3, Ubuntu 20.04 | Amazon Linux 2, Ubuntu 20.04 | Ubuntu 18.04, Ubuntu 20.04 |
If you are using Docker as your target infrastructure provider, the following additional configuration is needed:
| Local Docker |
|---|
| 6 GB of RAM and 4 CPUs (with no other containers running). |
| 15 GB of local machine disk storage for images |
| Bootstrapping a cluster to Docker from a Windows bootstrap machine is currently experimental. |
Note: Check your Docker configuration as follows:
Linux: Run docker system info
Mac and Windows: In Docker Desktop, select Preferences > Resources > Advanced
Support Matrix Summary for Operating System and Infrastructure Provider ¶
The following support matrix provides a summary of the target platforms that are supported for each operating system:
| Linux | Windows | Mac | |
|---|---|---|---|
| Amazon EC2 | yes | yes | yes |
| Docker | yes | experimental | yes |
| Microsoft Azure | yes | yes | yes |
| vSphere | yes | yes | yes |
Supported Kubernetes Versions ¶
Tanzu Community Edition supports the following Kubernetes versions: 1.21.2, 1.20.8, 1.19.12
Check and set the cgroup ¶
Check the cgroup by running the following command:
docker info | grep -i cgroupYou should see the following output:
Cgroup Driver: cgroupfs Cgroup Version: 1If you see cgroup version 2, we recommend the following:
Mac: Run the following compatible version of Docker Desktop: Docker Desktop 4.2.0.
Windows: Run the following compatible version of Docker Desktop 4.2.0
Linux: Set the
systemd.unified_cgroup_hierarchy=0kernel parameter to restore cgroups v1. See the instructions for setting kernel parameters for your Linux distribution, including:
In a future release, we’ll support cgroupsv2 which will resolve this issue. Please follow issue 2798 for progress.
