クイックスタート: ARM テンプレートを使用してマネージド DevOps プールを作成する

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

重要

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

この記事では、ARM テンプレートを使用してマネージド DevOps プールを作成し、新しいプールでパイプラインを実行する方法について説明します。

前提条件

この記事の手順を完了する前に、「前提条件」の記事の説明に従って、マネージド DevOps プールで使用するように Azure サブスクリプションと Azure DevOps 組織を構成しておく必要があります。これらの手順は、Azure サブスクリプションと Azure DevOps 組織ごとに 1 回だけ完了する必要があります。

コマンドプロンプトを開き (Windows の場合は Windows コマンドプロンプトまたは PowerShell を使用)、次のコマンドを実行します。

Azure CLI にサインインします。
```
az login
```
複数の Azure サブスクリプションがある場合は、既定の Azure サブスクリプションを設定します。
```
az account set --subscription "My subscription name"
```
サブスクリプションの一覧を取得するには、次のコマンドを実行します。
```
az account list -o table
```
複数のテナントがある場合、または Azure CLI を使用した Azure サブスクリプションの操作の詳細については、「Azure CLI を使用して Azure サブスクリプションを管理する方法」を参照してください。

リソースグループ、デベロッパーセンター、デベロッパーセンター Project を作成する

Azure CLI を使用した Azure デプロイ環境のデベロッパーセンターの作成と構成に関するページの「デベロッパーセンターの作成」の手順に従います。

必要なのは、「デベロッパーセンターの作成」セクションの手順に従うだけです。リソースグループ名とデベロッパーセンター名を書き留めます。
「Azure CLI を使用してプロジェクトを作成して構成する」の「プロジェクトの作成」の手順に従います。

作成されたプロジェクトを書き留めます id (作成したプロジェクトではありません devCenterId)。

テンプレートを確認して保存する

次の内容を含むローカルファイル名 mdp-azure-deploy.json を作成します。このファイルは、リソースを作成するパラメーター化された ARM テンプレートです microsoft.devopsinfrastructure/pools 。

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "poolName": {
            "type": "string"
        },
        "adoOrg": {
            "type": "string"
        },
        "devCenterResourceId": {
            "type": "string"
        },
        "imageName": {
            "type": "string"
        },
        "poolSize": {
            "type": "int"
        },
        "location": {
            "type": "string",
            "defaultValue": "eastus"
        }
    },
    "variables": {},
    "resources": [
        {
            "name": "[parameters('poolName')]",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2024-04-04-preview",
            "location": "[parameters('location')]",
            "tags": {},
            "properties": {
                "organizationProfile": {
                    "organizations": [
                        {
                            "url": "[parameters('adoOrg')]",
                            "parallelism": 1
                        }
                    ],
                    "permissionProfile": {
                        "kind": "CreatorOnly"
                    },
                    "kind": "AzureDevOps"
                },
                "devCenterProjectResourceId": "[parameters('devCenterResourceId')]",
                "maximumConcurrency": "[parameters('poolSize')]",
                "agentProfile": {
                    "kind": "Stateless"
                },
                "fabricProfile": {
                    "sku": {
                        "name": "Standard_D2ads_v5"
                    },
                    "images": [
                        {
                            "wellKnownImageName": "[parameters('imageName')]",
                            "buffer": "*"
                        }
                    ],
                    "kind": "Vmss"
                }
            }
        }
    ]
}

mdp-azure-deploy-parameters.jsonという名前の別のローカルファイルを作成し、最初のファイルと同じフォルダーに保存します。環境の詳細と一致するように、次のプロパティを更新します。

パラメーター	値
`poolName`	プールの目的の名前で更新 `value` します。名前は英数字、`.`または `-_`3 ~ 44 文字で構成されている必要があります。名前は Azure でグローバルに一意である必要があります。
`adoOrg`	Azure DevOps 組織の名前を更新 `value` して置き換えます `your-organization` 。
`devCenterResourceId`	前の「リソースグループ、`id`デベロッパーセンター、デベロッパーセンタープロジェクトの作成」の手順を使用して更新`value`します。
`imageName`	この例は、Azure Pipelines イメージを使用するように構成され、Windows Server 2022 イメージを使用します。これを変更する場合は、Azure Pipelines イメージの定義済みエイリアスから選択します。マネージド DevOps プールでは、Azure コンピューティングギャラリーイメージと選択したマーケットプレースイメージもサポートされます。これらのイメージの種類に対して Managed DevOps プールリソースを構成する方法については、「Managed DevOps プールイメージの構成」を参照してください。
`poolSize`	同時実行ジョブを実行できるエージェントの最大数で更新 `value` します。この例では、次のようになります`poolSize1`。
`location`	プールの Azure リージョン。この例では、領域は `eastus`.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "poolName": {
            "value": "my-first-managed-pool"
        },
        "adoOrg": {
            "value": "https://dev.azure.com/your-organization"
        },
        "devCenterResourceId": {
            "value": "/subscriptions/subscription_id_placeholder/resourceGroups/fabrikam-managed-devops-pools/providers/Microsoft.DevCenter/projects/fabrikam-dev-center-project"
        },
        "imageName": {
            "value": "windows-2022"
        },
        "poolSize": {
            "value": 1
        },
        "location": {
            "value": "eastus"
        }
    }
}

