Пулы Microsoft.DevOpsInfrastructure

Статья
12/16/2024

Определение ресурсов Bicep

Тип ресурса пулов можно развернуть с помощью операций, предназначенных для следующих операций:

группы ресурсов . См. команды развертывания группы ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.DevOpsInfrastructure/pools, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.DevOpsInfrastructure/pools@2024-10-19' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    agentProfile: {
      resourcePredictions: any(Azure.Bicep.Types.Concrete.AnyType)
      resourcePredictionsProfile: {
        kind: 'string'
        // For remaining properties, see ResourcePredictionsProfile objects
      }
      kind: 'string'
      // For remaining properties, see AgentProfile objects
    }
    devCenterProjectResourceId: 'string'
    fabricProfile: {
      kind: 'string'
      // For remaining properties, see FabricProfile objects
    }
    maximumConcurrency: int
    organizationProfile: {
      kind: 'string'
      // For remaining properties, see OrganizationProfile objects
    }
    provisioningState: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Объекты FabricProfile

Задайте свойство типа, чтобы указать тип объекта.

Для vmssиспользуйте:

{
  images: [
    {
      aliases: [
        'string'
      ]
      buffer: 'string'
      resourceId: 'string'
      wellKnownImageName: 'string'
    }
  ]
  kind: 'Vmss'
  networkProfile: {
    subnetId: 'string'
  }
  osProfile: {
    logonType: 'string'
    secretsManagementSettings: {
      certificateStoreLocation: 'string'
      keyExportable: bool
      observedCertificates: [
        'string'
      ]
    }
  }
  sku: {
    name: 'string'
  }
  storageProfile: {
    dataDisks: [
      {
        caching: 'string'
        diskSizeGiB: int
        driveLetter: 'string'
        storageAccountType: 'string'
      }
    ]
    osDiskStorageAccountType: 'string'
  }
}

Объекты OrganizationProfile

Задайте свойство типа, чтобы указать тип объекта.

Для AzureDevOpsиспользуйте:

{
  kind: 'AzureDevOps'
  organizations: [
    {
      parallelism: int
      projects: [
        'string'
      ]
      url: 'string'
    }
  ]
  permissionProfile: {
    groups: [
      'string'
    ]
    kind: 'string'
    users: [
      'string'
    ]
  }
}

Для GitHubиспользуйте:

{
  kind: 'GitHub'
  organizations: [
    {
      repositories: [
        'string'
      ]
      url: 'string'
    }
  ]
}

Объекты AgentProfile

Задайте свойство типа, чтобы указать тип объекта.

Для с отслеживанием состояния используйте:

{
  gracePeriodTimeSpan: 'string'
  kind: 'Stateful'
  maxAgentLifetime: 'string'
}

Для без отслеживания состояния используйте:

{
  kind: 'Stateless'
}

Объекты ResourcePredictionsProfile

Задайте свойство типа, чтобы указать тип объекта.

Для автоматическогоиспользуйте:

{
  kind: 'Automatic'
  predictionPreference: 'string'
}

Для вручнуюиспользуйте:

{
  kind: 'Manual'
}

Значения свойств

AgentProfile

Имя	Описание	Ценность
добрый	Установите значение Stateful для типа с отслеживанием состояния. Установите значение Stateless для типа StatelessAgentProfile.	"Stateful" "Без отслеживания состояния" (обязательно)
resourcePredictions	Определяет буфер пула или автономные агенты.	любой
resourcePredictionsProfile	Определяет, как предоставляется буфер или автономный агент пула.	ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Имя	Описание	Ценность
добрый	Определяет способ предоставления автономной схемы.	"Автоматический" (обязательный)
прогнозированиеPreference	Определяет баланс между затратами и производительностью.	"Balanced" "BestPerformance" 'MoreCostEffective' "MorePerformance" "MostCostEffective"

AzureDevOpsOrganizationProfile

Имя	Описание	Ценность
добрый	Дискриминационное свойство для OrganizationProfile.	AzureDevOps (обязательно)
Организаций	Список организаций Azure DevOps, в которые должен присутствовать пул.	организации[] (обязательно)
permissionProfile	Тип разрешения, определяющего, какие учетные записи являются администраторами в пуле Azure DevOps.	AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Имя	Описание	Ценность
Группы	Групповые адреса электронной почты	string[]
добрый	Определяет, кто имеет разрешения администратора в пуле Azure DevOps.	CreatorOnly "Наследование" "SpecificAccounts" (обязательный)
Пользователей	Адреса электронной почты пользователя	string[]

DataDisk

