AzureWebApp@1 - Azure Web App v1タスク

このタスクはLinuxまたはWindows向けのAzureウェブアプリを展開します。

構文

# Azure Web App v1
# Deploy an Azure Web App for Linux or Windows.
- task: AzureWebApp@1
  inputs:
    azureSubscription: # string. Required. Azure subscription. 
    appType: # 'webApp' | 'webAppLinux'. Required. App type. 
    appName: # string. Required. App name. 
    #deployToSlotOrASE: false # boolean. Optional. Use when appType != "". Deploy to Slot or App Service Environment. Default: false.
    #resourceGroupName: # string. Required when deployToSlotOrASE = true. Resource group. 
    #slotName: 'production' # string. Required when deployToSlotOrASE = true. Slot. Default: production.
    package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #customDeployFolder: # string. Optional. Use when package EndsWith .war. Custom Deploy Folder. 
    #runtimeStack: # 'DOTNETCORE|9.0' | 'DOTNETCORE|8.0' | 'DOTNETCORE|7.0' | 'DOTNETCORE|6.0' | 'NODE|24-lts' | 'NODE|22-lts' | 'NODE|20-lts' | 'NODE|18-lts' | 'NODE|16-lts' | 'PYTHON|3.13' | 'PYTHON|3.12' | 'PYTHON|3.11' | 'PYTHON|3.10' | 'PYTHON|3.9' | 'PYTHON|3.8' | 'PHP|8.3' | 'PHP|8.2' | 'PHP|8.1' | 'PHP|8.0' | 'JAVA|21-java21' | 'JAVA|17-java17' | 'JAVA|11-java11' | 'JAVA|8-jre8' | 'JBOSSEAP|8-java17' | 'JBOSSEAP|8-java11' | 'JBOSSEAP|7-java17' | 'JBOSSEAP|7-java11' | 'JBOSSEAP|7-java8' | 'TOMCAT|10.1-java21' | 'TOMCAT|10.1-java17' | 'TOMCAT|10.1-java11' | 'TOMCAT|10.0-java17' | 'TOMCAT|10.0-java11' | 'TOMCAT|10.0-jre8' | 'TOMCAT|9.0-java21' | 'TOMCAT|9.0-java17' | 'TOMCAT|9.0-java11' | 'TOMCAT|9.0-jre8' | 'TOMCAT|8.5-java11' | 'TOMCAT|8.5-jre8'. Optional. Use when appType = webAppLinux. Runtime stack. 
    #startUpCommand: # string. Optional. Use when appType = webAppLinux. Startup command. 
    #siteContainersConfig: # string. Site Containers Config. 
  # Application and Configuration Settings
    #customWebConfig: # string. Optional. Use when appType != webAppLinux && package NotEndsWith .war. Generate web.config parameters for Python, Node.js, Go and Java apps. 
    #appSettings: # string. App settings. 
    #configurationStrings: # string. Configuration settings. 
  # Additional Deployment Options
    #deploymentMethod: 'auto' # 'auto' | 'zipDeploy' | 'runFromPackage'. Required when appType != webAppLinux && appType != "" && package NotEndsWith .war && package NotEndsWith .jar. Deployment method. Default: auto.

