This topic describes how to install Cloud Native Runtimes on your local machine in as little as 3 steps. Install a working Kubernetes cluster using a provider of your choice with the correct physical resources. Install the necessary cli tools on your local machine. Then download and install CNR and kApp on your Kubernetes cluster.
The following is an overview of prerequisites required to install Cloud Native Runtimes:
|Cluster Hardware Requirements|
|Physical Resources||Single Node||Multi Node|
Note: You may need to increase your physical resources from Docker preferences.
Kubernetes v1.20 or later.
Local command line tools required:
Kubernetes cluster software required:
Note: See the CNR Compatibility Matrix for compatible versions.
To install Cloud Native Runtimes you first need to install software on your local machine.
brew tap vmware-tanzu/carvel brew install ytt kbld kapp imgpkg
wget -O- https://carvel.dev/install.sh | bash # or with curl... curl -L https://carvel.dev/install.sh | bash
To use Cloud Native Runtimes, you must have a Kubernetes cluster. There are several resources you can choose from to create a local cluster. CNR works especially well with Kind or Minikube follow their install docs to get started:
To install Cloud Native Runtimes, you must first download the installation package from VMware Tanzu Network.
To download Cloud Native Runtimes:
cloud-native-runtimes-<RELEASE_TARBALL_NAME>.tgz, for example:
tar -xvf cloud-native-runtimes-<RELEASE_TARBALL_NAME>.tgz
Use one of the following procedures, depending on your platform, to install Cloud Native Runtimes. To install, you target the cluster and run the installation script.
Note: If you see the following error message after you run the Cloud Native Runtimes installation script, see Installing Cloud Native Runtimes with an Existing Contour Installation:
Could not proceed with installation. Refer to Cloud Native Runtimes documentation for details on how to utilize an existing Contour installation. Another app owns the custom resource definitions listed below.
To install Cloud Native Runtimes on Docker Desktop, kind, or minikube:
Note: To install on minikube, you need at least 4GB of available system RAM for all pods to start.