Имя	Описание	Ценность
Кэширование	Тип кэширования для дисков данных. Значение по умолчанию для кэширования — readwrite. Сведения о параметрах кэширования см. в статье https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.	"Нет" "ReadOnly" ReadWrite
diskSizeGiB	Начальный размер диска в гигабайтах.	int
driveLetter	Буква диска для пустого диска данных. Если оно не указано, оно будет первым доступным письмом.	струна
storageAccountType	Тип учетной записи хранения, используемый для диска данных. Если опущено, значение по умолчанию — "standard_lrs".	"Premium_LRS" "Premium_ZRS" "StandardSSD_LRS" "StandardSSD_ZRS" "Standard_LRS"

DevOpsAzureSku

Имя	Описание	Ценность
имя	Имя SKU Azure для компьютеров в пуле.	строка (обязательно)

FabricProfile

Имя	Описание	Ценность
добрый	Установите значение Vmss для типа VmssFabricProfile.	Vmss (обязательный)

GitHubOrganization

Имя	Описание	Ценность
Репозитории	Необязательный список репозиториев, в которых должен быть создан пул.	string[]
URL-адрес	URL-адрес организации GitHub, в котором должен быть создан пул.	строка (обязательно)

GitHubOrganizationProfile

Имя	Описание	Ценность
добрый	Дискриминационное свойство для OrganizationProfile.	GitHub (обязательно)
Организаций	Список организаций и репозиториев GitHub, в который должен присутствовать пул.	GitHubOrganization[] (обязательно)

ManagedServiceIdentity

Имя	Описание	Ценность
тип	Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).	"Нет" SystemAssigned SystemAssigned, UserAssigned UserAssigned (обязательно)
userAssignedIdentities	Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах.	UserAssignedIdentities

ManualResourcePredictionsProfile

Имя	Описание	Ценность
добрый	Определяет способ предоставления автономной схемы.	"Вручную" (обязательно)

Microsoft.DevOpsInfrastructure/pools

Имя	Описание	Ценность
тождество	Удостоверения управляемой службы, назначенные этому ресурсу.	ManagedServiceIdentity
местоположение	Географическое расположение, в котором находится ресурс	строка (обязательно)
имя	Имя ресурса	струна Ограничения целостности: Pattern = `^[a-zA-Z0-9][a-zA-Z0-9-.]*$` (обязательно)
свойства	Свойства, относящиеся к ресурсу, для этого ресурса.	PoolProperties
Теги	Теги ресурсов	Словарь имен и значений тегов. См. теги в шаблонах

NetworkProfile

Имя	Описание	Ценность
SubnetId	Идентификатор подсети, на котором будут помещены все компьютеры, созданные в пуле.	строка (обязательно)

Организация

Имя	Описание	Ценность
параллелизм	Сколько компьютеров можно создать в этой организации в максимальной мере из максимального количества компьютеров пула.	int
проекты	Необязательный список проектов, в которых должен быть создан пул.	string[]
URL-адрес	URL-адрес организации Azure DevOps, в котором необходимо создать пул.	строка (обязательно)

OrganizationProfile

Имя	Описание	Ценность
добрый	Установите значение "AzureDevOps" для типа AzureDevOpsOrganizationProfile. Установите значение GitHub для типа GitHubOrganizationProfile.	AzureDevOps GitHub (обязательно)

OsProfile

Имя	Описание	Ценность
вход в систему	Определяет, как должна выполняться служба. По умолчанию этот параметр будет иметь значение Service.	"Интерактивный" "Служба"
secretManagementSettings	Параметры управления секретами компьютеров в пуле.	SecretManagementSettings

PoolImage

Имя	Описание	Ценность
Псевдонимы	Список псевдонимов для ссылки на изображение.	string[]
буфер	Процент буфера, выделенного этому изображению.	струна
resourceId	Идентификатор ресурса изображения.	струна
wellKnownImageName	Изображение, используемое из известного набора образов, предоставляемых клиентам.	струна

PoolProperties

Имя	Описание	Ценность
agentProfile	Определяет способ обработки компьютера после выполнения задания.	AgentProfile (обязательно)
devCenterProjectResourceId	Идентификатор ресурса проекта DevCenter, к которому принадлежит пул.	строка (обязательно)
fabricProfile	Определяет тип структуры, на который будет работать агент.	FabricProfile (обязательно)
максимальное значениеConcurrency	Определяет, сколько ресурсов можно создавать в любое время.	int Ограничения целостности: Минимальное значение = 1 Максимальное значение = 10000 (обязательно)
organizationProfile	Определяет организацию, в которой будет использоваться пул.	OrganizationProfile (обязательно)
provisioningState	Состояние текущей операции.	"Принято" "Отменено" Удаление "Не удалось" Подготовка "Успешно" "Обновление"

