Azure Pipelines を使用して Azure App Service にデプロイする

コード リポジトリに azure-pipelines.yml YAML ファイルを作成してパイプラインを定義します。

1. Azure DevOps プロジェクトの左側のナビゲーション メニューで、[ パイプライン] を選択します。
2. [パイプライン] ページ で 、[ 新しいパイプライン] を選択するか、このパイプラインがプロジェクトの最初のパイプラインである場合は [パイプラインの 作成 ] を選択します。
3. [コードの場所] 画面で、ソース コードの場所 (Azure Repos Git または GitHub) を選択します。 必要に応じて、GitHub にサインインします。
4. [ リポジトリの選択 ] 画面で、コード リポジトリを選択します。
5. [ パイプラインの構成 ] 画面で、[ スターター パイプライン] を選択します。

.NET Core (DotNetCoreCLI@2) タスクをパイプラインに追加し、アプリをビルドして発行します。

1. パイプライン YAML の確認 画面で、 steps: 行の後にあるすべてのコードを削除します。
2. ファイルの末尾を選択し、右側にある [アシスタントの表示 ] を選択します。
3. [ タスク] で 、[ .NET Core] を選択します。
4. .NET Core 構成画面の Azure Resource Manager 接続で、Azure サブスクリプションを選択し、[承認] を選択して必要なサービス接続を作成します。
5. [ コマンド] で [発行] を選択 します。
6. [ Web プロジェクトの発行 ] チェック ボックスと [ Zip 発行済みプロジェクト ] チェック ボックスがオンになっていることを確認し、[ 追加] を選択します。
7. タスクが YAML パイプラインに表示されます。 YAML コードを確認して、動作を確認します。 準備ができたら、[ 保存して実行] を選択し、[ 保存して再度実行] を選択します。
8. ビルドの 概要 画面の [ ジョブ] で、[ 必要なアクセス許可 ] リンクを選択します。 [ チェック ] 画面で、[ 許可] を選択し、もう一度 [許可 ] を選択します。 ここでアクセス許可を付与すると、このパイプラインのすべての実行に対して承認したサービス接続の使用が許可されます。

