AzureAppServiceManage@0 — служба приложений Azure управляет задачей v0

Статья
03/24/2025

Запуск, остановка, перезапуск, переключение слотов, удаление слотов, установка расширений сайта или включение непрерывного мониторинга для службы приложений Azure.

Синтаксис

# 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.

Входные данные

azureSubscription - подписке Azure
Псевдоним ввода: ConnectedServiceName. string. Обязательное.

Выбирает подписку Azure Resource Manager.

Action - действие
string. Допустимые значения: 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. Значение по умолчанию: Swap Slots.

Необязательно. Определяет действие для выполнения в службе приложений. Вы можете запустить, остановить, перезапустить, переключить слоты, начать переключение с предварительной версией, завершить переключение с предварительной версией, отменить предварительный просмотр, установить расширения сайта или включить непрерывный мониторинг для службы приложений Azure.

WebAppName - имя службы приложений
string. Обязательное.

Введите или выберите имя существующей службы приложений Azure.

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, содержащую службу приложений 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 - сохранить виртуальной сети
boolean. Необязательно. Используется при Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Значение по умолчанию: false.

Сохраняет параметры виртуальной сети.

слота
string. Требуется, если Action = Delete Slot || Action = Cancel Swap || SpecifySlot = true. Значение по умолчанию: production.

ExtensionsList - установка расширений
string. Требуется, если Action = Install Extensions.

Расширения сайта выполняются в службе приложений Microsoft Azure. Вы можете установить набор средств в качестве расширения сайта и лучше управлять службой приложений Azure. Перезапустите службу приложений, чтобы последние изменения вступили в силу.

OutputVariable - выходная переменная
string. Необязательно. Используется при Action = Install Extensions.

Предоставляет имя переменной для локального пути установки выбранного расширения.

Теперь это поле устарело и будет удалено. Используйте переменную LocalPathsForInstalledExtensions из раздела выходных переменных в последующих задачах.

AppInsightsResourceGroupName - имя группы ресурсов для Application Insights
string. Требуется, если Action == Enable Continuous Monitoring.

Введите или выберите группу ресурсов, в которой доступен ресурс Application Insights.

ApplicationInsightsResourceName - имя ресурса Application Insights
string. Требуется, если Action == Enable Continuous Monitoring.

Выбирает ресурс Application Insights, в котором записываются данные непрерывного мониторинга.

Если ресурс Application Insights не указан здесь, и вы хотите создать новый ресурс, выберите +Создать. После создания ресурса на портале Azure вернитесь сюда и выберите Обновить.

ApplicationInsightsWebTestName - имя веб-теста Application Insights
string. Необязательно. Используется при Action == Enable Continuous Monitoring.

Необязательно. Введите имя веб-теста Application Insights, которое вы хотите создать или обновить.

Если имя веб-теста не указано, используется имя теста по умолчанию.

Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.

Выходные переменные

Эта задача определяет следующие выходные переменные, которые можно использовать в подчиненных шагах, заданиях и этапах.

LocalPathsForInstalledExtensions
Это локальные пути установки для выбранного расширения.

Если выбрать несколько расширений, выходные данные — это разделенный запятыми список локальных путей для каждого выбранного расширения. Выходные данные перечисляют пути в порядке, который они отображаются в поле "Установка расширений".

Замечания

Эта задача предназначена для запуска, остановки, перезапуска, переключения слотов, переключения с предварительными версиями, установки расширений сайта или непрерывного мониторинга для службы приложений Azure.

Что происходит во время обмена

При переключении двух слотов (обычно из промежуточного слота в рабочий слот) убедитесь, что рабочий слот всегда является целевым слотом. Таким образом, операция переключения не влияет на рабочее приложение.

Кроме того, в любой момент операции замены (или переключения с предварительной версией) все действия по инициализации переключения приложений происходит в исходном слоте. Целевой слот остается в сети, пока исходный слот готовится и прогревается, независимо от того, где произошла замена.

См. сведения о том, как настраивать промежуточные среды в Службе приложений Azure.

Требования

Требование	Описание
Типы конвейеров	YAML, классическая сборка, классический выпуск
Выполняется в	Агент, DeploymentGroup
требования	Нет
возможностей	Эта задача не удовлетворяет требованиям к последующим задачам в задании.
ограничения команд	Любое
переменные settable	Любое
Версия агента	1.102.0 или более поздней версии
Категория задач	Внедрять

Поделиться через