Prerequisites for Managed DevOps Pools

There are a few things you need to prepare before using Managed DevOps Pools for the first time.

At a high level, you need:

  • An Azure account with an active subscription, with the Managed DevOps Pools resource provider registered
  • An Azure DevOps organization, connected to the Microsoft Entra ID tenant of the users who will be administering the Managed DevOps Pool
  • Permissions in the Azure DevOps organization to create a Managed DevOps Pool

This article shows you how to configure your Azure subscription and Azure DevOps organization for use with Managed DevOps Pools. These configuration steps only need to be performed a single time per Azure DevOps organization and Azure subscription.

Configure your Azure subscription

  1. Register the Managed DevOps Pools resource provider in your Azure Subscription
  2. Review Managed DevOps Pools quotas
  3. Create a dev center and dev center project (If you plan to create your Managed DevOps Pools using the Azure portal, you can create the dev center and dev center project during the pool creation process.)

Register the Managed DevOps Pools resource provider in your Azure Subscription

To use Managed DevOps Pools, register the following resource providers with your Azure subscription.

Resource provider Description
Microsoft.DevOpsInfrastructure Resource provider for Managed DevOps Pools
Microsoft.DevCenter Resource provider for dev center and dev center project

Registering a resource provider uses the /register/action operation. Permission to perform this operation is included if your account is assigned the contributor or owner role on your subscription.

Azure portal

  1. Sign in to the Azure portal.

  2. On the Azure portal menu, search for Subscriptions. Select it from the available options.

  3. Select the Azure subscription you plan to use for Managed DevOps Pools.

  4. On the left menu, under Settings, select Resource providers.

  5. Search for Microsoft.DevOpsInfrastructure, select the check box from the list, and choose Register.

    Screenshot of registering the Managed DevOps Pools Azure Resource provider.

  6. Search for Microsoft.DevCenter. If Microsoft.DevCenter isn't registered, select the check box from the list, and choose Register.

  7. To see the Azure regions that support Managed DevOps Pools in your subscription, first register the Microsoft.DevOpsInfrastructure provider, select it from the list, and choose Locations.

    Screenshot of Azure regions that support Managed DevOps Pools.

For more information about Azure resource providers, see Azure resource providers and types.

Review Managed DevOps Pools quotas

Managed DevOps Pools uses Azure Quotas to manage the usage of the virtual machine resources that run your agents. Managed DevOps Pools quotas are based on CPU cores per Azure VM SKU family. By default, regions that support Managed DevOps Pools have five cores of quota granted for the following SKU families.

  • standardBSFamily
  • standardDADSv5Family
  • standardDASv5Family
  • standardDDSv5Family
  • standardDLDSv5Family
  • standardDPLDSv5Family
  • standardDPLSv5Family
  • standardDPSv5Family
  • standardDSv2Family
  • standardDSv5Family
  • standardDv2Family
  • standardEASv4Family
  • standardEDSv5Family
  • standardESv5Family
  • standardFSv2Family
  • standardLSv3Family

The default agent size for new Managed DevOps Pools resources is Standard D2ads v5, which is part of the standardDADSv5Family. Standard D2ads v5 uses two cores, so you can create a pool with up to two agents, for a total of four cores, without requesting additional quota. To create more, you must request a quota adjustment.

View your quotas

  1. To view the quotas for SKU families in your region, sign in to the Azure portal, enter quotas in the search box, and choose Quotas from the list.

    Screenshot of Azure portal search for quotas.

  2. Choose Managed DevOps Pools.

    Screenshot of quotas overview.

  3. Choose your subscription and the region where you want to create the pool. In the following example, the Standard DADSv5 Family vCPUs quota is 8 of 8, which means eight cores are available, but all eight are being used. If you want to use more than eight cores for this SKU, or you want to use a different SKU that doesn't have any quota, you can request a quota adjustment.

    Screenshot of quotas list.

Request a quota adjustment

  1. To request an increase in quota, choose Request adjustment for the desired SKU in your region.

    Screenshot of request adjustment menu item.

  2. Specify the desired number of cores for the selected SKU, and choose Submit. In the following example, 20 cores are requested for Standard DSv2 Family vCPUs.

    Screenshot of selecting an increased number of cores.

  3. The quota request takes a few moments to process. The following example shows the result of a successful quota adjustment.

    Screenshot of granted quota request.

    If the quota adjustment can't be auto-approved, you'll be directed to submit a support request, as described in the following section.

