Udostępnij za pośrednictwem


AzureRmWebAppDeployment@3 — Azure App Service wdrożyć zadanie w wersji 3

To zadanie służy do wdrażania w celu Azure App Service aplikacji internetowej, mobilnej lub interfejsu API przy użyciu platformy Docker, Java, .NET, .NET Core, Node.js, PHP, Python lub Ruby.

Uwaga

Użyj AzureFunctionApp@1, aby wdrożyć aplikacje Azure Functions.

Zaktualizuj usługi aplikacja systemu Azure w systemie Windows, aplikację internetową w systemie Linux przy użyciu wbudowanych obrazów lub kontenerów platformy Docker, ASP.NET, .NET Core, PHP, Python lub Node.js opartych na aplikacjach internetowych, aplikacjach funkcji, aplikacjach mobilnych, aplikacjach interfejsu API i zadaniach Web Jobs przy użyciu interfejsów API REST Web Deploy/Kudu.

Składnia

# Azure App Service deploy v3
# Deploy to Azure App Service a web, mobile, or API app using Docker, Java, .NET, .NET Core, Node.js, PHP, Python, or Ruby.
- task: AzureRmWebAppDeployment@3
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    appType: 'app' # 'app' | 'applinux' | 'functionapp' | 'api' | 'mobileapp'. Alias: WebAppKind. Required. App type. Default: app.
    WebAppName: # string. Required. App Service name. 
    #DeployToSlotFlag: false # boolean. Optional. Use when WebAppKind != "". Deploy to slot. Default: false.
    #ResourceGroupName: # string. Required when DeployToSlotFlag = true. Resource group. 
    #SlotName: # string. Required when DeployToSlotFlag = true. Slot. 
    #ImageSource: 'Registry' # 'Registry' | 'Builtin'. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Image Source. Default: Registry.
    #AzureContainerRegistry: # string. Required when ImageSource = AzureContainerRegistry. Registry. 
    #AzureContainerRegistryLoginServer: # string. Optional. Use when ImageSource = invalidimagesource. Registry Login Server Name. 
    #AzureContainerRegistryImage: # string. Required when ImageSource = AzureContainerRegistry. Image. 
    #AzureContainerRegistryTag: # string. Optional. Use when ImageSource = AzureContainerRegistry. Tag. 
    #DockerRepositoryAccess: 'public' # 'private' | 'public'. Required when ImageSource = invalidImage. Repository Access. Default: public.
    #dockerRegistryConnection: # string. Alias: RegistryConnectedServiceName. Required when DockerRepositoryAccess = private || ImageSource = PrivateRegistry. Registry Connection. 
    #PrivateRegistryImage: # string. Required when ImageSource = PrivateRegistry. Image. 
    #PrivateRegistryTag: # string. Optional. Use when ImageSource = PrivateRegistry. Tag. 
    #DockerNamespace: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Registry or Namespace. 
    #DockerRepository: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Image. 
    #DockerImageTag: # string. Optional. Use when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Tag. 
    #VirtualApplication: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Virtual application. 
    #Package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required when WebAppKind != linux && WebAppKind != applinux &&  WebAppKind != "". Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Alias: BuiltinLinuxPackage. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #RuntimeStack: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Runtime Stack. 
    #StartupCommand: # string. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Startup command. 
  # Output
    #WebAppUri: # string. Optional. Use when WebAppKind != "". App Service URL. 
  # Post Deployment Action
    #ScriptType: # 'Inline Script' | 'File Path'. Optional. Use when WebAppKind != "". Deployment script type. 
    #InlineScript: ':: You can provide your deployment commands here. One command per line.' # string. Required when ScriptType == Inline Script && WebAppKind != "". Inline Script. Default: :: You can provide your deployment commands here. One command per line..
    #ScriptPath: # string. Required when ScriptType == File Path && WebAppKind != "". Deployment script path. 
  # File Transforms & Variable Substitution Options
    #GenerateWebConfig: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Generate Web.config. Default: false.
    #WebConfigParameters: # string. Required when GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Web.config parameters. 
    #enableXmlTransform: false # boolean. Alias: XmlTransformation. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML transformation. Default: false.
    #enableXmlVariableSubstitution: false # boolean. Alias: XmlVariableSubstitution. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML variable substitution. Default: false.
    #JSONFiles: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. JSON variable substitution. 
  # Application and Configuration Settings
    #AppSettings: # string. App settings. 
    #ConfigurationSettings: # string. Configuration settings. 
  # Additional Deployment Options
    #TakeAppOfflineFlag: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Take App Offline. Default: false.
    #UseWebDeploy: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Publish using Web Deploy. Default: false.
    #SetParametersFile: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". SetParameters file. 
    #RemoveAdditionalFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Remove additional files at destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Exclude files from the App_Data folder. Default: false.
    #AdditionalArguments: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Additional arguments. 
    #RenameFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Rename locked files. Default: false.
