プールの設定を構成する

[アーティクル]
10/18/2024

重要

マネージド DevOps プールは現在プレビュー段階です。ベータ版、プレビュー版、または一般提供としてまだリリースされていない Azure の機能に適用される法律条項については、「Microsoft Azure プレビューの追加使用条件」を参照してください。

この記事では、Managed DevOps プールの基本設定を構成する方法について説明します。

[概要] に移動して、プール設定の概要を表示したり、Azure リソースを新しいリソースグループまたはサブスクリプションに移動したり、タグを構成したりできます。マネージド DevOps プールは VM に最大 20 個のタグを渡し、残りは無視されます。

プールを構成するには、[設定プール]>に移動します。

マネージド DevOps プールを構成するには、次の設定を使用します。

デベロッパーセンタープロジェクト
Azure DevOps 組織
Images
エージェントの最大数
エージェントのサイズ
OS ディスクの種類

デベロッパーセンタープロジェクト

Managed DevOps プールのデベロッパーセンタープロジェクトを選択します。プールの作成時に、デベロッパーセンターを作成し、プロジェクトがない場合はデベロッパーセンターできます。

デベロッパーセンター設定のスクリーンショット。

デベロッパーセンタープロジェクトはプロパティによって 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概要ページから JSON ビューを使用して、Azure portal でデベロッパーセンタープロジェクトのプロジェクトを取得することも、Azure CLI を使用してそのプロパティについてプロジェクトidにクエリを実行して取得することもできます。次の例では、devCenterProjectResourceIdリソースグループに名前が付けられたfabrikam-dev-center-projectfabrikam-managed-devops-poolsデベロッパーセンタープロジェクトから取得されます。

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

デベロッパーセンタープロジェクトは、プールの作成時または更新時に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 概要ページから JSON ビューを使用して、Azure portal でデベロッパーセンタープロジェクトのプロジェクトを取得することも、Azure CLI を使用してそのプロパティについてプロジェクト id にクエリを実行して取得することもできます。次の例では、devcenter-project-idリソースグループに名前が付けられたfabrikam-dev-center-projectfabrikam-managed-devops-poolsデベロッパーセンタープロジェクトから取得されます。

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

Azure DevOps 組織

Managed DevOps プールが 1 つの Azure DevOps 組織用に構成されている場合は、プール設定で組織を指定できます。

1 つの組織を構成するスクリーンショット。

プールが複数の組織用に 構成されている場合、Azure DevOps 組織 の設定はプール設定に存在しません。複数の組織で使用するようにプールを構成するには、[設定のセキュリティ]>に移動し、複数の組織でプールの使用を構成します。

Azure DevOps 組織は、セクションのorganizationProfile一覧をorganizations使用して構成されます。次の例では、Managed DevOps プールが 1 つの組織内のすべてのプロジェクトに対して構成され、並列処理は 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-04-04-preview",
            "location": "eastus",
            "properties": {
                ...
                "organizationProfile": {
                    "organizations": [
                        {
                            "url": "https://dev.azure.com/fabrikam-tailspin",
                            "projects": [],
                            "parallelism": 4
                        }
                    ]
                }
            }
        }
    ]
}

Azure DevOps 組織は、パラメーターのorganization-profile一覧をorganizations使用して構成されます。次の例では、Managed DevOps プールが 1 つの組織内のすべてのプロジェクトに対して構成され、並列処理は 4 です。複数の組織を構成する例については、「複数の組織でプールを使用する」を参照してください。

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

次の例は、organizationsorganization-profile.json ファイル内の一覧を示しています。

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

既定では、マネージド DevOps プールは、指定した組織のすべてのプロジェクトで使用できます。プールを特定のプロジェクトに制限するには、「セキュリティ設定 - 組織のアクセスを構成する」を参照してください。

エージェントの最大数

プールで使用できるエージェントの最大数を指定します。たとえば、[エージェントの最大数] の値を 2 に指定すると、最大 2 つのエージェントを同時に実行できます。 2 つ以上のジョブがキューに入っている場合、一度に実行されるエージェントは 2 つのみですが、他のジョブは待機します。

エージェントの最大数は、既存のプールのプール設定と、プール作成時の [基本] タブで構成されます。

[エージェントの最大数] 設定のスクリーンショット。

最大エージェント は、プロパティを 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-04-04-preview",
            "location": "eastus",
            "properties": {
                ...
                "maximumConcurrency": 4
            }
        }
    ]
}

最大エージェントは、プールの作成時または更新時にmaximum-concurrencyパラメーターを使用して構成されます。次の例では、 最大エージェント は 4.

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

Note

