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

2025-04-23

Azure DevOps Services |Azure DevOps Server 2020 |Azure DevOps Server 2019

Azure Pipelines を使用して、正常にビルドされるたびに Web アプリを Azure App Service に自動的にデプロイします。 Azure Pipelines では、 Azure DevOps を使用して、継続的インテグレーションと継続的デリバリー (CI/CD) を使用してビルド、テスト、デプロイを行うことができます。

YAML パイプラインは、リポジトリ内の YAML ファイルを使用して定義されます。ステップは、パイプラインの最小の構成要素であり、スクリプトまたはタスク (事前にパッケージ化されたスクリプト) です。パイプラインを構成する主要な概念とコンポーネントについて説明します。

Azure Web App タスク (AzureWebApp) を使用して、パイプライン内の Azure App Service にデプロイします。デプロイで XML パラメーターを使用する必要がある場合など、より複雑なシナリオでは、 Azure App Service デプロイタスク AzureRmWebAppDeploymentを使用できます。

前提条件:

アクティブなサブスクリプションが含まれる Azure アカウント。無料でアカウントを作成できます。
Azure DevOps 組織。無料で作成できます。
Microsoft がホストするエージェントでパイプラインを実行する機能。並列ジョブを購入することも、Free レベルを要求することもできます。
GitHub または Azure Repos でホストされているコードを含む、動作する Azure App Service アプリ。
- .NET: Azure で ASP.NET Core Web アプリを作成します。
- ASP.NET: Azure で ASP.NET Framework Web アプリを作成します。
- JavaScript: Azure App Service で Node.js Web アプリを作成します。
- Java: Azure App Service で Java アプリを作成します。
- Python: Azure App Service で Python アプリを作成します。

1.スタックのパイプラインを作成する

このセクションのコード例では、ASP.NET Web アプリをデプロイすることを前提としています。この手順は、他のフレームワークに合わせて調整できます。

詳しくは、Azure Pipelines エコシステムのサポートに関する記事を参照してください。

YAML
クラシック

Azure DevOps 組織にサインインし、プロジェクトに移動します。
[パイプライン] に移動し、[新しいパイプライン] を選択します。
ダイアログが表示されたら、ソースコードの場所 (Azure Repos Git または GitHub のいずれか) を選びます。

サインインするために GitHub にリダイレクトされる場合があります。その場合は、GitHub の資格情報を入力します。
リポジトリの一覧が表示されたら、目的のリポジトリを選択します。
Azure Pipelines アプリをインストールするために、GitHub にリダイレクトされる場合があります。その場合は、[承認してインストール] を選択します。
[構成] タブが表示されたら、[ASP.NET Core] を選択します。
新しいパイプラインが表示されたら、YAML に目を通し、その動作を確認します。準備ができたら、[保存および実行] を選択します。

YAML ファイルの末尾を選択し、[ アシスタントの表示] を選択します。
タスクアシスタントを使用して、Azure Web アプリタスクを追加します。

または、 Azure App Service のデプロイ AzureRmWebAppDeployment タスクを追加することもできます。
お使いの Azure サブスクリプションを選びます。必ず [ 承認 ] を選択して接続を承認してください。認可により、必要なサービス接続が作成されます。
App Service アプリに基づいて、[アプリの種類]、[アプリ名]、[ランタイムスタック] を選びます。完成した YAML は次のコードのようになります。
```
variables:
  buildConfiguration: 'Release'

steps:
- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: true
- task: AzureWebApp@1
  inputs:
    azureSubscription: '<service-connection-name>'
    appType: 'webAppLinux'
    appName: '<app-name>'
    package: '$(System.DefaultWorkingDirectory)/**/*.zip'
```
- azureSubscription: Azure サブスクリプションへの承認されたサービス接続の名前。
- appName: 既存のアプリの名前。
- package: パッケージまたは App Service コンテンツを含むフォルダーへのファイルパス。ワイルドカードを利用できます。

作業を開始するには:

リリースパイプラインを作成します。左側のメニューから [ リリース ] を選択し、[ 新しいパイプライン] を選択します。
実際のステージに合わせて [Azure App Service の配置] テンプレートを選びます。この手順では、必要なタスクが自動的に追加されます。

注

Node.js アプリを App Service on Windows にデプロイする場合は、[ Deployed Node.js App to Azure App Service ] テンプレートを選択します。これらのテンプレートの唯一の違いは、Node.js テンプレートが、web.config サービスを開始するパラメーターを含むiisnode ファイルを生成するようにタスクを構成することです。
このリリースパイプラインを前の手順の Azure 成果物にリンクするには、[成果物の追加]>[ビルド] を選びます。
ソース (ビルドパイプライン) で、前のセクションで作成したビルドパイプラインを選択します。その後、追加を選択します。
動作を確認するには、リリースパイプラインを保存し、リリースを作成します。

例: .NET アプリをデプロイする

YAML
クラシック

.zip Web パッケージ (ASP.NET Web アプリなど) を Azure Web アプリにデプロイするには、次のスニペットを使用してビルドをアプリにデプロイします。

variables:
  buildConfiguration: 'Release'

