Настройка параметров пула

В этой статье описывается настройка основных параметров управляемого пула DevOps.

Перейдите кобзору параметров пула, переместите ресурсы Azure в новую группу ресурсов или подписку или настройте теги. Управляемые пулы DevOps передают до 20 тегов на виртуальную машину, а остальные игнорируются.

Чтобы настроить пул, перейдите в раздел "Параметры пула>".

Используйте следующие параметры, чтобы настроить управляемый пул DevOps.

• проект Центр разработки
• Организация Azure DevOps
• Изображения
• Максимальное количество агентов
• Размер агента
• Тип диска ОС

проект Центр разработки

Портал Azure

Выберите проект Центр разработки для управляемого пула DevOps. Во время создания пула можно создать Центр разработки и Центр разработки проект, если у вас его нет.

Шаблон ARM

Проект центра разработки определяется свойством devCenterProjectResourceId .

    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "location": "eastus",
            "tags": {},
            "properties": {
                ...
                "devCenterProjectResourceId": "/subscriptions/subscription_id_placeholder/resourceGroups/fabrikam-managed-devops-pools/providers/Microsoft.DevCenter/projects/fabrikam-dev-center-project"
            }
        }
    ]
}

Вы можете получить devCenterProjectResourceId проект Центр разработки в портал Azure с помощью представления JSON на странице обзора проекта Центр разработки или получить его с помощью Azure CLI для запроса проекта для его id свойства. В следующем примере devCenterProjectResourceId извлекается из проекта Центр разработки с именем fabrikam-dev-center-project в fabrikam-managed-devops-pools группе ресурсов.

 az devcenter admin project show --name fabrikam-dev-center-project --resource-group fabrikam-managed-devops-pools --query "id"

Azure CLI

Проект центра разработки определяется параметром devcenter-project-id при создании или обновлении пула.

az mdp pool create \
   --devcenter-project-id /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/resourceGroupName/providers/Microsoft.DevCenter/projects/devCenterProjectName
   # other parameters omitted for space

Вы можете получить devcenter-project-id проект центра разработки в портал Azure с помощью представления JSON на странице обзора проекта центра разработки или получить его с помощью Azure CLI для запроса проекта для своего id свойства. В следующем примере devcenter-project-id извлекается из проекта центра разработки с именем fabrikam-dev-center-project в fabrikam-managed-devops-pools группе ресурсов.

 az devcenter admin project show --name fabrikam-dev-center-project --resource-group fabrikam-managed-devops-pools --query "id"

Организация Azure DevOps

Портал Azure

Если управляемый пул DevOps настроен для одной организации Azure DevOps, можно указать организацию в параметрах пула.

Если пул настроен для нескольких организаций, параметр организации Azure DevOps отсутствует в параметрах пула. Чтобы настроить пул для использования в нескольких организациях, перейдите в раздел "Параметры>безопасности" и настройте пул использования в нескольких организациях.

Шаблон ARM

Организация Azure DevOps настроена с помощью organizations списка в organizationProfile разделе. В следующем примере управляемый пул DevOps настроен для всех проектов в одной организации с параллелизмом 4. Пример настройки нескольких организаций см. в разделе "Использование пула" в нескольких организациях.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2024-10-19",
            "location": "eastus",
            "properties": {
                ...
                "organizationProfile": {
                    "organizations": [
                        {
                            "url": "https://dev.azure.com/fabrikam-tailspin",
                            "projects": [],
                            "parallelism": 4
                        }
                    ]
                }
            }
        }
    ]
}

Azure CLI

Организация Azure DevOps настроена organizations с помощью списка в параметре organization-profile . В следующем примере управляемый пул DevOps настроен для всех проектов в одной организации с параллелизмом 4. Пример настройки нескольких организаций см. в разделе "Использование пула" в нескольких организациях.

az mdp pool create \
   --organization-profile organization-profile.json
   # other parameters omitted for space

В следующем примере показан organizations список в файле organization-profile.json .

{
  "AzureDevOps": {
    "organizations": [
      {
        "url": "https://dev.azure.com/fabrikam-tailspin",
        "projects": [],
        "parallelism": 4
      }
    ],
    "permissionProfile": {...}
  }
}

По умолчанию управляемый пул DevOps доступен для всех проектов в указанных организациях. Чтобы ограничить пул определенными проектами, см . раздел "Параметры безопасности" — настройка доступа к организации.

Максимальное количество агентов

Укажите максимальное количество агентов, которые можно подготовить в заданное время в пуле. Например, если указать максимальное значение агентов 2, можно одновременно запускать не более двух агентов. Если в очереди находятся более двух заданий, то только два агента за раз будут выполнять задания, а другие задания ожидают.

Текущее состояние и количество подготовленных агентов в пуле можно просмотреть в панели Агенты. Все агенты в представлении агентов (за исключением агентов с состоянием возвращенные) работают на ресурсе виртуальной машины и учитываются в количестве максимальное число агентов.

Портал Azure

Максимальные агенты настраиваются в параметрах пула для существующего пула и на вкладке "Основные сведения" при создании пула.

Шаблон ARM

Максимальные агенты настраиваются с помощью maximumConcurrency свойства. В следующем примере для максимальных агентов задано значение 4.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2024-10-19",
            "location": "eastus",
            "properties": {
                ...
                "maximumConcurrency": 4
            }
        }
    ]
}

