Azure Pipelines エージェント

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Azure Pipelines を使用したコードのビルドまたはソフトウェアのデプロイには、少なくとも 1 つのエージェントが必要です。 コードや人を追加していけば、それだけ多くが最終的に必要になります。

パイプラインを実行すると、システムによって 1 つ以上のジョブが開始されます。 エージェントは、一度に 1 つのジョブを実行するエージェント ソフトウェアがインストールされたコンピューティング インフラストラクチャです。

Azure Pipelines には、さまざまな種類のエージェントが用意されています。

エージェントの種類	説明	可用性
Microsoft によってホストされるエージェント	Microsoft によってホストおよび管理されるエージェント	Azure DevOps Services
セルフホステッド エージェント	自分の VM でホストされている、自分が構成および管理するエージェント	Azure DevOps Services、Azure DevOps Server
Azure 仮想マシン スケール セット エージェント	Azure Virtual Machine Scale Sets を使用して、ニーズに合わせて自動スケーリングできるセルフホステッド エージェントの一種	Azure DevOps Services

ジョブは、エージェントのホスト マシンで直接実行するか、コンテナーで実行することができます。

Microsoft によってホストされるエージェント

パイプラインが Azure Pipelines にある場合は、Microsoft ホステッド エージェントを使ってジョブを実行する便利なオプションがあります。 Microsoft によってホストされているエージェントを使用すると、メンテナンスとアップグレードが自動的に行われます。 パイプラインで指定した VM イメージの最新バージョンが常に取得されます。 パイプラインを実行するたびに、パイプラインの各ジョブに対して新しい仮想マシンが取得されます。 仮想マシンは 1 つのジョブの後に破棄されます (つまり、コードのチェックアウトなど、ジョブが仮想マシン ファイル システムに加えた変更は、次のジョブで使用できなくなります)。 Microsoft ホステッド エージェントは、VM 上で直接またはコンテナー内でジョブを実行できます。

Azure Pipelines には、Azure Pipelines という名前の事前定義されたエージェント プールと、Microsoft ホステッド エージェントが用意されています。

多くのチームにとって、ジョブを実行するにはこれが最も簡単な方法です。 まず試してみて、ビルドまたはデプロイに対して機能するかどうかを確認できます。 そうされない場合は、スケール セット エージェントまたはセルフホステッド エージェントを使用できます。

ヒント

Microsoft ホステッド エージェントは無料で試すことができます。

詳細については、「Microsoft によってホストされるエージェント」を参照してください。

セルフホステッド エージェント

ジョブを実行するために独自に設定および管理するエージェントは、セルフホステッド エージェントです。 Azure Pipelines または Azure DevOps Server (以前の Team Foundation Server (TFS)) でセルフホステッド エージェントを使用できます。 セルフホステッド エージェントを使用すると、ビルドとデプロイに必要な依存ソフトウェアのインストールをより細かく制御できます。 また、マシン レベルのキャッシュと構成は、次回の実行まで保持されるため、起動の速度を向上させることができます。

注意

1 台のマシンに複数のエージェントをインストールできますが、1 台のマシンに 1 つのエージェントのみをインストールすることを強くお勧めします。 複数のエージェントをインストールすると、パフォーマンスやパイプラインの結果に悪影響が及ぶ可能性があります。

ヒント

セルフホステッド エージェントをインストールする前に、Microsoft ホステッド エージェント プールが機能するかどうかを確認することをお勧めします。 多くの場合、これが最も簡単な方法です。 お試しください。

エージェントは、Linux、macOS、または Windows マシンにインストールできます。 Docker コンテナーにエージェントをインストールすることもできます。 セルフホステッド エージェントのインストールについては、以下を参照してください。

• macOS エージェント
• Linux エージェント
• Windows エージェント
• Docker エージェント

注意

macOS 上では、./config.sh の実行時に tar ファイル内の各アセンブリに対してゲートキーパー保護が表示されないように、ダウンロード アーカイブの特殊な属性をクリアする必要があります。 次のコマンドを実行すると、ファイルの拡張属性をクリアできます。

