Azure Pipelines 自動デプロイ（Git + ASP.NET Core）

flowchart LR
    A[開発者] --> |プッシュ| B("リポジトリ（Git）")
    B -.-> C(Azure Pipelines)
    C --> |デプロイ| D(実行環境) 

1Service Connection の作成

まずはじめに Service Connection というものを作成する必要があります。
Service Connection は Azure DevOps のパイプラインから外部サービスへアクセスするための認証付きの接続設定です。外部サービスとは GitHub のリポジトリや Azure の App Service などのリソースを指します。Azure DevOps から見ると Azure も外部サービスになるので、その接続設定が必要というわけです。

flowchart LR
    A[Azure DevOps] -->|Service Connection| B(Azure App Service)

プロジェクト の Project Settings > Service connections > New service connection をクリックし、
Azure Resource Manager を選択して Next ボタンをクリックします（図2）。

図2 Service connection の種類の選択

Service connection の内容を設定します（図3）。

図3 Service connection の設定

• Subscription を選択
• Resource group を選択
  デプロイ先の App Service のリソースグループを選択します。
• Service Connection Name を入力
  Service Connection を識別するための名称（ここでは Service Connection にしました）
• Grant access permission to all pipelines にチェック
  Pipeline すべてがこの Service connection を使用できるようになります。
  Pipeline 単位で許可を制御したい場合は未チェックのままにします。

他は初期値のまま「Save」ボタンをクリックします。
※Resource group 以下の項目は後から変更できます。

これで Service Connection の作成は完了です。

2Azure Pipeline の作成

次にデプロイを実行するパイプランの定義ファイル（YAML ファイル）を作成します。

Pipelines > Create Pipeline > Azure Repost Git（図4）> 対象のリポジトリを選択します

図4 リポジトリの種類の選択

Configure your pipeline で ASP.NET Core を選択します。（図5）
紛らわしいですが、ASP.NET や ASP.NET Core (.NET Framework) ではなく、ASP.NET Core と表示されているものを選択してください。

図5 Configure your pipeline

テンプレートの YAML ファイルが表示されます（図6）。

図6 Review your pipeline YAML

そのまま内容を変更せずに、右上の「Save and run」ボタンを押してみましょう。
コミットメッセージを入力するダイアログが表示されます（図7）。

図7 Save and run

ここで「Save and run」ボタンを押すと、既存のリポジトリのルートフォルダーに azure-pipelines.yml という名前で YAML ファイルが追加され、リポジトリにプッシュされます。
「Save and run」を押します。

しばらくすると、以下のような Pipeline の実行中画面が表示されます（図8）。
一番下の Status 欄に「Queued」と表示されています。これは Pipeline の実行リクエストがキューに追加されているけれど、まだ実行されていないことを表しています。

図8 Queued

そのまま待ちましょう。
またしばらくすると、Status が「Running」に変わり、最後に「Success」になります。
背景が緑色のチェックマークが表示されます。
これが Pipleline の実行が正常に終了した状態になります（図9）。

図9 Success

3YAML ファイルの内容

ここまでの手順でデプロイが行われたのか？というと、そうではありません。
実行されたのはビルドのみです。テンプレートの YAML ファイルの内容を詳しく見てみましょう。

# ASP.NET Core
# Build and test ASP.NET Core projects targeting .NET Core.
# Add steps that run tests, create a NuGet package, deploy, and more:
# https://docs.microsoft.com/azure/devops/pipelines/languages/dotnet-core

trigger:
- main

pool:
  vmImage: ubuntu-latest

variables:
  buildConfiguration: 'Release'

steps:
- script: dotnet build --configuration $(buildConfiguration)
  displayName: 'dotnet build $(buildConfiguration)'

trigger セクション

trigger:
- main

main ブランチに push されたときに、このパイプラインが自動的に実行されます。

pool セクション

pool:
  vmImage: ubuntu-latest

パイプラインを実行する仮想マシンイメージを指定します。
ubuntu-latest は最新の Ubuntu 環境を指します。
パイプラインを実行するための仮想マシンですので、デプロイ先の OS に合わせる必要はありません。

flowchart LR
    A(Azure Pipeline) -.-> B[仮想マシン]
    B --> |デプロイ| C(実行環境) 

variables セクション

