As a cluster administrator, you can register a Tanzu Kubernetes Grid or Tanzu Community Edition management cluster, that is running in Azure, AWS, or vSphere, with your Tanzu Mission Control organization.

To register a management cluster, you run the cluster agent registration script, provided by Tanzu Mission Control, on the cluster. The script creates a namespace and installs a set of cluster agent extensions and custom resource definitions into your cluster, which enables communication with Tanzu Mission Control.

Prerequisites

This procedure assumes that you have already started the registration process in Tanzu Mission Control as described in Register a Management Cluster with Tanzu Mission Control, and that you have a Tanzu Kubernetes Grid management cluster that satisfies the minimum requirements, as described in Requirements for Registering a Tanzu Kubernetes Cluster with Tanzu Mission Control in VMware Tanzu Mission Control Concepts. .

Make sure you have the appropriate permissions.
  • To register a management cluster with Tanzu Mission Control, you must have admin permissions on the cluster.
  • To use a proxy configuration defined in Tanzu Mission Control, you must be associated with the organization.credential.view role.

Procedure

  1. If you are using a proxy configuration, use the generated tmc command to register the cluster.
    1. In a command window, log in with the Tanzu Mission Control CLI (tmc), making sure you have the latest version.
    2. Run the tmc managementcluster register command provided by Tanzu Mission Control, inserting the appropriate kubeconfig.
      For example:
      tmc managementcluster register my-mgmt-cluster --kubeconfig my-mgmt-cluster-kubeconfig --continue-bootstrap
  2. Use the generated YAML manifest in a kubectl apply command to register the cluster, if you are not using a proxy configuration.
    1. In a command window, connect to the management cluster with kubectl.
      Make sure your current context is set appropriately for the management cluster you want to register, and not one of its workload clusters.
    2. Run a kubectl apply command like the following to start the installation.
      Make sure you use the URL provided by Tanzu Mission Control, and that it is enclosed in quotes.
      kubectl apply -f "https://my-org.tmc.cloud.vmware.com/installer?id=verylonginstallerid&source=registration"
      

Results

When you run the appropriate command, a namespace called vmware-system-tmc is created, and then the Tanzu Mission Control cluster agent is installed on the management cluster. The installation process may take a few minutes.

When the installation is complete, your management cluster is registered with Tanzu Mission Control. You can return to the Tanzu Mission Control console and view the registered cluster on the Management clusters tab of the Administration page. It might take a few minutes for Tanzu Mission Control to start receiving health information from the management cluster.

Note: Management clusters created using Tanzu Community Edition prior to version 0.12 are shown as Tanzu Kubernetes Grid clusters.