# Azure Web App v1
# Deploy an Azure Web App for Linux or Windows.
- task: AzureWebApp@1
  inputs:
    azureSubscription: # string. Required. Azure subscription. 
    appType: # 'webApp' | 'webAppLinux'. Required. App type. 
    appName: # string. Required. App name. 
    #deployToSlotOrASE: false # boolean. Optional. Use when appType != "". Deploy to Slot or App Service Environment. Default: false.
    #resourceGroupName: # string. Required when deployToSlotOrASE = true. Resource group. 
    #slotName: 'production' # string. Required when deployToSlotOrASE = true. Slot. Default: production.
    package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #customDeployFolder: # string. Optional. Use when package EndsWith .war. Custom Deploy Folder. 
    #runtimeStack: # 'DOTNETCORE|9.0' | 'DOTNETCORE|8.0' | 'DOTNETCORE|7.0' | 'DOTNETCORE|6.0' | 'NODE|22-lts' | 'NODE|20-lts' | 'NODE|18-lts' | 'NODE|16-lts' | 'PYTHON|3.13' | 'PYTHON|3.12' | 'PYTHON|3.11' | 'PYTHON|3.10' | 'PYTHON|3.9' | 'PYTHON|3.8' | 'PHP|8.3' | 'PHP|8.2' | 'PHP|8.1' | 'PHP|8.0' | 'JAVA|21-java21' | 'JAVA|17-java17' | 'JAVA|11-java11' | 'JAVA|8-jre8' | 'JBOSSEAP|8-java17' | 'JBOSSEAP|8-java11' | 'JBOSSEAP|7-java17' | 'JBOSSEAP|7-java11' | 'JBOSSEAP|7-java8' | 'TOMCAT|10.1-java21' | 'TOMCAT|10.1-java17' | 'TOMCAT|10.1-java11' | 'TOMCAT|10.0-java17' | 'TOMCAT|10.0-java11' | 'TOMCAT|10.0-jre8' | 'TOMCAT|9.0-java21' | 'TOMCAT|9.0-java17' | 'TOMCAT|9.0-java11' | 'TOMCAT|9.0-jre8' | 'TOMCAT|8.5-java11' | 'TOMCAT|8.5-jre8'. Optional. Use when appType = webAppLinux. Runtime stack. 
    #startUpCommand: # string. Optional. Use when appType = webAppLinux. Startup command. 
  # Application and Configuration Settings
    #customWebConfig: # string. Optional. Use when appType != webAppLinux && package NotEndsWith .war. Generate web.config parameters for Python, Node.js, Go and Java apps. 
    #appSettings: # string. App settings. 
    #configurationStrings: # string. Configuration settings. 
  # Additional Deployment Options
    #deploymentMethod: 'auto' # 'auto' | 'zipDeploy' | 'runFromPackage'. Required when appType != webAppLinux && appType != "" && package NotEndsWith .war && package NotEndsWith .jar. Deployment method. Default: auto.

# Azure Web App v1
# Deploy an Azure Web App for Linux or Windows.
- task: AzureWebApp@1
  inputs:
    azureSubscription: # string. Required. Azure subscription. 
    appType: # 'webApp' | 'webAppLinux'. Required. App type. 
    appName: # string. Required. App name. 
    #deployToSlotOrASE: false # boolean. Optional. Use when appType != "". Deploy to Slot or App Service Environment. Default: false.
    #resourceGroupName: # string. Required when deployToSlotOrASE = true. Resource group. 
    #slotName: 'production' # string. Required when deployToSlotOrASE = true. Slot. Default: production.
    package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #customDeployFolder: # string. Optional. Use when package EndsWith .war. Custom Deploy Folder. 
    #runtimeStack: # string. Optional. Use when appType = webAppLinux. Runtime stack. 
    #startUpCommand: # string. Optional. Use when appType = webAppLinux. Startup command. 
  # Application and Configuration Settings
    #customWebConfig: # string. Optional. Use when appType != webAppLinux && package NotEndsWith .war. Generate web.config parameters for Python, Node.js, Go and Java apps. 
    #appSettings: # string. App settings. 
    #configurationStrings: # string. Configuration settings. 
  # Additional Deployment Options
    #deploymentMethod: 'auto' # 'auto' | 'zipDeploy' | 'runFromPackage'. Required when appType != webAppLinux && appType != "" && package NotEndsWith .war && package NotEndsWith .jar. Deployment method. Default: auto.

入力

azureSubscription - Azure サブスクリプション
。必須。

デプロイメントのためのAzure Resource Managerサブスクリプション接続を指定します。

アプリの種類の
。必須。許可される値:webApp(WindowsのWebアプリ)、webAppLinux(LinuxのWebアプリ)。

Azure Web App タイプを指定します。

アプリ名の
。必須。

既存のAzure App Serviceの名前を指定します。選択したアプリの種類に基づくアプリサービスのみが一覧表示されます。

deployToSlotOrASE - スロットに展開またはApp Service Environment
。随意。するときに使用します。既定値: .

既存のデプロイスロットにデプロイするか、Azure App Service Environmentにデプロイするかを選択します。
どちらのターゲットでも、タスクにはリソースグループ名が必要です。
デプロイターゲットがスロットの場合、既定値は運用スロットです。その他の既存のスロット名も指定できます。
デプロイ対象がAzure App Service Environmentであれば、スロット名を「production」のままにし、リソースグループ名を指定します。