variables:
  buildConfiguration: 'Release'

variables セクションではパイプライン内で参照する変数を定義できます。
ここでの変数は以下になります。

• 変数名: $(buildConfiguration)
• 値: Release

steps セクション

steps:
- script: dotnet build --configuration $(buildConfiguration)
  displayName: 'dotnet build $(buildConfiguration)'

steps セクションでは、パイプラインで実行するコマンド（script）やタスク（task）などの処理（ステップ）を記述します。

• dotnet build コマンドでプロジェクトをビルド
  --configuration オプションで Release モードを指定
• displayName は Azure DevOps の UI 上で表示されるラベル
  $(buildConfiguration) の値は Release なので、dotnet build Release と表示されます。

このラベルはどこに表示されるのでしょうか？
図8、図9 の Job の行をクリックするとパイプラインの実行内容の詳細画面に遷移します。
ここにパイプライン内の各処理の実行内容が表示されますが、displayName はここに表示されます（図10）。

図10 詳細画面

4発行タスクを追加

今まで見てきたように、現在の YAML ファイルにはビルドまでの設定しか定義されていません。
デプロイするための設定を追加しましょう。

デプロイを実行するためには、デプロイ用に各ファイルをまとめて成果物にする必要があります。
いわゆる「発行（publish）」です。
ここでは成果物を1つの zip ファイルに圧縮します。

Azure Pipeline の GUI から発行のタスクを追加できます。
図8、図9 の右上にある三点リーダー > Edit pipleline を選択してください。
YAML ファイルの末尾にコードを追加したいので、入力カーソルを最後の行に合わせてから Tasks の .NET Core を選択します（図11）。
（Tasks が表示されていない場合は、右上の Show assistant をクリック）

図11 Task の選択

以下のように入力します（図12）。

図12 .NET Core

• Command: publish
• Arguments: --configuration $(buildConfiguration)
Release モードでビルドします。

他はすべてデフォルトのままで「Add」ボタンをクリックします。
以下のように発行タスクのコードが追加されます（図13）。

図13 発行タスクのコードが追加された

以上で発行タスクの追加は完了です。

5デプロイタスクを追加

(4) と同じように入力カーソルを YAML の最後の行に合わせてから Tasks の Azure Web App を選択します（図14）。

図14 Task の選択

デプロイ先の内容を選択します（図15）。

図15 Azure Web App

• Azure subscription
  (1) で作成した Service Connection を選択
• App type
  デプロイ先の種別（Windows／Linux）を選択
• App name
  デプロイ先の App Service を選択

他はデフォルトのままで「Add」ボタンをクリックしてください。
以下のようにデプロイを実行する task のコードが追加されます（図16）。

図16 デプロイタスクのコードが追加された

6デプロイの実行

ここまでの手順でデプロイに必要な設定はすべて完了しました。
「Validate and save」ボタンをクリックしましょう（図17）。

図17 Validate and save

「Save」ボタンをクリックします（図18）。

図18 Validate and save

パイプライン実行中の画面に自動的に遷移します（図19）。

図19 パイプライン実行中

しばらくまつと、パイプライン実行が完了します（図20）。
これでデプロイは完了です。

図20 パイプライン実行完了

# ASP.NET Core
# Build and test ASP.NET Core projects targeting .NET Core.
# Add steps that run tests, create a NuGet package, deploy, and more:
# https://docs.microsoft.com/azure/devops/pipelines/languages/dotnet-core

trigger:
- main

pool:
  vmImage: ubuntu-latest

variables:
  buildConfiguration: 'Release'

steps:
- script: dotnet build --configuration $(buildConfiguration)
  displayName: 'dotnet build $(buildConfiguration)'

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

- task: AzureWebApp@1
  inputs:
    azureSubscription: 'Service Connection'
    appType: 'webAppLinux'
    appName: 'korochin-hoge'
    package: '$(System.DefaultWorkingDirectory)/**/*.zip'

trigger:
- main

pool:
  vmImage: ubuntu-latest

steps:
- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: true

- task: AzureWebApp@1
  inputs:
    azureSubscription: 'Service Connection'
    appType: 'webAppLinux'
    appName: 'korochin-hoge'
    package: '$(System.DefaultWorkingDirectory)/**/*.zip'