1. Azure DevOps プロジェクトの左側のナビゲーション メニューで、[ パイプライン] を選択します。
2. [パイプライン] ページ で 、[ 新しいパイプライン] を選択するか、このパイプラインがプロジェクトの最初のパイプラインである場合は [パイプラインの 作成 ] を選択します。
3. [コードの場所] 画面で、[クラシック エディターを使用して YAML なしでパイプラインを作成する] を選択します。
4. [リポジトリの選択] 画面で、ソース コードの場所 (Azure Repos Git または GitHub) を選択し、コード リポジトリと既定のブランチを選択します。 続行を選択します。
5. [ テンプレートの選択 ] 画面で、[ コア ASP.NET 選択し、[ 適用] を選択します。
6. 新しいパイプライン画面の右側の [エージェントの仕様 ] で、アプリのプラットフォームとバージョンに応じて 、ubuntu-latest や windows-latest などのエージェント仕様を選択します。
7. パイプラインを見て、それが何をするのかを確認します。 準備ができたら、[ 保存してキュー] を選択します。
8. もう一度 [保存してキュー] を選択し、[ パイプラインの実行 ] 画面で [保存して実行] を選択します。

1. パイプラインの実行 の概要 画面で、右上にある [その他のアクション ] アイコンを選択し、[ パイプラインの編集] を選択します。
2. YAML ファイルの末尾を選択し、[タスク] リストに表示されていない場合は [アシスタントの表示] を選択します。
3. [タスク] ボックスの一覧で、Azure Web App タスクを検索して選択します。 または、 Azure App Service デプロイ タスクを使用することもできます。
4. Azure Web App 構成画面の Azure サブスクリプションで、前の手順で設定したのと同じサービス接続を選択します。 この接続を再認証する必要はありません。
5. [アプリの種類] で、コードに応じて [Azure Web App on Linux] または [Azure Web App on Windows] を選択します。
6. [アプリ名] で、App Service アプリ名を選択または入力します。
7. [] を選択し、[] を追加します。
8. [ 検証して保存] を選択し、[ 保存] を選択します。
9. [ 実行] を選択し、もう一度 [実行 ] を選択します。

完全な YAML パイプラインは、次のコードのようになります。

trigger:
- <branch-specification>

pool:
  vmImage: <agent-specification>

steps:
- task: DotNetCoreCLI@2
  inputs:
    azureSubscription: '<your-authorized-service-connection>'
    command: 'publish'
    publishWebProjects: true

- task: AzureWebApp@1
  inputs:
    azureSubscription: '<your-authorized-service-connection>'
    appType: 'webApp'
    appName: '<your-app-name>'
    package: '$(System.DefaultWorkingDirectory)/**/*.zip'
    deploymentMethod: 'auto'  

• azureSubscription: Azure サブスクリプションへの承認されたサービス接続の名前。
• appName: 既存のアプリの名前。
• package: App Service コンテンツを含むパッケージまたはフォルダーへのファイル パス。 ワイルドカードを利用できます。

クラシック パイプラインの場合、ビルド ステージとリリース ステージを別々のパイプラインで定義するのが最も簡単です。

1. プロジェクトの左側のナビゲーション メニューで、[ パイプライン>リリース] を選択し、[ 新しいパイプライン ] を選択して リリース パイプラインを作成します。

2. [ テンプレートの選択] で、 Azure App Service デプロイ テンプレートを選択し、[ 適用] を選択します。 このテンプレートは、必要なタスクを自動的に追加します。

   注

   Node.js アプリを App Service on Windows にデプロイする場合は、[ Node.js アプリを Azure App Service にデプロイする ] テンプレートを選択します。 このテンプレートは、 サービスを開始するパラメーターを含む iisnode ファイルを生成するようにタスクを構成します。

3. [ 新しいリリース パイプライン ] ページで、[ タスク ] タブを選択し、[ ステージ 1] を選択し、[ パラメーター] の下にある次のフィールドに入力します。

   • Azure サブスクリプション: Azure サービス接続がまだない場合は、Azure サブスクリプションを選択し、[ 承認 ] を選択して必要なサービス接続を作成します。
   • アプリの種類: コードとエージェントの仕様に合わせて、 Linux 上の Azure WebApp または Windows 上の Azure Web App を選択します。
   • App Service 名: App Service アプリを選択します。

4. [新しいリリース パイプライン] 画面の [パイプライン] タブで、[成果物] の横にある [追加] を選択します。

5. [ 成果物の追加 ] 画面で[ ビルド ] が選択されていることを確認し、[ ソース (ビルド パイプライン)]で、前のセクションで作成したパイプラインを選択します。

6. [] を選択し、[] を追加します。

7. パイプライン ページで、右上にある [保存] を選択し、[ OK] を選択します。

8. パイプラインを実行するには、パイプライン ページで [リリースの 作成] を選択し、[ 作成] を選択します。

Azure Web App タスクは、Azure Web アプリのルート アプリケーションにデプロイされます。 VirtualApplication デプロイ タスクの プロパティを使用して、特定の仮想アプリケーションにデプロイできます。

- task: AzureRmWebAppDeployment@5
  inputs:
    VirtualApplication: '<name of virtual application>'

VirtualApplication は、Azure portal で構成された仮想アプリケーションの名前です。 詳細については、 Azure portal での App Service アプリの構成に関するページを参照してください。

Azure Web App タスクは、Azure Web アプリのルート アプリケーションにデプロイされます。 特定の仮想アプリケーションにデプロイするには、Azure App Service デプロイ タスクの仮想アプリケーション プロパティにその名前を入力します。

次の例は、ステージング スロットにデプロイしてから運用スロットにスワップする方法を示しています。

- task: AzureWebApp@1
  inputs:
    azureSubscription: '<service-connection-name>'
    appType: webAppLinux
    appName: '<app-name>'
    deployToSlotOrASE: true
    resourceGroupName: '<name of resource group>'
    slotName: staging
    package: '$(Build.ArtifactStagingDirectory)/**/*.zip'

- task: AzureAppServiceManage@0
  inputs:
    azureSubscription: '<service-connection-name>'
    WebAppName: '<app-name>'
    ResourceGroupName: '<name of resource group>'
    SourceSlot: staging
    SwapWithProduction: true

• azureSubscription: Azure サービス接続。
• appType: Linux 上の Web アプリにデプロイする webAppLinux などの省略可能なアプリの種類。
• appName: 既存のアプリの名前。
• deployToSlotOrASE：ブーリアン。 既存のデプロイ スロットまたは App Service 環境にデプロイするかどうか。
• resourceGroupName: デプロイするリソース グループの名前。 deployToSlotOrASE が true の場合は必須。
• slotName: デプロイするスロットの名前。 deployToSlotOrASE が true の場合は必須。 既定値は production です。
• package: アプリの内容を含むパッケージまたはフォルダーへのファイル パス。 ワイルドカードを利用できます。
• SourceSlot: SwapWithProduction が true の場合に運用環境に送信されるスロット。
• SwapWithProduction：ブーリアン。 ソース スロットのトラフィックを運用環境にスワップするかどうか。

[Azure Web アプリ] タスクの [スロットまたは App Service 環境に配置する] オプションを使用して、デプロイ先のスロットを指定します。 スロットを入れ替えるには、Azure App Service マネージド タスクを使います。

YAML ファイル内の ジョブ を使用して、デプロイのパイプラインを設定できます。 ジョブを使用すると、複数の Web アプリへのデプロイの順序を制御できます。

jobs:
- job: buildandtest
  pool:
    vmImage: ubuntu-latest
 
  steps:
  # publish an artifact called drop
  - task: PublishPipelineArtifact@1
    inputs:
      targetPath: '$(Build.ArtifactStagingDirectory)' 
      artifactName: drop
  
  # deploy to Azure Web App staging
  - task: AzureWebApp@1
    inputs:
      azureSubscription: '<service-connection-name>'
      appType: <app type>
      appName: '<staging-app-name>'
      deployToSlotOrASE: true
      resourceGroupName: <group-name>
      slotName: 'staging'
      package: '$(Build.ArtifactStagingDirectory)/**/*.zip'

- job: deploy
  dependsOn: buildandtest
  condition: succeeded()

  pool: 
    vmImage: ubuntu-latest
  
  steps:
    # download the artifact drop from the previous job
  - task: DownloadPipelineArtifact@2
    inputs:
      source: 'current'
      artifact: 'drop'
      path: '$(Pipeline.Workspace)'

  - task: AzureWebApp@1
    inputs:
      azureSubscription: '<service-connection-name>'
      appType: <app type>
      appName: '<production-app-name>'
      resourceGroupName: <group-name>
      package: '$(Pipeline.Workspace)/**/*.zip'

複数の Web アプリにデプロイするには、リリース パイプラインにステージを追加します。 デプロイの順序を制御できます。 詳細については、「 ステージ」を参照してください。

YAML で条件付きでデプロイするには、次のいずれかの手法を使用します。

• 手順に条件を追加します。
• デプロイ手順を別のジョブに分離し、そのジョブに条件を追加します。

次の例は、ステップ条件を使用して、メイン ブランチから作成された成功したビルドのみをデプロイする方法を示しています。

- task: AzureWebApp@1
  condition: and(succeeded(), eq(variables['Build.SourceBranch'], 'refs/heads/main'))
  inputs:
    azureSubscription: '<service-connection-name>'
    appName: '<app-name>'

条件の詳細については、「条件の 指定」を参照してください。

リリース パイプラインでは、さまざまなチェックと条件を実装してデプロイを制御できます。

• ブランチ フィルターを設定して、リリース パイプラインの成果物に対して継続的デプロイ トリガーを構成します。
• デプロイ前の承認を設定するか、ステージへのデプロイの前提条件としてゲートを構成します。
• タスクを実行する条件を指定します。

詳細については、次の記事を参照してください。

• クラシック リリース トリガー
• 承認を使用したデプロイ制御
• デプロイ ゲートの概念

trigger:
- main

pool:
  vmImage: windows-latest

variables:
  buildConfiguration: 'Release'

steps:
- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: true
    arguments: '--configuration $(buildConfiguration)'
    zipAfterPublish: true

- task: AzureRmWebAppDeployment@5
  inputs:
    ConnectionType: 'AzureRM'
    azureSubscription: '<service-connection-name>'
    appType: 'webApp'
    WebAppName: '<app-name>'
    packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip'
    enableCustomDeployment: true
    DeploymentType: 'webDeploy'

リリース パイプラインで Azure App Service デプロイ テンプレートを使用している場合は、次の手順に従って Web デプロイにデプロイします。

1. [ タスク ] タブを選択し、[ Azure App Service のデプロイ] タスクである [ Azure App Service のデプロイ ] を選択します。
2. 構成画面で、 接続の種類 が Azure Resource Manager に設定されていることを確認します。
3. [ 追加の展開オプション] を 展開し、[ 展開方法の選択] を選択します。 デプロイ方法として [Web 配置] が選ばれていることを確認します。
4. リリース パイプラインを保存します。