# Azure App Service Deploy v3
# Update Azure App Services on Windows, Web App on Linux with built-in images or Docker containers, ASP.NET, .NET Core, PHP, Python or Node.js based Web applications, Function Apps, Mobile Apps, API applications, Web Jobs using Web Deploy / Kudu REST APIs.
- task: AzureRmWebAppDeployment@3
  inputs:
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    appType: 'app' # 'app' | 'applinux' | 'functionapp' | 'api' | 'mobileapp'. Alias: WebAppKind. Required. App type. Default: app.
    WebAppName: # string. Required. App Service name. 
    #DeployToSlotFlag: false # boolean. Optional. Use when WebAppKind != "". Deploy to slot. Default: false.
    #ResourceGroupName: # string. Required when DeployToSlotFlag = true. Resource group. 
    #SlotName: # string. Required when DeployToSlotFlag = true. Slot. 
    #ImageSource: 'Registry' # 'Registry' | 'Builtin'. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Image Source. Default: Registry.
    #AzureContainerRegistry: # string. Required when ImageSource = AzureContainerRegistry. Registry. 
    #AzureContainerRegistryLoginServer: # string. Optional. Use when ImageSource = invalidimagesource. Registry Login Server Name. 
    #AzureContainerRegistryImage: # string. Required when ImageSource = AzureContainerRegistry. Image. 
    #AzureContainerRegistryTag: # string. Optional. Use when ImageSource = AzureContainerRegistry. Tag. 
    #DockerRepositoryAccess: 'public' # 'private' | 'public'. Required when ImageSource = invalidImage. Repository Access. Default: public.
    #dockerRegistryConnection: # string. Alias: RegistryConnectedServiceName. Required when DockerRepositoryAccess = private || ImageSource = PrivateRegistry. Registry Connection. 
    #PrivateRegistryImage: # string. Required when ImageSource = PrivateRegistry. Image. 
    #PrivateRegistryTag: # string. Optional. Use when ImageSource = PrivateRegistry. Tag. 
    #DockerNamespace: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Registry or Namespace. 
    #DockerRepository: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Image. 
    #DockerImageTag: # string. Optional. Use when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource  = Registry. Tag. 
    #VirtualApplication: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Virtual application. 
    #Package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required when WebAppKind != linux && WebAppKind != applinux &&  WebAppKind != "". Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Alias: BuiltinLinuxPackage. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #RuntimeStack: # string. Required when WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Runtime Stack. 
    #StartupCommand: # string. Optional. Use when WebAppKind = applinux || WebAppKind = linux. Startup command. 
  # Output
    #WebAppUri: # string. Optional. Use when WebAppKind != "". App Service URL. 
  # Post Deployment Action
    #ScriptType: # 'Inline Script' | 'File Path'. Optional. Use when WebAppKind != "". Deployment script type. 
    #InlineScript: ':: You can provide your deployment commands here. One command per line.' # string. Required when ScriptType == Inline Script && WebAppKind != "". Inline Script. Default: :: You can provide your deployment commands here. One command per line..
    #ScriptPath: # string. Required when ScriptType == File Path && WebAppKind != "". Deployment script path. 
  # File Transforms & Variable Substitution Options
    #GenerateWebConfig: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Generate Web.config. Default: false.
    #WebConfigParameters: # string. Required when GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Web.config parameters. 
    #enableXmlTransform: false # boolean. Alias: XmlTransformation. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML transformation. Default: false.
    #enableXmlVariableSubstitution: false # boolean. Alias: XmlVariableSubstitution. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. XML variable substitution. Default: false.
    #JSONFiles: # string. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. JSON variable substitution. 
  # Application and Configuration Settings
    #AppSettings: # string. App settings. 
    #ConfigurationSettings: # string. Configuration settings. 
  # Additional Deployment Options
    #TakeAppOfflineFlag: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Take App Offline. Default: false.
    #UseWebDeploy: false # boolean. Optional. Use when WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Publish using Web Deploy. Default: false.
    #SetParametersFile: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". SetParameters file. 
    #RemoveAdditionalFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Remove additional files at destination. Default: false.
    #ExcludeFilesFromAppDataFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Exclude files from the App_Data folder. Default: false.
    #AdditionalArguments: # string. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Additional arguments. 
    #RenameFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Rename locked files. Default: false.

