You can attach Kubernetes clusters to Tanzu Platform. Attaching clusters to Tanzu Platform allows you to monitor them as part of your infrastructure and to use them as Space Targets.

As part of the process to attach a Kubernetes cluster, you download a YAML file that deploys the Tanzu agents and configures the connection from the cluster back to Tanzu Platform. Each file is unique to each cluster. You cannot reuse the same YAML file for multiple clusters. You must download the file provided in the attachment workflow.

Before you begin

• If you are attaching provider-managed clusters or self-managed clusters associated with a cloud account, verify that you added the accounts where the clusters that you want to manage are connected. See Amazon Web Services, Microsoft Azure, Google Cloud Platform.
• If you are attaching a discovered cluster, make sure that you have installed kubectl and helm.

• Verify that your target cluster meets the following minimum resource requirements so that you can install the Tanzu agents on the cluster. The amount of required resources scales based on the number of resources in your cluster. Please note the maximum limit.

  Resource	Minimum	Limit
  CPU	1	3
  Memory	100Mi	1Gi

• If you are adding a self-managed cluster, the cluster must not have more than 10 nodes.

• For Application management in Tanzu Platform, you must configure your Spring applications with actuator and micrometer libraries. See Configure your Spring applications for application management in Tanzu Platform.
• VMware recommends that you enable a network policy implementation for your Kubernetes distribution because Tanzu Platform uses the policy to further secure the system.

Attach a discovered Kubernetes cluster

You can attach Kubernetes clusters that Tanzu Platform discovered from your accounts. The clusters that are managed as services, for example, Microsoft Azure AKS or Amazon EKS, are discovered from the provider API.

As part of the process to attach a Kubernetes cluster, you download a YAML file that configures the connection. Each file is unique to each service account and cluster. You cannot reuse the same YAML file for each cluster. You must download the file provided in the attachment workflow.

1. In the Tanzu Platform UI, go to Administration > Infrastructure configuration > Kubernetes clusters.

   The list includes discovered, pending, and attached clusters. The clusters that are in a Attached state are collecting data. Pending indicates that the cluster is attached but the collector is not online. Discovered indicates that the clusters are collected from other accounts but not yet attached. This procedure guides your through attaching the discovered clusters.

2. To attach a discovered cluster, click the arrows next to the cluster name and click Attach.

3. Review the collected information and click Attach and Continue.

4. In the Install Collector section, install the collector.

   The collector sends cluster configuration information to Tanzu Platform.

   1. To install the collector, run the provided command to install the collector.
   2. When the command completes, return to the Tanzu Platform UI and click Finish.
5. After approximately five minutes, verify that the attached cluster status displays Attached on the Kubernetes Management page.

Attach a Kubernetes cluster

You can attach Kubernetes clusters to bring them under Tanzu Platform management.

1. In the Tanzu Platform UI header, use the Project selector to select the Project in which you want to add a cluster.
2. Go to Infrastructure > Kubernetes Clusters
3. Click Add Kubernetes Cluster.
4. Click Add self-managed cluster and Next.
5. Enter a unique Name that you can use to identify the cluster in Tanzu Platform.
6. Select if you want the cluster to be used for Spaces or not.
7. Select the Cluster Group for the cluster.
8. Optionally, add labels to your cluster.
9. From the UI, copy and paste the kubectl command into a shell. The command installs Tanzu agents to your cluster. The Tanzu agents include, the Kubernetes collector, cloud-native application support, application Spaces support.
10. Click View Kubernetes Cluster.
11. As the Tanzu agents are synced to the cluster and install, the cluster overview page will show more information about your cluster.

What you can do now

• You can monitor the attached clusters. See Monitoring Kubernetes resources in Tanzu Platform.
• You can also finish creating an application environment and deploy an application to a Space.