Microsoft.DevOpsInfrastructure 集區
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'
}
}
AgentProfile 物件
設定 種類 屬性,以指定對象的類型。
針對 具狀態,請使用:
{
gracePeriodTimeSpan: 'string'
kind: 'Stateful'
maxAgentLifetime: 'string'
}
針對 無狀態,請使用:
{
kind: 'Stateless'
}
ResourcePredictionsProfile 物件
設定 種類 屬性,以指定對象的類型。
針對 自動,請使用:
{
kind: 'Automatic'
predictionPreference: 'string'
}
針對 手動,請使用:
{
kind: 'Manual'
}
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
名字 | 描述 | 價值 |
---|---|---|
類 | 針對具狀態 類型設定為 [具狀態]。 針對 statelessAgentProfile 類型 設定為 'Stateless',。 | '具狀態' '無狀態' (必要) |
resourcePredictions | 定義集區緩衝區/待用代理程式。 | 任何 |
resourcePredictionsProfile | 定義如何提供集區緩衝區/待用代理程式。 | ResourcePredictionsProfile |
AutomaticResourcePredictionsProfile
名字 | 描述 | 價值 |
---|---|---|
類 | 決定應如何提供待用配置。 | 'Automatic' (必要) |
predictionPreference | 決定成本和效能之間的平衡。 | 'Balanced' 'BestPerformance' 'MoreCostEffective' 'MorePerformance' 'MostCostEffective' |
AzureDevOpsOrganizationProfile
名字 | 描述 | 價值 |
---|---|---|
類 | OrganizationProfile 的歧視性屬性。 | 'AzureDevOps' (必要) |
組織 | 集區應該位於的 Azure DevOps 組織清單。 | 組織[] (必要) |
permissionProfile | 決定 Azure DevOps 集區上哪些帳戶為系統管理員的許可權類型。 | AzureDevOpsPermissionProfile |
AzureDevOpsPermissionProfile
名字 | 描述 | 價值 |
---|---|---|
組 | 群組電子郵件位址 | string[] |
類 | 判斷誰具有 Azure DevOps 集區的管理員許可權。 | 'CreatorOnly' 'Inherit' 'SpecificAccounts' (必要) |
使用者 | 用戶電子郵件位址 | string[] |
DataDisk
名字 | 描述 | 價值 |
---|---|---|
緩存 | 要針對數據磁碟啟用的快取類型。 快取的預設值為 readwrite。 如需快取選項的相關信息,請參閱:https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/。 | 'None' 'ReadOnly' 'ReadWrite' |
diskSizeGiB | 以 GB 為單位的初始磁碟大小。 | int |
driveLetter | 空數據磁碟的驅動器號。 如果未指定,則會是第一個可用的字母。 | 字串 |
storageAccountType | 要用於數據磁碟的記憶體帳戶類型。 如果省略,預設值為 「standard_lrs」。。 | 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' |
DevOpsAzureSku
名字 | 描述 | 價值 |
---|---|---|
名字 | 集區中機器的 Azure SKU 名稱。 | 字串 (必要) |
FabricProfile
名字 | 描述 | 價值 |
---|---|---|
類 | 針對 vmssFabricProfile 類型 設定為 'Vmss',。 | 'Vmss' (必要) |
GitHubOrganization
名字 | 描述 | 價值 |
---|---|---|
存儲庫 | 應在其中建立集區之存放庫的選擇性清單。 | string[] |
url | 應該在其中建立集區的 GitHub 組織 URL。 | 字串 (必要) |
GitHubOrganizationProfile
名字 | 描述 | 價值 |
---|---|---|
類 | OrganizationProfile 的歧視性屬性。 | 'GitHub' (必要) |
組織 | 集區應該存在於的 GitHub 組織/存放庫清單。 | GitHubOrganization[] (必要) |
ManagedServiceIdentity
名字 | 描述 | 價值 |
---|---|---|
類型 | 受控服務識別的類型(允許 SystemAssigned 和 UserAssigned 類型)。 | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (必要) |
userAssignedIdentities | 與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是要求中的空白物件({})。 | UserAssignedIdentities |
ManualResourcePredictionsProfile
名字 | 描述 | 價值 |
---|---|---|
類 | 決定應如何提供待用配置。 | 'Manual' (必要) |
Microsoft.DevOpsInfrastructure/pools
名字 | 描述 | 價值 |
---|---|---|
身份 | 指派給此資源的受控服務識別。 | ManagedServiceIdentity |
位置 | 資源所在的地理位置 | 字串 (必要) |
名字 | 資源名稱 | 字串 約束: 模式 = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (必要) |
性能 | 此資源的資源特定屬性。 | PoolProperties |
標籤 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
NetworkProfile
名字 | 描述 | 價值 |
---|---|---|
subnetId | 要在其中放置集區中建立之所有計算機的子網標識碼。 | 字串 (必要) |
組織
名字 | 描述 | 價值 |
---|---|---|
排比 | 此組織中最多可以建立多少部機器,而集區的最大並行。 | int |
專案 | 應在其中建立集區的選擇性項目清單。 | string[] |
url | 應該在其中建立集區的 Azure DevOps 組織 URL。 | 字串 (必要) |
OrganizationProfile
名字 | 描述 | 價值 |
---|---|---|
類 | 針對 AzureDevOpsOrganizationProfile 類型設定為 'AzureDevOps',。 針對 gitHubOrganizationProfile 類型 設定為 'GitHub',。 | 'AzureDevOps' 'GitHub' (必要) |
OsProfile
名字 | 描述 | 價值 |
---|---|---|
logonType | 決定應該如何執行服務。 根據預設,這會設定為 [服務]。 | 'Interactive' 'Service' |
secretsManagementSettings | 集區中機器的秘密管理設定。 | SecretsManagementSettings |
PoolImage
名字 | 描述 | 價值 |
---|---|---|
別名 | 要參考影像的別名清單。 | string[] |
緩衝區 | 要配置給此映像之緩衝區的百分比。 | 字串 |
resourceId | 影像的資源標識碼。 | 字串 |
wellKnownImageName | 要從提供給客戶的一組已知映像中使用的映像。 | 字串 |
PoolProperties
名字 | 描述 | 價值 |
---|---|---|
agentProfile | 定義機器在執行作業後將如何處理。 | AgentProfile (必要) |
devCenterProjectResourceId | 集區所屬DevCenter Project的資源標識碼。 | 字串 (必要) |
fabricProfile | 定義代理程式將執行的網狀架構類型。 | FabricProfile (必要) |
maximumConcurrency | 定義在任何指定時間可以建立多少資源。 | int 約束: 最小值 = 1 最大值 = 10000 (必要) |
organizationProfile | 定義將使用集區的組織。 | OrganizationProfile (必要) |
provisioningState | 目前作業的狀態。 | 'Accepted' 'Canceled' '刪除' 'Failed' 'Provisioning' 'Succeeded' 'Updateing' |
ResourcePredictionsProfile
名字 | 描述 | 價值 |
---|---|---|
類 | 將 類型設定為 'Automatic',AutomaticResourcePredictionsProfile。 將 類型設定為 'Manual',ManualResourcePredictionsProfile。 | 'Automatic' 'Manual' (必要) |
SecretsManagementSettings
名字 | 描述 | 價值 |
---|---|---|
certificateStoreLocation | 在機器上儲存憑證的位置。 | 字串 |
keyExportable | 定義憑證的金鑰是否應該可匯出。 | 布林 (必要) |
observedCertificates | 要安裝在集區中所有機器上的憑證清單。 | string[] (必要) |
狀態
名字 | 描述 | 價值 |
---|---|---|
gracePeriodTimeSpan | 當沒有待用代理程式時,機器在執行工作負載之後,應該保留多久的時間。 最大值為一周。 | 字串 |
類 | AgentProfile 的歧視性屬性。 | '具狀態' (必要) |
maxAgentLifetime | 狀態機器應該保留多久的時間。 最大值為一周。 | 字串 |
StatelessAgentProfile
名字 | 描述 | 價值 |
---|---|---|
類 | AgentProfile 的歧視性屬性。 | '無狀態' (必要) |
StorageProfile
名字 | 描述 | 價值 |
---|---|---|
dataDisks | 要連結的空白數據磁碟清單。 | DataDisk[] |
osDiskStorageAccountType | 集區中機器的 Azure SKU 名稱。 | 'Premium' 'Standard' 'StandardSSD' |
TrackedResourceTags
名字 | 描述 | 價值 |
---|
UserAssignedIdentities
名字 | 描述 | 價值 |
---|
UserAssignedIdentity
名字 | 描述 | 價值 |
---|
VmssFabricProfile
名字 | 描述 | 價值 |
---|---|---|
圖像 | 集區中機器的 VM 映像。 | PoolImage[] (必要) |
類 | FabricProfile 的歧視性屬性。 | 'Vmss' (必要) |
networkProfile | 集區中機器的網路配置檔。 | NetworkProfile |
osProfile | 集區中機器的OS配置檔。 | OsProfile |
sku | 集區中機器的 Azure SKU。 | 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"
}
}
AgentProfile 物件
設定 種類 屬性,以指定對象的類型。
針對 具狀態,請使用:
{
"gracePeriodTimeSpan": "string",
"kind": "Stateful",
"maxAgentLifetime": "string"
}
針對 無狀態,請使用:
{
"kind": "Stateless"
}
ResourcePredictionsProfile 物件
設定 種類 屬性,以指定對象的類型。
針對 自動,請使用:
{
"kind": "Automatic",
"predictionPreference": "string"
}
針對 手動,請使用:
{
"kind": "Manual"
}
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
名字 | 描述 | 價值 |
---|---|---|
類 | 針對具狀態 類型設定為 [具狀態]。 針對 statelessAgentProfile 類型 設定為 'Stateless',。 | '具狀態' '無狀態' (必要) |
resourcePredictions | 定義集區緩衝區/待用代理程式。 | 任何 |
resourcePredictionsProfile | 定義如何提供集區緩衝區/待用代理程式。 | ResourcePredictionsProfile |
AutomaticResourcePredictionsProfile
名字 | 描述 | 價值 |
---|---|---|
類 | 決定應如何提供待用配置。 | 'Automatic' (必要) |
predictionPreference | 決定成本和效能之間的平衡。 | 'Balanced' 'BestPerformance' 'MoreCostEffective' 'MorePerformance' 'MostCostEffective' |
AzureDevOpsOrganizationProfile
名字 | 描述 | 價值 |
---|---|---|
類 | OrganizationProfile 的歧視性屬性。 | 'AzureDevOps' (必要) |
組織 | 集區應該位於的 Azure DevOps 組織清單。 | 組織[] (必要) |
permissionProfile | 決定 Azure DevOps 集區上哪些帳戶為系統管理員的許可權類型。 | AzureDevOpsPermissionProfile |
AzureDevOpsPermissionProfile
名字 | 描述 | 價值 |
---|---|---|
組 | 群組電子郵件位址 | string[] |
類 | 判斷誰具有 Azure DevOps 集區的管理員許可權。 | 'CreatorOnly' 'Inherit' 'SpecificAccounts' (必要) |
使用者 | 用戶電子郵件位址 | string[] |
DataDisk
名字 | 描述 | 價值 |
---|---|---|
緩存 | 要針對數據磁碟啟用的快取類型。 快取的預設值為 readwrite。 如需快取選項的相關信息,請參閱:https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/。 | 'None' 'ReadOnly' 'ReadWrite' |
diskSizeGiB | 以 GB 為單位的初始磁碟大小。 | int |
driveLetter | 空數據磁碟的驅動器號。 如果未指定,則會是第一個可用的字母。 | 字串 |
storageAccountType | 要用於數據磁碟的記憶體帳戶類型。 如果省略,預設值為 「standard_lrs」。。 | 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' |
DevOpsAzureSku
名字 | 描述 | 價值 |
---|---|---|
名字 | 集區中機器的 Azure SKU 名稱。 | 字串 (必要) |
FabricProfile
名字 | 描述 | 價值 |
---|---|---|
類 | 針對 vmssFabricProfile 類型 設定為 'Vmss',。 | 'Vmss' (必要) |
GitHubOrganization
名字 | 描述 | 價值 |
---|---|---|
存儲庫 | 應在其中建立集區之存放庫的選擇性清單。 | string[] |
url | 應該在其中建立集區的 GitHub 組織 URL。 | 字串 (必要) |
GitHubOrganizationProfile
名字 | 描述 | 價值 |
---|---|---|
類 | OrganizationProfile 的歧視性屬性。 | 'GitHub' (必要) |
組織 | 集區應該存在於的 GitHub 組織/存放庫清單。 | GitHubOrganization[] (必要) |
ManagedServiceIdentity
名字 | 描述 | 價值 |
---|---|---|
類型 | 受控服務識別的類型(允許 SystemAssigned 和 UserAssigned 類型)。 | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (必要) |
userAssignedIdentities | 與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是要求中的空白物件({})。 | UserAssignedIdentities |
ManualResourcePredictionsProfile
名字 | 描述 | 價值 |
---|---|---|
類 | 決定應如何提供待用配置。 | 'Manual' (必要) |
Microsoft.DevOpsInfrastructure/pools
名字 | 描述 | 價值 |
---|---|---|
apiVersion | API 版本 | '2024-10-19' |
身份 | 指派給此資源的受控服務識別。 | ManagedServiceIdentity |
位置 | 資源所在的地理位置 | 字串 (必要) |
名字 | 資源名稱 | 字串 約束: 模式 = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (必要) |
性能 | 此資源的資源特定屬性。 | PoolProperties |
標籤 | 資源標籤 | 標記名稱和值的字典。 請參閱範本中的 標籤 |
類型 | 資源類型 | 'Microsoft.DevOpsInfrastructure/pools' |
NetworkProfile
名字 | 描述 | 價值 |
---|---|---|
subnetId | 要在其中放置集區中建立之所有計算機的子網標識碼。 | 字串 (必要) |
組織
名字 | 描述 | 價值 |
---|---|---|
排比 | 此組織中最多可以建立多少部機器,而集區的最大並行。 | int |
專案 | 應在其中建立集區的選擇性項目清單。 | string[] |
url | 應該在其中建立集區的 Azure DevOps 組織 URL。 | 字串 (必要) |
OrganizationProfile
名字 | 描述 | 價值 |
---|---|---|
類 | 針對 AzureDevOpsOrganizationProfile 類型設定為 'AzureDevOps',。 針對 gitHubOrganizationProfile 類型 設定為 'GitHub',。 | 'AzureDevOps' 'GitHub' (必要) |
OsProfile
名字 | 描述 | 價值 |
---|---|---|
logonType | 決定應該如何執行服務。 根據預設,這會設定為 [服務]。 | 'Interactive' 'Service' |
secretsManagementSettings | 集區中機器的秘密管理設定。 | SecretsManagementSettings |
PoolImage
名字 | 描述 | 價值 |
---|---|---|
別名 | 要參考影像的別名清單。 | string[] |
緩衝區 | 要配置給此映像之緩衝區的百分比。 | 字串 |
resourceId | 影像的資源標識碼。 | 字串 |
wellKnownImageName | 要從提供給客戶的一組已知映像中使用的映像。 | 字串 |
PoolProperties
名字 | 描述 | 價值 |
---|---|---|
agentProfile | 定義機器在執行作業後將如何處理。 | AgentProfile (必要) |
devCenterProjectResourceId | 集區所屬DevCenter Project的資源標識碼。 | 字串 (必要) |
fabricProfile | 定義代理程式將執行的網狀架構類型。 | FabricProfile (必要) |
maximumConcurrency | 定義在任何指定時間可以建立多少資源。 | int 約束: 最小值 = 1 最大值 = 10000 (必要) |
organizationProfile | 定義將使用集區的組織。 | OrganizationProfile (必要) |
provisioningState | 目前作業的狀態。 | 'Accepted' 'Canceled' '刪除' 'Failed' 'Provisioning' 'Succeeded' 'Updateing' |
ResourcePredictionsProfile
名字 | 描述 | 價值 |
---|---|---|
類 | 將 類型設定為 'Automatic',AutomaticResourcePredictionsProfile。 將 類型設定為 'Manual',ManualResourcePredictionsProfile。 | 'Automatic' 'Manual' (必要) |
SecretsManagementSettings
名字 | 描述 | 價值 |
---|---|---|
certificateStoreLocation | 在機器上儲存憑證的位置。 | 字串 |
keyExportable | 定義憑證的金鑰是否應該可匯出。 | 布林 (必要) |
observedCertificates | 要安裝在集區中所有機器上的憑證清單。 | string[] (必要) |
狀態
名字 | 描述 | 價值 |
---|---|---|
gracePeriodTimeSpan | 當沒有待用代理程式時,機器在執行工作負載之後,應該保留多久的時間。 最大值為一周。 | 字串 |
類 | AgentProfile 的歧視性屬性。 | '具狀態' (必要) |
maxAgentLifetime | 狀態機器應該保留多久的時間。 最大值為一周。 | 字串 |
StatelessAgentProfile
名字 | 描述 | 價值 |
---|---|---|
類 | AgentProfile 的歧視性屬性。 | '無狀態' (必要) |
StorageProfile
名字 | 描述 | 價值 |
---|---|---|
dataDisks | 要連結的空白數據磁碟清單。 | DataDisk[] |
osDiskStorageAccountType | 集區中機器的 Azure SKU 名稱。 | 'Premium' 'Standard' 'StandardSSD' |
TrackedResourceTags
名字 | 描述 | 價值 |
---|
UserAssignedIdentities
名字 | 描述 | 價值 |
---|
UserAssignedIdentity
名字 | 描述 | 價值 |
---|
VmssFabricProfile
名字 | 描述 | 價值 |
---|---|---|
圖像 | 集區中機器的 VM 映像。 | PoolImage[] (必要) |
類 | FabricProfile 的歧視性屬性。 | 'Vmss' (必要) |
networkProfile | 集區中機器的網路配置檔。 | NetworkProfile |
osProfile | 集區中機器的OS配置檔。 | OsProfile |
sku | 集區中機器的 Azure SKU。 | 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"
}
})
}
AgentProfile 物件
設定 種類 屬性,以指定對象的類型。
針對 具狀態,請使用:
{
gracePeriodTimeSpan = "string"
kind = "Stateful"
maxAgentLifetime = "string"
}
針對 無狀態,請使用:
{
kind = "Stateless"
}
ResourcePredictionsProfile 物件
設定 種類 屬性,以指定對象的類型。
針對 自動,請使用:
{
kind = "Automatic"
predictionPreference = "string"
}
針對 手動,請使用:
{
kind = "Manual"
}
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
名字 | 描述 | 價值 |
---|---|---|
類 | 針對具狀態 類型設定為 [具狀態]。 針對 statelessAgentProfile 類型 設定為 'Stateless',。 | '具狀態' '無狀態' (必要) |
resourcePredictions | 定義集區緩衝區/待用代理程式。 | 任何 |
resourcePredictionsProfile | 定義如何提供集區緩衝區/待用代理程式。 | ResourcePredictionsProfile |
AutomaticResourcePredictionsProfile
名字 | 描述 | 價值 |
---|---|---|
類 | 決定應如何提供待用配置。 | 'Automatic' (必要) |
predictionPreference | 決定成本和效能之間的平衡。 | 'Balanced' 'BestPerformance' 'MoreCostEffective' 'MorePerformance' 'MostCostEffective' |
AzureDevOpsOrganizationProfile
名字 | 描述 | 價值 |
---|---|---|
類 | OrganizationProfile 的歧視性屬性。 | 'AzureDevOps' (必要) |
組織 | 集區應該位於的 Azure DevOps 組織清單。 | 組織[] (必要) |
permissionProfile | 決定 Azure DevOps 集區上哪些帳戶為系統管理員的許可權類型。 | AzureDevOpsPermissionProfile |
AzureDevOpsPermissionProfile
名字 | 描述 | 價值 |
---|---|---|
組 | 群組電子郵件位址 | string[] |
類 | 判斷誰具有 Azure DevOps 集區的管理員許可權。 | 'CreatorOnly' 'Inherit' 'SpecificAccounts' (必要) |
使用者 | 用戶電子郵件位址 | string[] |
DataDisk
名字 | 描述 | 價值 |
---|---|---|
緩存 | 要針對數據磁碟啟用的快取類型。 快取的預設值為 readwrite。 如需快取選項的相關信息,請參閱:https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/。 | 'None' 'ReadOnly' 'ReadWrite' |
diskSizeGiB | 以 GB 為單位的初始磁碟大小。 | int |
driveLetter | 空數據磁碟的驅動器號。 如果未指定,則會是第一個可用的字母。 | 字串 |
storageAccountType | 要用於數據磁碟的記憶體帳戶類型。 如果省略,預設值為 「standard_lrs」。。 | 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' |
DevOpsAzureSku
名字 | 描述 | 價值 |
---|---|---|
名字 | 集區中機器的 Azure SKU 名稱。 | 字串 (必要) |
FabricProfile
名字 | 描述 | 價值 |
---|---|---|
類 | 針對 vmssFabricProfile 類型 設定為 'Vmss',。 | 'Vmss' (必要) |
GitHubOrganization
名字 | 描述 | 價值 |
---|---|---|
存儲庫 | 應在其中建立集區之存放庫的選擇性清單。 | string[] |
url | 應該在其中建立集區的 GitHub 組織 URL。 | 字串 (必要) |
GitHubOrganizationProfile
名字 | 描述 | 價值 |
---|---|---|
類 | OrganizationProfile 的歧視性屬性。 | 'GitHub' (必要) |
組織 | 集區應該存在於的 GitHub 組織/存放庫清單。 | GitHubOrganization[] (必要) |
ManagedServiceIdentity
名字 | 描述 | 價值 |
---|---|---|
類型 | 受控服務識別的類型(允許 SystemAssigned 和 UserAssigned 類型)。 | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (必要) |
userAssignedIdentities | 與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是要求中的空白物件({})。 | UserAssignedIdentities |
ManualResourcePredictionsProfile
名字 | 描述 | 價值 |
---|---|---|
類 | 決定應如何提供待用配置。 | 'Manual' (必要) |
Microsoft.DevOpsInfrastructure/pools
名字 | 描述 | 價值 |
---|---|---|
身份 | 指派給此資源的受控服務識別。 | ManagedServiceIdentity |
位置 | 資源所在的地理位置 | 字串 (必要) |
名字 | 資源名稱 | 字串 約束: 模式 = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (必要) |
性能 | 此資源的資源特定屬性。 | PoolProperties |
標籤 | 資源標籤 | 標記名稱和值的字典。 |
類型 | 資源類型 | “Microsoft.DevOpsInfrastructure/pools@2024-10-19” |
NetworkProfile
名字 | 描述 | 價值 |
---|---|---|
subnetId | 要在其中放置集區中建立之所有計算機的子網標識碼。 | 字串 (必要) |
組織
名字 | 描述 | 價值 |
---|---|---|
排比 | 此組織中最多可以建立多少部機器,而集區的最大並行。 | int |
專案 | 應在其中建立集區的選擇性項目清單。 | string[] |
url | 應該在其中建立集區的 Azure DevOps 組織 URL。 | 字串 (必要) |
OrganizationProfile
名字 | 描述 | 價值 |
---|---|---|
類 | 針對 AzureDevOpsOrganizationProfile 類型設定為 'AzureDevOps',。 針對 gitHubOrganizationProfile 類型 設定為 'GitHub',。 | 'AzureDevOps' 'GitHub' (必要) |
OsProfile
名字 | 描述 | 價值 |
---|---|---|
logonType | 決定應該如何執行服務。 根據預設,這會設定為 [服務]。 | 'Interactive' 'Service' |
secretsManagementSettings | 集區中機器的秘密管理設定。 | SecretsManagementSettings |
PoolImage
名字 | 描述 | 價值 |
---|---|---|
別名 | 要參考影像的別名清單。 | string[] |
緩衝區 | 要配置給此映像之緩衝區的百分比。 | 字串 |
resourceId | 影像的資源標識碼。 | 字串 |
wellKnownImageName | 要從提供給客戶的一組已知映像中使用的映像。 | 字串 |
PoolProperties
名字 | 描述 | 價值 |
---|---|---|
agentProfile | 定義機器在執行作業後將如何處理。 | AgentProfile (必要) |
devCenterProjectResourceId | 集區所屬DevCenter Project的資源標識碼。 | 字串 (必要) |
fabricProfile | 定義代理程式將執行的網狀架構類型。 | FabricProfile (必要) |
maximumConcurrency | 定義在任何指定時間可以建立多少資源。 | int 約束: 最小值 = 1 最大值 = 10000 (必要) |
organizationProfile | 定義將使用集區的組織。 | OrganizationProfile (必要) |
provisioningState | 目前作業的狀態。 | 'Accepted' 'Canceled' '刪除' 'Failed' 'Provisioning' 'Succeeded' 'Updateing' |
ResourcePredictionsProfile
名字 | 描述 | 價值 |
---|---|---|
類 | 將 類型設定為 'Automatic',AutomaticResourcePredictionsProfile。 將 類型設定為 'Manual',ManualResourcePredictionsProfile。 | 'Automatic' 'Manual' (必要) |
SecretsManagementSettings
名字 | 描述 | 價值 |
---|---|---|
certificateStoreLocation | 在機器上儲存憑證的位置。 | 字串 |
keyExportable | 定義憑證的金鑰是否應該可匯出。 | 布林 (必要) |
observedCertificates | 要安裝在集區中所有機器上的憑證清單。 | string[] (必要) |
狀態
名字 | 描述 | 價值 |
---|---|---|
gracePeriodTimeSpan | 當沒有待用代理程式時,機器在執行工作負載之後,應該保留多久的時間。 最大值為一周。 | 字串 |
類 | AgentProfile 的歧視性屬性。 | '具狀態' (必要) |
maxAgentLifetime | 狀態機器應該保留多久的時間。 最大值為一周。 | 字串 |
StatelessAgentProfile
名字 | 描述 | 價值 |
---|---|---|
類 | AgentProfile 的歧視性屬性。 | '無狀態' (必要) |
StorageProfile
名字 | 描述 | 價值 |
---|---|---|
dataDisks | 要連結的空白數據磁碟清單。 | DataDisk[] |
osDiskStorageAccountType | 集區中機器的 Azure SKU 名稱。 | 'Premium' 'Standard' 'StandardSSD' |
TrackedResourceTags
名字 | 描述 | 價值 |
---|
UserAssignedIdentities
名字 | 描述 | 價值 |
---|
UserAssignedIdentity
名字 | 描述 | 價值 |
---|
VmssFabricProfile
名字 | 描述 | 價值 |
---|---|---|
圖像 | 集區中機器的 VM 映像。 | PoolImage[] (必要) |
類 | FabricProfile 的歧視性屬性。 | 'Vmss' (必要) |
networkProfile | 集區中機器的網路配置檔。 | NetworkProfile |
osProfile | 集區中機器的OS配置檔。 | OsProfile |
sku | 集區中機器的 Azure SKU。 | DevOpsAzureSku (必要) |
storageProfile | 集區中機器的記憶體配置檔。 | StorageProfile |