This topic tells you how to create a Project in Tanzu Platform and assign users to that Project.

Projects allow you manage permissions for users so that they can have one set of permissions for resources associated with one Project but different permissions in another Project.

When you log in to Tanzu Platform, you only see the Projects to which you are assigned. You can change between Projects from the drop-down Context list in the header. When you switch between Projects, you only see the resources that are assigned to that Project. Switching to Projects: All allows you to see all resources across all of your Projects.

Some features require you to be in a specific Project and if you are in Projects: All you will be notified to select a Project.

Before you begin

Before you can create a Project in Tanzu Platform, you must:

• Have administrator role at global scope. See Create role bindings.

Create a Project in Tanzu Platform

To create a Project, assign users, and manage their permissions:

1. In the Tanzu Platform UI, go to Administration > Identity and access > Projects.
2. Click New Project.
3. Enter a Project Name and click Save.

4. (Optional) Add one or more users to the Project.

   1. Click Add User.

   2. In the User field, enter the email address of the user that you want to have access to the Project.

      For example, username@yourdomain.com.

   3. In the Role field, select the required role from the drop-down menu. For more information about the roles you can select, see Supported roles for role bindings.

   4. Click Save.

5. Click Done.

For how to assign users to deploy and administer applications and services, see Allow users to deploy and administer applications and services.

Add users to an existing Project

To add users and assign role in an existing Project:

1. In the Tanzu Platform UI, go to Administration > Projects > YOUR-PROJECT-NAME.
2. On the Project page, click Add User.

3. In the User field, enter the email address of the user that you want to have access to the Project.

   For example, username@yourdomain.com.

4. In the Role field, select the required role from the drop-down menu. For more information about the roles you can select, see Supported roles for role bindings.

5. Click Save.

Delete a Project from Tanzu Platform

To delete a Project:

1. Delete or detach all entities that are associated with the Project, for example, clusters, cluster groups, or Spaces.

   To find out which entities to delete, go to Infrastructure > Search and search for the Project you want to delete.

   Deleting the Project fails if any entity is associated with the Project. The error message contains the type of entities associated with the Project.

2. Select Projects: All from the Project selector in the header. You can delete a Project only in the Projects: All context.
3. Go to Administration > Identity and access > Projects.
4. Click the Project you want to delete.
5. Click Actions and Delete.
6. Click Delete to confirm.