Tanzu Community Edition

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 ProviderLocal Infrastructure Provider
Amazon Web Services (AWS)Docker
Microsoft Azure
vSphere

The Cloud Infrastructure providers support the following infrastructure platforms and operating systems (OSs):

vSphereAWSAzure
Infrastructure PlatformvSphere 6.7U3 and later, vSphere 7Native AWSNative Azure
Kubernetes node OSPhoton OS 3, Ubuntu 20.04Amazon Linux 2, Ubuntu 20.04Ubuntu 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:

LinuxWindowsMac
Amazon EC2yesyesyes
Dockeryesexperimentalyes
Microsoft Azureyesyesyes
vSphereyesyesyes

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

  1. Check the cgroup by running the following command:

    docker info | grep -i cgroup
    

    You should see the following output:

    Cgroup Driver: cgroupfs
    Cgroup Version: 1
    
  2. If 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=0 kernel parameter to restore cgroups v1. See the instructions for setting kernel parameters for your Linux distribution, including:

      Fedora 32+
      Arch Linux
      OpenSUSE

    In a future release, we’ll support cgroupsv2 which will resolve this issue. Please follow issue 2798 for progress.

Join us!

Our open community welcomes all users and contributors

Community