Tanzu Platform 10.0

Where to begin when using VMware Tanzu Platform Self-Managed

Last Updated March 03, 2025

Depending on your assigned user role, your workflow in Tanzu Platform might be extensive or focused. A Tanzu Platform administrator manages resources and does basic curation of applications.

For more information about what tasks the different roles can perform in Tanzu Platform, see the About role-based access control in Tanzu Platform.

In addition to your role, where to start with Tanzu Platform is also determined by the version of Tanzu Platform that you are using, your infrastructure and your overall objective.

Prerequisites

Before you can start performing tasks in Tanzu Platform, certain infrastructure must be in place.

  • You have infrastructure in place for one or both of the following runtimes:
    • You have an existing Tanzu Platform for Cloud Foundry installation
    • You have applications and Kubernetes clusters running on VMware Cloud Foundation (VCF) or elsewhere
  • Tanzu Platform Self-Managed is installed and configured. You can install Tanzu Platform in one of two ways, depending on your available infrastructure.

What you see on first login

When you log in to the Tanzu Platform UI for the first time, only a limited subset of options are available. Before you and your users can start working in Tanzu Platform, you must perform the initial setup tasks listed in Initial Tanzu Platform setup on day 1 to enable the other options in Tanzu Platform.

Initial Tanzu Platform setup on day 1

As the Tanzu Platform administrator, you must first create Projects. In most cases, you need at least one Project before you can attach Tanzu Platform to your data sources. After you have a project, you can bring users onboard into the platform, and assign those users to the Projects.

What do you need to do?Documentation
Create one or more Projects, to which you can assign users and resources.Add Projects and assign users
Add users to Tanzu Platform from the identity provider configured during installation, and assign Tanzu Platform roles to those users.Assign users to resources in Tanzu Platform

After you have created Projects and added users, you must connect Tanzu Platform to your data sources and infrastructure. When you have attached a Cloud Foundry Foundation or VCF instance to Tanzu Platform, or attached other Kubernetes clusters, Tanzu Platform can start discovering the applications and clusters that are running on your infrastructure. This enables the other options in the Tanzu Platform UI. The following sections list what to do depending on what infrastructure you have.

What infrastructure do you have?Go to section
Tanzu Platform for Cloud FoundryYou have applications running on Tanzu Platform for Cloud Foundry foundations
VMware Cloud FoundationYou have applications and Kubernetes clusters running on VCF
Other Kubernetes clustersYou have Kubernetes clusters that are not managed by VCF

You have applications running on Tanzu Platform for Cloud Foundry foundations

If you have existing Tanzu Platform for Cloud Foundry foundations, you attach the foundations to Tanzu Platform so that you can observe and troubleshoot the foundations and the applications that run on them. This scenario applies to administrators and operators.

What do you want to do?Documentation
Attach your Tanzu Platform for Cloud Foundry foundations, to start the application discovery process.Attach a Tanzu Platform for Cloud Foundry foundation as a Tanzu Platform data source
Discover Tanzu Spring applications that are running on your foundations, so that you can monitor, manage, and troubleshoot them.Discover your applications and microservices
Use Tanzu Salt to discover applications running on VMs in your foundation, and manage their configuration.Add Tanzu Salt for Spring app discovery on virtual machines
Group component apps and microservices together to achieve a specific business outcome.Manage business applications on Tanzu Platform
Observe the data that Tanzu Platform collects from your foundations and applications, and review entities that need your attention.Observability in Tanzu Platform
Find specific resources from your foundations that have been discovered by Tanzu Platform, so that you can see their data and manage them accordingly.Find a particular resource

You have applications and Kubernetes clusters running on VCF

If you have Tanzu Kubernetes Grid clusters running applications on VCF, you attach your VCF instance to Tanzu Platform so that you can observe and troubleshoot those clusters, and manage and deploy applications on them, directly in the Tanzu Platform UI. This scenario applies to administrators and operators.

What do you want to do?Documentation
Attach your VCF instance to Tanzu Platform, to start the cluster and application discovery process.Attach a VMware Cloud Foundation deployment as a VMware Tanzu Platform data source
Discover Tanzu Spring applications that are running on VCF, so that you can monitor, manage, and troubleshoot them.Discover your applications and microservices
Create, deploy, and manage applications on your Kubernetes clusters in Kubernetes Spaces.Create and Manage Kubernetes Spaces
Use Tanzu Salt to discover applications running on VMs in your VCF instance, and manage their configuration.Add Tanzu Salt for Spring app discovery on virtual machines
Group component apps and microservices together to achieve a specific business outcome.Manage business applications on Tanzu Platform
Observe the data that Tanzu Platform collects from your VCF instance and applications, and review entities that need your attention.Observability in Tanzu Platform
Find specific resources from your VCF instance that have been discovered by Tanzu Platform, so that you can see their data and manage them accordingly.Find a particular resource

The Kubernetes Spaces features are not available in the Tanzu Platform Spring Essentials version of Tanzu Platform.

You have Kubernetes clusters that are not managed by VCF

If you have Kubernetes clusters that are not managed by VCF, you can add them to Tanzu Platform so that you can observe and troubleshoot, and deploy applications on those clusters. These clusters are referred to as self-managed clusters. This scenario applies to administrators and operators.

What do you want to do?Documentation
Add your self-managed Kubernetes clusters to Tanzu Platform, to start the cluster and application discovery process.Attach a Kubernetes cluster
Discover Tanzu Spring applications that are running on the clusters, so that you can monitor, manage, and troubleshoot them.Discover your applications and microservices
Create, deploy, and manage applications on your Kubernetes clusters in Kubernetes Spaces.Create and Manage Kubernetes Spaces
Group component apps and microservices together to achieve a specific business outcome.Manage business applications on Tanzu Platform
Observe the data that Tanzu Platform collects from your clusters and applications, and review entities that need your attention.Observability in Tanzu Platform
Find specific resources from the clusters that have been added to Tanzu Platform, so that you can see their data and manage them accordingly.Find a particular resource

Other resources

For information about where to find documentation for all of the components of Tanzu Platform, see About Tanzu Platform documentation.