Manage a dev box pool in Microsoft Dev Box

In this article, you learn how to manage a dev box pool in Microsoft Dev Box by using the Azure portal.

A dev box pool is a collection of dev boxes that have the same settings, such as the dev box definition and network connection. A dev box pool is associated with a Microsoft Dev Box project.

Dev box pools define the location of the dev boxes through the network connection. You can choose to deploy dev boxes to a Microsoft-hosted network or to a network that you manage. If you choose to deploy dev boxes to a network that you manage, you must first configure a network connection. Organizations that support developers in multiple geographical locations can create dev box pools for each location by specifying a nearby region.

Developers that have access to the project in the dev center can create a dev box from a dev box pool.

Permissions

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

Action Permissions required
Create, delete, or update a dev box pool - Owner or Contributor permissions on an Azure subscription or a specific resource group.
- DevCenter Project Admin permissions for the project.

Create a dev box pool

In Microsoft Dev Box, a dev box pool is a collection of dev boxes that you manage together. You must have at least one dev box pool before users can create a dev box.

The following steps show you how to create a dev box pool associated with a project. You use an existing dev box definition and network connection in the dev center to configure the pool.

If you don't have an available dev center with an existing dev box definition and network connection, follow the steps in Quickstart: Configure Microsoft Dev Box to create them.

  1. Sign in to the Azure portal.

  2. In the search box, enter projects. In the list of results, select Projects.

    Screenshot that shows a search for projects from the Azure portal search box.

  3. Open the Dev Box project with which you want to associate the new dev box pool.

    Screenshot of the list of existing projects.

  4. Select Dev box pools, and then select Create.

    Screenshot of the empty list of dev box pools within a project, along with the Create button.

  5. On the Create a dev box pool pane, enter the following values:

    Setting Value
    Name Enter a name for the pool. The pool name is visible to developers to select when they're creating dev boxes. It must be unique within a project.
    Dev box definition Select an existing dev box definition. The definition determines the base image and size for the dev boxes that are created in this pool.
    Network connection 1. Select Deploy to a Microsoft hosted network, or use an existing network connection.
    2. Select the region where the dev boxes should be deployed. Be sure to select a region that is close to where your developers are physically located to ensure the lowest latency experience with dev box.
    Enable single sign-on Select Yes to enable single sign-on for the dev boxes in this pool. Single sign-on must be configured for the organization. See Enable single sign-on for dev boxes.
    Dev box Creator Privileges Select Local Administrator or Standard User.
    Enable Auto-stop Yes is the default. Select No to disable an auto-stop schedule. You can configure an auto-stop schedule after the pool is created.
    Stop time Select a time to shut down all the dev boxes in the pool.
    Time zone Select the time zone that the stop time is in.
    Licensing Select this checkbox to confirm that your organization has Azure Hybrid Benefit licenses that you want to apply to the dev boxes in this pool.

    Screenshot of the pane for creating a dev box pool.

  6. Select Create.

  7. Verify that the new dev box pool appears in the list. You might need to refresh the screen.

The Azure portal deploys the dev box pool and runs health checks to ensure that the image and network pass the validation criteria for dev boxes. The following screenshot shows four dev box pools, each with a different status.

Screenshot that shows a list of dev box pools and status information.

Manage dev boxes in a pool

You can manage existing dev boxes in a dev box pool through the Azure portal. You can start, stop, or delete dev boxes.

Important

You must be a member of the Project Admin role for the project to manage dev boxes in the associated pools.

To manage dev boxes in a pool, you must access the pool through the associated project. The following steps show you how to navigate to the pool.

  1. Sign in to the Azure portal.

  2. In the search box, enter projects, in the list of results, select Projects.

  3. Select the project that contains the dev box pool that you want to manage.

  4. Select Dev box pools.

  5. Select the pool that contains the dev box that you want to manage. The names of pools that you can manage are displayed as links. If you don't see the pool name displayed as a link, check that you're a member of the Project Admin role for this project.

    Screenshot showing a list of dev box pools in Azure portal.

  6. Select more actions (...) for the dev box that you want to manage.

    Screenshot of the Azure portal, showing dev boxes in a dev box pool.

  7. Depending on the current state of the dev box, you can select Start, Stop, or Delete.

    Screenshot of the Azure portal, showing the menu for managing a dev box.

Delete a dev box pool

You can delete a dev box pool when you're no longer using it.

Caution

When you delete a dev box pool, all existing dev boxes within the pool are permanently deleted.

To delete a dev box pool in the Azure portal:

  1. Sign in to the Azure portal.

  2. In the search box, enter projects. In the list of results, select Projects.

  3. Open the project from which you want to delete the dev box pool.

  4. Select more actions (...) for the dev box pool that you want to delete.

  5. Select Delete.

  6. In the confirmation message, confirm the deletion by entering the name of the dev box pool that you want to delete, and then select Delete.

    Screenshot of the confirmation message for deleting a dev box pool.