Share via


AzureAppServiceManage@0 - Azure App Service manage v0 task

Start, stop, restart, slot swap, install site extensions, or enable continuous monitoring for an Azure App Service.

Inputs

azureSubscription - Azure subscription
Input alias: ConnectedServiceName. string. Required.

Selects the Azure Resource Manager subscription.


Action - Action
string. Allowed values: Swap Slots, Start Azure App Service (Start App Service), Stop Azure App Service (Stop App Service), Restart Azure App Service (Restart App Service), Install Extensions, Enable Continuous Monitoring, Start all continuous webjobs, Stop all continuous webjobs. Default value: Swap Slots.

Optional. Defines the action to perform on the App Service. You can start, stop, restart, slot swap, start swap with a preview, complete swap with a preview, cancel swap with a preview, install site extensions, or enable continuous monitoring for an Azure App Service.


WebAppName - App Service name
string. Required.

Enters or selects the name of an existing Azure App Service.


ResourceGroupName - Resource group
string. Required when Action = Swap Slots || SpecifySlot = true.

Enters or selects the Azure Resource Group that contains the Azure App Service specified above.


SourceSlot - Source Slot
string. Required when Action = Swap Slots.

Used as the source slot when action == Swap Slots. The swap action directs destination slot's traffic to the source slot.


SwapWithProduction - Swap with Production
boolean. Optional. Use when Action = Swap Slots. Default value: true.

Swaps the traffic of the source slot with production. If you don't select this option, then you need to provide the source and target slot names.


TargetSlot - Target Slot
string. Required when Action = Swap Slots && SwapWithProduction = false.

Use as the destination slot when action == Swap Slots. The swap action directs the destination slot's traffic to the source slot.


PreserveVnet - Preserve Vnet
boolean. Optional. Use when Action = Swap Slots. Default value: false.

Preserves the virtual network settings.


Slot - Slot
string. Required when Action != Swap Slots && SpecifySlot = true.


ExtensionsList - Install Extensions
string. Required when Action = Install Extensions. Allowed values: Microsoft.ApplicationInsights.AzureWebSites (Application Insights), ComposerExtension (Composer), python2712x64 (Python 2.7.12 x64), python2712x86 (Python 2.7.12 x86), python2713x64 (Python 2.7.13 x64), python2713x86 (Python 2.7.13 x86), python353x64 (Python 3.5.3 x64), python353x86 (Python 3.5.3 x86), python360x86 (Python 3.6.0 x86), python360x64 (Python 3.6.0 x64), python361x86 (Python 3.6.1 x86), python361x64 (Python 3.6.1 x64).

Site extensions run on Microsoft Azure App Service. You can install a set of tools as a site extension and better manage your Azure App Service. Restart the App Service so the latest changes take effect.


OutputVariable - Output variable
string. Optional. Use when Action = Install Extensions.

Provides the variable name for the selected extension's local installation path.

This field is now deprecated and will be removed. Use the LocalPathsForInstalledExtensions variable from the Output Variables section in subsequent tasks.


AppInsightsResourceGroupName - Resource Group name for Application Insights
string. Required when Action == Enable Continuous Monitoring.

Enters or selects the resource group where your Application Insights resource is available.


ApplicationInsightsResourceName - Application Insights resource name
string. Required when Action == Enable Continuous Monitoring.

Selects the Application Insights resource where continuous monitoring data is recorded.

If your Application Insights resource is not listed here and you want to create a new resource, select +New. Once you create the resource in the Azure portal, come back here and select Refresh.


SpecifySlot - Specify Slot
boolean. Optional. Use when Action != Swap Slots. Default value: false.


Task control options

All tasks have control options in addition to their task inputs. For more information, see Control options and common task properties.

Output variables

None.

Remarks

Use this task to start, stop, restart, slot swap, Swap with Preview, install site extensions, or enable continuous monitoring for an Azure App Service.

What happens during a swap

When you swap two slots (usually from a staging slot into the production slot), make sure that the production slot is always the target slot. This way, the swap operation doesn't affect your production app.

Also at any point of the swap (or swap with preview) operation, all work of initializing the swapped apps happens on the source slot. The target slot remains online while the source slot is being prepared and warmed up, regardless of where the swap succeeds or fails.

For more information, see Set up staging environments in Azure App Service.

Requirements

Requirement Description
Pipeline types YAML, Classic build, Classic release
Runs on Agent
Demands None
Capabilities This task does not satisfy any demands for subsequent tasks in the job.
Command restrictions Any
Settable variables Any
Agent version 1.102.0 or greater
Task category Deploy