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'
}
}
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' (必須) |
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 | 初期ディスク サイズ (ギガバイト単位)。 | int |
driveLetter | 空のデータ ディスクのドライブ文字。 指定しない場合は、最初に使用可能な文字になります。 | 糸 |
storageAccountType | データ ディスクに使用するストレージ アカウントの種類。 省略した場合、既定値は "standard_lrs" です。 | 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' |
DevOpsAzureSku
名前 | 形容 | 価値 |
---|---|---|
名前 | プール内のマシンの Azure SKU 名。 | string (必須) |
FabricProfile
名前 | 形容 | 価値 |
---|---|---|
種類 | VmssFabricProfileの種類 |
'Vmss' (必須) |
GitHubOrganization
名前 | 形容 | 価値 |
---|---|---|
リポジトリ | プールを作成する必要があるリポジトリの省略可能な一覧。 | string[] |
url | プールを作成する GitHub 組織の URL。 | string (必須) |
GitHubOrganizationProfile
名前 | 形容 | 価値 |
---|---|---|
種類 | OrganizationProfile の識別子プロパティ。 | 'GitHub' (必須) |
組織 | プールが存在する必要がある GitHub 組織/リポジトリの一覧。 | GitHubOrganization[] (必須) |
ManagedServiceIdentity
名前 | 形容 | 価値 |
---|---|---|
種類 | マネージド サービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。 | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (必須) |
userAssignedIdentities | リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリ キーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。 ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。 | UserAssignedIdentities の |
ManualResourcePredictionsProfile
名前 | 形容 | 価値 |
---|---|---|
種類 | スタンバイ スキームを提供する方法を決定します。 | 'Manual' (必須) |
Microsoft.DevOpsInfrastructure/pools
名前 | 形容 | 価値 |
---|---|---|
同一性 | このリソースに割り当てられているマネージド サービス ID。 | ManagedServiceIdentity の |
場所 | リソースが存在する地理的な場所 | string (必須) |
名前 | リソース名 | 糸 制約: パターン = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (必須) |
プロパティ | このリソースのリソース固有のプロパティ。 | PoolProperties |
タグ | リソース タグ | タグ名と値のディクショナリ。 テンプレート の |
NetworkProfile
名前 | 形容 | 価値 |
---|---|---|
subnetId | プールに作成されたすべてのマシンを配置するサブネット ID。 | string (必須) |
組織
名前 | 形容 | 価値 |
---|---|---|
平行 | プールの最大コンキュラージェンシーのうち、この組織内で最大で作成できるマシンの数。 | int |
プロジェクト | プールを作成する必要があるプロジェクトの省略可能な一覧。 | string[] |
url | プールを作成する必要がある Azure DevOps 組織の URL。 | string (必須) |
OrganizationProfile
名前 | 形容 | 価値 |
---|---|---|
種類 | AzureDevOpsOrganizationProfileの型 |
'AzureDevOps' 'GitHub' (必須) |
OsProfile
名前 | 形容 | 価値 |
---|---|---|
logonType | サービスの実行方法を決定します。 既定では、これはサービスに設定されます。 | 'Interactive' 'Service' |
secretsManagementSettings | プール内のマシンのシークレット管理設定。 | SecretsManagementSettings |
PoolImage
名前 | 形容 | 価値 |
---|---|---|
エイリアス | イメージを参照するエイリアスの一覧。 | string[] |
バッファ | このイメージに割り当てられるバッファーの割合。 | 糸 |
resourceId | イメージのリソース ID。 | 糸 |
wellKnownImageName | ユーザーが利用できる既知の画像セットから使用する画像。 | 糸 |
PoolProperties
名前 | 形容 | 価値 |
---|---|---|
agentProfile | ジョブを実行した後のマシンの処理方法を定義します。 | AgentProfile (必須) |
devCenterProjectResourceId | プールが属する DevCenter プロジェクトのリソース ID。 | string (必須) |
fabricProfile | エージェントが実行されるファブリックの種類を定義します。 | FabricProfile (必須) |
maximumConcurrency | 任意の時点で作成できるリソースの数を定義します。 | int 制約: 最小値 = 1 最大値 = 10000 (必須) |
organizationProfile | プールを使用する組織を定義します。 | OrganizationProfile (必須) |
provisioningState | 現在の操作の状態。 | 'Accepted' 'Canceled' '削除中' 'Failed' 'プロビジョニング' 'Succeeded' '更新中' |
ResourcePredictionsProfile
名前 | 形容 | 価値 |
---|---|---|
種類 | AutomaticResourcePredictionsProfileの型 |
'Automatic' 'Manual' (必須) |
SecretsManagementSettings
名前 | 形容 | 価値 |
---|---|---|
certificateStoreLocation | コンピューターに証明書を格納する場所。 | 糸 |
keyExportable | 証明書のキーをエクスポート可能にするかどうかを定義します。 | bool (必須) |
observedCertificates | プール内のすべてのマシンにインストールする証明書の一覧。 | string[] (必須) |
ステートフル
名前 | 形容 | 価値 |
---|---|---|
gracePeriodTimeSpan | スタンバイ エージェントがない場合に、ワークロードを実行した後にマシンを保持する必要がある時間。 最大値は 1 週間です。 | 糸 |
種類 | AgentProfile の識別子プロパティ。 | 'Stateful' (必須) |
maxAgentLifetime | ステートフル マシンを保持する期間。 最大値は 1 週間です。 | 糸 |
StatelessAgentProfile
名前 | 形容 | 価値 |
---|---|---|
種類 | AgentProfile の識別子プロパティ。 | 'Stateless' (必須) |
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"
}
}
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' (必須) |
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 | 初期ディスク サイズ (ギガバイト単位)。 | int |
driveLetter | 空のデータ ディスクのドライブ文字。 指定しない場合は、最初に使用可能な文字になります。 | 糸 |
storageAccountType | データ ディスクに使用するストレージ アカウントの種類。 省略した場合、既定値は "standard_lrs" です。 | 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' |
DevOpsAzureSku
名前 | 形容 | 価値 |
---|---|---|
名前 | プール内のマシンの Azure SKU 名。 | string (必須) |
FabricProfile
名前 | 形容 | 価値 |
---|---|---|
種類 | VmssFabricProfileの種類 |
'Vmss' (必須) |
GitHubOrganization
名前 | 形容 | 価値 |
---|---|---|
リポジトリ | プールを作成する必要があるリポジトリの省略可能な一覧。 | string[] |
url | プールを作成する GitHub 組織の URL。 | string (必須) |
GitHubOrganizationProfile
名前 | 形容 | 価値 |
---|---|---|
種類 | OrganizationProfile の識別子プロパティ。 | 'GitHub' (必須) |
組織 | プールが存在する必要がある GitHub 組織/リポジトリの一覧。 | GitHubOrganization[] (必須) |
ManagedServiceIdentity
名前 | 形容 | 価値 |
---|---|---|
種類 | マネージド サービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。 | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (必須) |
userAssignedIdentities | リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリ キーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。 ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。 | UserAssignedIdentities の |
ManualResourcePredictionsProfile
名前 | 形容 | 価値 |
---|---|---|
種類 | スタンバイ スキームを提供する方法を決定します。 | 'Manual' (必須) |
Microsoft.DevOpsInfrastructure/pools
名前 | 形容 | 価値 |
---|---|---|
apiVersion | API のバージョン | '2024-10-19' |
同一性 | このリソースに割り当てられているマネージド サービス ID。 | ManagedServiceIdentity の |
場所 | リソースが存在する地理的な場所 | string (必須) |
名前 | リソース名 | 糸 制約: パターン = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (必須) |
プロパティ | このリソースのリソース固有のプロパティ。 | PoolProperties |
タグ | リソース タグ | タグ名と値のディクショナリ。 テンプレート の |
種類 | リソースの種類 | 'Microsoft.DevOpsInfrastructure/pools' |
NetworkProfile
名前 | 形容 | 価値 |
---|---|---|
subnetId | プールに作成されたすべてのマシンを配置するサブネット ID。 | string (必須) |
組織
名前 | 形容 | 価値 |
---|---|---|
平行 | プールの最大コンキュラージェンシーのうち、この組織内で最大で作成できるマシンの数。 | int |
プロジェクト | プールを作成する必要があるプロジェクトの省略可能な一覧。 | string[] |
url | プールを作成する必要がある Azure DevOps 組織の URL。 | string (必須) |
OrganizationProfile
名前 | 形容 | 価値 |
---|---|---|
種類 | AzureDevOpsOrganizationProfileの型 |
'AzureDevOps' 'GitHub' (必須) |
OsProfile
名前 | 形容 | 価値 |
---|---|---|
logonType | サービスの実行方法を決定します。 既定では、これはサービスに設定されます。 | 'Interactive' 'Service' |
secretsManagementSettings | プール内のマシンのシークレット管理設定。 | SecretsManagementSettings |
PoolImage
名前 | 形容 | 価値 |
---|---|---|
エイリアス | イメージを参照するエイリアスの一覧。 | string[] |
バッファ | このイメージに割り当てられるバッファーの割合。 | 糸 |
resourceId | イメージのリソース ID。 | 糸 |
wellKnownImageName | ユーザーが利用できる既知の画像セットから使用する画像。 | 糸 |
PoolProperties
名前 | 形容 | 価値 |
---|---|---|
agentProfile | ジョブを実行した後のマシンの処理方法を定義します。 | AgentProfile (必須) |
devCenterProjectResourceId | プールが属する DevCenter プロジェクトのリソース ID。 | string (必須) |
fabricProfile | エージェントが実行されるファブリックの種類を定義します。 | FabricProfile (必須) |
maximumConcurrency | 任意の時点で作成できるリソースの数を定義します。 | int 制約: 最小値 = 1 最大値 = 10000 (必須) |
organizationProfile | プールを使用する組織を定義します。 | OrganizationProfile (必須) |
provisioningState | 現在の操作の状態。 | 'Accepted' 'Canceled' '削除中' 'Failed' 'プロビジョニング' 'Succeeded' '更新中' |
ResourcePredictionsProfile
名前 | 形容 | 価値 |
---|---|---|
種類 | AutomaticResourcePredictionsProfileの型 |
'Automatic' 'Manual' (必須) |
SecretsManagementSettings
名前 | 形容 | 価値 |
---|---|---|
certificateStoreLocation | コンピューターに証明書を格納する場所。 | 糸 |
keyExportable | 証明書のキーをエクスポート可能にするかどうかを定義します。 | bool (必須) |
observedCertificates | プール内のすべてのマシンにインストールする証明書の一覧。 | string[] (必須) |
ステートフル
名前 | 形容 | 価値 |
---|---|---|
gracePeriodTimeSpan | スタンバイ エージェントがない場合に、ワークロードを実行した後にマシンを保持する必要がある時間。 最大値は 1 週間です。 | 糸 |
種類 | AgentProfile の識別子プロパティ。 | 'Stateful' (必須) |
maxAgentLifetime | ステートフル マシンを保持する期間。 最大値は 1 週間です。 | 糸 |
StatelessAgentProfile
名前 | 形容 | 価値 |
---|---|---|
種類 | AgentProfile の識別子プロパティ。 | 'Stateless' (必須) |
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"
}
})
}
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' (必須) |
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 | 初期ディスク サイズ (ギガバイト単位)。 | int |
driveLetter | 空のデータ ディスクのドライブ文字。 指定しない場合は、最初に使用可能な文字になります。 | 糸 |
storageAccountType | データ ディスクに使用するストレージ アカウントの種類。 省略した場合、既定値は "standard_lrs" です。 | 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' |
DevOpsAzureSku
名前 | 形容 | 価値 |
---|---|---|
名前 | プール内のマシンの Azure SKU 名。 | string (必須) |
FabricProfile
名前 | 形容 | 価値 |
---|---|---|
種類 | VmssFabricProfileの種類 |
'Vmss' (必須) |
GitHubOrganization
名前 | 形容 | 価値 |
---|---|---|
リポジトリ | プールを作成する必要があるリポジトリの省略可能な一覧。 | string[] |
url | プールを作成する GitHub 組織の URL。 | string (必須) |
GitHubOrganizationProfile
名前 | 形容 | 価値 |
---|---|---|
種類 | OrganizationProfile の識別子プロパティ。 | 'GitHub' (必須) |
組織 | プールが存在する必要がある GitHub 組織/リポジトリの一覧。 | GitHubOrganization[] (必須) |
ManagedServiceIdentity
名前 | 形容 | 価値 |
---|---|---|
種類 | マネージド サービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。 | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (必須) |
userAssignedIdentities | リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリ キーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。 ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。 | UserAssignedIdentities の |
ManualResourcePredictionsProfile
名前 | 形容 | 価値 |
---|---|---|
種類 | スタンバイ スキームを提供する方法を決定します。 | 'Manual' (必須) |
Microsoft.DevOpsInfrastructure/pools
名前 | 形容 | 価値 |
---|---|---|
同一性 | このリソースに割り当てられているマネージド サービス ID。 | ManagedServiceIdentity の |
場所 | リソースが存在する地理的な場所 | string (必須) |
名前 | リソース名 | 糸 制約: パターン = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (必須) |
プロパティ | このリソースのリソース固有のプロパティ。 | PoolProperties |
タグ | リソース タグ | タグ名と値のディクショナリ。 |
種類 | リソースの種類 | "Microsoft.DevOpsInfrastructure/pools@2024-10-19" |
NetworkProfile
名前 | 形容 | 価値 |
---|---|---|
subnetId | プールに作成されたすべてのマシンを配置するサブネット ID。 | string (必須) |
組織
名前 | 形容 | 価値 |
---|---|---|
平行 | プールの最大コンキュラージェンシーのうち、この組織内で最大で作成できるマシンの数。 | int |
プロジェクト | プールを作成する必要があるプロジェクトの省略可能な一覧。 | string[] |
url | プールを作成する必要がある Azure DevOps 組織の URL。 | string (必須) |
OrganizationProfile
名前 | 形容 | 価値 |
---|---|---|
種類 | AzureDevOpsOrganizationProfileの型 |
'AzureDevOps' 'GitHub' (必須) |
OsProfile
名前 | 形容 | 価値 |
---|---|---|
logonType | サービスの実行方法を決定します。 既定では、これはサービスに設定されます。 | 'Interactive' 'Service' |
secretsManagementSettings | プール内のマシンのシークレット管理設定。 | SecretsManagementSettings |
PoolImage
名前 | 形容 | 価値 |
---|---|---|
エイリアス | イメージを参照するエイリアスの一覧。 | string[] |
バッファ | このイメージに割り当てられるバッファーの割合。 | 糸 |
resourceId | イメージのリソース ID。 | 糸 |
wellKnownImageName | ユーザーが利用できる既知の画像セットから使用する画像。 | 糸 |
PoolProperties
名前 | 形容 | 価値 |
---|---|---|
agentProfile | ジョブを実行した後のマシンの処理方法を定義します。 | AgentProfile (必須) |
devCenterProjectResourceId | プールが属する DevCenter プロジェクトのリソース ID。 | string (必須) |
fabricProfile | エージェントが実行されるファブリックの種類を定義します。 | FabricProfile (必須) |
maximumConcurrency | 任意の時点で作成できるリソースの数を定義します。 | int 制約: 最小値 = 1 最大値 = 10000 (必須) |
organizationProfile | プールを使用する組織を定義します。 | OrganizationProfile (必須) |
provisioningState | 現在の操作の状態。 | 'Accepted' 'Canceled' '削除中' 'Failed' 'プロビジョニング' 'Succeeded' '更新中' |
ResourcePredictionsProfile
名前 | 形容 | 価値 |
---|---|---|
種類 | AutomaticResourcePredictionsProfileの型 |
'Automatic' 'Manual' (必須) |
SecretsManagementSettings
名前 | 形容 | 価値 |
---|---|---|
certificateStoreLocation | コンピューターに証明書を格納する場所。 | 糸 |
keyExportable | 証明書のキーをエクスポート可能にするかどうかを定義します。 | bool (必須) |
observedCertificates | プール内のすべてのマシンにインストールする証明書の一覧。 | string[] (必須) |
ステートフル
名前 | 形容 | 価値 |
---|---|---|
gracePeriodTimeSpan | スタンバイ エージェントがない場合に、ワークロードを実行した後にマシンを保持する必要がある時間。 最大値は 1 週間です。 | 糸 |
種類 | AgentProfile の識別子プロパティ。 | 'Stateful' (必須) |
maxAgentLifetime | ステートフル マシンを保持する期間。 最大値は 1 週間です。 | 糸 |
StatelessAgentProfile
名前 | 形容 | 価値 |
---|---|---|
種類 | AgentProfile の識別子プロパティ。 | 'Stateless' (必須) |
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 の |