最大エージェント 数は、同時にプロビジョニングできるエージェントの最大数を構成しますが、組織のセルフホステッド並列ジョブ数は、同時に実行できるジョブの数を指定します。エージェントがジョブを実行できるように、組織で十分なセルフホステッド並列ジョブを使用できることを確認します。詳細については、Azure DevOps Services の並列ジョブの価格に関するページを参照してください。

エージェントのサイズ

エージェントサイズ は、マネージド DevOps プールエージェントのホストに使用する Azure 仮想マシンのサイズを指定します。

エージェントのサイズ設定のスクリーンショット。

[サイズの変更] を選択して表示し、Azure リージョンで使用可能な Azure 仮想マシンのサイズを選択します。使用可能なマネージド DevOps プールクォータを持つエージェントサイズ (SKU) は、使用可能としてマークされます。利用できない SKU のクォータを増やすことができます。利用できない SKU のクォータ要求が承認されると、その SKU は使用可能として一覧表示されます。 Managed DevOps プールのクォータの詳細を確認します。

エージェントのサイズは、セクションのfabricProfileプロパティをsku使用して構成されます。次の例では、 Standard_D2ads_v5 VM サイズが指定されています。

{
    "$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-04-04-preview",
            "location": "eastus",
            "properties": {
                ...
                "fabricProfile": {
                    "sku": {
                        "name": "Standard_D2ads_v5"
                    }
                }
            }
        }
    ]
}

エージェントサイズは、プールのsku作成時または更新時にセクションのfabricProfileプロパティを使用して構成されます。次の例では、 Standard_D2ads_v5 VM サイズが指定されています。

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

次の例は、skufabric-profile.json ファイルのセクションを示しています。

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

サブスクリプションに、目的の Azure VM SKU と最大エージェント数でプールを構成する容量がない場合は、次のメッセージのようなエラーが表示されます。 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 の仮想マシンのサイズ」および「リージョン別の利用可能な製品」を参照してください。

OS ディスクの種類

マネージド DevOps プールは、OS ディスクに次の種類のディスクを提供します。

Standard
Standard SSD
Premium SSD

既定の OS ディスクの種類は Standard です。ワークロードのスループットが Standard レベルのレベルを超える場合は、パフォーマンスの高いディスクの種類にアップグレードすることで、ワークロードのパフォーマンスが向上する可能性があります。ディスクの種類とパフォーマンスの詳細については、「Azure マネージドディスクの種類」を参照してください。

OS ディスクの種類は、既存のプールのプール設定と、プール作成時の [基本] タブで構成されます。

OS ディスクの種類の設定のスクリーンショット。

OS ディスクの種類は、セクションのstorageProfileプロパティをosDiskStorageAccountType使用して構成されます。次の例では、Standard OS ディスクの種類が指定されています。 Standard、StandardSSD、または Premium を選択します。

{
    "$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-04-04-preview",
            "location": "eastus",
            "properties": {
                ...
                "storageProfile": {
                    "osDiskStorageAccountType": "Standard"
                }
            }
        }
    ]
}

次の例では、Standard OS ディスクの種類が指定されています。 Standard、StandardSSD、または Premium を選択します。

OS ディスクの種類は、パラメーターのosDiskStorageAccountTypeセクションfabric-profileのプロパティをstorageProfile使用して構成されます。次の例では、Standard OS ディスクの種類が指定されています。 Standard、StandardSSD、または Premium を選択します。

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

次の例は、storageProfilefabric-profile.json ファイルのセクションを示しています。

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

画像

マネージド DevOps プールには、プールでパイプラインを実行するための仮想マシンイメージに関するいくつかのオプションが用意されています。選択した Azure Marketplace VM イメージを使用してプールを作成したり、Azure コンピューティングギャラリーで独自のカスタムイメージを使用したり、Azure Pipelines の Microsoft でホストされているエージェントで使用されるのと同じ Windows イメージと Linux イメージを使用したりできます。

イメージの構成のスクリーンショット。

1 つのイメージまたは複数のイメージを使用するようにプールを構成し、エイリアスを使用して、特定のイメージを使用するようにパイプラインを構成できます。詳細については、「マネージド DevOps プールイメージの構成」を参照してください。

次の方法で共有

プールの設定を構成する

デベロッパーセンタープロジェクト

Azure DevOps 組織

エージェントの最大数

エージェントのサイズ

OS ディスクの種類

画像

関連項目

フィードバック

その他のリソース

次の方法で共有

プールの設定を構成する

デベロッパー センター プロジェクト

Azure DevOps 組織

エージェントの最大数

エージェント のサイズ

OS ディスクの種類

画像

関連項目

フィードバック

その他のリソース

デベロッパーセンタープロジェクト

エージェントのサイズ