Dane wejściowe

azureSubscription - Subskrypcja platformy Azure
Alias wejściowy: ConnectedServiceName. string. Wymagane.

Określ subskrypcję usługi Azure Resource Manager dla wdrożenia.


appType - Typ aplikacji
Alias wejściowy: WebAppKind. string. Wymagane. Dozwolone wartości: app (aplikacja internetowa systemu Linux), applinux (Aplikacja internetowa systemu Linux), functionapp (Aplikacja funkcji (niezalecane, używanie Azure Functions zadanie)), api (aplikacja interfejsu API), mobileapp (aplikacja mobilna). Wartość domyślna: app.

Określ typ aplikacji internetowej do wdrożenia.

Uwaga: określ aplikację internetową systemu Linux dla wbudowanych obrazów platformy lub niestandardowych wdrożeń obrazów kontenera.


appType - Typ aplikacji
Alias wejściowy: WebAppKind. string. Wymagane. Dozwolone wartości: app (Aplikacja internetowa), applinux (Aplikacja internetowa systemu Linux), functionapp (Aplikacja funkcji), api (Aplikacja interfejsu API), mobileapp (Aplikacja mobilna). Wartość domyślna: app.

Określ typ aplikacji internetowej do wdrożenia.

Uwaga: określ aplikację internetową systemu Linux dla wbudowanych obrazów platformy lub niestandardowych wdrożeń obrazów kontenera.


WebAppName - nazwa App Service
string. Wymagane.

Określ nazwę istniejącej Azure App Service. Usługi App Services oparte na wybranym typie aplikacji będą wyświetlane tylko podczas korzystania z asystent zadania.


DeployToSlotFlag - Wdrażanie w miejscu
boolean. Opcjonalny. Użyj polecenia , gdy WebAppKind != "". Wartość domyślna: false.

Użyj tej opcji, aby wdrożyć w istniejącym miejscu innym niż miejsce produkcyjne. Jeśli ta opcja nie zostanie wybrana, Azure App Service zostanie wdrożona w miejscu produkcyjnym.


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

Określ grupę zasobów platformy Azure zawierającą Azure App Service określone powyżej.


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

Określ istniejące miejsce inne niż miejsce produkcyjne.


ImageSource - Źródło obrazu
string. Opcjonalny. Użyj polecenia , gdy WebAppKind = applinux || WebAppKind = linux. Dozwolone wartości: Registry (Container Registry), Builtin (Wbudowany obraz). Wartość domyślna: Registry.

App Service dla systemu Linux oferuje dwie różne opcje publikowania aplikacji:

Niestandardowe wdrażanie obrazów lub wdrażanie aplikacji z wbudowanym obrazem platformy.


AzureContainerRegistry - Rejestrze
string. Wymagane, gdy ImageSource = AzureContainerRegistry.

Globalnie unikatowa nazwa domeny najwyższego poziomu dla określonego rejestru.

Uwaga: w pełni kwalifikowana nazwa obrazu będzie mieć format: <registry>/<repository>:.<tag> Na przykład myregistry.azurecr.io/nginx:latest.


AzureContainerRegistryLoginServer - Nazwa serwera logowania rejestru
string. Opcjonalny. Użyj polecenia , gdy ImageSource = invalidimagesource.

Określ nazwę serwera logowania rejestru kontenerów platformy Azure.


AzureContainerRegistryImage - Obrazu
string. Wymagane, gdy ImageSource = AzureContainerRegistry.

Nazwa repozytorium, w którym przechowywane są obrazy kontenerów.

Uwaga: w pełni kwalifikowana nazwa obrazu będzie mieć format: <registry>/<repository>:.<tag> Na przykład :myregistry.azurecr.io/nginxlatest.


AzureContainerRegistryTag - Tag
string. Opcjonalny. Użyj polecenia , gdy ImageSource = AzureContainerRegistry.

Jest to mechanizm używany przez rejestry w celu nadania obrazom platformy Docker wersji.

Uwaga: w pełni kwalifikowana nazwa obrazu będzie mieć format: <registry>/<repository>:.<tag> Na przykład :myregistry.azurecr.io/nginxlatest.


