This topic tells you how to set up the infrastructure to create an environment on Tanzu Platform for an example Kubernetes application.

An application environment is represented by an abstraction called a Space. After creating a Space, it is easy to deploy an application to that Space with a single command.

This topic includes the procedures for setting up the infrastructure and objects required to enable anyone on your team to create a Space. You can then proceed through the Space creation and application deployment topics.

Before you begin

Ensure that you have the following objects in place and have performed the following tasks.

Tanzu setup and information

• Read the Release Notes.
• Log in to the Tanzu Platform UI.
• To create a project in your organization, you need either Organization Administrator or Organization Owner roles.
• Ensure that you have the Administrator role for Tanzu Platform.

Overview of steps

To set up your infrastructure:

1. Perform initial setup.
   1. Create a Project.
   2. Attach a Kubernetes cluster
2. Create a cluster group.

Perform initial setup

Before you can create an application environment in the Tanzu Platform, you must perform some initial configuration of Tanzu Platform, and the Tanzu CLI . You only need to follow these procedures once.

Create a Project

Kubernetes resources are created in a Project. The Project acts as a logical grouping within Tanzu Platform for resources related to your Kubernetes Spaces. Therefore, before you create any resources, you must create a Project.

A Project allows you to manage packages, configurations, and role-based access controls for all clusters in a cluster group, rather than managing each cluster on an individual basis. Creating a Project in your organization requires either Organization Admin or Organization Owner roles.

UI-based steps

Do the following in the Tanzu Platform UI to create a Project:

1. Select Projects: All from the Project selector in the header.
2. Go to Administration > Identity and access > Projects.
3. On the Projects page, click + New Project.
4. Enter a name for the Project.
5. (Optional) Enter a description for the Project.
6. Click Create Project And Continue.
7. Click Close to finish creating the Project.
8. Refresh your browser, and then select your newly created Project from the Project context drop-down menu.

Tanzu CLI-based steps

Use the following Tanzu CLI commands to create a Project:

1. Log in to the organization in which to create a new Project.

   tanzu login
   

2. Create a new Project with a unique name and a description.

   tanzu project create PROJECT-NAME --description PROJECT-DESCRIPTION
   

3. Verify that the Project was created.

   List all available Projects:

   tanzu project list
   

   Retrieving the details of your specific Project.

   tanzu project get PROJECT-NAME
   

For more information about creating Projects in Tanzu Platform, see Add Projects and assign users.

Attach a Kubernetes cluster

You will use the cluster you attach to run the example Where for Dinner application.

For how to attach a Kubernetes cluster in Tanzu Platform, see Attach a Kubernetes cluster as a data source.

Create a cluster group

When you create a Project, Tanzu Platform creates a run cluster group for you. The run cluster group contains the most common Capabilities required for deploying a Space for a run application environment.

If you want to create a new cluster group, see Create a cluster group. You must create the cluster in a cluster group.

What you can do now

The following table lists some actions you can take on managed clusters.