xattr -c vsts-agent-osx-x64-V.v.v.tar.gz  ## replace V.v.v with the version in the filename downloaded.

# then unpack the gzip tar file normally:

tar xvfz vsts-agent-osx-x64-V.v.v.tar.gz

マシンにエージェントをインストールした後は、ジョブに必要な他のソフトウェアをそのマシンにインストールできます。

注意

エージェントには広い下位互換性があります。 より新しいバージョンのエージェントが Azure DevOps に要求されていない限り、おそらくすべてのバージョンのエージェントがすべての Azure DevOps バージョンと互換性があります。

最新バージョンのエージェントのみをサポートしているのは、それがすべての最新のパッチとバグ修正が保証されている唯一のバージョンだからです。

Node ランナーのバージョン

エージェントには、異なる Node ハンドラーを使用するターゲット タスクをサポートするために、複数のバージョンの NodeJS ライブラリが付属しています。

すべての公式 Azure DevOps タスクは、ユニバーサル ハンドラーとして Node 10 を使用しますが、お客様は、古い Node 6 ライブラリを使用するカスタム タスクを引き続き使用している場合があります。 現在有効期間が終了した Node との下位互換性をサポートするために、指定された Node ランナーを手動でインストールするための次のセルフサービス方式が用意されています。

• Node 6 ランナーを手動でインストールします。 Node 6 ランナーを手動でインストールする方法の詳細については、「Node 6 のサポート」を参照してください。

• 古い Node 6 ライブラリを必要とするパイプラインで NodeTaskRunnerInstaller@0 タスクを使用します。

• Node 6 を含むエージェント パッケージをインストールします。

  Azure Pipelines には、2 つのバージョンのエージェント パッケージが用意されています。

  • vsts-agent-* パッケージは Node 6 をサポートします。
  • pipelines-agent-* パッケージは Node 6 をサポートしていません。 このバージョンのパッケージは、今後既定のエージェント パッケージになります。

  Node 6 依存タスクを使用していないことがわかっていて、エージェント マシンに Node 6 をインストールしたくない場合は、エージェントを https://github.com/microsoft/azure-pipelines-agent/releases の [代替エージェントのダウンロード] セクションからインストールできます。

Azure 仮想マシン スケール セット エージェント

Azure 仮想マシン スケール セット エージェントは、ニーズに合わせて自動スケールできるセルフホステッド エージェントの一種です。 この弾力性により、専用エージェントを常に実行する必要性が減少します。 Microsoft がホストするエージェントとは異なり、エージェントを実行するマシンのサイズとイメージに柔軟性があります。

仮想マシン スケール セット、スタンバイ状態を維持するエージェントの数、スケール セット内の仮想マシンの最大数を指定し、Azure Pipelines がエージェントのスケーリングを管理します。

詳細については、「Azure 仮想マシン スケール セット エージェント」を参照してください。

並列ジョブ

並列ジョブは、組織内で同時に実行できるジョブ数を表します。 組織の並列ジョブが 1 つの場合、組織内ではジョブを一度に 1 つずつ実行できます。追加の並列ジョブは、最初のジョブが完了するまでキューに格納されます。 同時に 2 つのジョブを実行するには、2 つの並列ジョブが必要です。 Azure Pipelines では、Microsoft ホステッド インフラストラクチャまたは独自の (セルフホステッド) インフラストラクチャ上で並列ジョブを実行できます。

Microsoft は、少なくとも 1 つの並列ジョブを含む Free レベルのサービスを既定ですべての組織に提供しています。 同時に実行する必要があるパイプライン数によっては、複数の Microsoft ホステッドまたはセルフホステッド エージェントを同時に使うには、さらに多くの並列ジョブが必要になる場合があります。 並列ジョブとさまざまな Free レベルのサービスの詳細については、Azure Pipelines の並列ジョブに関する記事を参照してください。

機能

