AzureAppServiceManage@0 - Azure App Service の v0 タスクの管理
Azure App Service の開始、停止、再起動、スロットスワップ、スロット削除、サイト拡張機能のインストール、または継続的な監視を有効にします。
構文
# Azure App Service manage v0
# Start, stop, restart, slot swap, slot delete, install site extensions or enable continuous monitoring for an Azure App Service.
- task: AzureAppServiceManage@0
inputs:
azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription.
#Action: 'Swap Slots' # 'Swap Slots' | 'Start Azure App Service' | 'Stop Azure App Service' | 'Restart Azure App Service' | 'Start Swap With Preview' | 'Complete Swap' | 'Cancel Swap' | 'Delete Slot' | 'Install Extensions' | 'Enable Continuous Monitoring' | 'Start all continuous webjobs' | 'Stop all continuous webjobs'. Action. Default: Swap Slots.
WebAppName: # string. Required. App Service name.
#SpecifySlotOrASE: false # boolean. Alias: SpecifySlot. Optional. Use when Action != Swap Slots && Action != Delete Slot && Action != Start Swap With Preview && Action != Complete Swap && Action != Cancel Swap. Specify Slot or App Service Environment. Default: false.
#ResourceGroupName: # string. Required when Action = Swap Slots || Action = Delete Slot || SpecifySlot = true || Action = Start Swap With Preview || Action = Complete Swap || Action = Cancel Swap. Resource group.
#SourceSlot: # string. Required when Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Source Slot.
#SwapWithProduction: true # boolean. Optional. Use when Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Swap with Production. Default: true.
#TargetSlot: # string. Required when SwapWithProduction = false. Target Slot.
#PreserveVnet: false # boolean. Optional. Use when Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Preserve Vnet. Default: false.
#Slot: 'production' # string. Required when Action = Delete Slot || Action = Cancel Swap || SpecifySlot = true. Slot. Default: production.
#ExtensionsList: # string. Required when Action = Install Extensions. Install Extensions.
#OutputVariable: # string. Optional. Use when Action = Install Extensions. Output variable.
#AppInsightsResourceGroupName: # string. Required when Action == Enable Continuous Monitoring. Resource Group name for Application Insights.
#ApplicationInsightsResourceName: # string. Required when Action == Enable Continuous Monitoring. Application Insights resource name.
# Advanced Settings
#ApplicationInsightsWebTestName: # string. Optional. Use when Action == Enable Continuous Monitoring. Application Insights web test name.
入力
Azure サブスクリプション を
入力エイリアス: ConnectedServiceName。
string. 必須。
Azure Resource Manager サブスクリプションを選択します。
Action
-
アクションの
string. 使用できる値: Swap Slots、Start Azure App Service (App Service の起動)、Stop Azure App Service (App Service の停止)、Restart Azure App Service (App Service の再起動)、Start Swap With Preview、Complete Swap (プレビューでのスワップの完了)、Cancel Swap (プレビューでのスワップのキャンセル)、Delete Slot、Install Extensions、Enable Continuous Monitoring、Start all continuous webjobs、Stop all continuous webjobs。 既定値: Swap Slots.
任意 App Service で実行するアクションを定義します。 開始、停止、再起動、スロット スワップ、プレビューでのスワップの開始、プレビューとのスワップの完了、プレビューとのスワップのキャンセル、サイト拡張機能のインストール、または Azure App Service の継続的な監視を有効にすることができます。
App Service 名 を
string. 必須。
既存の Azure App Service の名前を入力または選択します。
スロットまたは App Service Environmentを指定する SpecifySlotOrASE -
入力エイリアス: SpecifySlot。
boolean. 任意
Action != Swap Slots && Action != Delete Slot && Action != Start Swap With Preview && Action != Complete Swap && Action != Cancel Swapするときに使用します。 既定値: false.
ResourceGroupName
-
リソース グループの
string.
Action = Swap Slots || Action = Delete Slot || SpecifySlot = true || Action = Start Swap With Preview || Action = Complete Swap || Action = Cancel Swapする場合に必要です。
上記で指定した Azure App Service を含む Azure リソース グループを入力または選択します。
ソース スロットの SourceSlot -
string.
Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swapする場合に必要です。
action == Swap Slotsするときにソース スロットとして使用されます。 スワップ アクションは、宛先スロットのトラフィックをソース スロットに転送します。
SwapWithProduction
-
運用 とのスワップ
boolean. 任意
Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swapするときに使用します。 既定値: true.
ソース スロットのトラフィックを運用環境と交換します。 このオプションを選択しない場合は、ソース スロット名とターゲット スロット名を指定する必要があります。
ターゲット スロットの TargetSlot -
string.
SwapWithProduction = falseする場合に必要です。
action == Swap Slotsするときに宛先スロットとして使用します。 スワップ アクションは、宛先スロットのトラフィックをソース スロットに転送します。
PreserveVnet
-
Vnet を保持する
boolean. 任意
Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swapするときに使用します。 既定値: false.
仮想ネットワーク設定を保持します。
Slot
-
スロット
string.
Action = Delete Slot || Action = Cancel Swap || SpecifySlot = trueする場合に必要です。 既定値: production.
拡張機能をインストールする ExtensionsList -
string.
Action = Install Extensionsする場合に必要です。
サイト拡張機能は、Microsoft Azure App Service で実行されます。 一連のツールをサイト拡張機能としてインストールし、Azure App Service をより適切に管理できます。 最新の変更が有効になるように App Service を再起動します。
OutputVariable
-
出力変数の
string. 任意
Action = Install Extensionsするときに使用します。
選択した拡張機能のローカル インストール パスの変数名を指定します。
このフィールドは非推奨になり、削除されます。 後続のタスクの [出力変数] セクションの LocalPathsForInstalledExtensions 変数を使用します。
Application Insightsのリソース グループ名を AppInsightsResourceGroupName - する
string.
Action == Enable Continuous Monitoringする場合に必要です。
Application Insights リソースが使用可能なリソース グループを入力または選択します。
ApplicationInsightsResourceName
-
Application Insights リソース名の
string.
Action == Enable Continuous Monitoringする場合に必要です。
継続的な監視データが記録される Application Insights リソースを選択します。
Application Insights リソースがここに表示されておらず、新しいリソースを作成する場合は、[+新規] を選択します。 Azure portal でリソースを作成したら、ここに戻り、[更新] を選択します。
ApplicationInsightsWebTestName
-
Application Insights Web テスト名の
string. 任意
Action == Enable Continuous Monitoringするときに使用します。
任意 作成または更新する Application Insights Web テスト名を入力します。
Web テスト名を指定しない場合は、既定のテスト名が使用されます。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
このタスクでは、次の 出力変数を定義します。この変数は、ダウンストリームのステップ、ジョブ、およびステージで使用できます。
LocalPathsForInstalledExtensions
この入力は、選択した拡張機能のローカル インストール パスです。
複数の拡張機能を選択した場合、出力は、選択した各拡張機能のローカル パスのコンマ区切りの一覧です。 出力には、[拡張機能のインストール] フィールドに表示される順序でパスが一覧表示されます。
注釈
このタスクを使用して、Azure App Service の開始、停止、再起動、スロットスワップ、プレビューとのスワップ、サイト拡張機能のインストール、または継続的な監視を有効にします。
スワップ中の動作
2 つのスロット (通常はステージング スロットから運用スロット) をスワップする場合は、運用スロットが常にターゲット スロットであることを確認します。 こうすることで、スワップ操作が運用アプリに影響を及ぼしません。
また、スワップ (またはプレビューでのスワップ) 操作の任意の時点で、スワップされたアプリの初期化のすべての作業がソース スロットで行われます。 スワップが成功または失敗した場所に関わらず、ソース スロットが準備され、ウォームアップされる間は、ターゲット スロットがオンライン状態に留まります。
詳細については、「Azure App Serviceでステージング環境を設定する」を参照してください。