Edit

Manage a dev box project

  • Article

A project is the point of access to Microsoft Dev Box for the development team members. A project contains dev box pools, which specify the dev box definitions and network connections used when dev boxes are created. Dev managers can configure the project with dev box pools that specify dev box definitions appropriate for their team's workloads. Dev box users create dev boxes from the dev box pools they have access to through their project memberships.

Each project is associated with a single dev center. When you associate a project with a dev center, all the settings at the dev center level will be applied to the project automatically.

Project admins

Microsoft Dev Box makes it possible for you to delegate administration of projects to a member of the project team. Project administrators can assist with the day-to-day management of projects for their team, like creating and managing dev box pools. To provide users permissions to manage projects, add them to the DevCenter Project Admin role. The tasks in this quickstart can be performed by project admins.

To learn how to add a user to the Project Admin role, refer to Provide access to projects for project admins.

Important

A user who is assigned the Dev Box User role or the Project Admin role can create a dev box.

Permissions

To manage a dev box project, you need the following permissions:

Action Permission required
Create or delete dev box project Owner, Contributor, or Write permissions on the dev center in which you want to create the project.
Update a dev box project Owner, Contributor, or Write permissions on the project.
Create, delete, and update dev box pools in the project Owner, Contributor, or DevCenter Project Admin.
Manage a dev box within the project Owner, Contributor, or DevCenter Project Admin.
Add a dev box user to the project Owner permissions on the project.

Create a dev box project

The following steps show you how to create and configure a project in dev box.

  1. In the Azure portal, in the search box, type Projects and then select Projects from the list.

  2. On the Projects page, select +Create.

  3. On the Create a project page, on the Basics tab, enter the following values:

    Name Value
    Subscription Select the subscription in which you want to create the project.
    Resource group Select an existing resource group or select Create new, and enter a name for the resource group.
    Dev center Select the dev center to which you want to associate this project. All the dev center level settings will be applied to the project.
    Name Enter a name for your project.
    Description Enter a brief description of the project.

    Screenshot of the Create a dev box project basics tab.

  4. [Optional] On the Tags tab, enter a name and value pair that you want to assign.

  5. Select Review + Create.

  6. On the Review tab, select Create.

  7. Confirm that the project is created successfully by checking the notifications. Select Go to resource.

  8. Verify that you see the Project page.

Delete a dev box project

You can delete a dev box project when you're no longer using it. Deleting a project is permanent and cannot be undone. You cannot delete a project that has dev box pools associated with it.

  1. Sign in to the Azure portal.

  2. In the search box, type Projects and then select Projects from the list.

  3. Open the project you want to delete.

  4. Select the dev box project you want to delete and then select Delete.

    Screenshot of the list of existing dev box pools, with the one to be deleted selected.

  5. In the confirmation message, select Confirm.

    Screenshot of the Delete dev box pool confirmation message.

Provide access to a dev box project

Before users can create dev boxes based on the dev box pools in a project, you must provide access for them through a role assignment. The Dev Box User role enables dev box users to create, manage and delete their own dev boxes. You must have sufficient permissions to a project before you can add users to it.

  1. Sign in to the Azure portal.

  2. In the search box, type Projects and then select Projects from the list.

  3. Select the project you want to provide your team members access to.

    Screenshot of the list of existing projects.

  4. Select Access Control (IAM) from the left menu.

  5. Select Add > Add role assignment.

  6. Assign the following role. For detailed steps, see Assign Azure roles using the Azure portal.

    Setting Value
    Role Select DevCenter Dev Box User.
    Assign access to Select User, group, or service principal.
    Members Select the users or groups you want to have access to the project.

    Screenshot that shows the Add role assignment pane.

The user will now be able to view the project and all the pools within it. They can create dev boxes from any of the pools and manage those dev boxes from the developer portal.

To assign administrative access to a project, select the DevCenter Project Admin role. For more details on how to add a user to the Project Admin role, refer to Provide access to projects for project admins.

Next steps