リソースグループの
。する場合に必要です。

リソースグループ名は、デプロイメント対象がデプロイスロットまたはAzure App Service Environmentである場合に必要です。
上記のAzure App Serviceを含むAzureリソースグループを指定します。

スロット
。する場合に必要です。既定値: .

運用スロットを除く既存のスロットを指定します。

パッケージまたはフォルダー
。必須。既定値: .

MSBuild によって生成された App Service コンテンツ、圧縮 zip ファイル、または war ファイルを含むパッケージまたはフォルダーへのファイルパス。変数 (BuildRelease) とワイルドカードがサポートされています。たとえば、やなどです。

カスタム配置フォルダーをする
。随意。するときに使用します。

展開先のカスタムフォルダー名を指定します。
フィールドが空の場合、パッケージはに展開されます。
ROOT を入力すると、パッケージはにデプロイされます。
他のすべてのインスタンスでは、にデプロイされます。

Web App on Linux には、アプリケーションを発行するための 2 つの異なるオプションが用意されています。カスタムイメージのデプロイ (Web App for Containers) と組み込みのプラットフォームイメージを使用したアプリのデプロイ (Linux 上の Web アプリ) です。このパラメーターは、タスク Linux Web App がアプリの種類として選択されている場合にのみ使用できます。

ランタイムスタックの
。随意。するときに使用します。

スタートアップコマンドの
。随意。するときに使用します。

起動コマンドを指定します。
例えば：
dotnet run
dotnet filename.dll.

customWebConfig - Python、Node.js、Go、Javaアプリの web.config パラメータを生成する
。随意。するときに使用します。

アプリケーションに標準の web.config がなければ、Azure App Serviceに生成・展開されます。 web.config の値は、アプリケーションフレームワークによって異なり、編集できます。たとえば、node.js アプリケーションの場合、web.config にはスタートアップファイルとiis_nodeモジュール値が含まれます。この編集機能は、生成された web.config専用です。

アプリ設定の
。

構文を使用して Web アプリアプリケーションの設定を指定します (例: )。スペースを含む値を二重引用符で囲みます (例: )。

構成設定の
。

構文を使用して Web アプリの構成設定を指定します (例: )。スペースを含む値を二重引用符で囲みます。

展開方法の
。する場合に必要です。使用できる値: (自動検出)、 (Zip 配置)、 (パッケージから実行)。既定値: .

アプリの展開方法を選択します。使用可能な値は、自動、zipDeploy、および runFromPackageです。

サイトコンテナー構成
。

SiteContainers デプロイメント用の siteContainers-config JSON を指定します。

タスクコントロールのオプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。詳細については、「コントロールオプションと一般的なタスクプロパティを参照してください。

出力変数

このタスクでは、次の出力変数を定義します。この変数は、ダウンストリームのステップ、ジョブ、およびステージで使用できます。

AppServiceApplicationUrl
選択したAzure App ServiceのアプリケーションURLです。

備考

このタスクを使って、Azure App Serviceにウェブアプリケーションをデプロイしてください。

デプロイ方法

このタスクでは、いくつかの展開方法を使用できます。が既定のオプションです。

デザイナータスクでパッケージベースの展開オプションを変更するには、[追加の展開オプション] 展開オプションを展開し、[展開方法の選択]有効にします。

Azure App ServiceおよびAzure Pipelinesエージェントの種類に基づいて、適切な展開技術を選択します。タスクで使用されるさまざまな展開テクノロジは次のとおりです。

Kudu REST API
Zip デプロイ
RunFromPackage (パッケージから実行)

既定では、タスクは、入力パッケージ、App Service の種類、およびエージェント OS を指定して、適切なデプロイテクノロジを選択しようとします。

App Service の種類が Web App on Linux App の場合は、Zip Deploy を使用します
War ファイルが指定されている場合は、War Deploy 使用します
Jar ファイルが指定されている場合は、パッケージから実行使用します
その他の場合は、[Zip から実行] を使用します (Zip Deploy 経由)

非Windowsエージェント(どのアプリサービスタイプでも)では、タスクはKudu REST APIsに依存してウェブアプリを展開します。

Kudu REST API

Kudu REST APIは、対象がWindowsのWeb App、LinuxのWeb App(組み込みソース)、またはFunction Appの場合、WindowsまたはLinuxの自動化エージェントで動作します。このタスクはKuduを使ってファイルをAzure App Serviceにコピーします。

