環境での VM リソースの管理

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

この記事では、環境で仮想マシン (VM) リソースを使用して、複数のマシンにまたがる Azure Pipelines デプロイを管理する方法について説明します。 また、展開をローリングするために、独自のサーバーにエージェントをインストールすることもできます。

VM リソースは、開発、テスト、運用などの 環境に存在できます。 環境を定義したら、デプロイでターゲットに VM を追加できます。 環境のデプロイ履歴は、各 VM からパイプラインへの追跡可能性を提供します。

前提条件

環境の作成

VM リソースを環境に追加するには、次の手順に従います。 同じプロセスを使用して、物理マシンを設定できます。

VM リソースを追加する

1. Azure DevOps プロジェクトで、Pipelines>Environments に移動し[環境の作成または新しい環境を選択。

2. 最初の New 環境 画面で、 Name と省略可能な Description を追加します。

3. Resourceで、仮想マシンを選択し、次へ選択。

   

登録スクリプトをコピーする

VM リソースのエージェント スクリプトは、セルフホステッド エージェントのスクリプトに似ていますが、同じコマンドを使用します。 スクリプトには、サインインしているユーザーの Azure DevOps 個人用アクセス トークン (PAT) が含まれます。このトークンは、スクリプトが生成されてから 3 時間後に期限切れになります。

コピーしたスクリプトを実行する

1. Close を選択し、新しい環境が作成されることに注意してください。 PAT の有効期限が切れた場合など、スクリプトをもう一度コピーするには、 リソースの追加を選択します。

   

2. 環境に登録する各ターゲット VM でコピーしたスクリプトを実行します。

   Note

   VM に既に別のエージェントが実行されている場合は、環境に登録する agent の一意の名前を指定します。

VM が登録されると、環境の Resources タブにリソースとして表示されます。

パイプラインで VM を使用する

YAML パイプラインでは、その環境を参照して VM をターゲットにすることができます。 既定では、ジョブは、その環境の resourceNameに登録されているすべての VM を対象とします。

trigger: 
- main

pool: 
   vmImage: ubuntu-latest

jobs:
- deployment: VMDeploy
  displayName: Deploy to VM
  environment: 
   name: VMenv
   resourceName: VMenv
   resourceType: virtualMachine
  strategy:
     runOnce:
        deploy:   
          steps:
            - script: echo "Hello world"

resourceNameで指定することで、環境内の特定の VM にデプロイできます。 次の例では、VMenv環境の RESOURCE-PC という名前の VM リソースにのみデプロイします。

trigger: 
- main

pool: 
   vmImage: ubuntu-latest

jobs:
- deployment: VMDeploy
  displayName: Deploy to VM
  environment: 
    name: VMenv
    resourceType: virtualMachine
    resourceName: RESOURCE-PC # only deploy to the VM resource named RESOURCE-PC
  strategy:
    runOnce:
      deploy:   
          steps:
          - script: echo "Hello world"

YAML パイプライン デプロイ ジョブの詳細については、 YAML パイプライン スキーマを参照してください。

タグを追加および管理する

タグは、デプロイのために環境内の特定の VM セットをターゲットにする方法です。 タグはそれぞれ 256 文字に制限されています。 使用できるタグの数に制限はありません。

対話型登録スクリプトで、または UI を使用して VM のタグを追加したり、タグを削除したりできます。その場合は、VM リソースに対して その他のアクション を選択します。

複数のタグを指定した場合、パイプラインはすべてのタグを含む VM のみを使用します。 次の例では、 windows タグと prod タグの両方を持つ VM のみを対象としています。 タグが 1 つしかない VM またはタグがない VM は対象になりません。

trigger: 
- main

pool: 
   vmImage: ubuntu-latest

jobs:
- deployment: VMDeploy
  displayName: Deploy to VM
  environment: 
    name: VMenv
    resourceType: virtualMachine
    tags: windows,prod # only deploy to VMs with both windows and prod tags
  strategy:
    runOnce:
      deploy:   
          steps:
          - script: echo "Hello world"

デプロイ戦略を適用する

デプロイ strategy を適用して、アプリケーションをロールアウトする方法を定義できます。 VM では、 runOnce と rolling の両方の戦略がサポートされています。 デプロイ戦略とライフサイクル フックの詳細については、「 デプロイ戦略を参照してください。

デプロイ履歴を表示する

[デプロイ] タブを選択して、コミットと作業項目の完全な追跡可能性と、環境およびリソースごとのクロスパイプライン デプロイ履歴を確認します。

環境から VM を削除する

./config.sh remove

./config.cmd remove

関連するコンテンツ

• 環境の作成とターゲット設定
• デプロイ ジョブ
• YAML パイプラインスキーマリファレンス