ResourcePredictionsProfile

Имя	Описание	Ценность
добрый	Установите значение Automatic для типа AutomaticResourcePredictionsProfile. Установите значение "Вручную" для типа ManualResourcePredictionsProfile.	"Автоматически" "Вручную" (обязательно)

SecretManagementSettings

Имя	Описание	Ценность
certificateStoreLocation	Где хранить сертификаты на компьютере.	струна
keyExportable	Определяет, следует ли экспортировать ключ сертификатов.	bool (обязательно)
observedCertificates	Список сертификатов для установки на всех компьютерах в пуле.	string[] (обязательно)

С отслеживанием состояния

Имя	Описание	Ценность
gracePeriodTimeSpan	Сколько времени компьютер должен храниться вокруг после запуска рабочей нагрузки, когда не существует автономных агентов. Максимальное значение составляет одну неделю.	струна
добрый	Дискриминационные свойства для AgentProfile.	"Stateful" (обязательно)
maxAgentLifetime	Как долго должны храниться компьютеры с отслеживанием состояния. Максимальное значение составляет одну неделю.	струна

StatelessAgentProfile

Имя	Описание	Ценность
добрый	Дискриминационные свойства для AgentProfile.	"Без отслеживания состояния" (обязательно)

StorageProfile

Имя	Описание	Ценность
dataDisks	Список пустых дисков данных для подключения.	DataDisk[]
osDiskStorageAccountType	Имя SKU Azure для компьютеров в пуле.	"Премиум" "Стандартный" "StandardSSD"

TrackedResourceTags

Имя	Описание	Ценность

UserAssignedIdentities

Имя	Описание	Ценность

UserAssignedIdentity

Имя	Описание	Ценность

VmssFabricProfile

Имя	Описание	Ценность
Изображения	Образы виртуальных машин в пуле.	PoolImage[] (обязательно)
добрый	Дискриминационное свойство Для FabricProfile.	Vmss (обязательный)
networkProfile	Сетевой профиль компьютеров в пуле.	NetworkProfile
osProfile	Профиль ОС компьютеров в пуле.	OsProfile
SKU	Номер SKU Azure для компьютеров в пуле.	DevOpsAzureSku (обязательно)
storageProfile	Профиль хранения компьютеров в пуле.	StorageProfile

Определение ресурса шаблона ARM

Тип ресурса пулов можно развернуть с помощью операций, предназначенных для следующих операций:

группы ресурсов . См. команды развертывания группы ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.DevOpsInfrastructure/pools, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.DevOpsInfrastructure/pools",
  "apiVersion": "2024-10-19",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "agentProfile": {
      "resourcePredictions": {},
      "resourcePredictionsProfile": {
        "kind": "string"
        // For remaining properties, see ResourcePredictionsProfile objects
      },
      "kind": "string"
      // For remaining properties, see AgentProfile objects
    },
    "devCenterProjectResourceId": "string",
    "fabricProfile": {
      "kind": "string"
      // For remaining properties, see FabricProfile objects
    },
    "maximumConcurrency": "int",
    "organizationProfile": {
      "kind": "string"
      // For remaining properties, see OrganizationProfile objects
    },
    "provisioningState": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Объекты FabricProfile

Задайте свойство типа, чтобы указать тип объекта.

Для vmssиспользуйте:

{
  "images": [
    {
      "aliases": [ "string" ],
      "buffer": "string",
      "resourceId": "string",
      "wellKnownImageName": "string"
    }
  ],
  "kind": "Vmss",
  "networkProfile": {
    "subnetId": "string"
  },
  "osProfile": {
    "logonType": "string",
    "secretsManagementSettings": {
      "certificateStoreLocation": "string",
      "keyExportable": "bool",
      "observedCertificates": [ "string" ]
    }
  },
  "sku": {
    "name": "string"
  },
  "storageProfile": {
    "dataDisks": [
      {
        "caching": "string",
        "diskSizeGiB": "int",
        "driveLetter": "string",
        "storageAccountType": "string"
      }
    ],
    "osDiskStorageAccountType": "string"
  }
}

Объекты OrganizationProfile

Задайте свойство типа, чтобы указать тип объекта.

Для AzureDevOpsиспользуйте:

{
  "kind": "AzureDevOps",
  "organizations": [
    {
      "parallelism": "int",
      "projects": [ "string" ],
      "url": "string"
    }
  ],
  "permissionProfile": {
    "groups": [ "string" ],
    "kind": "string",
    "users": [ "string" ]
  }
}

Для GitHubиспользуйте:

