このタスクを使用して、Web 配置を使用して Web サイトまたは Web アプリケーションをデプロイします。
重要
このタスクは、クラシック パイプラインでのみ機能します。 代わりに 、WinRM - Visual Studio Marketplace を使用して IIS Web アプリのデプロイを使用 します。
構文
# IIS web app deploy v0
# Deploy a website or web application using Web Deploy.
- task: IISWebAppDeploymentOnMachineGroup@0
inputs:
WebSiteName: # string. Required. Website Name.
#VirtualApplication: # string. Virtual Application.
Package: '$(System.DefaultWorkingDirectory)\**\*.zip' # string. Required. Package or Folder. Default: $(System.DefaultWorkingDirectory)\**\*.zip.
# Advanced Deployment Options
#SetParametersFile: # string. SetParameters File.
#RemoveAdditionalFilesFlag: false # boolean. Remove Additional Files at Destination. Default: false.
#ExcludeFilesFromAppDataFlag: false # boolean. Exclude Files from the App_Data Folder. Default: false.
#TakeAppOfflineFlag: false # boolean. Take App Offline. Default: false.
#AdditionalArguments: # string. Additional Arguments.
# File Transforms & Variable Substitution Options
#XmlTransformation: false # boolean. XML transformation. Default: false.
#XmlVariableSubstitution: false # boolean. XML variable substitution. Default: false.
#JSONFiles: # string. JSON variable substitution.
入力
WebSiteName
-
Web サイト名
string
。 必須。
マシン グループ コンピューター上の既存の Web サイトの名前を指定します。
VirtualApplication
-
仮想アプリケーション
string
。
ターゲット マシン上の既存の Azure Virtual アプリケーションの名前を指定します。
Package
-
パッケージまたはフォルダー
string
。 必須。 既定値: $(System.DefaultWorkingDirectory)\**\*.zip
。
MSBuild によって生成されたパッケージまたはフォルダー、または圧縮されたアーカイブ ファイルへのファイル パスを指定します。 変数 ( ビルド | リリース) とワイルドカードがサポートされています。
SetParametersFile
-
SetParameters ファイル
string
。
使用する SetParameters.xml
ファイルへのパスを指定します。
RemoveAdditionalFilesFlag
-
宛先で追加のファイルを削除する
boolean
。 既定値: false
。
true
に設定されている場合は、Web アプリ ZIP パッケージに一致するファイルがない Web アプリ上のファイルを削除します。
ExcludeFilesFromAppDataFlag
-
App_Data フォルダーからファイルを除外する
boolean
。 既定値: false
。
true
に設定すると、App_Data
フォルダー内のファイルが Web アプリに展開されなくなります。
TakeAppOfflineFlag
-
アプリをオフラインにする
boolean
。 既定値: false
。
同期操作を開始する前に、ルート ディレクトリに app_offline.htm
ファイルを配置して、Web アプリをオフラインにするオプションを選択します。 同期操作が正常に完了すると、ファイルは自動的に削除されます。
AdditionalArguments
-
その他の引数
string
。
Azure Web アプリのデプロイ時に使用する追加の Web デプロイ引数を指定します。 たとえば、-disableLink:AppPoolExtension
や -disableLink:ContentExtension
などです。
サポートされている引数の完全な一覧については、「 Web 配置操作の設定」を参照してください。
XML 変換 を
boolean
。 既定値: false
。
対応する*.Release.config
上の*.<EnvironmentName>.config
および*.config file
ファイルの XML 変換を実行します。 これらの変換は、変数の置換の前に適用されます。 XML 変換は Windows でのみサポートされます。
XmlVariableSubstitution
-
XML 変数の置換
boolean
。 既定値: false
。
ビルドまたはリリース パイプラインで定義されている変数を指定します。 これらの変数は、構成ファイルとkey
のname
、appSettings
、およびapplicationSettings
セクションのconnectionStrings
またはparameters.xml
エントリと照合されます。 変数の置換は、構成変換の後に実行されます。
注
リリース パイプラインと環境の両方で同じ変数が定義されている場合、環境変数はリリース パイプライン変数よりも優先されます。
JSON 変数の置換 を
string
。
変数の置換のために、改行で区切られた JSON ファイルの一覧を指定します。 ファイル名は、ルート フォルダーに対して相対的である必要があります。
入れ子になった JSON 変数または階層構造の JSON 変数を置き換える場合は、JSONPath 式を使用します。 たとえば、次のサンプルの ConnectionString
の値を置き換えるには、変数をビルドまたはリリース パイプライン (またはリリース パイプラインのステージ) で Data.DefaultConnection.ConnectionString
として定義します。
{
"Data": {
"DefaultConnection": {
"ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"
}
}
}
変数の置換は構成変換の後に実行され、パイプライン変数は置換から除外されます。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール のオプションと一般的なタスクのプロパティ」を参照してください。
出力変数
なし。
注釈
このタスクを使用して、WebDeploy を使用して Web サイトまたは Web アプリをデプロイします。