Create a quota support request

If your subscription doesn't have the capacity to configure your pool with desired Azure VM SKU and maximum agents count, pool creation fails with an error similar to the following message:

Cores needed to complete this request is 8, which exceeds the current limit of 0 for SKU family standardDDSv4Family in region eastus. Please choose a different region if possible, or request additional quota at https://portal.azure.com/#view/Microsoft_Azure_Support/NewSupportRequestV3Blade/issueType/quota/subscriptionId/subscription_id_placeholder/topicId/3eadc5d3-b59a-3658-d8c6-9c729ba35b97.

  1. Go to the link to start a New support request to request a quota increase. Choose Next.

    Screenshot of new quota support request

  2. Choose Enter details.

    Screenshot of new quota support request.

  3. Enter the Region, Sku Family, New limit, and choose Save and continue. In th following example, 100 cores are requested for Standard DDSv4 Family vCPUs.

    Screenshot of quota details.

  4. Fill the following details in this form:

    • Severity: Choose one of the available severity levels based on the business impact.

    • Preferred contact method: You can either choose to be contacted over Email or by Phone.

  5. Select Next: Review+Create. Validate the information provided and select Create to create a support request.

Within 24 hours, the Managed DevOps Pools support team will evaluate your request and get back to you.

Create a dev center and dev center project

Managed DevOps Pools requires a dev center and dev center project. You have the option to create a dev center and dev center project when you create your pool in the Azure portal, but if you want to create them ahead of time, perform the following steps. Multiple Managed DevOps Pools can use the same dev center and dev center project.

Create a dev center

  1. Sign in to the Azure portal.

  2. On the Azure portal menu, search for Dev centers, select it from the available options, and choose Create.

    Screenshot of the Dev centers create button.

  3. Choose the desired Subscription, Resource group, Name, and Location, and choose Review + Create.

    Screenshot of Create a dev center.

  4. On the confirmation window, choose Create to create the dev center.

  5. Wait until the new dev center is created, and proceed to the next section and create a dev center Project.

Create a dev center Project

  1. Go to the dev center created in the previous section, and choose Create project.

    Screenshot of Create dev center Project button

  2. Choose the desired Subscription, Resource group, dev center, Name, and choose Review + Create.

    Screenshot of Create a dev center project.

  3. On the confirmation window, choose Create to create the dev center project.

  4. When you create your Managed DevOps Pool, specify the dev center and dev center project you created in these steps.

Configure your Azure DevOps organization

  1. Connect your Azure DevOps organization to Microsoft Entra ID and verify membership
  2. Verify Azure DevOps permissions

Connect your Azure DevOps organization to Microsoft Entra ID and verify membership

To create a Managed DevOps Pool in your Azure DevOps organization, your Azure DevOps organization must be connected to Microsoft Entra ID, and your user account must be a member of the following Microsoft Entra ID tenants:

  • The tenant of the Azure subscription that contains your Managed DevOps Pool
  • The tenant your Azure DevOps organization is connected to

If the tenants are different, your account must be a member of both tenants. To view your tenants:

  1. View your current directory (Azure tenant) in the Azure portal.
  2. View the tenant for your Azure DevOps organization. You can go directly to this page in the Azure DevOps portal here: https://dev.azure.com/<your-organization>/_settings/organizationAad.
  3. If your Azure DevOps organization isn't connected to Microsoft Entra ID, follow the steps in Connect your organization to Microsoft Entra ID and connect to the desired tenant, such as the same tenant as your Azure subscription.
  4. If your Azure DevOps organization and Managed DevOps Pools Azure subscription are in different tenants, verify that you are a member of both tenants.

Verify Azure DevOps permissions

When you create a Managed DevOps Pool, the account you use to sign in to the Azure subscription that contains your Managed DevOps Pool is used to create a corresponding agent pool in your Azure DevOps organization. To successfully create a Managed DevOps Pool, your account must have one of the following permissions in your Azure DevOps organization. These permissions are listed in order from least privileged to most privileged.

Next steps