DockerRepositoryAccess - Dostęp do repozytorium
string. Wymagane, gdy ImageSource = invalidImage. Dozwolone wartości: private, public. Wartość domyślna: public.

Określ dostęp do repozytorium platformy Docker.


dockerRegistryConnection - Połączenie rejestru
Alias wejściowy: RegistryConnectedServiceName. string. Wymagane, gdy DockerRepositoryAccess = private || ImageSource = PrivateRegistry.

Określ połączenie rejestru.


PrivateRegistryImage - Obrazu
string. Wymagane, gdy ImageSource = PrivateRegistry.

Nazwa repozytorium, w którym przechowywane są obrazy kontenerów.

Uwaga: w pełni kwalifikowana nazwa obrazu będzie mieć format: <registry><repository>:<tag>. Na przykład :myregistry.azurecr.io/nginxlatest.


PrivateRegistryTag - Tag
string. Opcjonalny. Użyj polecenia , gdy ImageSource = PrivateRegistry.

Tagi są mechanizmem używanym przez rejestry w celu nadania obrazom platformy Docker wersji.

Uwaga: w pełni kwalifikowana nazwa obrazu będzie mieć format: "<registry>/<repository>:".<tag> Na przykład :myregistry.azurecr.io/nginxlatest.


DockerNamespace - Rejestr lub przestrzeń nazw
string. Wymagane, gdy WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Globalnie unikatowa nazwa domeny najwyższego poziomu dla określonego rejestru lub przestrzeni nazw.

Uwaga: w pełni kwalifikowana nazwa obrazu będzie mieć format: <registry or namespace>/<repository>:.<tag> Na przykład :myregistry.azurecr.io/nginxlatest.


DockerRepository - Obrazu
string. Wymagane, gdy WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Nazwa repozytorium, w którym przechowywane są obrazy kontenerów.

Uwaga: w pełni kwalifikowana nazwa obrazu będzie mieć format: '<registry or namespace>/<repository>:.<tag> Na przykład :myregistry.azurecr.io/nginxlatest.


DockerImageTag - Tag
string. Opcjonalny. Użyj polecenia , gdy WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry.

Jest to mechanizm używany przez rejestry w celu nadania obrazom platformy Docker wersji.

Uwaga: W pełni kwalifikowana nazwa obrazu będzie mieć format: "<registry or namespace>/<repository>:".<tag> Na przykład myregistry.azurecr.io/nginx: .latest


VirtualApplication - Aplikacja wirtualna
string. Opcjonalny. Użyj polecenia , gdy WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Określ nazwę aplikacji wirtualnej, która została skonfigurowana w Azure Portal. Opcja nie jest wymagana w przypadku wdrożeń w katalogu głównym App Service.


Package - Pakiet lub folder
string. Wymagane, gdy WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Wartość domyślna: $(System.DefaultWorkingDirectory)/**/*.zip.

Ścieżka pliku do pakietu lub folderu zawierającego zawartość usługi App Service wygenerowaną przez program MSBuild lub skompresowany plik zip lub war.

Zmienne to kompilacja i wydanie. Obsługiwane są symbole wieloznaczne.

Na przykład: $(System.DefaultWorkingDirectory)/\*\*/\*.zip lub $(System.DefaultWorkingDirectory)/\*\*/\*.war.


packageForLinux - Pakiet lub folder
Alias wejściowy: BuiltinLinuxPackage. string. Wymagane, gdy WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin. Wartość domyślna: $(System.DefaultWorkingDirectory)/**/*.zip.

Ścieżka pliku do pakietu lub folderu zawierającego zawartość usługi App Service wygenerowaną przez program MSBuild lub skompresowany plik zip lub war.

Zmienne to kompilacja i wydanie. Obsługiwane są symbole wieloznaczne.

Na przykład: $(System.DefaultWorkingDirectory)/\*\*/\*.zip lub $(System.DefaultWorkingDirectory)/\*\*/\*.war.


RuntimeStack - Stos środowiska uruchomieniowego
string. Wymagane, gdy WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin.

Określ strukturę i wersję.


StartupCommand - Polecenie uruchamiania
string. Opcjonalny. Użyj polecenia , gdy WebAppKind = applinux || WebAppKind = linux.

Określ polecenie uruchamiania.


WebAppUri - adres URL App Service
string. Opcjonalny. Użyj polecenia , gdy WebAppKind != "".

Określ nazwę zmiennej wyjściowej, która jest generowana dla adresu URL Azure App Service. Zmienna może być używana w kolejnych zadaniach.


ScriptType - Typ skryptu wdrożenia
string. Opcjonalny. Użyj polecenia , gdy WebAppKind != "". Dozwolone wartości: Inline Script, File Path (Ścieżka pliku skryptu).

Dostosowuje wdrożenie, podając skrypt, który zostanie uruchomiony w usłudze aplikacja systemu Azure po pomyślnym ukończeniu wdrożenia. Może to na przykład przywrócić pakiety dla aplikacji Node, PHP i Python. Dowiedz się więcej o Azure App Service Deployment.


InlineScript - Skrypt wbudowany
string. Wymagane, gdy ScriptType == Inline Script && WebAppKind != "". Wartość domyślna: :: You can provide your deployment commands here. One command per line..


ScriptPath - Ścieżka skryptu wdrożenia
string. Wymagane, gdy ScriptType == File Path && WebAppKind != "".


GenerateWebConfig - Generowanie Web.config
boolean. Opcjonalny. Użyj polecenia , gdy WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Wartość domyślna: false.

Standard Web.config zostanie wygenerowany i wdrożony w Azure App Service, jeśli aplikacja jej nie ma. Wartości w programie web.config można edytować i różnić w zależności od struktury aplikacji. Na przykład w przypadku aplikacji web.config będą miały wartości pliku uruchamiania node.js i iis_node modułu. Dowiedz się więcej o Azure App Service Deployment.


WebConfigParameters - parametryWeb.config
string. Wymagane, gdy GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war.

Edytuje wartości, takie jak pliki uruchamiania w wygenerowanych web.config plikach. Ta funkcja edycji dotyczy tylko wygenerowanego web.configelementu . Dowiedz się więcej o Azure App Service Deployment.


AppSettings - Ustawienia aplikacji
string.

Edytuje ustawienia aplikacji internetowej zgodnie ze składnią -key value . Wartości zawierające spacje powinny być ujęte w cudzysłów podwójnych. Przykłady: -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE"Eastern Standard Time".


ConfigurationSettings - Ustawienia konfiguracji
string.

Edytuje ustawienia konfiguracji aplikacji internetowej zgodnie z wartością składni -key . Wartości zawierające spacje powinny być ujęte w cudzysłów podwójnych.

Przykłady: -phpVersion 5.6-linuxFxVersion: node|6.11.


TakeAppOfflineFlag - Przełącz aplikację w tryb offline
boolean. Opcjonalny. Użyj polecenia , gdy WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Wartość domyślna: false.

Użyj tej opcji, aby przełączyć Azure App Service w tryb offline, umieszczając app_offline.htm plik w katalogu głównym App Service przed rozpoczęciem operacji synchronizacji. Plik zostanie usunięty po pomyślnym zakończeniu operacji synchronizacji.


UseWebDeploy - Publikowanie przy użyciu narzędzia Web Deploy
boolean. Opcjonalny. Użyj polecenia , gdy WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Wartość domyślna: false.

Publish using Web Deploy opcje są 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 Azure App Service, a następujące opcje nie są obsługiwane.


SetParametersFile - Plik SetParameters
string. Opcjonalny. Użyj polecenia , gdy UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Lokalizacja SetParameters.xml pliku do użycia.


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

Użyj tej opcji, aby usunąć pliki w Azure App Service, które nie mają pasujących plików w pakiecie lub folderze App Service.

Uwaga: spowoduje to również usunięcie wszystkich plików powiązanych z dowolnym rozszerzeniem zainstalowanym na tym Azure App Service. Aby temu zapobiec, zaznacz Exclude files from App_Data folder pole wyboru.


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

Użyj tej opcji, aby zapobiec wdrażaniu App_Data plików w folderze do/usunięcia z Azure App Service.


AdditionalArguments - Dodatkowe argumenty
string. Opcjonalny. Użyj polecenia , gdy UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "".

Dodatkowe argumenty narzędzia Web Deploy zgodnie ze składnią -key:value.

Zostaną one zastosowane podczas wdrażania Azure App Service. Przykłady: -disableLink:AppPoolExtension-disableLink:ContentExtension.

Zobacz więcej przykładów ustawień operacji narzędzia Web Deploy.


RenameFilesFlag - Zmienianie nazwy zablokowanych plików
boolean. Opcjonalny. Użyj polecenia , gdy UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "". Wartość domyślna: false.

Użyj tej opcji, aby włączyć flagę MSDEPLOY_RENAME_LOCKED_FILES=1 msdeploy w ustawieniach aplikacji Azure App Service. Opcja umożliwia programowi msdeploy zmianę nazwy zablokowanych plików, które są zablokowane podczas wdrażania aplikacji.


enableXmlTransform - Przekształcanie XML
Alias wejściowy: XmlTransformation. boolean. Opcjonalny. Użyj polecenia , gdy WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Wartość domyślna: false.

Przekształcenia konfiguracji zostaną uruchomione dla *.Release.config elementów i *.<EnvironmentName>.config w pliku *.config file.

Przekształcenia konfiguracji zostaną uruchomione przed zastąpieniem zmiennej.

Przekształcenia XML są obsługiwane tylko dla platformy Windows.


enableXmlVariableSubstitution - Podstawianie zmiennych XML
Alias wejściowy: XmlVariableSubstitution. boolean. Opcjonalny. Użyj polecenia , gdy WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war. Wartość domyślna: false.

Zmienne zdefiniowane w potoku kompilacji lub wydania będą dopasowywane do key wpisów lub name w appSettingssekcjach , applicationSettingsi connectionStrings dowolnego pliku konfiguracji i parameters.xml. Podstawianie zmiennych jest uruchamiane po przekształceniach konfiguracji.

Uwaga: jeśli te same zmienne są zdefiniowane w potoku wydania i w środowisku, zmienne środowiskowe zastąpią zmienne potoku wydania.


JSONFiles - Podstawianie zmiennych JSON
string. Opcjonalny. Użyj polecenia , gdy WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war.

Udostępnia nową listę plików JSON rozdzielanych wierszami, aby zastąpić wartości zmiennych. Nazwy plików należy podać względem folderu głównego.

Aby zastąpić zmienne JSON, które są zagnieżdżone lub hierarchiczne, określ je przy użyciu JSONPath wyrażeń.

Aby na przykład zastąpić wartość ConnectionString w poniższym przykładzie, należy zdefiniować zmienną tak jak Data.DefaultConnection.ConnectionString w potoku kompilacji/wydania (lub w środowisku potoku wydania).

{
  "Data": {
    "DefaultConnection": {
      "ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"
    }
  }
}

Podstawianie zmiennych jest uruchamiane po przekształceniach konfiguracji.

Uwaga: zmienne potoku są wykluczane w podstawieniu.


Opcje sterowania zadania

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

Zmienne wyjściowe

Brak.

Uwagi

Jest dostępna nowsza wersja tego zadania. Aby uzyskać więcej informacji, zobacz AzureRmWebAppDeployment@4.

Rozwiązywanie problemów

Nie mogę wdrożyć narzędzia Web Deploy na moim Azure App Service przy użyciu uwierzytelniania Tożsamość Microsoft Entra z poziomu agenta systemu Windows

Zadanie wdrażania Azure App Service obsługuje nawiązywanie połączenia z platformą Microsoft Azure przy użyciu połączenia z usługą ARM przy użyciu Tożsamość Microsoft Entra, chyba że istnieją następujące trzy warunki:

  • Używasz formatu pakietu Web Deploy w agencie systemu Windows
  • Agent jest uruchomiony ze starszą wersją msdeploy.exe (na przykład w przypadku korzystania z obrazu hostowanego agenta systemu Windows-2019 )
  • Uwierzytelnianie podstawowe jest wyłączone dla Azure App Service

Jeśli te trzy warunki są obecne, zostanie wyświetlony komunikat o błędzie, taki jak App Service is configured to not use basic authentication. This requires Web Deploy msdeploy.exe version 7.1.7225.2108 or higher. You need a version of Visual Studio that includes an updated version of msdeploy.exe. For more information, visit https://aka.ms/azdo-webapp-msdeploy.

Aby rozwiązać ten problem, możesz wybrać jedną z następujących opcji w kolejności preferencji.

  1. Zaktualizuj obraz agenta. Jeśli używasz hostowanych agentów, przejdź z wersji windows-2019 do windows-2022 (lub windows-latest). Jeśli używasz własnych agentów, zainstaluj program Visual Studio 2022 na agencie, aby uzyskać nowszą wersję msdeploy.exe.
  2. Jeśli zależysz od starszego obrazu agenta i nie możesz zaktualizować agenta dla potoku, rozważ podzielenie zadania tak, aby zadanie wdrażania Azure App Service było uruchamiane w systemie windows-2022 (lub windows-latest).
  3. Jeśli żadna z tych opcji nie jest możliwa, możesz włączyć uwierzytelnianie podstawowe dla Azure App Service.

Wymagania

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