{
  "kind": "GitHub",
  "organizations": [
    {
      "repositories": [ "string" ],
      "url": "string"
    }
  ]
}

Объекты AgentProfile

Задайте свойство типа, чтобы указать тип объекта.

Для с отслеживанием состояния используйте:

{
  "gracePeriodTimeSpan": "string",
  "kind": "Stateful",
  "maxAgentLifetime": "string"
}

Для без отслеживания состояния используйте:

{
  "kind": "Stateless"
}

Объекты ResourcePredictionsProfile

Задайте свойство типа, чтобы указать тип объекта.

Для автоматическогоиспользуйте:

{
  "kind": "Automatic",
  "predictionPreference": "string"
}

Для вручнуюиспользуйте:

{
  "kind": "Manual"
}

Значения свойств

AgentProfile

Имя	Описание	Ценность
добрый	Установите значение Stateful для типа с отслеживанием состояния. Установите значение Stateless для типа StatelessAgentProfile.	"Stateful" "Без отслеживания состояния" (обязательно)
resourcePredictions	Определяет буфер пула или автономные агенты.	любой
resourcePredictionsProfile	Определяет, как предоставляется буфер или автономный агент пула.	ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Имя	Описание	Ценность
добрый	Определяет способ предоставления автономной схемы.	"Автоматический" (обязательный)
прогнозированиеPreference	Определяет баланс между затратами и производительностью.	"Balanced" "BestPerformance" 'MoreCostEffective' "MorePerformance" "MostCostEffective"

AzureDevOpsOrganizationProfile

Имя	Описание	Ценность
добрый	Дискриминационное свойство для OrganizationProfile.	AzureDevOps (обязательно)
Организаций	Список организаций Azure DevOps, в которые должен присутствовать пул.	организации[] (обязательно)
permissionProfile	Тип разрешения, определяющего, какие учетные записи являются администраторами в пуле Azure DevOps.	AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Имя	Описание	Ценность
Группы	Групповые адреса электронной почты	string[]
добрый	Определяет, кто имеет разрешения администратора в пуле Azure DevOps.	CreatorOnly "Наследование" "SpecificAccounts" (обязательный)
Пользователей	Адреса электронной почты пользователя	string[]

DataDisk

Имя	Описание	Ценность
Кэширование	Тип кэширования для дисков данных. Значение по умолчанию для кэширования — readwrite. Сведения о параметрах кэширования см. в статье https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.	"Нет" "ReadOnly" ReadWrite
diskSizeGiB	Начальный размер диска в гигабайтах.	int
driveLetter	Буква диска для пустого диска данных. Если оно не указано, оно будет первым доступным письмом.	струна
storageAccountType	Тип учетной записи хранения, используемый для диска данных. Если опущено, значение по умолчанию — "standard_lrs".	"Premium_LRS" "Premium_ZRS" "StandardSSD_LRS" "StandardSSD_ZRS" "Standard_LRS"

DevOpsAzureSku

Имя	Описание	Ценность
имя	Имя SKU Azure для компьютеров в пуле.	строка (обязательно)

FabricProfile

Имя	Описание	Ценность
добрый	Установите значение Vmss для типа VmssFabricProfile.	Vmss (обязательный)

GitHubOrganization

Имя	Описание	Ценность
Репозитории	Необязательный список репозиториев, в которых должен быть создан пул.	string[]
URL-адрес	URL-адрес организации GitHub, в котором должен быть создан пул.	строка (обязательно)

GitHubOrganizationProfile

Имя	Описание	Ценность
добрый	Дискриминационное свойство для OrganizationProfile.	GitHub (обязательно)
Организаций	Список организаций и репозиториев GitHub, в который должен присутствовать пул.	GitHubOrganization[] (обязательно)

ManagedServiceIdentity

Имя	Описание	Ценность
тип	Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).	"Нет" SystemAssigned SystemAssigned, UserAssigned UserAssigned (обязательно)
userAssignedIdentities	Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах.	UserAssignedIdentities

ManualResourcePredictionsProfile

Имя	Описание	Ценность
добрый	Определяет способ предоставления автономной схемы.	"Вручную" (обязательно)

Microsoft.DevOpsInfrastructure/pools

Имя	Описание	Ценность
apiVersion	Версия API	'2024-10-19'
тождество	Удостоверения управляемой службы, назначенные этому ресурсу.	ManagedServiceIdentity
местоположение	Географическое расположение, в котором находится ресурс	строка (обязательно)
имя	Имя ресурса	струна Ограничения целостности: Pattern = `^[a-zA-Z0-9][a-zA-Z0-9-.]*$` (обязательно)
свойства	Свойства, относящиеся к ресурсу, для этого ресурса.	PoolProperties
Теги	Теги ресурсов	Словарь имен и значений тегов. См. теги в шаблонах
тип	Тип ресурса	"Microsoft.DevOpsInfrastructure/pools"

