AzureAppServiceManage@0 – Azure App Service– v0-Aufgabe verwalten

Starten, Beenden, Neustarten, Steckplatztausch, Löschen von Steckplätzen, Installieren von Websiteerweiterungen oder Aktivieren der kontinuierlichen Überwachung für einen Azure App Service.

Syntax

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

Eingänge

azureSubscription - Azure-Abonnement
Eingabealias: ConnectedServiceName. string. Erforderlich.

Wählt das Azure Resource Manager-Abonnement aus.

Action - Aktion
string. Zulässige Werte: Swap Slots, Start Azure App Service (Start App Service), Stop Azure App Service (App-Dienst beenden), Restart Azure App Service (App-Dienst neu starten), Start Swap With Preview, Complete Swap (Vollständige Vorschau tauschen), Cancel Swap (Vorschau abbrechen), Delete Slot, Install Extensions, Enable Continuous Monitoring, Start all continuous webjobs, Stop all continuous webjobs. Standardwert: Swap Slots.

Wahlfrei. Definiert die aktion, die für den App-Dienst ausgeführt werden soll. Sie können starten, beenden, neu starten, Steckplatz tauschen, mit einer Vorschau tauschen, eine Vorschau abschließen, den Tausch mit einer Vorschau abbrechen, Websiteerweiterungen installieren oder eine kontinuierliche Überwachung für einen Azure App Service aktivieren.

WebAppName - App Service-Name
string. Erforderlich.

Gibt den Namen eines vorhandenen Azure App Service ein, oder wählt ihn aus.

SpecifySlotOrASE - Angeben des Steckplatzes oder der App-Dienstumgebung
Eingabealias: SpecifySlot. boolean. Wahlfrei. Wird verwendet, wenn Action != Swap Slots && Action != Delete Slot && Action != Start Swap With Preview && Action != Complete Swap && Action != Cancel Swap. Standardwert: false.

ResourceGroupName - Ressourcengruppe
string. Erforderlich, wenn Action = Swap Slots || Action = Delete Slot || SpecifySlot = true || Action = Start Swap With Preview || Action = Complete Swap || Action = Cancel Swap.

Gibt die Azure-Ressourcengruppe ein, die den oben angegebenen Azure App Service enthält, oder wählt sie aus.

SourceSlot - Source Slot
string. Erforderlich, wenn Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap.

Wird beim action == Swap Slotsals Quellplatz verwendet. Die Swapaktion leitet den Datenverkehr des Zielplatzes an den Quellplatz weiter.

SwapWithProduction - Mit Produktions- austauschen
boolean. Wahlfrei. Wird verwendet, wenn Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Standardwert: true.

Tauscht den Datenverkehr des Quellplatzes mit der Produktion. Wenn Sie diese Option nicht auswählen, müssen Sie die Quell- und Zielplatznamen angeben.

TargetSlot - Zielplatz
string. Erforderlich, wenn SwapWithProduction = false.

Wird als Zielplatz verwendet, wenn action == Swap Slots. Die Swap-Aktion leitet den Datenverkehr des Zielplatzes an den Quellplatz weiter.

PreserveVnet - Vnet- beibehalten
boolean. Wahlfrei. Wird verwendet, wenn Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Standardwert: false.

Behält die Einstellungen des virtuellen Netzwerks bei.

Slot - Slot-
string. Erforderlich, wenn Action = Delete Slot || Action = Cancel Swap || SpecifySlot = true. Standardwert: production.

ExtensionsList - Installieren von Erweiterungen
string. Erforderlich, wenn Action = Install Extensions.

Websiteerweiterungen werden auf Microsoft Azure App Service ausgeführt. Sie können eine Reihe von Tools als Websiteerweiterung installieren und Ihren Azure App Service besser verwalten. Starten Sie den App-Dienst neu, damit die neuesten Änderungen wirksam werden.

OutputVariable - Ausgabevariable
string. Wahlfrei. Wird verwendet, wenn Action = Install Extensions.

Stellt den Variablennamen für den lokalen Installationspfad der ausgewählten Erweiterung bereit.

Dieses Feld ist jetzt veraltet und wird entfernt. Verwenden Sie die LocalPathsForInstalledExtensions Variable aus dem Abschnitt "Ausgabevariablen" in nachfolgenden Aufgaben.

AppInsightsResourceGroupName - Ressourcengruppenname für Application Insights
string. Erforderlich, wenn Action == Enable Continuous Monitoring.

Gibt die Ressourcengruppe ein, in der Ihre Application Insights-Ressource verfügbar ist, oder wählt sie aus.

ApplicationInsightsResourceName - Application Insights-Ressourcenname
string. Erforderlich, wenn Action == Enable Continuous Monitoring.

Wählt die Application Insights-Ressource aus, in der fortlaufende Überwachungsdaten aufgezeichnet werden.

Wenn Ihre Application Insights-Ressource hier nicht aufgeführt ist und Sie eine neue Ressource erstellen möchten, wählen Sie +Neuaus. Sobald Sie die Ressource im Azure-Portal erstellt haben, kehren Sie hierher zurück, und wählen Sie Aktualisierenaus.

ApplicationInsightsWebTestName - Application Insights-Webtestname
string. Wahlfrei. Wird verwendet, wenn Action == Enable Continuous Monitoring.

Wahlfrei. Gibt den Namen des Application Insights-Webtests ein, den Sie erstellen oder aktualisieren möchten.

Wenn Sie keinen Webtestnamen angeben, wird der Standardtestname verwendet.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Mit dieser Aufgabe werden die folgenden Ausgabevariablendefiniert, die Sie in nachgeschalteten Schritten, Aufträgen und Phasen verwenden können.

LocalPathsForInstalledExtensions
Diese Eingabe ist die lokalen Installationspfade für die von Ihnen ausgewählten Erweiterungen.

Wenn Sie mehrere Erweiterungen auswählen, handelt es sich bei der Ausgabe um eine durch Trennzeichen getrennte Liste mit lokalen Pfaden für jede der von Ihnen ausgewählten Erweiterungen. Die Ausgabe listet die Pfade in der Reihenfolge auf, in der sie im Feld "Erweiterungen installieren" angezeigt werden.

Bemerkungen

Verwenden Sie diese Aufgabe, um eine fortlaufende Überwachung für einen Azure App Service zu starten, zu beenden, neu zu starten, zu tauschen, mit Vorschau zu tauschen, Websiteerweiterungen zu installieren oder eine kontinuierliche Überwachung für einen Azure App Service zu ermöglichen.

Was geschieht bei einem Austausch?

Wenn Sie zwei Steckplätze austauschen (in der Regel von einem Staging-Slot in den Produktionsplatz), stellen Sie sicher, dass der Produktionsplatz immer der Zielplatz ist. So ist sichergestellt, dass Ihre Produktions-App durch den Austauschvorgang nicht beeinträchtigt wird.

Auch an jedem Punkt des Tauschvorgangs (oder Tausch mit Vorschau) erfolgt die Initialisierung der ausgetauschten Apps auf dem Quellplatz. Der Zielslot bleibt während der gesamten Vorbereitung des Quellslots online – unabhängig davon, ob der Austausch erfolgreich ist.

Weitere Informationen finden Sie unter Einrichten von Stagingumgebungen in Azure App Service.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	1.102.0 oder höher
Vorgangskategorie	Einsetzen