マネージド DevOps プールを作成する

コマンドプロンプトを開き (Windows の場合は Windows コマンドプロンプトまたは PowerShell を使用)、次のコマンドを実行します。最初の手順の Azure CLI セッションがまだアクティブな場合は、最初の 2 つのコマンドをスキップできます。

Azure CLI にサインインします。
```
az login
```
複数の Azure サブスクリプションがある場合は、既定の Azure サブスクリプションを設定します。
```
az account set --subscription "My subscription name"
```
サブスクリプションの一覧を取得するには、次のコマンドを実行します。
```
az account list -o table
```
複数のテナントがある場合、または Azure CLI を使用した Azure サブスクリプションの操作の詳細については、「Azure CLI を使用して Azure サブスクリプションを管理する方法」を参照してください。
前の手順で 2 つの JSON ファイルを保存したときにフォルダーに移動します。この例では、ファイルは .C:\examples
```
cd c:\examples
```
マネージド DevOps プールを作成します。最初の手順で作成したリソースグループに置き換えます <resourceGroupName> 。
```
az deployment group create --resource-group <resourceGroupName> --template-file mdp-azure-deploy.json --parameters mdp-azure-deploy-parameters.json
```
必要な 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 プールクォータを確認する」を参照してください。

Azure portal で作成したプールを表示する

Azure portal にサインインします。
Managed DevOps プールを検索し、使用可能なオプションから選択します。
一覧から新しい Managed DevOps プールを選択します。
[JSON ビュー] を選択して、マネージド DevOps プールリソースの JSON 形式を表示します。

Azure DevOps でエージェントプールを表示する

Azure DevOps ポータルに移動し、Azure DevOps 組織 (https://dev.azure.com/{your-organization}) にサインインします。
Azure DevOps 組織の設定に>移動します。
Pipelines>エージェントプールに移動し、新しいプールが一覧表示されていることを確認します。 Managed DevOps プールを作成したばかりの場合、新しいプールがエージェントの一覧に表示されるまでに少し時間がかかることがあります。

新しいプールでパイプラインを実行する

この手順では、Azure DevOps プロジェクトの既定のリポジトリに単純なパイプラインを作成し、新しい Managed DevOps プールで実行します。

Azure DevOps ポータルに移動し、Azure DevOps 組織 (https://dev.azure.com/{your-organization}) にサインインします。
パイプラインを実行するプロジェクトに移動し、[パイプライン] を選択します。
[新しいパイプライン] を選択します (最初のパイプラインの場合は [パイプラインの作成] を選択します)。
[Azure Repos Git] を選択 します。
プロジェクトと同じ名前のリポジトリを選択します。この例では、プロジェクトの名前は FabrikamFiber であるため、同じ名前のリポジトリを選択します。
スターターパイプラインを選択します。
既定では、スターターテンプレートは Microsoft でホストされている Linux エージェントを使用します。パイプラインテンプレートを編集し、前の pool 手順で作成したプールを参照するようにセクションを変更します。
```
# Change these two lines as shown in the following example.
 pool:
  vmImage: ubuntu-latest
```
この例では、Managed DevOps プールに名前が付fabrikam-managed-poolけられているのでname: fabrikam-managed-pools、Managed DevOps プールの名前を〚に置き換えvmImage: ubuntu-latest、指定します。
```
# Replace fabrikam-managed-pools with the name
# of your Managed DevOps Pool.
pool:
  name: fabrikam-managed-pool
```
[保存して実行] を選択し、[保存] を選択してもう一度実行して確認します。
これがこのプールで最初に実行されるパイプラインの場合は、パイプラインを実行する前にアクセス許可を付与するように求められる場合があります。
Azure DevOps でのパイプラインの実行を監視します。Azure portal に切り替えて、[エージェント] ビューで実行中のエージェントを確認できます。

リソースをクリーンアップする

クイックスタートを完了したら、作成したリソースを引き続き使用しない場合は削除します。

Managed DevOps プール、デベロッパーセンター、デベロッパーセンター Project を削除するには、それらを含むリソースグループを削除します。

次の方法で共有

クイックスタート: ARM テンプレートを使用してマネージド DevOps プールを作成する

前提条件

リソースグループ、デベロッパーセンター、デベロッパーセンター Project を作成する

テンプレートを確認して保存する

マネージド DevOps プールを作成する

Azure portal で作成したプールを表示する

Azure DevOps でエージェントプールを表示する

新しいプールでパイプラインを実行する

リソースをクリーンアップする

関連項目

フィードバック

その他のリソース

次の方法で共有

クイック スタート: ARM テンプレートを使用してマネージド DevOps プールを作成する

前提条件

Azure CLI にサインインする

リソース グループ、デベロッパー センター、デベロッパー センター Project を作成する

テンプレートを確認して保存する

マネージド DevOps プールを作成する

Azure portal で作成したプールを表示する

Azure DevOps でエージェント プールを表示する

新しいプールでパイプラインを実行する

リソースをクリーンアップする

関連項目

フィードバック

その他のリソース

クイックスタート: ARM テンプレートを使用してマネージド DevOps プールを作成する

リソースグループ、デベロッパーセンター、デベロッパーセンター Project を作成する

Azure DevOps でエージェントプールを表示する