すべてのセルフホステッド エージェントには、何ができるかを示す一連の機能があります。 機能は名前と値のペアであり、エージェント ソフトウェアによって自動的に検出されるもの (この場合はシステム能力と呼ばれます)、またはユーザーが定義するもの (この場合はユーザー機能と呼ばれます) があります。

エージェント ソフトウェアによって、さまざまなシステム機能が自動的に判断されます。たとえば、マシンの名前、オペレーティング システムの種類、マシンにインストールされている特定のソフトウェアのバージョンなどです。 また、マシンで定義された環境変数もシステム機能の一覧に自動的に表示されます。

注意

環境変数を機能として格納することは、エージェントの実行時に、格納された機能の値が環境変数の設定に使われることを意味します。 また、エージェントの実行時に環境変数に加えられた変更は、どのタスクでも取得されず、使われません。 変更する環境変数の機密性が高く、機能として格納したくない場合、それらが無視されるようにするには、無視する変数のコンマ区切り一覧を使って VSO_AGENT_IGNORE 環境変数を設定します。 たとえば、PATH は重要な変数であり、ソフトウェアをインストールする場合に無視することがあります。

パイプラインを作成するときに、エージェントに特定の要求を指定します。 システムからジョブが送信される対象は、パイプラインに指定された要求と一致する機能を持つエージェントのみです。 そのため、エージェント機能を使って、特定のエージェントにジョブを指示することができます。

注意

要求と機能はセルフホステッド エージェントで使うように設計されているので、ジョブをジョブの要件を満たすエージェントと対応付けることができます。 Microsoft ホステッド エージェントを使う場合、ジョブの要件に一致するエージェントのイメージはお客様が選ぶので、Microsoft ホステッド エージェントに機能を追加することもできますが、Microsoft ホステッド エージェントで機能を使う必要はありません。

要求を構成する

YAML

YAML ビルド パイプラインに 1 つの要求を追加するには、pool セクションに demands: 行を追加します。

pool:
  name: Default
  demands: SpecialSoftware # exists check for SpecialSoftware

機能の存在をチェックすることも、機能の値と比較することもできます。 詳細については、「YAML スキーマ - Demands」を参照してください。

クラシック

パイプラインの [タスク] タブで、エージェント ジョブに要求を追加します。

Name	条件	値
SpecialSoftware	exists	該当なし
Agent.OS	equals	Linux

エージェント機能を構成する

ブラウザー

バージョンとシステム機能を含むエージェントの詳細を表示し、ユーザー機能を管理するには、[エージェント プール] に移動し、目的のエージェントの [機能] タブを選びます。

