Managing Apache CloudStack Projects

A project is a way to organize accounts and resources. Users (accounts) can group themselves into projects so they can share resources such as instances, snapshots, templates, data disks, and IP addresses. Resources created within a project belong only to the project, not to an account. They can be used only within that project.

Only domain admins can create projects. Every project has a project owner (the domain admin who creates the project is the default project owner). The default project owner can be changed later. The project owner can add/remove accounts to/from a project. All project members can view and manage all virtual resources created by anyone within the project.

Adding a Project

You can create a project to share resources between accounts and users. 

Perform the following steps to add a project:

1. On the left panel, click Projects.
   The Projects page displays.
   
2. Click the + New Project button.
   The New Project dialog box displays.
   
3. Enter the following information and click Create project.
   By default, your account name will be associated with this project.

4. The New Project dialog box provides you the option to add additional accounts. 
   

5. Click Add accounts. 
   The New Project dialog box provides you the option to add an additional account/user to this project.
   

6. Enter the name of the account that you want to add to this project and click Add. The account gets added to this project.

7. The New Project dialog box allows you to perform the following two tasks on the account that you added to the project.
   • To make this newly added account the owner of this project, click the Make account project owner icon.
     
   • To remove the newly added account from the project, click the Remove account from the project icon.
     

Editing a Project

Perform the following steps to edit a project:

1. On the left panel, click Projects.
   The Projects page displays.
2. Click the Select view drop-down list and select Projects.
   The Projects page displays. 
3. Click the project that you want to edit.
   The Details tab displays.
4. Click the Edit icon.
   The editable field allows you to enter a new value.
5. Update the value and click Apply.
   The updated value displays.

Suspending a Project

You can temporarily suspend the status of a project. Once suspended, the accounts (and users) within the project will not be able to access or use the resources. Once suspended, the project can be activated again. Only a domain admin project owner can suspend a project. 

Perform the following steps to suspend a project:

1. On the left panel, click Projects.
   The Projects page displays.
2. Click the Select view drop-down list and select Projects.
   The Projects page displays. 
3. Click the project that you want to suspend. Click on suspend project icon. 
   
4. Click the Suspend Project icon.
   A Confirmation dialog box displays. 
   
5. Click OK to suspend the project.
   The state of the project is changed to Suspended.
   

Deleting a Project

When you suspend a project, it is temporarily frozen and unavailable to accounts associated to the project. However, it can be reactivated. To remove the project completely from the CloudStack infrastructure, you must delete the project. Only a domain admin or the project owner can delete a project. On deleting a project, its resources are destroyed, and the associated accounts are removed from the project (not from the CloudStack platform).

Perform the following steps to delete a project:

1. On the left panel, click Projects.
   The Projects page displays.
2. Click the Select view drop-down list and select Projects.
   The Projects page displays. 
3. Click the project that you want to delete.
   The Details tab displays.
4. Click the Delete project icon.
   
   A Confirmation dialog box displays.
   
5. Click OK to delete the project. 

Adding an Account to an Existing Project

While creating a project, by default, the project adds your account to it. It also provides you the option to add multiple accounts to the project. Even after creating the project, you can continue to add accounts to it. By doing so, you provide access to the users of the added account to the resources of the project.

Perform the following steps to add an account to an existing project:

1. On the left panel, click Projects.
   The Projects page displays.
2. Click the project to which you want to add an account.
   The Details tab displays.
3. Click the Accounts tab and add an account to the project.
   
4. Enter the name of the account that you want to add to the project and click Add.
   The account gets added to the project and reflects in the accounts list below. 

Making an Account the Project Owner

A project owner can add/remove accounts to/from the project. By assigning the project ownership to another account, you delegate the role to another account. 

Perform the following steps to transfer project ownership:

1. On the left panel, click Projects.
   The Projects page displays.
2. Click the Select view drop-down list and select Projects.
   The Projects page displays. 
3. Click the project for which you want to change the project owner.
   The Details tab displays.
4. Click the Accounts tab. 
   
5. Click the Make account project owner icon for the account that you want to make the project owner. 

Applying Resources

You can update the resource limit for a project. This is possible only if you are a domain admin.

Perform the following steps to update the resource count for a project:

1. On the left panel, click Projects.
   The Projects page displays.
2. Click the Select view drop-down list and select Projects.
   The Projects page displays.
3. Click the Configure limits tab.
   
4. Edit the values to update the resource count and click Submit.
   The updated limitations for the project are applicable.

Selecting a Project View

One account may be associated with multiple projects. Once you log in, you can get a view of different projects, and once in a specific project view, can work with the resources.

Perform the following steps to select a project view:

1. Log in to the CloudStack user interface.
2. Click the Projects drop-down list.
   The list of projects to which you are associated displays.
   
3. Select the project that you want to work with. 
   The Project Dashboard displays the details of resources pertaining to that project.