クラシック パイプライン構成
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
従来のパイプラインを使用すると、開発者はユーザー インターフェイスを使用してパイプライン ワークフローを簡単に設計し、シナリオに合わせたタスクと条件を追加できます。 この記事では、エージェント ジョブを構成するために使用できるオプションについて説明し、クラシック パイプラインのさまざまなビルド プロパティについて説明します。
エージェント ジョブ
Azure DevOps 組織にサインインし、プロジェクトに移動します。
[Pipelines] を選択し、パイプライン定義を選んで、[編集] を選択してください。
Tasks を選択し、 Agent job を選択します。
既定のエージェント プール:
ビルドをキューに入れると、選択したプールのエージェントで実行されます。 Microsoft がホストするプールまたは管理するセルフホステッド プールを選択できます。 このパイプラインを実行するエージェントに関連付けられている pool を選択します。
Parallelism
ジョブのタスクを並列で実行する方法を定義します。
なし: タスクは 1 つのエージェントで実行されます。
複数構成: 乗数で指定されているように、タスクは複数の構成で実行されます。 構成は並列で実行され、それぞれが 1 つのエージェントを使用します。 エージェントの合計数は構成の数によって異なり、エージェントの最大数を設定することで制限できます。
マルチエージェント: タスクは、指定された数のエージェントを使用して複数のエージェントで実行されます。
タイムアウト
サーバーによって取り消されるまでのエージェントでのデプロイの実行を許可する最大時間を分単位で指定します。 期間は、事前申請が完了した後、承認後に要求される前に測定されます。 値が 0 の場合、親パイプラインのタイムアウトが使用されます。
ジョブ キャンセルのタイムアウト
サーバーによって終了される前に、取り消し要求に応答する展開ジョブの最大待機時間を指定します。 値が 0 の場合、親パイプラインのタイムアウトが使用されます。
スクリプトが OAuth トークンにアクセスできるようにする
スクリプトやその他のプロセスが、 System.AccessToken 変数を介して OAuth トークンにアクセスできるようにします。 詳細については、REST API にアクセスするための サンプル スクリプト を参照してください。
ビルド プロパティ
Azure DevOps 組織にサインインし、プロジェクトに移動します。
Pipelinesを選択し、パイプライン定義を選択し、Edit を選択してから、Options タブを選択します。
ビルド番号の形式
完成したビルドにわかりやすい名前を付ける形式を定義します。 ビルドに名前として一意の整数を付ける場合は、空白のままにします。 詳細については、「 構成ビルドの実行番号 を参照してください。
失敗時に作業項目を作成する
有効にすると、パイプラインが失敗した場合、問題を追跡するために作業項目が自動的に作成されます。 作業項目の種類を指定し、それをリクエスタに割り当てるかどうかを選択できます。
- 追加フィールド: 作業項目の作成時に追加フィールドを設定します。
たとえば、"System.Title" = "Build $(build.buildNumber) failed" は作業項目のタイトルを書式設定し、"System.Reason" = "ビルドエラー" は理由を設定します。 その他の使用可能なフィールドについては、「 作業項目フィールドのインデックス を参照してください。
ビルド ジョブ
ビルド ジョブの承認とタイムアウトの設定を定義します。
ビルド ジョブの承認スコープ: ビルド ジョブの承認スコープを指定します。 選択:
- プロジェクト コレクション: パイプラインが複数のプロジェクトにアクセスする必要がある場合。
- 現在のプロジェクト: 現在のプロジェクト内のリソースにのみアクセスするようにこのパイプラインを制限する場合。
詳細については、「 ジョブ アクセス トークンの管理 」を参照してください。
ビルド ジョブのタイムアウト (分単位): サーバーによって取り消されるまでに、エージェントでビルド ジョブを実行できる最大時間を指定します。 空またはゼロの値は、タイムアウト制限がないことを示します。
ビルド ジョブの取り消しタイムアウト (分単位): サーバーによって終了される前に、ビルド ジョブがキャンセル要求に応答するまでの最大待機時間を指定します。
確認要求
エージェントがこのパイプラインを実行するために必要な機能を指定します。 詳細については、「 Agent の機能と要求 を参照してください。
