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

Starten, Beenden, Neustarten, Slottausch, Slotlöschen, Installieren von Standorterweiterungen oder Aktivieren der kontinuierlichen Überwachung für eine 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.

Eingaben

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 (Stop App Service), Restart Azure App Service (Restart App Service), Start Swap With Preview, , Complete Swap (Complete Swap with Preview), Cancel Swap (Cancel Swap with Preview), Delete Slot, , Install Extensions, Enable Continuous Monitoring, Start all continuous webjobs, , , . Stop all continuous webjobs Standardwert. Swap Slots.

Optional. Definiert die Aktion, die auf dem App Service ausgeführt werden soll. Sie können starten, beenden, neu starten, Slot tauschen, mit einer Vorschau beginnen, den Austausch mit einer Vorschau abschließen, den Austausch mit einer Vorschau abbrechen, Websiteerweiterungen installieren oder die kontinuierliche Überwachung für eine Azure App Service aktivieren.

WebAppName - App Service Name
string. Erforderlich.

Gibt den Namen einer vorhandenen Azure App Service ein oder wählt diese aus.

SpecifySlotOrASE - Angeben von Slot oder App Service-Umgebung
Eingabealias: SpecifySlot. boolean. Optional. Verwenden Sie , 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 die oben angegebene Azure App Service enthält, oder wählt sie aus.

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

Wird als Quellslot verwendet, wenn action == Swap Slots. Durch die Tauschaktion wird der Datenverkehr des Zielslots an den Quellslot umgeleitet.

SwapWithProduction - Austauschen mit Produktion
boolean. Optional. Verwenden Sie , wenn Action = Swap Slots || Action = Start Swap With Preview || Action = Complete Swap. Standardwert. true.

Tauscht den Datenverkehr des Quellslots durch die Produktion. Wenn Sie diese Option nicht auswählen, müssen Sie die Namen der Quelle und des Zielslots angeben.

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

Verwenden Sie als Zielslot, wenn action == Swap Slots. Die Tauschaktion leitet den Datenverkehr des Zielslots an den Quellslot weiter.

PreserveVnet - Beibehalten des VNET
boolean. Optional. Verwenden Sie , 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 unter Microsoft Azure App Service ausgeführt. Sie können eine Reihe von Tools als Standorterweiterung installieren und Ihre Azure App Service besser verwalten. Starten Sie die App Service neu, damit die neuesten Änderungen wirksam werden.

OutputVariable - Ausgabevariable
string. Optional. Verwenden Sie , wenn Action = Install Extensions.

Gibt den Variablennamen für den lokalen Installationspfad der ausgewählten Erweiterung an.

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 diese aus.

ApplicationInsightsResourceName - Name der Application Insights-Ressource
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 +Neu aus. Nachdem Sie die Ressource im Azure-Portal erstellt haben, kehren Sie hierher zurück, und wählen Sie Aktualisieren aus.

ApplicationInsightsWebTestName - Name des Application Insights-Webtests
string. Optional. Verwenden Sie , wenn Action == Enable Continuous Monitoring.

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

Wenn Sie keinen Webtestnamen angeben, wird der Standardtestname verwendet.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Diese Aufgabe definiert die folgenden Ausgabevariablen, die Sie in nachgelagerten Schritten, Aufträgen und Phasen nutzen können.

LocalPathsForInstalledExtensions
Diese Eingabe ist der lokale Installationspfad für die von Ihnen ausgewählten Erweiterungen.

Wenn Sie mehrere Erweiterungen auswählen, ist die Ausgabe eine durch Trennzeichen getrennte Liste lokaler Pfade für jede der ausgewählten Erweiterungen. Die Ausgabe listet die Pfade in der Reihenfolge auf, in der sie im Feld Erweiterungen installieren angezeigt werden.

Hinweise

Verwenden Sie diese Aufgabe, um einen Azure App Service zu starten, zu stoppen, neu zu starten, einen Slot zu tauschen, mit der Vorschau zu tauschen, Site-Erweiterungen zu installieren oder die kontinuierliche Überwachung zu aktivieren.

Was geschieht bei einem Austausch?

Wenn Sie zwei Slots (in der Regel von einem Stagingslot in den Produktionsslot) austauschen, stellen Sie sicher, dass der Produktionsslot immer der Zielslot ist. So ist sichergestellt, dass Ihre Produktions-App durch den Austauschvorgang nicht beeinträchtigt wird.

Außerdem findet zu jedem Zeitpunkt des Swap-Vorgangs (oder Swap mit Vorschau) die gesamte Initialisierung der ausgelagerten Anwendungen auf dem Quell-Slot statt. 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, Klassischer Build, klassische Version
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Einstellbare Variablen	Any
Agent-Version	1.102.0 oder höher
Aufgabenkategorie	Bereitstellen