AzureRmWebAppDeployment@2 — zadanie wdrażania w wersji 2 Azure App Service

Artykuł
01/27/2024

Zaktualizuj Azure App Service przy użyciu interfejsów API REST Web Deploy/Kudu.

Składnia

# Azure App Service Deploy v2
# Update Azure App Service using Web Deploy / Kudu REST APIs.
- task: AzureRmWebAppDeployment@2
  inputs:
    ConnectedServiceName: # string. Required. Azure Subscription. 
    WebAppName: # string. Required. App Service name. 
    #DeployToSlotFlag: false # boolean. Deploy to slot. Default: false.
    #ResourceGroupName: # string. Required when DeployToSlotFlag = true. Resource group. 
    #SlotName: # string. Required when DeployToSlotFlag = true. Slot. 
    #VirtualApplication: # string. Virtual Application. 
    Package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or Folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
  # Output
    #WebAppUri: # string. App Service URL. 
  # Additional Deployment Options
    #UseWebDeploy: true # boolean. Publish using Web Deploy. Default: true.
    #SetParametersFile: # string. Optional. Use when UseWebDeploy == true. SetParameters File. 
    #RemoveAdditionalFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true. Remove Additional Files at Destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Optional. Use when UseWebDeploy == true. Exclude Files from the App_Data Folder. Default: false.
    #AdditionalArguments: # string. Optional. Use when UseWebDeploy == true. Additional Arguments. 
    #TakeAppOfflineFlag: false # boolean. Take App Offline. Default: false.

# YAML Syntax is not supported in TFS 2018.
# Use the classic designer to add and configure tasks.
# See the following Inputs section for details on the inputs that this task supports.

Dane wejściowe

ConnectedServiceName - Subskrypcja platformy Azure
string. Wymagane.

Wybierz subskrypcję usługi Azure Resource Manager dla wdrożenia.

WebAppName - nazwa App Service
string. Wymagane.

Wprowadź lub wybierz nazwę istniejącej Azure App Service.

DeployToSlotFlag - Wdrażanie w miejscu
boolean. Wartość domyślna: false.

Wybierz opcję wdrożenia w istniejącym miejscu innym niż miejsce produkcyjne.

ResourceGroupName - Grupa zasobów
string. Wymagane, gdy DeployToSlotFlag = true.

Wprowadź lub wybierz grupę zasobów platformy Azure zawierającą Azure App Service określone powyżej.

SlotName - Gniazdo
string. Wymagane, gdy DeployToSlotFlag = true.

Wprowadź lub wybierz istniejące miejsce inne niż miejsce produkcyjne.

VirtualApplication - Aplikacja wirtualna
string.

Określ nazwę aplikacji wirtualnej skonfigurowanej w Azure Portal. Opcja nie jest wymagana w przypadku wdrożeń w katalogu głównym App Service.

Package - Pakiet lub folder
string. Wymagane. Wartość domyślna: $(System.DefaultWorkingDirectory)/**/*.zip.

Folder lub ścieżka pliku do pakietu lub folderu App Service. Obsługiwane są zmienne (wydanie kompilacji | ), symbole wieloznaczne.
Na przykład $(System.DefaultWorkingDirectory)/**/*.zip.

WebAppUri - adres URL App Service
string.

Określ nazwę zmiennej wyjściowej wygenerowanej dla adresu URL App Service. Zmienną można używać w kolejnych zadaniach.

UseWebDeploy - Publikowanie przy użyciu narzędzia Web Deploy
boolean. Wartość domyślna: true.

Publikowanie przy użyciu opcji wdrażania internetowego jest obsługiwane tylko w przypadku korzystania z agenta systemu Windows. Na innych platformach zadanie opiera się na interfejsach API REST Kudu w celu wdrożenia App Service, a następujące opcje nie są obsługiwane.

SetParametersFile - Plik SetParameters
string. Opcjonalny. Użyj polecenia , gdy UseWebDeploy == true.

Opcjonalnie: lokalizacja pliku SetParameters.xml do użycia.

RemoveAdditionalFilesFlag - Usuwanie dodatkowych plików w lokalizacji docelowej
boolean. Opcjonalny. Użyj polecenia , gdy UseWebDeploy == true. Wartość domyślna: false.

Wybierz opcję usuwania plików w Azure App Service, które nie mają pasujących plików w pakiecie lub folderze App Service.

ExcludeFilesFromAppDataFlag - Wykluczanie plików z folderu App_Data
boolean. Opcjonalny. Użyj polecenia , gdy UseWebDeploy == true. Wartość domyślna: false.

Wybierz opcję, aby uniemożliwić wdrażanie plików w folderze App_Data w Azure App Service.

AdditionalArguments - Dodatkowe argumenty
string. Opcjonalny. Użyj polecenia , gdy UseWebDeploy == true.

Dodatkowe argumenty Web Deploy są następujące po składni -key:value.
Zostaną one zastosowane podczas wdrażania Azure App Service. Przykład: -disableLink:AppPoolExtension -disableLink:ContentExtension.
Aby uzyskać więcej przykładów ustawień operacji web deploy, zapoznaj się z tym tematem.

TakeAppOfflineFlag - Przełącz aplikację w tryb offline
boolean. Wartość domyślna: false.

Wybierz opcję przełączenia Azure App Service w tryb offline, umieszczając plik app_offline.htm w katalogu głównym App Service przed rozpoczęciem operacji synchronizacji. Plik zostanie usunięty po pomyślnym zakończeniu operacji synchronizacji.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz ich danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, kompilacja klasyczna, wersja klasyczna
Działa na	Agent
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne w formie tabeli settable	Dowolne
Wersja agenta	1.102.0 lub nowsza
Kategoria zadania	Wdrażanie

Udostępnij za pośrednictwem