1. Web ブラウザーでエージェント プールに移動します。

   1. 組織にサインインします (https://dev.azure.com/{yourorganization})。

   2. [Azure DevOps]、[組織の設定] の順に選びます。

      

   3. [エージェント プール] を選択します。

      

2. [機能] タブに移動します。

   1. [エージェント プール] タブから、目的のエージェント プールを選びます。

      

   2. [エージェント] を選択し、目的のエージェントを選択します。

      

   3. [機能] タブを選択します。

      

      注意

      Microsoft ホステッド エージェントでは、システム機能は表示されません。 Microsoft ホステッド エージェントにインストールされるソフトウェアの一覧については、「Microsoft ホステッド エージェントを使用する」をご覧ください。

3. エージェントに新しい機能を登録するには、[新しい機能を追加する] を選びます。

Azure DevOps CLI

バージョン、システムとユーザーの機能など、エージェントの詳細を表示するには、次の az pipelines agent Azure CLI メソッドを使います。

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

注意

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

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

az pipelines agent list コマンドを使ってエージェントを一覧表示することができます。

az pipelines agent list --pool-id
                        [--agent-name]
                        [--demands]
                        [--detect {false, true}]
                        [--include-assigned-request {false, true}]
                        [--include-capabilities {false, true}]
                        [--include-last-completed-request {false, true}]
                        [--org]
                        [--subscription]

パラメーター

• pool-id: (必須) エージェントを含むエージェント プール。
• agent-name: エージェント名でフィルター処理します。
• demand: エージェントが満たすことのできる要求でフィルター処理します。 コンマ区切りの一覧です。
• detect: 組織を自動的に検出します。 指定できる値: false、true
• include-assigned-request: エージェントの現在の作業に関する詳細を含めるかどうか。 指定できる値: false、true
• include-capabilities: エージェントの機能を応答に含めるかどうか。 指定できる値: false、true
• include-last-completed-request: エージェントが最後に完了した作業に関する詳細を含めるかどうか。 指定できる値: false、true
• org または organization: Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URL を使って既定の組織を構成できます。 既定として構成されていない場合、または git config を使って取得されていない場合は必須です (例: https://dev.azure.com/MyOrganizationName/)。
• subscription: サブスクリプションの名前または ID。 既定のサブスクリプションを構成するには、az account set -s NAME_OR_ID を使用します。

例

次の例の場合、プール ID: 4 内のすべてのエージェントが表形式で一覧表示されます。 プールの ID を取得するには、az pipelines pool list を使います。 この例では、次の既定の構成を使っています。az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines agent list --pool-id 4 --output table

ID    Name          Is Enabled    Status    Version
----  ------------  ------------  --------  ---------
3     Hosted Agent  True          offline   2.155.1

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

az pipelines agent show コマンドを使ってエージェントの詳細を取得することができます。

az pipelines agent show --agent-id
                        --pool-id
                        [--detect {false, true}]
                        [--include-assigned-request {false, true}]
                        [--include-capabilities {false, true}]
                        [--include-last-completed-request {false, true}]
                        [--org]
                        [--subscription]

パラメーター

• agent-id または id: (必須) 情報を取得するエージェント ID。
• pool-id: (必須) エージェントを含むエージェント プール。
• detect: 組織を自動的に検出します。 指定できる値: false、true
• include-assigned-request: エージェントの現在の作業に関する詳細を含めるかどうか。 指定できる値: false、true
• include-capabilities: エージェントの機能を応答に含めるかどうか。 指定できる値: false、true
• include-last-completed-request: エージェントが最後に完了した作業に関する詳細を含めるかどうか。 指定できる値: false、true
• org または organization: Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URL を使って既定の組織を構成できます。 既定として構成されていない場合、または git config を使って取得されていない場合は必須です (例: https://dev.azure.com/MyOrganizationName/)。
• subscription: サブスクリプションの名前または ID。 既定のサブスクリプションを構成するには、az account set -s NAME_OR_ID を使用します。

例

次の例の場合、ID が 3 のエージェントの詳細が表示されます。 この例では、次の既定の構成を使っています。az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines agent show --agent-id 3 --pool-id 4 --include-capabilities true
This command group is in preview. It might be changed/removed in a future release.
{
  "accessPoint": null,
  "assignedAgentCloudRequest": null,

  <Some properties omitted for space>

  "status": "offline",
  "statusChangedOn": null,
  "systemCapabilities": {
    "ANDROID_HOME": "",
    "ANDROID_NDK_HOME": "",
    "Agent.Name": "Hosted Agent",
    "Agent.Version": "2.160.1",

    <Some capabilities omitted for space>

    "sh": "",
    "subversion": "",
    "svn": "",
    "xcode": ""
  },
  "userCapabilities": null,
  "version": "2.160.1"
}
}

また、--output table を使って、同じ情報の省略バージョンを返すこともできます。

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

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

ヒント

セルフホステッド エージェントに新しいソフトウェアをインストールした後、新しい機能を表示するにはエージェントを再起動する必要があります。 詳細については、Windows エージェントの再起動、Linux エージェントの再起動、Mac エージェントの再起動に関する記事を参照してください。

通信

Azure Pipelines との通信

エージェントは、どのジョブを実行する必要があるかを判定したり、ログやジョブの状態を報告したりするために Azure Pipelines または Azure DevOps Server と通信します。 この通信は常にエージェントによって開始されます。 エージェントから Azure Pipelines または Azure DevOps Server への HTTP または HTTPS を経由したすべてのメッセージが、そのエージェントをどのように構成しているかに依存します。 このプル モデルでは、次に示すように、エージェントを異なるトポロジで構成できます。

エージェントと Azure Pipelines またはAzure DevOps Server の間の一般的な通信パターンを次に示します。

1. ユーザーは、エージェントをエージェント プールに追加することによってエージェントを Azure Pipelines または Azure DevOps Server に登録します。 エージェントをエージェント プールに登録するには、そのエージェント プールの管理者である必要があります。 エージェント プール管理者の ID は、登録の時点でのみ必要であり、エージェントには保持されず、エージェントと Azure Pipelines または Azure DevOps Server の間のそれ以降の通信に使用されることもありません。 登録が完了すると、エージェントは "リスナー OAuth トークン" をダウンロードし、それを使用してジョブ キューをリッスンします。

2. エージェントは、HTTP の長いポーリングを使用して、Azure Pipelines/Azure DevOps Server のジョブ キューに新しいジョブ要求がポストされているかどうかをリッスンします。 ジョブが使用可能な場合、エージェントは、そのジョブと "ジョブ固有の OAuth トークン" をダウンロードします。 このトークンは、パイプラインで指定されているスコープ指定された ID 用に Azure Pipelines/Azure DevOps Server によって生成されます。 そのトークンは存続期間が短く、そのジョブ内で Azure Pipelines または Azure DevOps Server のリソース (ソース コードなど) にアクセスしたり、リソースを変更したり (テスト結果のアップロードなど) するためにエージェントによって使用されます。

3. そのジョブが完了した後に、エージェントはジョブ固有の OAuth トークンを破棄して元に戻り、リスナー OAuth トークンを使用して新しいジョブ要求が存在するかどうかを確認します。

エージェントと Azure Pipelines/Azure DevOps Server の間で交換されるメッセージのペイロードは、非対称暗号化を使用してセキュリティで保護されます。 各エージェントには公開キーと秘密キーのペアがあり、公開キーは登録中にサーバーと交換されます。 サーバーは、その公開キーを使用してジョブのペイロードを暗号化してから、それをエージェントに送信します。 エージェントは、秘密キーを使用してジョブの内容の暗号化を解除します。 このようにして、パイプラインまたは変数グループに格納されているシークレットが、エージェントと交換されるときにセキュリティで保護されます。

Note

エージェントは、UTF-8 クライアント エンコード出力をサポートします。 ただし、システムのエンコードが UTF-8 とは異なる場合は、ログの出力に問題が発生する可能性があります。 たとえば、ログには、システムのエンコードで認識されない文字が含まれている可能性があり、文字化けまたは欠落した記号として表示される可能性があります。

ターゲット サーバーにデプロイするための通信

エージェントを使用して成果物を一連のサーバーにデプロイする場合、そのエージェントには、これらのサーバーへの "見通し線" 接続が必要です。 Microsoft ホステッド エージェント プールは、既定で Azure Web サイトや Azure で実行されているサーバーに接続されています。

注意

Azure リソースが Azure 仮想ネットワークで実行されている場合、Microsoft ホステッド エージェントが配置されているエージェント IP の範囲を取得できるので、Azure VNet に対してエージェントによるアクセスを許可するファイアウォール規則を構成できます。

オンプレミス環境に Microsoft でホストされるエージェント プールへの接続がない場合 (通常は中間にファイアウォールがあることが理由になっているケースです)、オンプレミス コンピューターでセルフホステッド エージェントを手動で構成する必要があります。 次の概略図に示すように、Azure Pipelines または Team Foundation Server に接続するには、これらのエージェントにターゲットのオンプレミス環境への接続とインターネットへのアクセスが必要です。

認証

エージェントを登録するには、エージェント プール内の管理者ロールのメンバーである必要があります。 エージェント プール管理者の ID は、登録の時点でのみ必要であり、エージェントには保持されず、エージェントと Azure Pipelines または Azure DevOps Server の間のそれ以降の通信に使用されることもありません。 さらに、エージェントを構成するために、サーバー上のローカル管理者であることも必要です。

エージェントを登録するときに次の認証の種類から選択すると、エージェントのセットアップから、各認証の種類に必要な特定の追加情報の入力を求められます。 詳細については、「セルフホステッド エージェントの認証オプション」を参照してください。

• 個人用アクセス トークン
• デバイス コード フロー
• サービス プリンシパル

エージェントの登録に使用される認証方法は、エージェントの登録時にのみ使用されます。 登録後にエージェントがどのように Azure Pipelines と通信するかの詳細については、「Azure Pipelines または Azure DevOps Server との通信」を参照してください。

対話型とサービス

セルフホステッド エージェントは、サービスまたは対話型プロセスのどちらかとして実行できます。 エージェントを構成したら、それが動作することを確認するために、まず対話モードで試してみることをお勧めします。 次に、運用環境で使用する場合、稼働状態を確実に維持するために、エージェントを次のいずれかのモードで実行することをお勧めします。 また、これらのモードによって、マシンが再起動された場合にエージェントが自動的に起動されることも確認されます。

1. サービスとして。 オペレーティング システムのサービス マネージャーを利用して、エージェントのライフサイクルを管理できます。 さらに、エージェントの自動アップグレードのエクスペリエンスは、サービスとして実行されているときの方が優れています。

2. 自動ログオンが有効になっている対話型プロセスとして。 場合によっては、運用環境での使用のためにエージェントの対話的な実行が必要になることがあります (UI テストを実行するためなど)。 エージェントがこのモードで実行するように構成されている場合は、スクリーン セーバーも無効になります。 一部のドメイン ポリシーでは、自動ログオンを有効にしたり、スクリーン セーバーを無効にしたりできないことがあります。 このような場合は、ドメイン ポリシーからの除外を求めるか、ドメイン ポリシーが適用されないワークグループ コンピューターでエージェントを実行する必要があります。

   Note

   自動ログオンを有効にした場合、またはスクリーン セーバーを無効にした場合にはセキュリティ リスクがあります。なぜなら、他のユーザーがコンピューターに近づいて、自動的にログオンするアカウントを使用できるからです。 エージェントをこのように構成する場合は、そのコンピューターが物理的に保護されている (たとえば、セキュリティで保護された施設に配置されている) ことを確認する必要があります。 エージェントが自動ログオンで実行されるコンピューターにアクセスするためにリモート デスクトップを使っている場合は、単純にリモート デスクトップを閉じると、コンピューターがロックされるため、このエージェントで実行される UI テストがすべて失敗する可能性があります。 これを回避するには、tscon コマンドを使ってリモート デスクトップから切断します。 次に例を示します。

   %windir%\System32\tscon.exe 1 /dest:console

エージェント アカウント

エージェントをサービスとして実行するか、対話的に実行するかに関わらず、エージェントの実行に使うコンピューター アカウントを選択できます (これは、Azure Pipelines または Azure DevOps Server にエージェントを登録するときに使う資格情報とは異なることに注意してください)。エージェント アカウントの選択を左右するものは、ビルドおよびデプロイ ジョブで実行されるタスクのニーズのみです。

たとえば、Windows 認証を使って外部サービスにアクセスするタスクを実行するには、そのサービスにアクセスできるアカウントを使ってエージェントを実行する必要があります。 ただし、ブラウザーを必要とする Selenium またはコード化された UI テストなどの UI テストを実行している場合は、そのエージェント アカウントのコンテキストでブラウザーが起動されます。

Windows では、ネットワーク サービスやローカル サービスなどのサービス アカウントの使用を検討する必要があります。 これらのアカウントはアクセス許可が制限されており、パスワードの有効期限が切れないため、時間の経過と共に必要なエージェントの管理が少なくなります。

エージェントのバージョンとアップグレード

Azure Pipelines のエージェント ソフトウェアは数週間に 1 回更新されます。 エージェントのバージョンは {major}.{minor} という形式です。 たとえば、エージェントのバージョンが 2.1 である場合、メジャー バージョンは 2 であり、マイナー バージョンは 1 です。

Microsoft ホステッド エージェントは常に最新の状態に保たれます。 新しいバージョンのエージェントの "マイナー" バージョンのみが異なる場合、通常、セルフホステッド エージェントは Azure Pipelines によって自動的に更新できます (この設定を構成するには [エージェント プール] でエージェント、[設定] の順に選びます - 既定値は有効です)。 プラットフォームの機能またはパイプラインで使われているタスクのいずれかに新しいバージョンのエージェントが必要な場合は、アップグレードが必要です。

セルフホステッド エージェントを対話形式で実行する場合、または新しい "メジャー" バージョンのエージェントを使用できる場合、状況に応じてエージェントを手動でアップグレードする必要があります。 これは、組織の [エージェント プール] タブから簡単に行うことができます。 互換性のあるエージェントをターゲットにできるようになるまでは、パイプラインは実行されません。

セルフホステッド エージェントを更新するには

1. [プロジェクトの設定] の [エージェント プール] に移動します。

   

2. エージェント プールを選び、[すべてのエージェントの更新] を選びます。

   

   また、エージェントを個別に更新するには、[...] メニューから [エージェントの更新] を選びます。

   

3. [更新] を選んで更新を確認します。

   

4. 更新要求は、プール内のエージェントごとにキューに格納され、現在実行中のジョブが完了すると実行されます。 通常、アップグレードにかかる時間はわずかです。エージェント ソフトウェアの最新バージョン (約 200 MB) をダウンロードし、それを展開し、新しいバージョンを使ってエージェントを再起動するだけの時間です。 エージェントの状態は、[エージェント] タブで監視できます。

エージェントのバージョンを確認するには、「エージェント機能を構成する」で説明されているように、[エージェント プール] に移動し、目的のエージェントの [機能] タブを選びます。

プログラムでエージェントの更新をトリガーするには、セクション「特定のエージェント プールに対してプログラムでエージェントの更新をトリガーするにはどうすればよいですか?」で説明されているように、エージェントの更新 API を使用できます。

Note

インターネットにアクセスできないサーバーの場合、ローカル ファイルとして使うために、エージェントの zip ファイルを手動で次のフォルダーにコピーします。 Agents フォルダーが存在しない場合は作成します。

• Windows: %ProgramData%\Microsoft\Azure DevOps\Agents
• Linux: usr/share/Microsoft/Azure DevOps/Agents
• macOS: usr/share/Microsoft/Azure DevOps/Agents

Agents フォルダーが存在しない場合は作成します。

よく寄せられる質問

最新の v2 エージェント バージョンを使っていることを確認するにはどうすればよいですか?

1. [エージェント プール] タブに移動します。

   1. 組織にサインインします (https://dev.azure.com/{yourorganization})。

   2. [Azure DevOps]、[組織の設定] の順に選びます。

      

   3. [エージェント プール] を選択します。

      

2. エージェントを含むプールをクリックします。

3. エージェントが有効になっていることを確認します。

4. [機能] タブに移動します。

   1. [エージェント プール] タブから、目的のエージェント プールを選びます。

      

   2. [エージェント] を選択し、目的のエージェントを選択します。

      

   3. [機能] タブを選択します。

      

      注意

      Microsoft ホステッド エージェントでは、システム機能は表示されません。 Microsoft ホステッド エージェントにインストールされるソフトウェアの一覧については、「Microsoft ホステッド エージェントを使用する」をご覧ください。

5. Agent.Version 機能を探します。 この値は、公開されている最新のエージェント バージョンに対してチェックできます。 一覧表示されている最も高いバージョン番号については、Azure Pipelines エージェントに関するページを参照し、確認します。

6. 各エージェントは、新しいバージョンのエージェントを必要とするタスクを実行すると、自動的に更新されます。 一部のエージェントを手動で更新する場合は、プールを右クリックし、[すべてのエージェントの更新] を選びます。

セルフホステッド エージェントには Microsoft ホステッド エージェントを超えるパフォーマンス上の利点がありますか?

多くの場合、あります。 具体的な内容は次のとおりです。

• セルフホステッド エージェントを使用する場合は、インクリメンタル ビルドを実行できます。 たとえば、リポジトリをクリーンせず、クリーン ビルドを実行しないパイプラインを定義した場合、通常、ビルドの実行速度は速くなります。 Microsoft ホステッド エージェントを使う場合は、ビルドまたはリリース パイプラインが完了した後にエージェントが破棄されるため、(キャッシュなどの機能を使用しない限り) このような利点はありません。

• Microsoft ホステッド エージェントは、ビルドの開始により長い時間がかかることがあります。 多くの場合は、Microsoft ホステッド エージェントにジョブが割り当てられるまでに数秒しかかかりませんが、システムの負荷によっては、エージェントが割り当てられるまでに数分かかる場合があります。

同じマシンに複数のセルフホステッド エージェントをインストールできますか?

はい。 このアプローチは、多くの共有リソースを消費しないジョブを実行するエージェントに対しては適切に機能します。 たとえば、作業の大部分がデプロイの調整であり、エージェント自体では多くの作業を行わないリリースを実行するエージェントには試してみることができます。

それ以外の場合は、同じマシンで複数のエージェントを実行しても、あまり効率が上がらないことがわかるかもしれません。 たとえば、大量のディスクや I/O リソースを消費するビルドを実行するエージェントでは、それだけの価値がない可能性があります。

並列ビルド ジョブで同じシングルトン ツール デプロイ (npm パッケージなど) を使う場合も問題が発生する可能性があります。 たとえば、あるビルドが依存関係を更新しているときに、別のビルドがそれを使用している最中である場合は、信頼できない結果やエラーが発生する可能性があります。

パイプライン ジョブが取り消されたときのエージェントの動作はどうなりますか?

Microsoft ホステッド エージェントの場合、エージェントは切断され、Azure Pipelines プールに戻されます。

セルフホステッド エージェントの場合:

パイプラインが取り消されると、エージェントは、現在の手順を実行しているプロセスに一連のコマンドを送信します。 最初のコマンドは 7.5 秒のタイムアウトで送信されます。 プロセスが終了していない場合、2 つ目のコマンドは 2.5 秒のタイムアウトで送信されます。 プロセスが終了していない場合、エージェントはプロセスを強制終了するコマンドを発行します。 プロセスが最初の 2 つの終了要求を受け入れない場合は強制終了されます。 最初の要求から終了までにかかる時間は約 10 秒です。

パイプラインを取り消すためにプロセスに発行されるコマンドは、エージェントのオペレーティング システムによって異なります。

• macOS と Linux - 送信されるコマンドは、SIGINT、SIGTERM、SIGKILL の順です。
• Windows - プロセスに送信されるコマンドは、Ctrl+C、Ctrl+Break、Process.Kill の順です。

特定のエージェント プールに対してプログラムでエージェントの更新をトリガーするにはどうすればよいですか?

次の API を使うことで、プールのエージェント更新をトリガーできます。

POST https://dev.azure.com/{organization}/_apis/distributedtask/pools/{poolId}/messages?agentId={agentId}&api-version=6.0

URI パラメーター

名前	/	必須	タイプ	説明
agentId	query	False	string	更新するエージェント。 指定しない場合、すべてのエージェントに対して更新がトリガーされます。
organization	path	True	string	Azure DevOps 組織の名前です。
poolId	path	True	integer int32	使うエージェント プール
api-version	query	False	string	使う API のバージョン。 このバージョンの API を使うには、'6.0' に設定する必要があります。

エージェントの更新をトリガーするには、要求本文を空にする必要があります。

注意

Azure Pipelines エージェントは GitHub 上のオープン ソースです。

詳細情報

エージェントの詳細については、「Azure DevOps を使用してアプリケーションをビルドする」ラーニング パスの次のモジュールを参照してください。

• Microsoft ホステッド ビルド エージェントまたはセルフホステッド ビルド エージェントを選択する
• Azure Pipelines で独自のビルド エージェントをホストする