NetworkProfile

Имя	Описание	Ценность
SubnetId	Идентификатор подсети, на котором будут помещены все компьютеры, созданные в пуле.	строка (обязательно)

Организация

Имя	Описание	Ценность
параллелизм	Сколько компьютеров можно создать в этой организации в максимальной мере из максимального количества компьютеров пула.	int
проекты	Необязательный список проектов, в которых должен быть создан пул.	string[]
URL-адрес	URL-адрес организации Azure DevOps, в котором необходимо создать пул.	строка (обязательно)

OrganizationProfile

Имя	Описание	Ценность
добрый	Установите значение "AzureDevOps" для типа AzureDevOpsOrganizationProfile. Установите значение GitHub для типа GitHubOrganizationProfile.	AzureDevOps GitHub (обязательно)

OsProfile

Имя	Описание	Ценность
вход в систему	Определяет, как должна выполняться служба. По умолчанию этот параметр будет иметь значение Service.	"Интерактивный" "Служба"
secretManagementSettings	Параметры управления секретами компьютеров в пуле.	SecretManagementSettings

PoolImage

Имя	Описание	Ценность
Псевдонимы	Список псевдонимов для ссылки на изображение.	string[]
буфер	Процент буфера, выделенного этому изображению.	струна
resourceId	Идентификатор ресурса изображения.	струна
wellKnownImageName	Изображение, используемое из известного набора образов, предоставляемых клиентам.	струна

PoolProperties

Имя	Описание	Ценность
agentProfile	Определяет способ обработки компьютера после выполнения задания.	AgentProfile (обязательно)
devCenterProjectResourceId	Идентификатор ресурса проекта DevCenter, к которому принадлежит пул.	строка (обязательно)
fabricProfile	Определяет тип структуры, на который будет работать агент.	FabricProfile (обязательно)
максимальное значениеConcurrency	Определяет, сколько ресурсов можно создавать в любое время.	int Ограничения целостности: Минимальное значение = 1 Максимальное значение = 10000 (обязательно)
organizationProfile	Определяет организацию, в которой будет использоваться пул.	OrganizationProfile (обязательно)
provisioningState	Состояние текущей операции.	"Принято" "Отменено" Удаление "Не удалось" Подготовка "Успешно" "Обновление"

ResourcePredictionsProfile

Имя	Описание	Ценность
добрый	Установите значение Automatic для типа AutomaticResourcePredictionsProfile. Установите значение "Вручную" для типа ManualResourcePredictionsProfile.	"Автоматически" "Вручную" (обязательно)

SecretManagementSettings

Имя	Описание	Ценность
certificateStoreLocation	Где хранить сертификаты на компьютере.	струна
keyExportable	Определяет, следует ли экспортировать ключ сертификатов.	bool (обязательно)
observedCertificates	Список сертификатов для установки на всех компьютерах в пуле.	string[] (обязательно)

С отслеживанием состояния

Имя	Описание	Ценность
gracePeriodTimeSpan	Сколько времени компьютер должен храниться вокруг после запуска рабочей нагрузки, когда не существует автономных агентов. Максимальное значение составляет одну неделю.	струна
добрый	Дискриминационные свойства для AgentProfile.	"Stateful" (обязательно)
maxAgentLifetime	Как долго должны храниться компьютеры с отслеживанием состояния. Максимальное значение составляет одну неделю.	струна

StatelessAgentProfile

Имя	Описание	Ценность
добрый	Дискриминационные свойства для AgentProfile.	"Без отслеживания состояния" (обязательно)

StorageProfile

Имя	Описание	Ценность
dataDisks	Список пустых дисков данных для подключения.	DataDisk[]
osDiskStorageAccountType	Имя SKU Azure для компьютеров в пуле.	"Премиум" "Стандартный" "StandardSSD"

TrackedResourceTags

Имя	Описание	Ценность

UserAssignedIdentities

Имя	Описание	Ценность

UserAssignedIdentity

Имя	Описание	Ценность

VmssFabricProfile

Имя	Описание	Ценность
Изображения	Образы виртуальных машин в пуле.	PoolImage[] (обязательно)
добрый	Дискриминационное свойство Для FabricProfile.	Vmss (обязательный)
networkProfile	Сетевой профиль компьютеров в пуле.	NetworkProfile
osProfile	Профиль ОС компьютеров в пуле.	OsProfile
SKU	Номер SKU Azure для компьютеров в пуле.	DevOpsAzureSku (обязательно)
storageProfile	Профиль хранения компьютеров в пуле.	StorageProfile

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса пулов можно развернуть с помощью операций, предназначенных для следующих операций:

