Managing Apache CloudStack Projects

Description

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.


Contents

Adding a Project

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

By default, the account to which you belong is added to the project. You are assigned as the project owner. During the creation of a project or after it is created, you can add additional accounts to the project and also transfer the project owner role to another account.

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.


    Field NameDescription
    Project nameEnter the name of the project you are creating. This name must be unique.
    Display textEnter the name with which you can remember the project.
  4. The New Project dialog box provides you the option to add additional accounts. 




    If you do not want to add an additional account to this project now and want to be reminded later, click Remind me later. Your project will be created with your account associated to it.

  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.

    All resources allocated to this project can be shared and accessed by users of the accounts 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. 

    1. To make this newly added account the owner of this project, click the Make account project owner icon.

      If the type of your account is ADMIN, you will be able to revert the role and become the project owner again. However, if the type of your account is USER, you will not be able to revert the role. You will continue to be associated with the project, but not as the project owner.

    2. 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.

    An editable field for a project is the Display Name.

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.

    A suspended project can be activated by clicking the Activate Project icon.

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 domainadmin 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. 

    All users under this account will be able to access the resources of this project.

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. 


    By default, upon creating a project, your account is made the project owner. 

  5. Click the Make account project owner icon for the account that you want to make the project owner. 

    If your account is of type ADMIN, you can revert the role and become the project owner again. However, if your account is of type USER, you will not be able to revert the role. You will continue to be associated with the project, but not as a project owner.

Applying Resources

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

You can increase the resource limit for a project, However, the resource limits for a project are overruled by the resource limitation of the domain. For example, if the project is allocated 20 public IP addresses, and the domain is allocated 10 public IP addresses, the total usage of the IP addresses for the project can only be 10.

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.

Resources allocated to/created within a project belong only to the project. It cannot be accessed by the account when outside the project view.

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.


Get Support

Need Technical Support?

Have a specific challenge with your setup?

Create a Ticket