AzureAppServiceManage@0 – Azure App Service spravuje úlohu v0

Článek
03/24/2025

Spuštění, zastavení, restartování, prohození slotu, odstranění slotu, instalace rozšíření webu nebo povolení průběžného monitorování pro službu Azure App Service

Syntaxe

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

Vstupy

azureSubscription - předplatného Azure
Vstupní alias: ConnectedServiceName. string. Povinné.

Vybere předplatné Azure Resource Manageru.

Action - akce
string. Povolené hodnoty: Swap Slots, Start Azure App Service (Spustit app Service), Stop Azure App Service (Zastavit app Service), Restart Azure App Service (restartování služby App Service), Start Swap With Preview, Complete Swap (úplné prohození s verzí Preview), Cancel Swap (zrušit prohození s verzí Preview), Delete Slot, Install Extensions, Enable Continuous Monitoring, Start all continuous webjobs, Stop all continuous webjobs. Výchozí hodnota: Swap Slots.

Volitelný. Definuje akci, která se má provést ve službě App Service. Můžete spustit, zastavit, restartovat, prohození slotů, spustit prohození s verzí Preview, dokončit prohození s verzí Preview, zrušit prohození s náhledem, nainstalovat rozšíření webu nebo povolit průběžné monitorování pro službu Azure App Service.

WebAppName - název služby App Service
string. Povinné.

Zadá nebo vybere název existující služby Azure App Service.

SpecifySlotOrASE - Zadání slotu nebo služby App Service Environment
Vstupní alias: SpecifySlot. boolean. Volitelný. Používá se při Action != Swap Slots && Action != Delete Slot && Action != Start Swap With Preview && Action != Complete Swap && Action != Cancel Swap. Výchozí hodnota: false.

skupiny prostředků
string. Požadováno při Action = Swap Slots || Action = Delete Slot || SpecifySlot = true || Action = Start Swap With Preview || Action = Complete Swap || Action = Cancel Swap.

Zadá nebo vybere skupinu prostředků Azure, která obsahuje službu Azure App Service uvedenou výše.

zdrojového slotu SourceSlot -
string. Požadováno při Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap.

Používá se jako zdrojový slot při action == Swap Slots. Akce prohození směruje provoz cílového slotu do zdrojového slotu.

SwapWithProduction - prohození s produkčním
boolean. Volitelný. Používá se při Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Výchozí hodnota: true.

Prohodí provoz zdrojového slotu s produkčním prostředím. Pokud tuto možnost nevyberete, musíte zadat názvy zdrojových a cílových slotů.

cílového slotu TargetSlot -
string. Požadováno při SwapWithProduction = false.

Použijte jako cílový slot při action == Swap Slots. Akce prohození směruje provoz cílového slotu do zdrojového slotu.

PreserveVnet - zachovat virtuální sítě
boolean. Volitelný. Používá se při Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Výchozí hodnota: false.

Zachová nastavení virtuální sítě.

slotu
string. Požadováno při Action = Delete Slot || Action = Cancel Swap || SpecifySlot = true. Výchozí hodnota: production.

ExtensionsList - instalace rozšíření
string. Požadováno při Action = Install Extensions.

Rozšíření webu běží ve službě Microsoft Azure App Service. Sadu nástrojů můžete nainstalovat jako rozšíření webu a lépe spravovat službu Azure App Service. Restartujte app Service, aby se projevily nejnovější změny.

OutputVariable - výstupní proměnná
string. Volitelný. Používá se při Action = Install Extensions.

Poskytuje název proměnné pro místní instalační cestu vybraného rozšíření.

Toto pole je teď zastaralé a bude odebráno. V dalších úkolech použijte proměnnou LocalPathsForInstalledExtensions z části Výstupní proměnné.

název skupiny prostředků AppInsightsResourceGroupName - pro Application Insights
string. Požadováno při Action == Enable Continuous Monitoring.

Zadá nebo vybere skupinu prostředků, ve které je prostředek Application Insights dostupný.

ApplicationInsightsResourceName - název prostředku Application Insights
string. Požadováno při Action == Enable Continuous Monitoring.

Vybere prostředek Application Insights, ve kterém se zaznamenávají data průběžného monitorování.

Pokud váš prostředek Application Insights tu není uvedený a chcete vytvořit nový prostředek, vyberte + Nový. Jakmile prostředek vytvoříte na webu Azure Portal, vraťte se sem a vyberte Aktualizovat.

ApplicationInsightsWebTestName - název webového testu Application Insights
string. Volitelný. Používá se při Action == Enable Continuous Monitoring.

Volitelný. Zadá název webového testu Application Insights, který chcete vytvořit nebo aktualizovat.

Pokud nezadáte název webového testu, použije se výchozí název testu.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace naleznete v tématu Možnosti ovládacího prvku a běžné vlastnosti úloh.

Výstupní proměnné

Tato úloha definuje následující výstupní proměnné, které můžete využívat v podřízených krocích, úlohách a fázích.

LocalPathsForInstalledExtensions
Tento vstup představuje místní instalační cesty vybraných rozšíření.

Pokud vyberete více rozšíření, výstupem je čárkami oddělený seznam místních cest pro každou z vybraných rozšíření. Výstup zobrazí cesty v pořadí, v jakém se zobrazí v poli Instalovat rozšíření.

Poznámky

Tuto úlohu použijte ke spuštění, zastavení, restartování, prohození slotů, prohození s verzí Preview, instalaci rozšíření webu nebo povolení průběžného monitorování pro službu Azure App Service.

Co se stane během prohození

Při prohození dvou slotů (obvykle z přípravného slotu do produkčního slotu) se ujistěte, že produkční slot je vždy cílovým slotem. Operace prohození tak nemá vliv na vaši produkční aplikaci.

V jakémkoli okamžiku operace prohození (nebo prohození s verzí Preview) se na zdrojovém slotu provede veškerá inicializace prohozených aplikací. Cílový slot zůstane online, zatímco zdrojový slot se připravuje a zahřeje bez ohledu na to, kde se prohození úspěšně nebo selže.

Další informace najdete v článku Nastavení přípravných prostředí ve službě Azure App Service.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení, klasická verze
Běží na	Agent, DeploymentGroup
požadavky	Žádný
možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
omezení příkazů	Jakýkoliv
nastavitelné proměnné	Jakýkoliv
Verze agenta	1.102.0 nebo novější
Kategorie úkolu	Nasadit

Sdílet prostřednictvím