AzureRmWebAppDeployment@2 - Azure App Service v2 のデプロイ タスク

Web Deploy/Kudu REST API を使用してAzure App Serviceを更新します。

構文

# Azure App Service Deploy v2
# Update Azure App Service using Web Deploy / Kudu REST APIs.
- task: AzureRmWebAppDeployment@2
  inputs:
    ConnectedServiceName: # string. Required. Azure Subscription. 
    WebAppName: # string. Required. App Service name. 
    #DeployToSlotFlag: false # boolean. Deploy to slot. Default: false.
    #ResourceGroupName: # string. Required when DeployToSlotFlag = true. Resource group. 
    #SlotName: # string. Required when DeployToSlotFlag = true. Slot. 
    #VirtualApplication: # string. Virtual Application. 
    Package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or Folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
  # Output
    #WebAppUri: # string. App Service URL. 
  # Additional Deployment Options
    #UseWebDeploy: true # boolean. Publish using Web Deploy. Default: true.
    #SetParametersFile: # string. Optional. Use when UseWebDeploy == true. SetParameters File. 
    #RemoveAdditionalFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true. Remove Additional Files at Destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Optional. Use when UseWebDeploy == true. Exclude Files from the App_Data Folder. Default: false.
    #AdditionalArguments: # string. Optional. Use when UseWebDeploy == true. Additional Arguments. 
    #TakeAppOfflineFlag: false # boolean. Take App Offline. Default: false.

# YAML Syntax is not supported in TFS 2018.
# Use the classic designer to add and configure tasks.
# See the following Inputs section for details on the inputs that this task supports.

入力

ConnectedServiceName - Azure サブスクリプション
string. 必須です。

デプロイの Azure Resource Manager サブスクリプションを選択します。

WebAppName - App Service名
string. 必須です。

既存のAzure App Serviceの名前を入力または選択します。

DeployToSlotFlag - スロットへのデプロイ
boolean. 既定値: false。

運用スロット以外の既存のスロットにデプロイするオプションを選択します。

ResourceGroupName - リソース グループ
string. 次の場合に DeployToSlotFlag = true必要です。

上記で指定したAzure App Serviceを含む Azure リソース グループを入力または選択します。

SlotName - スロット
string. 次の場合に DeployToSlotFlag = true必要です。

運用スロット以外の既存のスロットを入力または選択します。

VirtualApplication - 仮想アプリケーション
string.

Azure portalで構成されている仮想アプリケーションの名前を指定します。 このオプションは、App Service ルートへのデプロイには必要ありません。

Package - パッケージまたはフォルダー
string. 必須です。 既定値: $(System.DefaultWorkingDirectory)/**/*.zip。

App Service パッケージまたはフォルダーへのフォルダーまたはファイル パス。 変数 ( ビルド | リリース)、ワイルドカードがサポートされています。
たとえば、$(System.DefaultWorkingDirectory)/**/*.zip。

WebAppUri - APP SERVICE URL
string.

App Serviceの URL に対して生成される出力変数の名前を指定します。 変数は、後続のタスクで使用できます。

UseWebDeploy - Web Deploy を使用して発行する
boolean. 既定値: true。

Web 展開オプションを使用した発行は、Windows エージェントを使用する場合にのみサポートされます。 他のプラットフォームでは、タスクは Kudu REST API を使用してApp Serviceをデプロイします。次のオプションはサポートされていません。

SetParametersFile - SetParameters ファイル
string. 省略可能。 次の場合に使用します UseWebDeploy == true。

省略可能: 使用するSetParameters.xml ファイルの場所。

RemoveAdditionalFilesFlag - コピー先で追加のファイルを削除する
boolean. 省略可能。 次の場合に使用します UseWebDeploy == true。 既定値: false。

App Service パッケージまたはフォルダーに一致するファイルがないAzure App Service上のファイルを削除するオプションを選択します。

ExcludeFilesFromAppDataFlag - App_Data フォルダーからファイルを除外する
boolean. 省略可能。 次の場合に使用します UseWebDeploy == true。 既定値: false。

App_Data フォルダー内のファイルがAzure App Serviceに展開されないようにするには、このオプションを選択します。

AdditionalArguments - その他の引数
string. 省略可能。 次の場合に使用します UseWebDeploy == true。

構文 -key:value に続く追加の Web Deploy 引数。
これらは、Azure App Serviceのデプロイ時に適用されます。 例: -disableLink:AppPoolExtension -disableLink:ContentExtension。
Web 配置操作の設定の詳細な例については、 これを参照してください。

TakeAppOfflineFlag - アプリをオフラインにする
boolean. 既定値: false。

同期操作が開始される前に、App Serviceのルート ディレクトリにapp_offline.htm ファイルを配置して、Azure App Serviceをオフラインにするオプションを選択します。 同期操作が正常に完了すると、ファイルが削除されます。

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

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

出力変数

[なし] :

必要条件

要件	説明
パイプラインの種類	YAML、クラシック ビルド、クラシック リリース
実行	エージェント
確認要求	なし
Capabilities	このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限	Any
設定可能な変数	Any
エージェントのバージョン	1.102.0 以上
タスクのカテゴリ	配置