steps:
- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: true
- task: AzureWebApp@1
  inputs:
    azureSubscription: '<service-connection-name>'
    appType: 'webAppLinux'
    appName: '<app-name>'
    package: '$(System.DefaultWorkingDirectory)/**/*.zip'

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

例: 仮想アプリケーションへのデプロイ

YAML
クラシック

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

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

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

例: スロットにデプロイする

YAML
クラシック

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

- 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>'
    appType: webAppLinux
    WebAppName: '<app-name>'
    ResourceGroupName: '<name of resource group>'
    SourceSlot: staging
    SwapWithProduction: true

azureSubscription: Azure サブスクリプション。
appType: (省略可能) webAppLinux を使用して、Linux 上の Web アプリにデプロイします。
appName: 既存のアプリサービスの名前。
deployToSlotOrASE*：ブーリアン。既存のデプロイスロットまたは Azure App Service Environment にデプロイします。
resourceGroupName: リソースグループの名前。 deployToSlotOrASE が true の場合は必須です。
slotName: スロットの名前。既定では production。 deployToSlotOrASE が true の場合は必須です。
package: パッケージまたは App Service コンテンツを含むフォルダーへのファイルパス。ワイルドカードを利用できます。
SourceSlot: SwapWithProduction が true の場合に運用環境に送信されるスロット。
SwapWithProduction：ブーリアン。ソーススロットのトラフィックを運用環境と入れ替えます。

例: 複数の Web アプリにデプロイする

YAML
クラシック

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'

例: 条件付きでデプロイする

YAML
クラシック

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

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

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

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

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

例: Web Deploy でデプロイする

Azure App Service デプロイタスク AzureRmWebAppDeployment 、Web デプロイを使用して App Service にデプロイできます。

YAML
クラシック

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@4
  inputs:
    ConnectionType: 'AzureRM'
    azureSubscription: '<service-connection-name>'
    appType: 'webApp'
    WebAppName: '<app-name>'
    packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip'
    enableCustomDeployment: true
    DeploymentType: 'webDeploy'

リリースパイプラインで Azure App Service デプロイ テンプレートを使用している場合:

[ タスク ] タブを選択し、[ Azure App Service のデプロイ ] ( AzureRmWebAppDeployment タスク) を選択します。
ダイアログで [接続の種類] が Azure Resource Manager に設定されていることを確認します。
ダイアログで、[ 追加の展開オプション] を 展開し、[ 展開方法の選択] を選択します。デプロイ方法として [Web 配置] が選ばれていることを確認します。
リリースパイプラインを保存します。

注

AzureRmWebAppDeployment@3タスクとAzureRmWebAppDeployment@4タスクでは、Web デプロイを使用してデプロイするときにAzureRM の接続の種類またはを使用する必要があります。アプリで基本認証が有効になっている場合、デプロイ時に発行プロファイルが使用されます。基本認証を無効にすると、より安全な Microsoft Entra ID 認証が使用されます。

よく寄せられる質問

タスク `AzureWebApp` と `AzureRmWebAppDeployment` の違いは何ですか?

Azure Web App タスク AzureWebAppは、Azure Web アプリにデプロイする最も簡単な方法です。既定では、デプロイは Azure Web アプリのルートアプリケーションに対して行われます。

Azure App Service デプロイタスク (AzureRmWebAppDeployment) は、次のようにその他のカスタムシナリオに対応できます。

通常、インターネットインフォメーションサービス (IIS) の展開プロセスを使用する場合は、Web 配置を使用して展開します。
仮想アプリケーションにデプロイする。
コンテナーアプリ、関数アプリ、Web ジョブ、API アプリ、モバイルアプリなど、他の種類のアプリにデプロイします。

注

個別のファイル変換タスクでは、Azure Pipelines で使用するためのファイル変換と変数の置換もサポートされています。 ファイル変換タスクを使用すると、任意の構成ファイルとパラメーターファイルにファイル変換と変数置換を適用できます。

"無効な App Service パッケージまたはフォルダーパスが指定されました" というメッセージが表示されるのはなぜですか?

YAML パイプラインでは、パイプラインによっては、ビルドされた Web パッケージを保存する場所と、デプロイタスクで検索する場所が一致しない場合があります。たとえば、AzureWebApp タスクはデプロイ用の Web パッケージを取得します。 AzureWebApp タスクは、$(System.DefaultWorkingDirectory)/**/*.zipで検索される場合があります。 Web パッケージが他の場所に保管されている場合は、package の値を変更します。

"Webdeploy オプションを使用した発行は、Windows エージェントを使用している場合にのみサポートされます" というメッセージが表示されるのはなぜですか?

このエラーは、AzureRmWebAppDeploymentを使用してデプロイするようにタスクを構成したが、エージェントが Windows を実行していない場合に、タスクで発生します。 YAML に次のようなコードが含まれていることを確認します。

pool:
  vmImage: windows-latest

基本認証を無効にすると Web 配置が機能しないのはなぜですか?

AzureRmWebAppDeployment タスクで Microsoft Entra ID 認証を使用するためのトラブルシューティング情報については、「Windows エージェントからの Microsoft Entra ID 認証を使用して Azure App Service に Web デプロイできない」を参照してください。

Azure DevOps パイプラインをカスタマイズします。

次の方法で共有