Zip デプロイ

選択したパッケージまたはフォルダーの .zip 展開パッケージを作成します。ファイルの内容はAzure App Service内の関数アプリのwwwrootフォルダにデプロイされます。このオプションは、wwwroot フォルダー内のすべての既存のコンテンツを上書きします。詳細については、Azure Functionsの Zip デプロイメントを参照してください。

RunFromPackage (パッケージから実行)

Zip 配置と同じ展開パッケージを作成します。しかし、ファイルをwwwrootフォルダにデプロイする代わりに、パッケージ全体がAzure Functionsランタイムによってマウントされます。このオプションを使用すると、wwwroot フォルダー内のファイルは読み取り専用になります。詳細については、パッケージファイルからAzure Functionsを実行してくださいをご覧ください。

エラー:Azureのアクセストークンを取得できませんでした。使用されているサービスプリンシパルが有効であり、有効期限が切れていないかどうかを確認します。

このタスクはサービス接続内のサービスプリンシパルを使ってAzureで認証します。サービスプリンシパルの有効期限が切れているか、App Service に対するアクセス許可がない場合、タスクはこのエラーで失敗します。使用されているサービスプリンシパルの有効性と、それがアプリの登録に存在することを確認します。詳細については、Azureサブスクリプションリソースへのアクセス管理にロールベースのアクセス制御を使うをご覧ください。このブログ記事には、サービスプリンシパル認証の使用に関する詳細も記載されています。

SSL エラー

App Service で証明書を使用する場合、証明書は信頼された証明機関によって署名されている必要があります。 Web アプリで証明書の検証エラーが発生した場合は、自己署名証明書を使用している可能性があります。エラーを解決するには、という名前の変数をビルドまたはリリースパイプラインの値に設定します。

リリースが長時間ハングし、失敗する

この問題は、App Service プランの容量が不足している可能性があります。この問題を解決するには、App Service インスタンスをスケールアップして使用可能な CPU、RAM、ディスク領域を増やすか、別の App Service プランを試すことができます。

5xx エラーコード

5xxエラーが表示された場合は、Azureサービスの状況を確認してください。

Azure関数が突然動作しなくなりました

Azure Functionsは、前回の展開から1年以上経過すると突然動作を停止することがあります。 "deploymentMethod" で "RunFromPackage" を使用してデプロイすると、有効期限が 1 年の SAS が生成され、アプリケーション構成で "WEBSITE_RUN_FROM_PACKAGE" の値として設定されます。 Azure FunctionsはこのSASを使ってパッケージファイルを参照し、関数実行のためにSASが期限切れの場合は関数が実行されません。この問題を解決するには、もう一度デプロイして、有効期限が 1 年の SAS を生成します。

エラー: 指定されたパターンのパッケージが見つかりません

タスクに記載されているパッケージがビルドまたは前のステージで成果物として発行され、現在のジョブにダウンロードされているかどうかを確認します。

エラー: msBuild パッケージの種類では、zip 配置オプションを使用した発行はサポートされていません

MSBuild タスクを使用して作成された Web パッケージ (既定の引数を使用) には、Web 配置によってのみ正しく配置できる入れ子になったフォルダー構造があります。 publish-to-zip デプロイオプションを使用してこれらのパッケージをデプロイすることはできません。パッケージ構造を変換するには、次の手順を実行します。

ビルドソリューションタスクで、MSBuild 引数をに変更します。

ビルドソリューションの値を示すスクリーンショット。
アーカイブタスクを追加し、次のように値を変更します。
1. に変更します。
2. [ルートフォルダー名の先頭にしてパスをアーカイブする] チェックボックスオフにします。
  
  アーカイブ値を示すスクリーンショット。

FAQ

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

Azure Web App task(AzureWebApp)は、Azure Web Appにデプロイする最も簡単な方法です。デフォルトでは、デプロイはAzure Web App内のルートアプリケーションに行われます。

Azure App Service展開タスク(AzureRmWebAppDeployment)は、以下のようなよりカスタムなシナリオを扱うことができます。

