エージェントプールの作成と管理

2025-10-08

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

エージェントプールは、エージェントのコレクションです。各エージェントを個別に管理するのではなく、エージェントをエージェントプールにまとめます。エージェントを構成すると、1 つのプールに登録されます。パイプラインを作成するときは、パイプラインを実行するプールを指定します。パイプラインを実行するときに、パイプラインは、パイプラインの要求を満たす、そのプールのエージェントで実行されます。

Managed DevOps Pools エージェントプールは、Azure portal で管理されます。 Managed DevOps プールを使用している場合は、プールの作成に関するクイックスタートを参照してください。

Azure Pipelines では、プールのスコープは組織全体であるため、プロジェクト間でエージェントマシンを共有できます。

Azure DevOps Server では、エージェントプールのスコープはサーバー全体であるため、プロジェクトやコレクション間でエージェントマシンを共有できます。

エージェントプールジョブは、1 つのエージェントでジョブを実行します。クラシックリリースパイプラインのデプロイグループなど、すべてのエージェントでジョブを実行する必要がある場合は、「デプロイグループのプロビジョニング」を参照してください。

組織管理者の場合は、管理者設定の [エージェントプール] タブから エージェントプール を作成および管理します。

組織にサインインします (https://dev.azure.com/{yourorganization})。
Azure DevOps>組織設定を選択します。
[エージェントプール] を選択します。

プロジェクトコレクション (http://your-server/DefaultCollection) にサインインします。
[Azure DevOps>Collection の設定] を選択します。
[エージェントプール] を選択します。

プロジェクトチームメンバーの場合は、プロジェクト設定の [エージェントプール] タブから エージェントプール を作成および管理します。

プロジェクトに移動し、 プロジェクト設定>Agent プールを選択します。

既定のエージェントプール

次のエージェントプールが既定で提供されます。

既定のプール: これを使用して、設定したセルフホステッドエージェントを登録します。

Azure Pipelines: このホストされたプールには、さまざまな Windows、Linux、および macOS イメージが付属しています。使用可能なイメージとそのインストール済みソフトウェアの完全な一覧については、「Microsoft ホステッドエージェント」を参照してください。

既定では、プロジェクト内のすべての共同作成者が、ホステッドプール上のユーザー ロールのメンバーです。この指定により、プロジェクト内のすべての共同作成者は、Microsoft がホストするエージェントを使用してパイプラインを作成して実行できます。

Azure DevOps Services YAML パイプラインの Azure Pipelines プールから Microsoft でホストされるエージェントを選択するには、このテーブルの YAML VM イメージラベルを使用してイメージの名前を指定します。

pool:
  vmImage: ubuntu-latest # This is the default if you don't specify a pool or vmImage.

要求なしでプライベートプールを使用するには、次のようにします。

pool: MyPool

詳しくは、プールの YAML スキーマに関する記事を参照してください。

プールとキューを管理する

Azure Pipelines UI
Azure DevOps CLI

組織の管理者は、管理者設定の [エージェントプール] タブから エージェントプール を作成および管理します。

組織にサインインします (https://dev.azure.com/{yourorganization})。
Azure DevOps>組織設定を選択します。
[エージェントプール] を選択します。

プロジェクトコレクション (http://your-server/DefaultCollection) にサインインします。
[Azure DevOps>Collection の設定] を選択します。
[エージェントプール] を選択します。

プロジェクトチームメンバーは、プロジェクト設定の [エージェントプール] タブから エージェントプール を作成および管理します。

プロジェクトに移動し、 プロジェクト設定>Agent プールを選択します。

プールを削除するには、[ エージェントプール ] ボックスの一覧に移動し、[ その他のオプション>削除] を選択します。

エージェントプールを削除する方法を示すスクリーンショット。

エージェントプールを一覧表示する | エージェントプールの詳細を表示する | エージェントキューを一覧表示する | エージェントキューの詳細を表示する

Note

ユーザーは、Azure CLI を使用して、エージェントプールとキューに関する情報を表示できますが、編集することはできません。

az devops pipelines コマンドを初めて使用する場合は、「Azure DevOps CLI の概要」を参照してください。

エージェントプールを一覧表示する

az pipelines pool list [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]
                       [--pool-name]
                       [--pool-type {automation, deployment}]

パラメーター

action: ユーザーアクションが許可されているリストをフィルター処理します。指定できる値は manage、none、use です。
detect: 組織を自動的に検出します。使用できる値は、 false と trueです。
org または organization: Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。このプロセスは、既定として構成されていない場合、または Git 構成を使用して取得された場合に必要です。たとえば、 https://dev.azure.com/MyOrganizationName/と指定します。
pool-name: 一致するプール名で一覧をフィルター処理します。
pool-type: プールの種類で一覧をフィルター処理します。使用できる値は、 automation と deploymentです。

例

次の例では、すべてのプールをテーブル形式で一覧表示します。この例では、次の既定の構成を使用します az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber。

az pipelines pool list --output table

ID    Name                             Is hosted    Pool type
----  -------------------------------  -----------  -----------
1     Default                          False        automation
2     Hosted                           True         automation
3     Hosted VS2017                    True         automation
4     Hosted Windows 2019 with VS2019  True         automation
5     Hosted Windows Container         True         automation
6     Hosted macOS                     True         automation
7     Hosted macOS High Sierra         True         automation
8     Hosted Ubuntu 1604               True         automation
9     Azure Pipelines                  True         automation
10    MyAgentPool                      False        automation

エージェントプールの詳細を表示する

az pipelines pool show --id
                       [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]

パラメーター

id または pool-id: 詳細を一覧表示するプールの (必須) ID。
action: ユーザーアクションが許可されているリストをフィルター処理します。指定できる値は manage、none、use です。
detect: 組織を自動的に検出します。使用できる値は、 false と trueです。
org または organization: Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。このプロセスは、既定として構成されていない場合、または Git 構成を使用して取得された場合に必要です。たとえば、 https://dev.azure.com/MyOrganizationName/と指定します。

例

次の例では、 VS2019 プールを使用するホストされた Windows 2019 のプールの詳細を表示します。この例では、次の既定の構成を使用します az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber。

az pipelines pool show --id 4

{
  "agentCloudId": 1,
  "autoProvision": true,
  "autoSize": null,

  <Some properties omitted for space>

  "poolType": "automation",
  "properties": null,
  "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
  "size": 1,
  "targetSize": 1
}

--output table コマンドと同じ情報を返すlistを使用することもできます。

az pipelines pool show --id 4 --output table

ID    Name                             Is Hosted    Pool Type
----  -------------------------------  -----------  -----------
4     Hosted Windows 2019 with VS2019  True         automation

エージェントキューを一覧表示する

az pipelines queue list [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]
                        [--queue-name]

パラメーター

action: ユーザーアクションが許可されているリストをフィルター処理します。指定できる値は manage、none、use です。
detect: 組織を自動的に検出します。使用できる値は、 false と trueです。
org または organization: Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URLを使用して、既定の組織を構成できます。このプロセスは、既定として構成されていない場合、または Git 構成を使用して取得された場合に必要です。たとえば、 https://dev.azure.com/MyOrganizationName/と指定します。
project または p: プロジェクトの名前または ID。 az devops configure -d project=NAME_OR_IDを使用して、既定のプロジェクトを構成できます。このプロセスは、既定として構成されていない場合、または Git 構成を使用して取得された場合に必要です。
queue-name: 一致するキュー名の正規表現 (たとえば、Hosted Ubuntu 1604 という名前のキューの ubuntu) で一覧をフィルター処理します。

例

次の例では、すべてのキューを表形式で一覧表示します。この例では、次の既定の構成を使用します az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber。

az pipelines queue list --output table
This command group is in preview. It might be changed/removed in a future release.
ID    Name                             Pool IsHosted    Pool Type
----  -------------------------------  ---------------  -----------
11    Default                          False            automation
12    Hosted                           True             automation
13    Hosted VS2017                    True             automation
14    Hosted Windows 2019 with VS2019  True             automation
15    Hosted Windows Container         True             automation
16    Hosted macOS                     True             automation
17    Hosted macOS High Sierra         True             automation
18    Hosted Ubuntu 1604               True             automation
19    Azure Pipelines                  True             automation

エージェントキューの詳細を表示する

az pipelines queue show --id
                        [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]

パラメーター

id または queue-id: 情報を取得するエージェントキューの ID。
action: ユーザーアクションが許可されているリストをフィルター処理します。指定できる値は manage、none、use です。
detect: 組織を自動的に検出します。使用できる値は、 false と trueです。
org または organization: Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URLを使用して、既定の組織を構成できます。このプロセスは、既定として構成されていない場合、または Git 構成を使用して取得された場合に必要です。たとえば、 https://dev.azure.com/MyOrganizationName/と指定します。
project または p: プロジェクトの名前または ID。 az devops configure -d project=NAME_OR_IDを使用して、既定のプロジェクトを構成できます。このプロセスは、既定として構成されていない場合、または Git 構成を使用して取得された場合に必要です。

例

次の例では、 VS2019 キューを使用してホストされている Windows 2019 のキューの詳細を表示します。次の既定の構成を使用します: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber。

az pipelines queue show --id 14

{
  "id": 14,
  "name": "Hosted Windows 2019 with VS2019",
  "pool": {
    "id": 4,
    "isHosted": true,
    "isLegacy": true,
    "name": "Hosted Windows 2019 with VS2019",
    "poolType": "automation",
    "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
    "size": 1
  },
  "projectId": "16836457-4ce1-4e77-b97a-e7e0c6508e84"
}

Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。

プールはジョブの実行に使用されます。ジョブのプールを指定する方法について説明します。

さまざまなチームまたは目的を対象とする多くのセルフホステッドエージェントがある場合は、さらにプールを作成できます。次の手順を使用します。

エージェントプールを作成する

セルフホステッドエージェントプールを作成する場合の一般的な状況を次に示します。

あなたはプロジェクトのメンバーであり、チームが所有する一連のマシンを使用してビルドジョブと配置ジョブを実行したいと考えています。

プロジェクトにプールを作成するアクセス許可があることを確認します。 [プロジェクトの設定] で、[エージェントプール] ウィンドウに移動し、[セキュリティ] を選択します。新しいプールを作成するには、 管理者 ロールが必要です。
[ プールの追加] を選択し、新しいプールを作成するオプションを選択します。
エージェントをインストールし、新しいエージェントプールの一部として構成します。

インフラストラクチャチームのメンバーであり、すべてのプロジェクトで使用するエージェントのプールを設定する必要があります。

プロジェクトにプールを作成するアクセス許可があることを確認します。 [組織の設定] で、[エージェントプール] ウィンドウに移動し、[セキュリティ] を選択します。
新しいエージェントプールを作成し、プールの作成時にすべてのプロジェクトでこのエージェントプールを自動プロビジョニングするオプションを選択します。この設定により、すべてのプロジェクトがこのエージェントプールにアクセスできるようになります。
エージェントをインストールし、新しいエージェントプールの一部として構成します。

一部のプロジェクトに対してのみエージェントマシンのセットを共有したい場合:

いずれかのプロジェクトの [設定] に移動します。エージェントプールを追加し、組織レベルで新しいプールを作成するオプションを選択します。
他のプロジェクトに移動し、それぞれにプールを作成します。 [組織の既存のエージェントプールを使用する] を選択します。
エージェントをインストールし、共有エージェントプールの一部として構成します。

あなたはプロジェクトのメンバーであり、チームが所有する一連のマシンを使用してビルドジョブと配置ジョブを実行したいと考えています。

プロジェクトにプールを作成するアクセス許可があることを確認します。 [プロジェクトの設定] で、[エージェントプール] ウィンドウに移動し、[セキュリティ] を選択します。新しいプールを作成するには、 管理者 ロールが必要です。
[ プールの追加] を選択し、新しいプールを作成するオプションを選択します。
エージェントをインストールし、新しいエージェントプールの一部として構成します。

インフラストラクチャチームのメンバーであり、すべてのプロジェクトで使用するエージェントのプールを設定する必要があります。

プロジェクトにプールを作成するアクセス許可があることを確認します。 [組織の設定] で、[エージェントプール] ウィンドウに移動し、[セキュリティ] を選択します。
新しいエージェントプールを作成し、プールの作成時にすべてのプロジェクトでこのエージェントプールを自動プロビジョニングするオプションを選択します。この設定により、すべてのプロジェクトがこのエージェントプールにアクセスできるようになります。
エージェントをインストールし、新しいエージェントプールの一部として構成します。

一部のプロジェクトに対してのみエージェントマシンのセットを共有したい場合:

いずれかのプロジェクトの [設定] に移動します。エージェントプールを追加し、組織レベルで新しいプールを作成するオプションを選択します。
他のプロジェクトに移動し、それぞれにプールを作成します。 [組織の既存のエージェントプールを使用する] を選択します。
エージェントをインストールし、共有エージェントプールの一部として構成します。

エージェントプールのセキュリティ

エージェントプールのセキュリティのしくみを理解すると、エージェントの共有と使用をより適切に制御できます。

ロール は、各エージェントプールで定義されます。これらのロールのメンバーシップは、エージェントプールで実行できる操作を制御します。

組織レベルのセキュリティ設定

「組織設定」におけるエージェントプールでのロール	目的
Reader	このロールのメンバーは、エージェントプールとエージェントを表示できます。通常、このロールは、作業員の監視と状態管理を担当するオペレーターを追加するために使用します。
サービスアカウント	このロールのメンバーは、組織エージェントプールを使用して、プロジェクトのプロジェクトエージェントプールを作成できます。前のガイドラインに従って新しいプロジェクトエージェントプールを作成する場合、通常、ここにメンバーを追加する必要はありません。
管理者	上記のすべてのアクセス許可に加えて、このロールのメンバーは、組織エージェントプールからエージェントを登録または登録解除できます。また、プロジェクトでプロジェクトエージェントプールを作成するときに、組織のエージェントプールを参照することもできます。また、組織エージェントプールのすべてのロールのメンバーシップを管理することもできます。組織エージェントプールを作成するユーザーには、そのプールの管理者ロールが自動的に割り当てられます。

[ エージェントプール ] タブの [すべての エージェントプール ] ノードは、 すべての 組織のエージェントプールのセキュリティを制御します。個々の組織のエージェントプールのロールメンバーシップは、[ すべてのエージェントプール ] ノードから自動的に継承されます。既定では、Azure DevOps Server 管理者は、Azure DevOps Server を使用する場合、[ すべてのエージェントプール ] ノードの管理者でもあります。

プロジェクトレベルのセキュリティ設定

ロールは、各プロジェクトエージェントプールでも定義されます。これらのロールのメンバーシップは、プロジェクトレベルでエージェントプールに対して実行できる操作を制御します。

プロジェクト設定のエージェントプールにおけるロール	目的
Reader	このロールのメンバーは、プロジェクトエージェントプールを表示できます。通常、このロールを使用して、そのプロジェクトエージェントプール内のビルドジョブと配置ジョブを監視するオペレーターを追加します。
User	このロールのメンバーは、パイプラインを作成するときにプロジェクトエージェントプールを使用できます。
管理者	上記のすべての操作以外にも、このロールのメンバーは、プロジェクトエージェントプールのすべてのロールのメンバーシップを管理できます。組織エージェントプールを作成するユーザーには、そのプールの管理者ロールが自動的に割り当てられます。

パイプラインのアクセス許可

パイプラインのアクセス許可では、エージェントプールを使用する権限を持つ YAML パイプラインを制御します。パイプラインのアクセス許可では、クラシックパイプラインからのアクセスは制限されません。

次のいずれかのプロセスを選択します。

エージェントプールの [セキュリティ] タブの [パイプライン のアクセス許可 ] セクションの右上隅にあるその他のオプションから、すべてのパイプラインでエージェントプールを使用するためのアクセスを開きます。
エージェントプールをロックダウンし、選択した YAML パイプラインのみに使用を許可します。他の YAML パイプラインがエージェントプールを参照している場合は、承認要求が発生し、エージェントプール 管理者 が承認する必要があります。このプロセスでは、クラシックパイプラインからのアクセスは制限されません。

エージェントプールのパイプラインアクセス許可のユーザーエクスペリエンスを示すスクリーンショット。

Azure Pipelines エージェントプールのパイプラインアクセス許可は、既定ですべてのパイプラインからアクセスできるため、構成できません。

[エージェントプール] タブの [セキュリティ] アクションは、プロジェクト内のすべてのプロジェクトエージェントプールのセキュリティを制御します。個々のプロジェクトエージェントプールのロールメンバーシップは、ここで定義した内容から自動的に継承されます。既定では、すべてのエージェントプールの管理者ロールに、ビルド管理者、リリース管理者、およびプロジェクト管理者のグループが追加されます。

FAQ

メンテナンス期間をスケジュールしない場合、エージェントはいつメンテナンスを実行しますか?

時間枠をスケジュールしない場合、そのプール内のエージェントはメンテナンスジョブを実行しません。

メンテナンスジョブとは何ですか?

古くなった作業ディレクトリやリポジトリを定期的にクリーンするようにエージェントプールを構成できます。このプロセスにより、エージェントのディスク領域が不足する可能性が軽減されます。メンテナンスジョブは、 エージェントプール の設定で組織レベルで構成されます。

メンテナンスジョブの設定を構成します。

組織にサインインします (https://dev.azure.com/{yourorganization})。
Azure DevOps>組織設定を選択します。
[エージェントプール] を選択します。

プロジェクトコレクション (http://your-server/DefaultCollection) にサインインします。
[Azure DevOps>Collection の設定] を選択します。
[エージェントプール] を選択します。

目的のプールを選択し、[ 設定] を選択して、そのエージェントプールのメンテナンスジョブ設定を構成します。

重要

メンテナンスジョブ設定を構成するには、ビルドキューの管理アクセス許可が必要です。 [設定] タブまたは [メンテナンス履歴] タブが表示されない場合は、管理者ロールに既定でそのアクセス許可がありません。詳しくは、「エージェントプールのセキュリティ」をご覧ください。

メンテナンスジョブの設定を示すスクリーンショット。

目的の設定を構成し、[ 保存] を選択します。

[メンテナンス履歴] を選んで、現在のエージェントプールのメンテナンスジョブ履歴を表示します。ログをダウンロードして確認し、クリーニング手順と実行されたアクションを確認できます。

メンテナンスジョブの履歴を示すスクリーンショット。

メンテナンスは、マシンごとではなく、エージェントプールごとに行われます。 1 台のコンピューターに複数のエージェントプールがある場合でも、ディスク領域の問題が発生する可能性があります。

自己ホストエージェントプールのメンテナンスジョブが停止したまま動かなくなったようです。なぜでしょうか。

通常、メンテナンスジョブは、エージェントプールから削除されたエージェントでの実行を待機しているときに停止します。たとえば、エージェントが意図的にオフラインになったり、通信中に問題が発生したりしたとします。

実行するためにキューに登録されているメンテナンスジョブは、実行されるまで 7 日間待機します。その間に実行されない場合は、自動的に失敗状態になります。この制限時間は変更できません。

この 7 日間の制限はメンテナンスジョブタイムアウト設定とは異なります。後者は、エージェントでメンテナンスに使用できる最大時間 (分) を制御するものです。エージェントでジョブが待ち行列に入ったときではなく、ジョブの開始時にこのタイマーは開始されます。

既存の組織エージェントプールを使用するプロジェクトエージェントプールを作成しようとしていますが、コントロールは使用できません。なぜでしょうか。

別の プロジェクトエージェントプール が既に参照している場合は、[プロジェクトエージェントプールの作成] ダイアログボックスで既存の組織エージェントプールを使用することはできません。各組織エージェントプールは、プロジェクトコレクション内の 1 つのプロジェクトエージェントプールでのみ参照できます。

Microsoft ホステッドプールが選択できず、ビルドをキューに入れることができません。この問題を解決するにはどうすればよいですか?

ご自分の Azure DevOps 組織の所有者に、プールを使用するためのアクセス許可を付与してくれるように依頼してください。「エージェントプールのセキュリティ」を参照してください。

より多くのホステッドビルドリソースが必要です。どうすればよいですか?

Azure Pipelines プールは、クラウドでホストされるビルドエージェントと無料のビルド分を毎月すべての Azure DevOps 組織に提供します。より多くの Microsoft ホスト型ビルドリソースが必要な場合、またはより多くのジョブを並列で実行する必要がある場合は、次のいずれかを実行できます。

フィードバック

このページはお役に立ちましたか?

次の方法で共有

エージェント プールの作成と管理

既定のエージェント プール

パイプライン内のプールを指定する

プールとキューを管理する

エージェント プールを作成する

エージェント プールのセキュリティ

組織レベルのセキュリティ設定

プロジェクト レベルのセキュリティ設定

パイプラインのアクセス許可

FAQ

メンテナンス期間をスケジュールしない場合、エージェントはいつメンテナンスを実行しますか?

メンテナンス ジョブとは何ですか?

自己ホスト エージェント プールのメンテナンス ジョブが停止したまま動かなくなったようです。 なぜでしょうか。

既存の組織エージェント プールを使用するプロジェクト エージェント プールを作成しようとしていますが、コントロールは使用できません。 なぜでしょうか。

Microsoft ホステッド プールが選択できず、ビルドをキューに入れることができません。 この問題を解決するにはどうすればよいですか?

より多くのホステッド ビルド リソースが必要です。 どうすればよいですか?

フィードバック

その他のリソース

エージェントプールの作成と管理

既定のエージェントプール

エージェントプールを作成する

エージェントプールのセキュリティ

プロジェクトレベルのセキュリティ設定

メンテナンスジョブとは何ですか?

自己ホストエージェントプールのメンテナンスジョブが停止したまま動かなくなったようです。なぜでしょうか。

既存の組織エージェントプールを使用するプロジェクトエージェントプールを作成しようとしていますが、コントロールは使用できません。なぜでしょうか。

Microsoft ホステッドプールが選択できず、ビルドをキューに入れることができません。この問題を解決するにはどうすればよいですか?

より多くのホステッドビルドリソースが必要です。どうすればよいですか?