групп ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.DevOpsInfrastructure/pools, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevOpsInfrastructure/pools@2024-10-19"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      agentProfile = {
        resourcePredictions = ?
        resourcePredictionsProfile = {
          kind = "string"
          // For remaining properties, see ResourcePredictionsProfile objects
        }
        kind = "string"
        // For remaining properties, see AgentProfile objects
      }
      devCenterProjectResourceId = "string"
      fabricProfile = {
        kind = "string"
        // For remaining properties, see FabricProfile objects
      }
      maximumConcurrency = int
      organizationProfile = {
        kind = "string"
        // For remaining properties, see OrganizationProfile objects
      }
      provisioningState = "string"
    }
  })
}

Объекты FabricProfile

Задайте свойство типа, чтобы указать тип объекта.

Для vmssиспользуйте:

{
  images = [
    {
      aliases = [
        "string"
      ]
      buffer = "string"
      resourceId = "string"
      wellKnownImageName = "string"
    }
  ]
  kind = "Vmss"
  networkProfile = {
    subnetId = "string"
  }
  osProfile = {
    logonType = "string"
    secretsManagementSettings = {
      certificateStoreLocation = "string"
      keyExportable = bool
      observedCertificates = [
        "string"
      ]
    }
  }
  sku = {
    name = "string"
  }
  storageProfile = {
    dataDisks = [
      {
        caching = "string"
        diskSizeGiB = int
        driveLetter = "string"
        storageAccountType = "string"
      }
    ]
    osDiskStorageAccountType = "string"
  }
}

Объекты OrganizationProfile

Задайте свойство типа, чтобы указать тип объекта.

Для AzureDevOpsиспользуйте:

{
  kind = "AzureDevOps"
  organizations = [
    {
      parallelism = int
      projects = [
        "string"
      ]
      url = "string"
    }
  ]
  permissionProfile = {
    groups = [
      "string"
    ]
    kind = "string"
    users = [
      "string"
    ]
  }
}

Для GitHubиспользуйте:

{
  kind = "GitHub"
  organizations = [
    {
      repositories = [
        "string"
      ]
      url = "string"
    }
  ]
}

Объекты AgentProfile

Задайте свойство типа, чтобы указать тип объекта.

Для с отслеживанием состояния используйте:

{
  gracePeriodTimeSpan = "string"
  kind = "Stateful"
  maxAgentLifetime = "string"
}

Для без отслеживания состояния используйте:

{
  kind = "Stateless"
}

Объекты ResourcePredictionsProfile

Задайте свойство типа, чтобы указать тип объекта.

Для автоматическогоиспользуйте:

{
  kind = "Automatic"
  predictionPreference = "string"
}

Для вручнуюиспользуйте:

{
  kind = "Manual"
}

Значения свойств

AgentProfile

Имя	Описание	Ценность
добрый	Установите значение Stateful для типа с отслеживанием состояния. Установите значение Stateless для типа StatelessAgentProfile.	"Stateful" "Без отслеживания состояния" (обязательно)
resourcePredictions	Определяет буфер пула или автономные агенты.	любой
resourcePredictionsProfile	Определяет, как предоставляется буфер или автономный агент пула.	ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Имя	Описание	Ценность
добрый	Определяет способ предоставления автономной схемы.	"Автоматический" (обязательный)
прогнозированиеPreference	Определяет баланс между затратами и производительностью.	"Balanced" "BestPerformance" 'MoreCostEffective' "MorePerformance" "MostCostEffective"

AzureDevOpsOrganizationProfile

Имя	Описание	Ценность
добрый	Дискриминационное свойство для OrganizationProfile.	AzureDevOps (обязательно)
Организаций	Список организаций Azure DevOps, в которые должен присутствовать пул.	организации[] (обязательно)
permissionProfile	Тип разрешения, определяющего, какие учетные записи являются администраторами в пуле Azure DevOps.	AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Имя	Описание	Ценность
Группы	Групповые адреса электронной почты	string[]
добрый	Определяет, кто имеет разрешения администратора в пуле Azure DevOps.	CreatorOnly "Наследование" "SpecificAccounts" (обязательный)
Пользователей	Адреса электронной почты пользователя	string[]

DataDisk

