AzureRmWebAppDeployment@3 – Azure App Service v3-feladat üzembe helyezése
Ezzel a feladattal üzembe helyezhet web-, mobil- vagy API-alkalmazásokat Azure App Service Docker, Java, .NET, .NET Core, Node.js, PHP, Python vagy Ruby használatával.
Megjegyzés
Azure Functions-alkalmazások üzembe helyezése AzureFunctionApp@1 használatával.
Frissítse a Azure-alkalmazás-szolgáltatásokat Windows rendszeren, a Linuxon futó Web Appot beépített rendszerképekkel vagy docker-tárolókkal, ASP.NET, .NET Core- és PHP-, Python- vagy Node.js-alapú webalkalmazásokkal, függvényalkalmazásokkal, mobilalkalmazásokkal, API-alkalmazásokkal és webfeladatokkal a Web Deploy/Kudu REST API-k használatával.
Syntax
# 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.
Bevitelek
azureSubscription
- Azure-előfizetés
Bemeneti alias: ConnectedServiceName
. string
. Kötelező.
Adja meg az üzembe helyezéshez tartozó Azure Resource Manager-előfizetést.
appType
- Alkalmazás típusa
Bemeneti alias: WebAppKind
. string
. Kötelező. Engedélyezett értékek: app
(Webalkalmazás), applinux
(Linux-webalkalmazás), functionapp
(függvényalkalmazás (nem ajánlott, Azure Functions feladat használata)), api
(API-alkalmazás), mobileapp
(mobilalkalmazás). Alapértelmezett érték: app
.
Adja meg az üzembe helyezendő webalkalmazás típusát.
Megjegyzés: Adja meg a Linux-webalkalmazást a beépített platformrendszerképekhez vagy az egyéni tárolólemezképek üzembe helyezéséhez.
appType
- Alkalmazás típusa
Bemeneti alias: WebAppKind
. string
. Kötelező. Engedélyezett értékek: app
(Webalkalmazás), applinux
(Linux Web App), functionapp
(Függvényalkalmazás), api
(API-alkalmazás), mobileapp
(Mobilalkalmazás). Alapértelmezett érték: app
.
Adja meg az üzembe helyezendő webalkalmazás típusát.
Megjegyzés: Adja meg a Linux-webalkalmazást a beépített platformrendszerképekhez vagy az egyéni tárolólemezképek üzembe helyezéséhez.
WebAppName
- App Service neve
string
. Kötelező.
Adja meg egy meglévő Azure App Service nevét. A kiválasztott alkalmazástípuson alapuló alkalmazásszolgáltatások csak a feladat segéd használatakor jelennek meg.
DeployToSlotFlag
- Üzembe helyezés a tárolóhelyen
boolean
. Választható. Használja a következőt: WebAppKind != ""
. Alapértelmezett érték: false
.
Ezzel a beállítással az éles ponttól eltérő meglévő tárolóhelyre helyezheti üzembe. Ha ez a beállítás nincs kiválasztva, akkor a Azure App Service az éles üzembe helyezési ponton lesznek üzembe helyezve.
ResourceGroupName
- Erőforráscsoport
string
. Akkor szükséges, ha DeployToSlotFlag = true
.
Adja meg a fent megadott Azure App Service tartalmazó Azure-erőforráscsoportot.
SlotName
- Slot
string
. Akkor szükséges, ha DeployToSlotFlag = true
.
Adjon meg egy, az éles ponttól eltérő meglévő tárolóhelyet.
ImageSource
- Kép forrása
string
. Választható. Használja a következőt: WebAppKind = applinux || WebAppKind = linux
. Engedélyezett értékek: Registry
(Tárolóregisztrációs adatbázis), Builtin
(beépített rendszerkép). Alapértelmezett érték: Registry
.
App Service on Linux két különböző lehetőséget kínál az alkalmazás közzétételére:
Egyéni rendszerkép üzembe helyezése vagy alkalmazástelepítés beépített platformrendszerképpel.
AzureContainerRegistry
- Rendszerleíró
string
. Akkor szükséges, ha ImageSource = AzureContainerRegistry
.
Az adott beállításjegyzék globálisan egyedi legfelső szintű tartományneve.
Megjegyzés: A teljes képnév formátuma: <registry>
/<repository>
:.<tag>
Például: myregistry.azurecr.io
/nginx:latest
.
AzureContainerRegistryLoginServer
- Regisztrációs adatbázis bejelentkezési kiszolgálója neve
string
. Választható. Használja a következőt: ImageSource = invalidimagesource
.
Adja meg az Azure Container Registry bejelentkezési kiszolgálónevét.
AzureContainerRegistryImage
- Kép
string
. Akkor szükséges, ha ImageSource = AzureContainerRegistry
.
Annak az adattárnak a neve, amelyben a tárolórendszerképek találhatók.
Megjegyzés: A teljes képnév formátuma: <registry>
/<repository>
:.<tag>
Például: myregistry.azurecr.io
/nginx
:.latest
AzureContainerRegistryTag
- Tag
string
. Választható. Használja a következőt: ImageSource = AzureContainerRegistry
.
Ez az a mechanizmus, amellyel a regisztrációs adatbázisok verziót adnak a Docker-rendszerképekhez.
Megjegyzés: A teljes képnév formátuma: <registry>
/<repository>
:.<tag>
Például: myregistry.azurecr.io
/nginx
:.latest
DockerRepositoryAccess
- Adattár hozzáférése
string
. Akkor szükséges, ha ImageSource = invalidImage
. Engedélyezett értékek: private
, public
. Alapértelmezett érték: public
.
Adja meg a Docker-adattár hozzáférését.
dockerRegistryConnection
- Beállításjegyzék-kapcsolat
Bemeneti alias: RegistryConnectedServiceName
. string
. Akkor szükséges, ha DockerRepositoryAccess = private || ImageSource = PrivateRegistry
.
Adja meg a beállításjegyzék-kapcsolatot.
PrivateRegistryImage
- Kép
string
. Akkor szükséges, ha ImageSource = PrivateRegistry
.
Annak az adattárnak a neve, amelyben a tárolórendszerképek találhatók.
Megjegyzés: A teljes képnév formátuma: <registry>
<repository>
:<tag>
. Például: myregistry.azurecr.io
/nginx
:.latest
PrivateRegistryTag
- Tag
string
. Választható. Használja a következőt: ImageSource = PrivateRegistry
.
A címkék az a mechanizmus, amellyel a regisztrációs adatbázisok verziót adnak a Docker-rendszerképek számára.
Megjegyzés: A teljes képnév a következő formátumú lesz: ":<tag>
"<registry>
/<repository>
. Például: myregistry.azurecr.io
/nginx
:.latest
DockerNamespace
- Beállításjegyzék vagy névtér
string
. Akkor szükséges, ha WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry
.
Globálisan egyedi legfelső szintű tartománynév az adott beállításjegyzékhez vagy névtérhez.
Megjegyzés: A teljes képnév formátuma: <registry or namespace>
/<repository>
:.<tag>
Például: myregistry.azurecr.io
/nginx
:.latest
DockerRepository
- Kép
string
. Akkor szükséges, ha WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry
.
Annak az adattárnak a neve, amelyben a tárolórendszerképek találhatók.
Megjegyzés: A teljes képnév a következő formátumú lesz: "<registry or namespace>
/<repository>
:.<tag>
Például: myregistry.azurecr.io
/nginx
:.latest
DockerImageTag
- Tag
string
. Választható. Használja a következőt: WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Registry
.
A beállításjegyzékek ezt a mechanizmust használják a Docker-rendszerképek verziószámozására.
Megjegyzés: A teljes képnév a következő formátumú lesz: ":<tag>
"<registry or namespace>
/<repository>
. Például: myregistry.azurecr.io
/nginx
:.latest
VirtualApplication
- Virtuális alkalmazás
string
. Választható. Használja a következőt: WebAppKind != linux && WebAppKind != applinux && WebAppKind != ""
.
Adja meg a Azure Portal konfigurált virtuális alkalmazás nevét. A beállítás nem szükséges a App Service gyökérben történő üzembe helyezéshez.
Package
- Csomag vagy mappa
string
. Akkor szükséges, ha WebAppKind != linux && WebAppKind != applinux && WebAppKind != ""
. Alapértelmezett érték: $(System.DefaultWorkingDirectory)/**/*.zip
.
A csomag vagy az MSBuild által létrehozott App Service-tartalmat vagy tömörített zip- vagy warfájlt tartalmazó mappa elérési útja.
A változók a buildelés és a kiadás. A helyettesítő karakterek támogatottak.
Például $(System.DefaultWorkingDirectory)/\*\*/\*.zip
vagy $(System.DefaultWorkingDirectory)/\*\*/\*.war
.
packageForLinux
- Csomag vagy mappa
Bemeneti alias: BuiltinLinuxPackage
. string
. Akkor szükséges, ha WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin
. Alapértelmezett érték: $(System.DefaultWorkingDirectory)/**/*.zip
.
A csomag vagy az MSBuild által létrehozott App Service-tartalmat vagy tömörített zip- vagy warfájlt tartalmazó mappa elérési útja.
A változók a buildelés és a kiadás. A helyettesítő karakterek támogatottak.
Például $(System.DefaultWorkingDirectory)/\*\*/\*.zip
vagy $(System.DefaultWorkingDirectory)/\*\*/\*.war
.
RuntimeStack
- Futtatókörnyezeti verem
string
. Akkor szükséges, ha WebAppKind != app && WebAppKind != functionapp && WebAppKind != api && WebAppKind != mobileapp && ImageSource = Builtin
.
Adja meg a keretrendszert és a verziót.
StartupCommand
- Indítási parancs
string
. Választható. Használja a következőt: WebAppKind = applinux || WebAppKind = linux
.
Adja meg az indítási parancsot.
WebAppUri
- APP SERVICE URL-cím
string
. Választható. Használja a következőt: WebAppKind != ""
.
Adja meg a Azure App Service URL-címéhez létrehozott kimeneti változó nevét. A változó a következő feladatokban is használható.
ScriptType
- Üzembehelyezési szkript típusa
string
. Választható. Használja a következőt: WebAppKind != ""
. Engedélyezett értékek: Inline Script
, File Path
(Szkriptfájl elérési útja).
Testre szabja az üzembe helyezést egy szkript megadásával, amely a Azure-alkalmazás szolgáltatáson fog futni, miután a feladat sikeresen befejezte az üzembe helyezést. Ez például visszaállíthatja a Node-, PHP- és Python-alkalmazások csomagjait. További információ a Azure App Service üzembe helyezésről.
InlineScript
- Beágyazott szkript
string
. Akkor szükséges, ha ScriptType == Inline Script && WebAppKind != ""
. Alapértelmezett érték: :: You can provide your deployment commands here. One command per line.
.
ScriptPath
- Üzembehelyezési szkript elérési útja
string
. Akkor szükséges, ha ScriptType == File Path && WebAppKind != ""
.
GenerateWebConfig
- Web.configlétrehozása
boolean
. Választható. Használja a következőt: WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war
. Alapértelmezett érték: false
.
A rendszer létrehoz és üzembe helyez egy szabványt Web.config
a Azure App Service, ha az alkalmazás nem rendelkezik ilyenrel. A(z) web.config
értékei szerkeszthetők, és az alkalmazás-keretrendszertől függően változhatnak. Az alkalmazáshoz web.config
például indítási node.js
fájl és iis_node
modulértékek tartoznak. További információ a Azure App Service üzembe helyezésről.
WebConfigParameters
- Web.config paraméterek
string
. Akkor szükséges, ha GenerateWebConfig == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war
.
Olyan értékeket szerkeszt, mint az indítási fájlok a létrehozott web.config
fájlban. Ez a szerkesztési funkció csak a létrehozott web.config
szolgáltatáshoz tartozik. További információ a Azure App Service üzembe helyezésről.
AppSettings
- Alkalmazásbeállítások
string
.
Szerkessze a webalkalmazás alkalmazásbeállításait a szintaxis -key értéke alapján. A szóközöket tartalmazó értékeket idézőjelek közé kell tenni.
Példák: -Port 5000
-WEBSITE_TIME_ZONE
-RequestTimeout 5000
"Eastern Standard Time"
.
ConfigurationSettings
- Konfigurációs beállítások
string
.
Szerkessze a webalkalmazás konfigurációs beállításait a szintaxisérték -key
alapján. A szóközöket tartalmazó értékeket idézőjelek közé kell tenni.
Példák: -phpVersion 5.6
-linuxFxVersion: node|6.11
.
TakeAppOfflineFlag
- Alkalmazás offline állapotba helyezése
boolean
. Választható. Használja a következőt: WebAppKind != linux && WebAppKind != applinux && WebAppKind != ""
. Alapértelmezett érték: false
.
Ezzel a beállítással offline állapotba helyezheti a Azure App Service úgy, hogy a szinkronizálási művelet megkezdése előtt elhelyez egy app_offline.htm
fájlt a App Service gyökérkönyvtárában. A fájl a szinkronizálási művelet sikeres befejezése után törlődik.
UseWebDeploy
- Közzététel a Web Deploy használatával
boolean
. Választható. Használja a következőt: WebAppKind != linux && WebAppKind != applinux && WebAppKind != ""
. Alapértelmezett érték: false
.
Publish using Web Deploy
beállítások csak Windows-ügynök használata esetén támogatottak. Más platformokon a feladat a Kudu REST API-kra támaszkodik a Azure App Service üzembe helyezéséhez, és a következő lehetőségek nem támogatottak.
SetParametersFile
- SetParameters fájl
string
. Választható. Használja a következőt: UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != ""
.
A használni kívánt fájl helye SetParameters.xml
.
RemoveAdditionalFilesFlag
- További fájlok eltávolítása a célhelyen
boolean
. Választható. Használja a következőt: UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != ""
. Alapértelmezett érték: false
.
Ezzel a beállítással törölheti azokat a fájlokat a Azure App Service, amelyek nem rendelkeznek egyező fájlokkal a App Service csomagban vagy mappában.
Megjegyzés: Ezzel a Azure App Service telepített bővítményekkel kapcsolatos összes fájlt is eltávolítja. Ennek megakadályozásához jelölje be a Exclude files from App_Data folder
jelölőnégyzetet.
ExcludeFilesFromAppDataFlag
- Fájlok kizárása a App_Data mappából
boolean
. Választható. Használja a következőt: UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != ""
. Alapértelmezett érték: false
.
Ezzel a beállítással megakadályozhatja, hogy a App_Data
mappában lévő fájlok a Azure App Service legyenek üzembe helyezve vagy törölve legyenek.
AdditionalArguments
- További argumentumok
string
. Választható. Használja a következőt: UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != ""
.
A webtelepítés további argumentumai a szintaxist -key:value
követve.
Ezek a Azure App Service telepítésekor lesznek alkalmazva. Példák: -disableLink:AppPoolExtension
-disableLink:ContentExtension
.
További példák a webes üzembe helyezési művelet beállításaira.
RenameFilesFlag
- Zárolt fájlok átnevezése
boolean
. Választható. Használja a következőt: UseWebDeploy == true && WebAppKind != linux && WebAppKind != applinux && WebAppKind != ""
. Alapértelmezett érték: false
.
Ezzel a beállítással engedélyezheti az msdeploy jelzőt MSDEPLOY_RENAME_LOCKED_FILES=1
Azure App Service alkalmazásbeállításokban. A beállítás lehetővé teszi, hogy az msdeploy átnevezze az alkalmazás üzembe helyezése során zárolt fájlokat.
enableXmlTransform
- XML-átalakítás
Bemeneti alias: XmlTransformation
. boolean
. Választható. Használja a következőt: WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war
. Alapértelmezett érték: false
.
A konfigurációs átalakítások a és a *.config file
rendszeren lesznek futtatva.*.Release.config
*.<EnvironmentName>.config
A konfigurációs átalakítások a változóhelyettesítés előtt lesznek futtatva.
Az XML-átalakítások csak Windows-platformon támogatottak.
enableXmlVariableSubstitution
- XML-változó helyettesítése
Bemeneti alias: XmlVariableSubstitution
. boolean
. Választható. Használja a következőt: WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war
. Alapértelmezett érték: false
.
A buildelési vagy kiadási folyamatban definiált key
változók a konfigurációs fájlok és a appSettings
konfigurációs fájlok parameters.xml
, applicationSettings
és connectionStrings
szakaszainak vagy name
bejegyzéseinek megfelelőek lesznek. A változó-helyettesítés a konfigurációátalakítások után fut.
Megjegyzés: Ha ugyanazok a változók vannak definiálva a kiadási folyamatban és a környezetben, akkor a környezeti változók felülírják a kiadási folyamat változóit.
JSONFiles
- JSON-változó helyettesítése
string
. Választható. Használja a következőt: WebAppKind != linux && WebAppKind != applinux && WebAppKind != "" && Package NotEndsWith .war
.
Új sorra tagolt JSON-fájllistát biztosít a változóértékek helyettesítéséhez. A fájlneveket a gyökérmappához viszonyítva kell megadni.
A beágyazott vagy hierarchikus JSON-változók helyettesítéséhez kifejezések használatával JSONPath
adja meg őket.
Az alábbi mintában szereplő érték ConnectionString
cseréjéhez például definiálnia kell egy változót Data.DefaultConnection.ConnectionString
a buildelési/kiadási folyamatban (vagy a kiadási folyamat környezetében).
{
"Data": {
"DefaultConnection": {
"ConnectionString": "Server=(localdb)\SQLEXPRESS;Database=MyDB;Trusted_Connection=True"
}
}
}
A változó-helyettesítés a konfigurációátalakítások után fut.
Megjegyzés: A folyamatváltozók ki vannak zárva a helyettesítésből.
Feladatvezérlési lehetőségek
Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.
Kimeneti változók
Nincsenek.
Megjegyzések
A feladat egy újabb verziója érhető el. További információ: AzureRmWebAppDeployment@4.
Hibaelhárítás
A Windows-ügynökömtől származó Microsoft Entra ID hitelesítéssel nem tudom webre üzembe helyezni a Azure App Service
A Azure App Service üzembe helyezési feladat támogatja a Microsoft Azure-hoz való csatlakozást ARM-szolgáltatáskapcsolattal a Microsoft Entra ID használatával, kivéve, ha az alábbi három feltétel van érvényben:
- Webes üzembe helyezési csomagformátumot használ Windows-ügynökön
- Az ügynök a msdeploy.exe régebbi verziójával fut (például a Windows-2019 által üzemeltetett ügynök rendszerképének használatakor)
- Az alapszintű hitelesítés le van tiltva a Azure App Service
Ha ez a három feltétel jelenik meg, a következő hibaüzenet jelenik meg: 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.
A probléma megoldásához az alábbi lehetőségek közül választhat, a beállítások sorrendjében.
- Frissítse az ügynök lemezképét. Ha üzemeltetett ügynököket használ, váltsa át a windows-2019-rőla windows-2022-ra (vagy a windows-latest-ra). Ha saját üzemeltetésű ügynököket használ, telepítse a Visual Studio 2022-t az ügynökre a msdeploy.exeújabb verziójának beszerzéséhez.
- Ha egy régebbi ügynökrendszerképtől függ, és nem tudja frissíteni a folyamat ügynökét, fontolja meg a feladat felosztását, hogy a Azure App Service üzembe helyezési feladat a Windows-2022 (vagy a windows-latest) rendszeren fusson.
- Ha egyik lehetőség sem lehetséges, engedélyezheti az alapszintű hitelesítést a Azure App Service.
Követelmények
Követelmény | Leírás |
---|---|
Folyamattípusok | YAML, klasszikus build, klasszikus kiadás |
Futtatás | Ügynök, DeploymentGroup |
Igények | None |
Képességek | Ez a feladat nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek. |
Parancskorlátozások | Bármelyik |
Változók beállítása | Bármelyik |
Ügynök verziója | 2.104.1 vagy újabb |
Feladatkategória | Üzembe helyezés |
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: