要求の指定

注意

Microsoft Team Foundation Server (TFS) 2018 以前のバージョンでは、ビルドとリリースの "パイプライン" は "定義"、"実行" は "ビルド"、"サービス接続" は "サービス エンドポイント"、"ステージ" は "環境"、"ジョブ" は "フェーズ" と呼ばれます。

要求を使用して、パイプラインが必要とする機能が、それを実行するエージェント上に存在することを確認します。 要求は、タスクによって自動的にアサートされるか、手動でアサートされます。

注意

要求と機能は、ジョブの要件を満たすエージェントとジョブを照合できるように、自己ホスト型エージェントで使用するように設計されています。 Microsoft がホストするエージェントを使用する場合は、ジョブの要件に一致するエージェントのイメージを選択します。そのため、Microsoft がホストするエージェントに機能を追加することはできますが、Microsoft がホストするエージェントで機能を使用する必要はありません。

タスクの要求

エージェントが1つ以上の要求を満たしていないと、一部のタスクが実行されません。 たとえば、 Visual Studio のビルド タスクでは、 msbuild エージェントにとがインストールされていることが要求され visualstudio ます。

手動で入力された要求

特別な機能を備えた自己ホスト型エージェントの使用が必要になる場合があります。 たとえば、パイプラインでプール内のエージェントに特別な ソフトウェア が必要になる場合があり Default ます。 また、同じプール内の異なるオペレーティングシステムを持つ複数のエージェントがある場合は、Linux エージェントを必要とするパイプラインがある可能性があります。

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

pool:
  name: Default
  demands: SpecialSoftware # Check if SpecialSoftware capability exists

複数の要求を追加する必要がある場合は、行ごとに1つ追加します。

pool:
  name: MyPool
  demands:
  - myCustomCapability   # check for existence of capability
  - agent.os -equals Darwin  # check for specific string in capability

注意

機能の存在 (存在する場合) を確認し、機能に特定の文字列 (等しい) があるかどうかをチェックするのは、要求に対してサポートされている2つの操作だけです。

詳細と例については、「 Yaml スキーマ要求」を参照してください。

機能がある各エージェントを登録します。

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

    1. [ Azure DevOps]、[ 組織の設定] の順に選択します。

      [組織の設定] を選択します。

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

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

    1. [ Azure DevOps]、[ コレクションの設定] の順に選択します。

      [コレクションの設定] を選択します。

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

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

    1. [ Azure DevOps]、[ コレクションの設定] の順に選択します。

      コレクション設定、2019。

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

      エージェントプール、2019を選択します。

    1. プロジェクトに移動し、[ 設定 ] (歯車アイコン) > エージェントキュー] を選択します。

      [設定]、[エージェントキュー]、[2018] の順に選択します。

    2. [ プールの管理] を選択します。

      [プールの管理]、[2018] の順に選択します。

    1. プロジェクトに移動し、[ 設定 ] (歯車アイコン) > エージェントキュー] を選択します。

      [設定]、[エージェントキュー]、[2017] の順に選択します。

    2. [ プールの管理] を選択します。

      [プールの管理]、[2017] の順に選択します。

    1. プロジェクトに移動し、[ プロジェクトの管理 ] (歯車アイコン) を選択します。

      プロジェクト2015を管理します。

    2. [ コントロールパネル] を選択します。

      [コントロールパネル]、[2015] の順に選択します。

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

      エージェントプール、2015を選択します。

  2. エージェントの [機能] タブに移動します。

    1. [ エージェントプール ] タブで、目的のエージェントプールを選択します。

      [エージェントプール] で、目的のエージェントプールを選択します。

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

      [エージェント] を選択し、エージェントを選択します。

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

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

      注意

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

    1. [ エージェントプール ] タブで、目的のプールを選択します。

      目的のプールを選択します。

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

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

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

      [エージェント機能] タブ。

    1. [ エージェントプール ] タブで、目的のプールを選択します。

      目的のタブ2019を選択します。

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

      目的のエージェント2019を選択します。

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

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

    目的のエージェントを選択し、[ 機能 ] タブを選択します。

    [エージェントの機能] タブ2018。

    目的のエージェントを選択し、[ 機能 ] タブを選択します。

    [エージェントの機能] タブ2017。

    [ エージェントプール ] タブで、目的のエージェントを選択し、[ 機能 ] タブを選択します。

    [エージェント機能] タブ2015を選択します。

  3. 次のようなエントリを追加します。

最初のボックス 2番目のボックス
特殊ソフトウェア C:\Program Files (x86)/特殊ソフトウェア

ヒント

クラシック非 YAML ビルド定義の場合、手動でビルドをキューに入れたときに、その実行に対する要求を変更できます。