AzureAppServiceManage@0 - Azure App Service v0-taak beheren

Artikel
03/24/2025

Starten, stoppen, opnieuw opstarten, site-wisselen, site-extensies verwijderen, installeren of continue bewaking inschakelen voor een Azure App Service.

Syntaxis

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

Invoer

azureSubscription - Azure-abonnement
Invoeralias: ConnectedServiceName. string. Verplicht.

Selecteert het Azure Resource Manager-abonnement.

Action - actie-
string. Toegestane waarden: Swap Slots, Start Azure App Service (App Service starten), Stop Azure App Service (App Service stoppen), Restart Azure App Service (App Service opnieuw opstarten), Start Swap With Preview, Complete Swap (Volledig wisselen met preview), Cancel Swap (Wisselen annuleren met preview), Delete Slot, Install Extensions, Enable Continuous Monitoring, Start all continuous webjobs, Stop all continuous webjobs. Standaardwaarde: Swap Slots.

Facultatief. Hiermee definieert u de actie die moet worden uitgevoerd op de App Service. U kunt beginnen, stoppen, opnieuw opstarten, uitwisselen van sites, wisselen met een preview starten, uitwisselen met een preview voltooien, wisselen annuleren met een preview, site-extensies installeren of continue bewaking inschakelen voor een Azure App Service.

WebAppName - App Service-naam
string. Verplicht.

Hiermee voert u de naam van een bestaande Azure App Service in of selecteert u deze.

SpecifySlotOrASE - Site- of App Service Environment- opgeven
Invoeralias: SpecifySlot. boolean. Facultatief. Gebruiken wanneer Action != Swap Slots && Action != Delete Slot && Action != Start Swap With Preview && Action != Complete Swap && Action != Cancel Swap. Standaardwaarde: false.

ResourceGroupName - resourcegroep
string. Vereist wanneer Action = Swap Slots || Action = Delete Slot || SpecifySlot = true || Action = Start Swap With Preview || Action = Complete Swap || Action = Cancel Swap.

Hiermee voert u de Azure-resourcegroep in of selecteert die de Azure App Service bevat die hierboven is opgegeven.

SourceSlot - bronsite
string. Vereist wanneer Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap.

Wordt gebruikt als bronsite wanneer action == Swap Slots. De wisselactie stuurt het verkeer van de doelsite naar de bronsite.

SwapWithProduction - wisselen met productie-
boolean. Facultatief. Gebruiken wanneer Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Standaardwaarde: true.

Hiermee wordt het verkeer van de bronsite gewisseld met productie. Als u deze optie niet selecteert, moet u de namen van de bron- en doelsite opgeven.

TargetSlot - doelsite
string. Vereist wanneer SwapWithProduction = false.

Gebruiken als de doelsite wanneer action == Swap Slots. De wisselactie stuurt het verkeer van de doelsite naar de bronsite.

PreserveVnet - Vnet- behouden
boolean. Facultatief. Gebruiken wanneer Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Standaardwaarde: false.

Behoudt de instellingen van het virtuele netwerk.

Slot - Slot
string. Vereist wanneer Action = Delete Slot || Action = Cancel Swap || SpecifySlot = true. Standaardwaarde: production.

ExtensionsList - extensies installeren
string. Vereist wanneer Action = Install Extensions.

Site-extensies worden uitgevoerd in Microsoft Azure App Service. U kunt een set hulpprogramma's installeren als site-extensie en uw Azure App Service beter beheren. Start de App Service opnieuw zodat de meest recente wijzigingen van kracht worden.

OutputVariable - uitvoervariabele
string. Facultatief. Gebruiken wanneer Action = Install Extensions.

Geeft de naam van de variabele op voor het lokale installatiepad van de geselecteerde extensie.

Dit veld is nu afgeschaft en wordt verwijderd. Gebruik de variabele LocalPathsForInstalledExtensions uit de sectie Uitvoervariabelen in volgende taken.

AppInsightsResourceGroupName - naam van de resourcegroep voor Application Insights-
string. Vereist wanneer Action == Enable Continuous Monitoring.

Hiermee voert u de resourcegroep in of selecteert u de resourcegroep waar uw Application Insights-resource beschikbaar is.

ApplicationInsightsResourceName - Naam van Application Insights-resource
string. Vereist wanneer Action == Enable Continuous Monitoring.

Selecteert de Application Insights-resource waarin continue bewakingsgegevens worden vastgelegd.

Als uw Application Insights-resource hier niet wordt vermeld en u een nieuwe resource wilt maken, selecteert u +Nieuwe. Zodra u de resource in Azure Portal hebt gemaakt, keert u hier terug en selecteert u Vernieuwen.

ApplicationInsightsWebTestName - Application Insights-webtestnaam
string. Facultatief. Gebruiken wanneer Action == Enable Continuous Monitoring.

Facultatief. Hiermee voert u de naam van de Application Insights-webtest in die u wilt maken of bijwerken.

Als u geen webtestnaam opgeeft, wordt de standaardtestnaam gebruikt.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Deze taak definieert de volgende uitvoervariabelen, die u kunt gebruiken in downstreamstappen, taken en fasen.

LocalPathsForInstalledExtensions
Deze invoer zijn de lokale installatiepaden voor de extensies die u selecteert.

Als u meerdere extensies selecteert, is de uitvoer een door komma's gescheiden lijst met lokale paden voor elk van de extensies die u selecteert. De uitvoer bevat de paden in de volgorde waarin ze worden weergegeven in het veld Extensies installeren.

Opmerkingen

Gebruik deze taak om te starten, stoppen, opnieuw opstarten, uitwisselen van sites, wisselen met preview, site-extensies installeren of continue bewaking inschakelen voor een Azure App Service.

Wat gebeurt er tijdens een wissel

Wanneer u twee sites wisselt (meestal van een staging-site naar de productiesite), moet u ervoor zorgen dat de productiesite altijd de doelsite is. Op deze manier heeft de wisselbewerking geen invloed op uw productie-app.

Ook op elk moment van de wisselbewerking (of wisselen met preview) vindt alle werkzaamheden voor het initialiseren van de gewisselde apps plaats op de bronsite. De doelsite blijft online terwijl de bronsite wordt voorbereid en opgewarmd, ongeacht waar de wisseling slaagt of mislukt.

Zie Faseringsomgevingen in Azure App Service instellen voor meer informatie.

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Geen
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	1.102.0 of hoger
Taakcategorie	Implementeren

Delen via