クラシックリリースパイプラインでデプロイグループを使用する

2025-05-28

Azure DevOps Services |Azure DevOps Server 2022 および Azure DevOps Server 2019

エージェントプールと同様に、デプロイグループはターゲットマシンの論理セットであり、それぞれにデプロイエージェントがインストールされています。デプロイグループは、通常、*開発、 テスト、運用などの環境を表します。デプロイグループ内の各物理マシンまたは仮想マシンは、デプロイタスクを調整するために Azure Pipelines と通信します。デプロイグループは、YAML パイプラインで定義されているタスク関連のステップのコレクションであるデプロイジョブとは異なります。

デプロイグループを使用すると、デプロイターゲットを柔軟に管理および監視できます。エージェントのセキュリティコンテキストとランタイム環境を定義し、ロールとアクセス許可をチームメンバーに割り当て、各サーバーのライブログを使用してデプロイをリアルタイムで可視化できます。タグを使用して特定のマシンをターゲットにして、デプロイをより正確かつ効率的にすることもできます。

注

デプロイグループは、クラシックリリースパイプラインでのみ使用できます。

前提条件

製品	必要条件
Azure DevOps	- Azure DevOps 組織。 - Azure DevOps プロジェクト。 - 展開エージェントをインストールして構成するための Windows または Linux コンピューターの管理者アクセス許可。

配置グループを作成する

Azure DevOps 組織にサインインし、プロジェクトに移動します。
プロジェクトで[ パイプライン]、[ デプロイグループ]の順に選択します。
[ デプロイグループ ] ページで、[ 新規] を選択します。これが最初のデプロイグループの場合は、[ デプロイグループの追加] を選択します。
[配置グループ名] を入力し、 [作成] を選択します。
次の画面で、 Windows または Linux を選択して、登録するターゲットの Type。登録スクリプトが生成されます。
認証用のスクリプトで [個人用アクセストークンを使用する] を選択し、[スクリプトをクリップボードにコピー] を選択します。
コピーしたスクリプトを保存して、デプロイグループ内のすべてのターゲットマシンで実行します。

ターゲットサーバーを登録する

展開グループ内の各ターゲットサーバーを登録するには:

管理者権限を持つアカウントを使用してマシンにサインインし、コピーしたスクリプトを実行します。 Windows マシンの場合は、管理者特権の PowerShell コマンドプロンプトを使用します。
タグの追加を求められたら ( 展開グループジョブ内の特定のサーバーへのデプロイをターゲットにできます)、Y と入力し、1 つ以上のタグを指定します。タグでは大文字と小文字が区別されず、それぞれ 256 文字に制限され、使用できるタグの数に制限はありません。
セットアップが完了すると、スクリプトは次のメッセージを返します。
```
Service vstsagent.{organization-name}.{computer-name} started successfully.
```

エージェントのインストールとアップグレード

配置グループ内のすべてのターゲットサーバーに、デプロイエージェントが必要です。ターゲットサーバー用に生成された登録スクリプトによって、エージェントがインストールされます。または、次のいずれかの方法を使用してエージェントをインストールできます。

Azure VM の場合、各 VM に Azure Pipelines エージェント拡張機能をインストールすることで、サーバーを簡単に設定できます。
リリースパイプラインで AzureResourceGroupDeploymentV2 タスクを使用して、デプロイグループエージェントを動的に作成および登録します。

詳細については、デプロイグループ向けのプロビジョニングエージェントをご覧ください。

再デプロイせずにデプロイエージェントを最新バージョンにアップグレードするには、[ デプロイグループ ] ページに移動し、展開グループの横にある [その他のアクション ] 省略記号を選択して、[ ターゲットの更新] を選択します。詳細については、「エージェント」を参照してください。

配置グループ内のターゲットを更新する方法を示すスクリーンショット。