Имя	Описание	Ценность
Кэширование	Тип кэширования для дисков данных. Значение по умолчанию для кэширования — readwrite. Сведения о параметрах кэширования см. в статье https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.	"Нет" "ReadOnly" ReadWrite
diskSizeGiB	Начальный размер диска в гигабайтах.	int
driveLetter	Буква диска для пустого диска данных. Если оно не указано, оно будет первым доступным письмом.	струна
storageAccountType	Тип учетной записи хранения, используемый для диска данных. Если опущено, значение по умолчанию — "standard_lrs".	"Premium_LRS" "Premium_ZRS" "StandardSSD_LRS" "StandardSSD_ZRS" "Standard_LRS"

DevOpsAzureSku

Имя	Описание	Ценность
имя	Имя SKU Azure для компьютеров в пуле.	строка (обязательно)

FabricProfile

Имя	Описание	Ценность
добрый	Установите значение Vmss для типа VmssFabricProfile.	Vmss (обязательный)

GitHubOrganization

Имя	Описание	Ценность
Репозитории	Необязательный список репозиториев, в которых должен быть создан пул.	string[]
URL-адрес	URL-адрес организации GitHub, в котором должен быть создан пул.	строка (обязательно)

GitHubOrganizationProfile

Имя	Описание	Ценность
добрый	Дискриминационное свойство для OrganizationProfile.	GitHub (обязательно)
Организаций	Список организаций и репозиториев GitHub, в который должен присутствовать пул.	GitHubOrganization[] (обязательно)

ManagedServiceIdentity

Имя	Описание	Ценность
тип	Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).	"Нет" SystemAssigned SystemAssigned, UserAssigned UserAssigned (обязательно)
userAssignedIdentities	Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах.	UserAssignedIdentities

ManualResourcePredictionsProfile

Имя	Описание	Ценность
добрый	Определяет способ предоставления автономной схемы.	"Вручную" (обязательно)

Microsoft.DevOpsInfrastructure/pools

Имя	Описание	Ценность
тождество	Удостоверения управляемой службы, назначенные этому ресурсу.	ManagedServiceIdentity
местоположение	Географическое расположение, в котором находится ресурс	строка (обязательно)
имя	Имя ресурса	струна Ограничения целостности: Pattern = `^[a-zA-Z0-9][a-zA-Z0-9-.]*$` (обязательно)
свойства	Свойства, относящиеся к ресурсу, для этого ресурса.	PoolProperties
Теги	Теги ресурсов	Словарь имен и значений тегов.
тип	Тип ресурса	"Microsoft.DevOpsInfrastructure/pools@2024-10-19"

NetworkProfile

Имя	Описание	Ценность
SubnetId	Идентификатор подсети, на котором будут помещены все компьютеры, созданные в пуле.	строка (обязательно)

Организация

Имя	Описание	Ценность
параллелизм	Сколько компьютеров можно создать в этой организации в максимальной мере из максимального количества компьютеров пула.	int
проекты	Необязательный список проектов, в которых должен быть создан пул.	string[]
URL-адрес	URL-адрес организации Azure DevOps, в котором необходимо создать пул.	строка (обязательно)

OrganizationProfile

Имя	Описание	Ценность
добрый	Установите значение "AzureDevOps" для типа AzureDevOpsOrganizationProfile. Установите значение GitHub для типа GitHubOrganizationProfile.	AzureDevOps GitHub (обязательно)

OsProfile

Имя	Описание	Ценность
вход в систему	Определяет, как должна выполняться служба. По умолчанию этот параметр будет иметь значение Service.	"Интерактивный" "Служба"
secretManagementSettings	Параметры управления секретами компьютеров в пуле.	SecretManagementSettings

PoolImage

Имя	Описание	Ценность
Псевдонимы	Список псевдонимов для ссылки на изображение.	string[]
буфер	Процент буфера, выделенного этому изображению.	струна
resourceId	Идентификатор ресурса изображения.	струна
wellKnownImageName	Изображение, используемое из известного набора образов, предоставляемых клиентам.	струна

PoolProperties

Имя	Описание	Ценность
agentProfile	Определяет способ обработки компьютера после выполнения задания.	AgentProfile (обязательно)
devCenterProjectResourceId	Идентификатор ресурса проекта DevCenter, к которому принадлежит пул.	строка (обязательно)
fabricProfile	Определяет тип структуры, на который будет работать агент.	FabricProfile (обязательно)
максимальное значениеConcurrency	Определяет, сколько ресурсов можно создавать в любое время.	int Ограничения целостности: Минимальное значение = 1 Максимальное значение = 10000 (обязательно)
organizationProfile	Определяет организацию, в которой будет использоваться пул.	OrganizationProfile (обязательно)
provisioningState	Состояние текущей операции.	"Принято" "Отменено" Удаление "Не удалось" Подготовка "Успешно" "Обновление"

