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
/nginx
latest
.
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
/nginx
latest
.
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
/nginx
latest
.
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
/nginx
latest
.
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
/nginx
latest
.
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
/nginx
latest
.
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.config
elementu . 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 appSettings
sekcjach , applicationSettings
i 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.
- 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.
- 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).
- 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 |