Web パッケージと XML パラメーターファイル内構成設定を変更します。
Iis 展開プロセスに慣れている場合は、Web 配置を使用して配置します。
仮想アプリケーションにデプロイします。
コンテナーアプリ、関数アプリ、Web ジョブ、API アプリ、モバイルアプリなど、他の種類のアプリにデプロイします。

手記

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

Windowsでのウェブアプリの展開は成功していますが、アプリ自体は動作しません

これは、web.config がアプリに存在しないことが原因である可能性があります。 web.config ファイルをソースに追加するか、アプリケーションと構成設定を使用して自動生成することができます。

タスクをクリックしてPython、Node.js、Go、Javaアプリのパラメータを生成する web.configに移動します。

web.config パラメーターの生成ダイアログのスクリーンショット。
パラメーターを編集するには、その他のボタンをクリックします。

ドロップダウンダイアログのスクリーンショット。
ドロップダウンからアプリケーションの種類を選択します。
[OK] をクリックします。これにより、web.configの生成に必要な web.config パラメーターが設定されます。

App Service Environment(ASE)でのWebアプリのデプロイが動作しません

Azure DevOpsビルドエージェントがASEのInternal Load Balancer(ILB)と同じVNET(サブネットは異なる場合)にあることを確認してください。これにより、エージェントはAzure DevOpsからコードを取得し、ASEにデプロイできるようになります。
Azure DevOpsを使用している場合、エージェントはインターネットからアクセスされる必要はなく、Azure DevOpsサービスに接続するためにアウトバウンドアクセスのみで十分です。
TFS/Azure DevOps ServerをVirtual Networkにデプロイしている場合、エージェントは完全に隔離可能です。
ビルドエージェントは、デプロイする必要がある Web アプリの DNS 構成で構成する必要があります。 Virtual Network内のプライベートリソースにはAzure DNSのエントリがないため、これはエージェントマシン上のホストファイルに追加する必要があります。
ASE 構成に自己署名証明書を使用する場合は、MSDeploy のデプロイタスクでオプションを設定する必要があります。変数をに設定することもお勧めします。証明機関からの証明書を ASE 構成に使用する場合は、この必要はありません。

サービス接続を構成する方法

この作業には Azure Resource Manager サービス接続が必要です。

Application Insights を使用して Web ジョブのデプロイを構成する方法

App Service にデプロイするときに、Application Insights を構成し、を有効にしている場合は、も有効にする必要があります。このオプションを有効にすると、Application Insights 拡張機能は安全な状態を保ちます。 Application Insights の継続的な Web ジョブが App_Data フォルダーにインストールされているため、この手順が必要です。

App Service へのデプロイ中にエージェントがプロキシの背後にある場合は、どのように構成すればよいですか?

セルフホステッドエージェントに Web プロキシが必要な場合は、構成時にエージェントにプロキシについて通知できます。そうすることで、エージェントはプロキシ経由でAzure PipelinesやAzure DevOps Serverに接続できます。 Web プロキシの背後でセルフホステッドエージェントを実行する方法の詳細について説明します。

例

以下は、Windows上で動作するAzure Web App ServiceにウェブアプリケーションをデプロイするためのYAMLスニペットの例です。

variables:
  azureSubscription: Contoso
  # To ignore SSL error uncomment the below variable
  # VSTS_ARM_REST_IGNORE_SSL_ERRORS: true

steps:

- task: AzureWebApp@1
  displayName: Azure Web App Deploy
  inputs:
    azureSubscription: $(azureSubscription)
    appName: samplewebapp
    package: $(System.DefaultWorkingDirectory)/**/*.zip

Web App on Linux をデプロイするには、パラメーターを追加し、に設定します。

デプロイ方法を Zip Deploy として指定するには、パラメーター追加します。このパラメーターでサポートされているもう 1 つの値は、です。

指定しない場合、が既定値になります。

必要条件

要件	形容
パイプラインの種類	YAML、クラシックビルド、クラシックリリース
実行日	エージェント、DeploymentGroup
の需要	何一つ
機能の	このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限	任意
設定可能な変数	任意
エージェントのバージョン	2.209.0 以上
タスクカテゴリ	展開

要件	形容
パイプラインの種類	YAML、クラシックビルド、クラシックリリース
実行日	エージェント、DeploymentGroup
の需要	何一つ
機能の	このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限	任意
設定可能な変数	任意
エージェントのバージョン	2.104.1 以上
タスクカテゴリ	展開

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-03-06