Azure CLI

Максимальные агенты настраиваются с помощью maximum-concurrency параметра при создании или обновлении пула. В следующем примере для максимальных агентов задано значение 4.

az mdp pool create \
   --maximum-concurrency 4
   # other parameters omitted for space

Примечание.

Максимальное число агентов настраивает максимальное количество агентов , которые могут быть подготовлены одновременно, но число локальных параллельных заданий вашей организации указывает количество заданий, которые могут выполняться одновременно. Убедитесь, что в организации достаточно локальных параллельных заданий, чтобы агенты могли выполнять задания. Дополнительные сведения см. в статье о ценах на параллельные задания Azure DevOps Services.

Размер агента

Размер агента указывает размер виртуальной машины Azure для размещения агентов управляемых пулов DevOps.

Портал Azure

Выберите "Изменить размер", чтобы просмотреть и выбрать размер виртуальной машины Azure, доступный в вашем регионе Azure. Размеры агента (SKU) с доступными квотами управляемых пулов DevOps помечены как доступные. Вы можете запросить дополнительную квоту для номеров SKU not Available . После утверждения запроса квоты для номера SKU "Недоступно " он будет указан как доступный. Дополнительные сведения о квотах управляемых пулов DevOps.

Шаблон ARM

Размер агента настраивается с помощью sku свойства в fabricProfile разделе. В следующем примере указывается размер виртуальной машины Standard_D2ads_v5 .

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2024-10-19",
            "location": "eastus",
            "properties": {
                ...
                "fabricProfile": {
                    "sku": {
                        "name": "Standard_D2ads_v5"
                    }
                }
            }
        }
    ]
}

Azure CLI

Размер агента настраивается с помощью sku свойства в fabricProfile разделе при создании или обновлении пула. В следующем примере указывается размер виртуальной машины Standard_D2ads_v5 .

az mdp pool create \
   --fabric-profile fabric-profile.json
   # other parameters omitted for space

В следующем примере показан sku раздел файла fabric-profile.json .

{
  "vmss": {
    "sku": {
      "name": "Standard_D2ads_v5"
    },
    "images": [...],
    "osProfile": {...},
    "storageProfile": {...}
  }
}

Если у вашей подписки нет емкости для настройки пула с требуемым номером SKU виртуальной машины Azure и максимальным числом агентов, вы получите ошибку, аналогичную приведенному ниже сообщению. 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. Чтобы устранить проблему, ознакомьтесь с квотами управляемых пулов DevOps.

Не все номера SKU поддерживаются для всех регионов Azure. Если вы получаете сообщение SKU family <sku-family> is not available in location <region> об ошибке, убедитесь, что размер номера SKU поддерживается для вашего региона. Дополнительные сведения см. в Размеры виртуальных машин в Azure и Доступность продуктов по регионам.

Тип диска ОС

Управляемые пулы DevOps предоставляют следующие типы дисков для диска ОС.

• Стандартные
• SSD ценовой категории «Стандартный»
• SSD ценовой категории «Премиум»

Тип диска ОС по умолчанию — "Стандартный". Если пропускная способность рабочей нагрузки превышает уровень "Стандартный", вы можете повысить производительность рабочей нагрузки, обновив его до более производительного типа диска. Дополнительные сведения о типах дисков и производительности см. в статье "Управляемые типы дисков Azure".

Портал Azure

Тип диска ОС настраивается в параметрах пула для существующего пула и на вкладке "Основные сведения" при создании пула.

Шаблон ARM

Тип диска ОС настраивается с помощью osDiskStorageAccountType свойства в storageProfile разделе. В следующем примере указывается тип диска ОС уровня "Стандартный". Выберите "Стандартный", "Стандартный" или "Премиум".

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2024-10-19",
            "location": "eastus",
            "properties": {
                ...
                "storageProfile": {
                    "osDiskStorageAccountType": "Standard"
                }
            }
        }
    ]
}

Azure CLI

В следующем примере указывается тип диска ОС уровня "Стандартный". Выберите "Стандартный", "Стандартный" или "Премиум".

Тип диска ОС настраивается с помощью osDiskStorageAccountType свойства в storageProfile разделе параметра fabric-profile . В следующем примере указывается тип диска ОС уровня "Стандартный". Выберите "Стандартный", "Стандартный" или "Премиум".

az mdp pool create \
   --fabric-profile fabric-profile.json
   # other parameters omitted for space

В следующем примере показан storageProfile раздел файла fabric-profile.json .

{
  "vmss": {
    "sku": {...},
    "images": [...],
    "osProfile": {...},
    "storageProfile": {
      "osDiskStorageAccountType": "Standard",
      "dataDisks": []
    }
  }
}

Изображения

Управляемые пулы DevOps предоставляют несколько вариантов для образов виртуальных машин для выполнения конвейеров в пуле. Вы можете создать пул с помощью выбранных образов виртуальных машин Azure Marketplace, использовать собственные пользовательские образы в коллекции вычислений Azure или использовать те же образы Windows и Linux, которые используются размещенными агентами Майкрософт в Azure Pipelines.

Вы можете настроить пул для использования одного образа или нескольких образов и использовать псевдонимы для настройки конвейеров для использования определенного образа. Дополнительные сведения см. в разделе "Настройка образов управляемых пулов DevOps".

См. также

• Настройка изображений