As a prerequisite for provisioning Tanzu Kubernetes clusters, create a Content Library on the vCenter Server where Workload Management is enabled. The VM image that is used for creating the nodes of Tanzu Kubernetes clusters is pulled from the content library. This library contains the latest distributions of Kubernetes and accompanying Photon operating system.

This task describes how to create a subscribed content library which requires internet connectivity. For air-gapped deployments of Tanzu Kubernetes clusters, create a local content library. See Create a Local Content Library for Air-Gapped Deployments.

The size of the content library can grow over time as new Kubernetes versions and images are published. If the underlying storage runs out of space, you will need to migrate to a new content library. See Migrate Tanzu Kubernetes Clusters to a New Content Library.


The following privileges are required to create a Subscribed Content Library:
  • Content library.Create local library or Content library.Create subscribed library on the vCenter Server instance where you want to create the library.
  • Datastore.Allocate space on the destination datastore.


  1. Log in to the vCenter Server using the vSphere Client.
  2. Select Menu > Content Libraries.
  3. Click the Create a new content library icon.
    The New Content Library wizard opens.
  4. Enter identification information at the Name and location page.
    1. Enter a Name for the Content Library.
    2. For the vCenter Server, select the vCenter Server instance where the Supervisor Cluster will be configured.
    3. Click Next.
  5. Provide content library configuration details at the Configure content library page.
    1. Select the menu item Subscribed content library.
    2. In the Subscription URL text box, enter the URL address of the published library:
    3. For the Download content option, select one of the following:
      Option Description
      Download all library content immediately The subscription process synchronizes both the library metadata and images. If items are deleted from the published library, their contents remain in the subscribed library storage, and you have to manually delete them.
      Download library content only when needed The subscription process synchronizes only the library metadata. The Tanzu Kubernetes Grid Service downloads the images when published. When you no longer need the item, you can delete the item contents to free storage space.
      Note: The general recommendation is to use the on-demand option. For more information, see Managing a Subscribed Library.
    4. Click Next.
  6. When prompted, accept the SSL certificate thumbprint.
    The SSL certificate thumbprint is stored on your system until you delete the subscribed content library from the inventory.
  7. On the Add storage page, select a datastore as a storage location for the content library contents and click Next.
  8. On the Ready to complete page, review the details and click Finish.
  9. At the Content Libraries page, confirm or complete synchronization.
    Synchronization Option Description
    On Publish Confirm that the library is synchronized, if you chose to download all content immediately.
    On Demand Synchronize the content library now by selecting Actions > Synchronize.

What to do next

After the Supervisor Cluster is deployed, create a vSphere Namespace and associate it with the Content Library. See Associate a vSphere Namespace with a Content Library Using the vSphere Inventory.

Once you have associated the Content Library with the vSphere Namespace, log in using kubectl and verify that the Tanzu Kubernetes Release images are available for provisioning a Tanzu Kubernetes.