ResourcePredictionsProfile

Имя	Описание	Ценность
добрый	Установите значение Automatic для типа AutomaticResourcePredictionsProfile. Установите значение "Вручную" для типа ManualResourcePredictionsProfile.	"Автоматически" "Вручную" (обязательно)

SecretManagementSettings

Имя	Описание	Ценность
certificateStoreLocation	Где хранить сертификаты на компьютере.	струна
keyExportable	Определяет, следует ли экспортировать ключ сертификатов.	bool (обязательно)
observedCertificates	Список сертификатов для установки на всех компьютерах в пуле.	string[] (обязательно)

С отслеживанием состояния

Имя	Описание	Ценность
gracePeriodTimeSpan	Сколько времени компьютер должен храниться вокруг после запуска рабочей нагрузки, когда не существует автономных агентов. Максимальное значение составляет одну неделю.	струна
добрый	Дискриминационные свойства для AgentProfile.	"Stateful" (обязательно)
maxAgentLifetime	Как долго должны храниться компьютеры с отслеживанием состояния. Максимальное значение составляет одну неделю.	струна

StatelessAgentProfile

Имя	Описание	Ценность
добрый	Дискриминационные свойства для AgentProfile.	"Без отслеживания состояния" (обязательно)

StorageProfile

Имя	Описание	Ценность
dataDisks	Список пустых дисков данных для подключения.	DataDisk[]
osDiskStorageAccountType	Имя SKU Azure для компьютеров в пуле.	"Премиум" "Стандартный" "StandardSSD"

TrackedResourceTags

Имя	Описание	Ценность

UserAssignedIdentities

Имя	Описание	Ценность

UserAssignedIdentity

Имя	Описание	Ценность

VmssFabricProfile

Имя	Описание	Ценность
Изображения	Образы виртуальных машин в пуле.	PoolImage[] (обязательно)
добрый	Дискриминационное свойство Для FabricProfile.	Vmss (обязательный)
networkProfile	Сетевой профиль компьютеров в пуле.	NetworkProfile
osProfile	Профиль ОС компьютеров в пуле.	OsProfile
SKU	Номер SKU Azure для компьютеров в пуле.	DevOpsAzureSku (обязательно)
storageProfile	Профиль хранения компьютеров в пуле.	StorageProfile

Поделиться через

Пулы Microsoft.DevOpsInfrastructure

Определение ресурсов Bicep

Формат ресурса

Объекты FabricProfile

Объекты OrganizationProfile

Объекты AgentProfile

Объекты ResourcePredictionsProfile

Значения свойств

AgentProfile

AutomaticResourcePredictionsProfile

AzureDevOpsOrganizationProfile

AzureDevOpsPermissionProfile

DataDisk

DevOpsAzureSku

FabricProfile

GitHubOrganization

GitHubOrganizationProfile

ManagedServiceIdentity

ManualResourcePredictionsProfile

Microsoft.DevOpsInfrastructure/pools

NetworkProfile

Организация

OrganizationProfile

OsProfile

PoolImage

PoolProperties

ResourcePredictionsProfile

SecretManagementSettings

С отслеживанием состояния

StatelessAgentProfile

StorageProfile

TrackedResourceTags

UserAssignedIdentities

UserAssignedIdentity

VmssFabricProfile

Определение ресурса шаблона ARM

Формат ресурса

Объекты FabricProfile

Объекты OrganizationProfile

Объекты AgentProfile

Объекты ResourcePredictionsProfile

Значения свойств

AgentProfile

AutomaticResourcePredictionsProfile

AzureDevOpsOrganizationProfile

AzureDevOpsPermissionProfile

DataDisk

DevOpsAzureSku

FabricProfile

GitHubOrganization

GitHubOrganizationProfile

ManagedServiceIdentity

ManualResourcePredictionsProfile

Microsoft.DevOpsInfrastructure/pools

NetworkProfile

Организация

OrganizationProfile

OsProfile

PoolImage

PoolProperties

ResourcePredictionsProfile

SecretManagementSettings

С отслеживанием состояния

StatelessAgentProfile

StorageProfile

TrackedResourceTags

UserAssignedIdentities

UserAssignedIdentity

VmssFabricProfile

Определение ресурса Terraform (поставщик AzAPI)

Формат ресурса

Объекты FabricProfile

Объекты OrganizationProfile

Объекты AgentProfile

Объекты ResourcePredictionsProfile

Значения свойств

AgentProfile

AutomaticResourcePredictionsProfile

AzureDevOpsOrganizationProfile