Настройка дополнительных параметров

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

Обзор

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

Рабочая папка

Рабочая папка по умолчанию для агентов управляемых пулов DevOps обычно D:\a\_work (или C:\a\_work если размер виртуальной машины пула не имеет D диска) для агентов Windows или /mnt/vss/_work агентов Linux, а конвейер может ссылаться на рабочую папку с помощью Agent.WorkFolderпредопределенной переменной. Настройте параметр рабочей папки , чтобы переопределить рабочую папку по умолчанию для каждого образа агента в пуле.

Распространенный сценарий указания настраиваемого параметра рабочей папки заключается в том, что у вас есть подключенный диск данных и требуется, чтобы рабочая папка агента была на этом диске. Например, если у вас есть образ агента Windows с присвоенной буквой F для подключенного диска данных, можно установить папку Work на F:\custom-work-folder, чтобы все агенты, использующие этот образ, использовали указанную папку на диске данных как рабочую папку. Для агентов Linux диск данных монтируется как /mnt/storage/sdc, поэтому для использования папки с именем custom-work-folder на подключенном диске данных используйте /mnt/storage/sdc/custom-work-folder.

Это важно

Параметр рабочей папки применяется к каждому агенту в пуле. Если в пуле настроено несколько образов, и вы хотите настроить разные рабочие папки для каждого образа, настройте запрос WorkFolder в конвейерах для образов, в которых вы не хотите использовать параметр рабочей папки уровня пула. Спрос на уровне WorkFolder конвейера имеет приоритет над параметром пула Рабочих папок.

Не указывайте рабочую папку стиля Windows для агента Linux. Если вы указываете рабочую папку в стиле Windows для агента Linux, например F:\custom-work-folder, агент Linux пытается использовать рабочую папку, аналогичную mnt/vss/_workF:\custom-work-folder, что не удается.

Если указать рабочую папку стиля Linux для агента Windows, например, агент Windows использует эту папку на диске по умолчанию, например/mnt/storage/sdc/custom-work-folderD:\mnt\storage\sdc\custom-work-folder.

Портал Azure

Вы можете настроить параметр рабочей папки на вкладке "Дополнительно" при создании нового пула и перейдите к разделу "Дополнительные параметры>" для существующего пула.

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

Шаблон ARM

Свойство workfolder в runtimeConfiguration разделе указывает параметр рабочей папки .

Замечание

Раздел runtimeConfiguration и свойство workFolder доступны начиная с версии API 2025-09-20.

{
    "$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": {
                ...
                "organizationProfile": {...},
                "agentProfile": {...},
                "fabricProfile": {...},
                "runtimeConfiguration": {
                    "workFolder": "<your custom work folder>"
                }
            }
        }
    ]
}

Бицепс

Чтобы настроить параметр Work folder с помощью Bicep, добавьте workFolder свойство в разделе runtimeConfiguration. В следующем примере агенты в пуле настроены для использования D:\MyWorkFolder.

Чтобы использовать рабочую папку агента по умолчанию, опустите runtimeConfiguration раздел или укажите пустое значение при workFolder создании или обновлении пула.

Замечание

Раздел runtimeConfiguration и свойство workFolder доступны начиная с версии 2025-09-20 API.

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'MyManagedDevOpsPool'
  ...
  properties: {
    ...
    "organizationProfile": {...},
    "agentProfile": {...},
    "fabricProfile": {...},
    "runtimeConfiguration": {
        "workFolder": "<your custom work folder>"
    }
  }
}