AzureRmWebAppDeployment@4 – Az Azure App Service v4-feladat üzembe helyezése

Ezzel a feladattal üzembe helyezhet egy web-, mobil- vagy API-alkalmazást az Azure App Service-ben Docker, Java, .NET, .NET Core, Node.js, PHP, Python vagy Ruby használatával.

Note

Használd AzureFunctionApp@2-t Azure Functions alkalmazások telepítéséhez.

Syntax

# Azure App Service deploy v4
# 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@4
  inputs:
    ConnectionType: 'AzureRM' # 'AzureRM' | 'PublishProfile'. Required. Connection type. Default: AzureRM.
    azureSubscription: # string. Alias: ConnectedServiceName. Required when ConnectionType = AzureRM. Azure subscription. 
    #PublishProfilePath: '$(System.DefaultWorkingDirectory)/**/*.pubxml' # string. Required when ConnectionType = PublishProfile. Publish profile path. Default: $(System.DefaultWorkingDirectory)/**/*.pubxml.
    #PublishProfilePassword: # string. Required when ConnectionType = PublishProfile. Publish profile password. 
    appType: 'webApp' # 'webApp' | 'webAppLinux' | 'webAppContainer' | 'webAppHyperVContainer' | 'functionApp' | 'functionAppLinux' | 'functionAppContainer' | 'apiApp' | 'mobileApp'. Alias: WebAppKind. Required when ConnectionType = AzureRM. App Service type. Default: webApp.
    WebAppName: # string. Required when ConnectionType = AzureRM. App Service name. 
    #deployToSlotOrASE: false # boolean. Alias: DeployToSlotOrASEFlag. Optional. Use when ConnectionType = AzureRM && WebAppKind != "". Deploy to Slot or App Service Environment. Default: false.
    #ResourceGroupName: # string. Required when DeployToSlotOrASEFlag = true. Resource group. 
    #SlotName: 'production' # string. Required when DeployToSlotOrASEFlag = true. Slot. Default: production.
    #DockerNamespace: # string. Required when WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContainer. Registry or Namespace. 
    #DockerRepository: # string. Required when WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContainer. Image. 
    #DockerImageTag: # string. Optional. Use when WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContainer. Tag. 
    #VirtualApplication: # string. Optional. Use when WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != functionApp && webAppKind != functionAppLinux && WebAppKind != "". Virtual application. 
    #packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Alias: Package. Required when ConnectionType = PublishProfile || WebAppKind = webApp || WebAppKind = apiApp || WebAppKind = functionApp || WebAppKind = mobileApp || WebAppKind = webAppLinux || webAppKind = functionAppLinux. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #RuntimeStack: # string. Optional. Use when WebAppKind = webAppLinux. Runtime Stack. 
    #RuntimeStackFunction: # 'DOTNET|2.2' | 'DOTNET|3.1' | 'JAVA|8' | 'JAVA|11' | 'NODE|8' | 'NODE|10' | 'NODE|12' | 'NODE|14' | 'NODE|20' | 'NODE|22' | 'PYTHON|3.6' | 'PYTHON|3.7' | 'PYTHON|3.8'. Optional. Use when WebAppKind = functionAppLinux. Runtime Stack. 
    #StartupCommand: # string. Optional. Use when WebAppKind = webAppLinux || WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = functionAppLinux || WebAppKind = webAppHyperVContainer. Startup command. 
  # Post Deployment Action
    #ScriptType: # 'Inline Script' | 'File Path'. Optional. Use when ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer. Deployment script type. 
    #InlineScript: ':: You can provide your deployment commands here. One command per line.' # string. Required when ScriptType == Inline Script && ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer. Inline Script. Default: :: You can provide your deployment commands here. One command per line..
    #ScriptPath: # string. Required when ScriptType == File Path && ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer. Deployment script path. 
  # File Transforms & Variable Substitution Options
    #WebConfigParameters: # string. Optional. Use when WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war. Generate web.config parameters for Python, Node.js, Go and Java apps. 
    #enableXmlTransform: false # boolean. Alias: XmlTransformation. Optional. Use when WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war. XML transformation. Default: false.
    #enableXmlVariableSubstitution: false # boolean. Alias: XmlVariableSubstitution. Optional. Use when WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war. XML variable substitution. Default: false.
    #JSONFiles: # string. Optional. Use when WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war. JSON variable substitution. 
  # Application and Configuration Settings
    #AppSettings: # string. Optional. Use when ConnectionType = AzureRM. App settings. 
    #ConfigurationSettings: # string. Optional. Use when ConnectionType = AzureRM. Configuration settings. 
  # Additional Deployment Options
    #enableCustomDeployment: false # boolean. Alias: UseWebDeploy. Optional. Use when ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Select deployment method. Default: false.
    #DeploymentType: 'webDeploy' # 'webDeploy' | 'zipDeploy' | 'runFromZip'. Required when UseWebDeploy == true && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Deployment method. Default: webDeploy.
    #TakeAppOfflineFlag: true # boolean. Optional. Use when UseWebDeploy == true && DeploymentType != runFromZip && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Take App Offline. Default: true.
    #SetParametersFile: # string. Optional. Use when UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. SetParameters file. 
    #RemoveAdditionalFilesFlag: false # boolean. Optional. Use when UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Remove additional files at destination. Default: false.
    #ExcludeFilesFromAppDataFlag: true # boolean. Optional. Use when UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Exclude files from the App_Data folder. Default: true.
    #AdditionalArguments: '-retryAttempts:6 -retryInterval:10000' # string. Optional. Use when UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Additional arguments. Default: -retryAttempts:6 -retryInterval:10000.
    #RenameFilesFlag: true # boolean. Optional. Use when UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Rename locked files. Default: true.

Inputs

ConnectionType - Kapcsolat típusa
string. Required. Engedélyezett értékek: AzureRM (Azure Resource Manager), PublishProfile (Közzétételi profil). Alapértelmezett érték: AzureRM.

Adja meg a webalkalmazás üzembe helyezéséhez használandó szolgáltatáskapcsolat típusát.

Adja meg Publish Profile a Visual Studio által létrehozott közzétételi profilok használatát.

Azure-előfizetés azureSubscription -
Bemeneti alias: ConnectedServiceName. string. ConnectionType = AzureRMesetén kötelező.

Adja meg az üzembe helyezéshez szükséges Azure Resource Manager-előfizetést.

PublishProfilePath - Profil elérési útjának közzététele
string. ConnectionType = PublishProfileesetén kötelező. Alapértelmezett érték: $(System.DefaultWorkingDirectory)/**/*.pubxml.

A Visual Studióból létrehozott közzétételi profil elérési útja.

PublishProfilePassword - Profiljelszó közzététele
string. ConnectionType = PublishProfileesetén kötelező.

Javasoljuk, hogy titkos változóban tárolja a jelszót, és használja ezt a változót, például $(Password).

appType - App Service-típus
Bemeneti alias: WebAppKind. string. ConnectionType = AzureRMesetén kötelező. Engedélyezett értékek: webApp (Web App on Windows), webAppLinux (Web App on Linux), webAppContainer (Web App for Containers (Linux)), webAppHyperVContainer (Web App for Containers (Windows)), functionApp (Függvényalkalmazás Windows rendszeren (Nem ajánlott, Az Azure Functions-feladat használata)), functionAppLinux (Függvényalkalmazás Linux rendszeren (Nem ajánlott, Azure Functions-feladat használata)), functionAppContainer (Függvényalkalmazás tárolókhoz (Linux) (Nem ajánlott, Azure Functions használata tárolófeladathoz)), apiApp (API-alkalmazás), mobileApp (Mobilalkalmazás). Alapértelmezett érték: webApp.

Válasszon a Windows webalkalmazás, a Linux webalkalmazás, a Web App for Containers, a Függvényalkalmazás, a Függvényalkalmazás Linuxon, a Függvényalkalmazás tárolókhoz és a Mobilalkalmazás közül.

WebAppName - App Service-név
string. ConnectionType = AzureRMesetén 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 feladatsegéd használatakor jelennek meg.

deployToSlotOrASE - Üzembe helyezés pont- vagy App Service-környezetben
Bemeneti alias: DeployToSlotOrASEFlag. boolean. Optional. Használja a ConnectionType = AzureRM && WebAppKind != "". Alapértelmezett érték: false.

Adja meg a meglévő üzembehelyezési ponton vagy az Azure App Service-környezetben való üzembe helyezés lehetőségét. Mindkét cél esetében a tevékenységhez erőforráscsoport-név szükséges. Ha az üzembe helyezési cél egy tárolóhely, alapértelmezés szerint az üzembe helyezés az éles tárolóhelyre történik. Bármely más meglévő pontnév megadható. Ha az üzembehelyezési cél egy Azure App Service-környezet, hagyja meg a pont nevét Production, és csak az erőforráscsoport nevét adja meg.

ResourceGroupName - erőforráscsoport
string. DeployToSlotOrASEFlag = trueesetén kötelező.

Az erőforráscsoport nevére akkor van szükség, ha az üzembehelyezési cél egy üzembehelyezési pont vagy egy App Service-környezet.

Adja meg a fent megadott Azure App Service-t tartalmazó Azure-erőforráscsoportot.

SlotName - pont
string. DeployToSlotOrASEFlag = trueesetén kötelező. Alapértelmezett érték: production.

Adjon meg egy, az éles ponttól eltérő meglévő pontot.

DockerNamespace - beállításjegyzék- vagy névtér-
string. WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContaineresetén kötelező.

Az adott beállításjegyzék vagy névtér globálisan egyedi legfelső szintű tartományneve. 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. WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContaineresetén kötelező.

Annak az adattárnak a neve, amelyben a tárolólemezképek vannak tárolva. Megjegyzés: A teljes képnév formátuma: {registry or namespace}/{repository}:{tag}. Például myregistry.azurecr.io/nginx:latest.

DockerImageTag - Címke
string. Optional. Használja a WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContainer.

A címkék az a mechanizmus, amellyel a regisztrációs adatbázisok verzióinformációkat alkalmazhatnak a Docker-rendszerképekre. Megjegyzés: A teljes képnév formátuma: {registry or namespace}/{repository}:{tag}. Például myregistry.azurecr.io/nginx:latest.

VirtualApplication - Virtuális alkalmazás
string. Optional. Használja a WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != functionApp && webAppKind != functionAppLinux && WebAppKind != "".

Adja meg az Azure Portalon konfigurált virtuális alkalmazás nevét. Ez a beállítás nem szükséges a webhely gyökerében történő üzembe helyezéshez. A virtuális alkalmazást a webes projekt üzembe helyezése előtt konfigurálnia kell.

packageForLinux - Csomag vagy mappa
Bemeneti alias: Package. string. ConnectionType = PublishProfile || WebAppKind = webApp || WebAppKind = apiApp || WebAppKind = functionApp || WebAppKind = mobileApp || WebAppKind = webAppLinux || webAppKind = functionAppLinuxesetén kötelező. Alapértelmezett érték: $(System.DefaultWorkingDirectory)/**/*.zip.

A csomaghoz vagy az MSBuild által létrehozott App Service-tartalmat tartalmazó mappához vagy tömörített zip- vagy háborús fájlhoz vezető fájl elérési útja.

A változók a Build és a Release. A helyettesítő karakterek támogatottak.

Például $(System.DefaultWorkingDirectory)/\*\*/\*.zip vagy $(System.DefaultWorkingDirectory)/\*\*/\*.war.

RuntimeStack - Futásidejű verem
string. Optional. Használja a WebAppKind = webAppLinux.

Adja meg a keretrendszert és a verziót.

RuntimeStackFunction - Futásidejű verem
string. Optional. Használja a WebAppKind = functionAppLinux. Engedélyezett értékek: DOTNET|2.2 (DOTNET|2.2 (függvényalkalmazás v2)), DOTNET|3.1 (DOTNET|3.1 (függvényalkalmazás v3)), JAVA|8 (JAVA|8 (függvényalkalmazás v2/v3)), JAVA|11 (JAVA|11 (függvényapp v3)), NODE|8 (NODE|8 (függvényapp v2)), NODE|10 (NODE|10 (függvényalkalmazás v2/v3)), NODE|12 (NODE|12 (függvényapp v3)), NODE|14 (NODE|14 (függvényapp v3)), NODE|20 (NODE|20 (függvényalkalmazás v4)), NODE|22 (NODE|22 (függvényapp v4)), PYTHON|3.6 (PYTHON|3.6 (függvényalkalmazás v2/v3)), PYTHON|3.7 (PYTHON|3.7 (függvényalkalmazás v2/v3)), PYTHON|3.8 (PYTHON|3.8 (függvényalkalmazás v3)).

Adja meg a keretrendszert és a verziót. A támogatott futtatókörnyezeti verziók az Azure Functions-futtatókörnyezetek áttekintésében. A régi értékek, például a DOCKER|microsoft/azure-functions-* elavultak. Használja a legördülő lista új értékeit.

StartupCommand - indítási parancs
string. Optional. Használja a WebAppKind = webAppLinux || WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = functionAppLinux || WebAppKind = webAppHyperVContainer.

Adja meg az Indítás parancsot. Például:

dotnet ügyvezető filename.dll

dotnet filename.dll.

ScriptType - üzembehelyezési szkript típusa
string. Optional. Használja a ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer. Engedélyezett értékek: Inline Script, File Path (szkriptfájl elérési útja).

A sikeres üzembe helyezés után az Azure App Service-ben futó szkripttel testre szabhatja az üzembe helyezést. Válassza ki a beágyazott üzembehelyezési szkriptet, vagy egy szkriptfájl elérési útját és nevét. További információ az Azure App Service üzembe helyezési.

InlineScript - Beágyazott szkript
string. ScriptType == Inline Script && ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContaineresetén kötelező. Alapértelmezett érték: :: You can provide your deployment commands here. One command per line..

A végrehajtandó szkript. Itt adhat meg üzembehelyezési parancsokat, soronként egy parancsot. Lásd a következő példát.

ScriptPath - üzembehelyezési szkript elérési útja
string. ScriptType == File Path && ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContaineresetén kötelező.

A végrehajtandó szkript elérési útja és neve.

WebConfigParameters - Python-, Node.js-, Go- és Java-alkalmazásokhoz web.config-paraméterek létrehozása
string. Optional. Használja a WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war.

Egy szabványos Web.config fog létrehozni és üzembe helyezni az Azure App Service-ben, ha az alkalmazás nem rendelkezik ilyenrel. A web.config értékei az alkalmazás keretrendszerétől függően szerkeszthetők és változhatnak. Például node.js alkalmazások esetében a web.config indítási fájllal és iis_node modulértékekkel fog rendelkezni. Ez a szerkesztési funkció csak a létrehozott web.configérhető el. További információ az Azure App Service üzembe helyezési.

AppSettings - alkalmazásbeállítások
string. Optional. Használja a ConnectionType = AzureRM.

A webalkalmazás-alkalmazás beállításait a szintaxis -key valuehasználatával szerkessze. A szóközöket tartalmazó értékeket idézőjelek közé kell tenni. Példák: -Port 5000 -RequestTimeout 5000 és -WEBSITE_TIME_ZONE "Eastern Standard Time". Két vagy több kulcsérték megadásához a kulcsértékeket szóközzel kell elválasztani. Példa: -key1 "Value1" -Key2 "Value2".

ConfigurationSettings - konfigurációs beállítások
string. Optional. Használja a ConnectionType = AzureRM.

A webalkalmazás konfigurációs beállításait a szintaxis -key valuehasználatával szerkessze. A szóközöket tartalmazó értékeket idézőjelek közé kell tenni. Példa: -phpVersion 5.6 -linuxFxVersion node|6.11.

enableCustomDeployment - Telepítési módszer kiválasztása
Bemeneti alias: UseWebDeploy. boolean. Optional. Használja a ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Alapértelmezett érték: false.

Ha nincs bejelölve vagy hamis, a feladat automatikusan észleli a legjobb üzembe helyezési módszert az alkalmazás típusa, a csomag formátuma és egyéb paraméterek alapján. Ezt a beállítást a feladatsegédben ellenőrizheti a támogatott üzembehelyezési módszerek megtekintéséhez, és válasszon egyet az alkalmazás üzembe helyezéséhez.

DeploymentType - üzembe helyezési módszer
string. UseWebDeploy == true && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jaresetén kötelező. Engedélyezett értékek: webDeploy (Web Deploy), zipDeploy (Zip Deploy), runFromZip (Futtatás csomagból). Alapértelmezett érték: webDeploy.

Meghatározza az alkalmazás üzembehelyezési módját.

TakeAppOfflineFlag - Alkalmazás offline állapotba helyezése
boolean. Optional. Használja a UseWebDeploy == true && DeploymentType != runFromZip && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Alapértelmezett érték: true.

Adja meg ezt a beállítást az Azure App Service offline állapotba helyezéséhez, ha egy app_offline.htm fájlt helyez el a gyökérkönyvtárban a szinkronizálási művelet megkezdése előtt. A fájl a szinkronizálás sikeres befejezése után törlődik.

SetParametersFile - SetParameters fájl
string. Optional. Használja a UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar.

A használni kívánt SetParameters.xml fájl helye.

RemoveAdditionalFilesFlag - További fájlok eltávolítása a cél
boolean. Optional. Használja a UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Alapértelmezett érték: false.

Adja meg az "igaz" értéket az Olyan Azure App Service-fájlok törléséhez, amelyek nem rendelkeznek egyező fájlokkal az App Service-csomagban vagy -mappában. Ezzel az Azure App Service-ben 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. Optional. Használja a UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Alapértelmezett érték: true.

Itt adhatja meg, hogy a App_Data mappában lévő fájlok ne legyenek üzembe helyezve vagy törölve legyenek az Azure App Service-ben.

AdditionalArguments - További argumentumok
string. Optional. Használja a UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Alapértelmezett érték: -retryAttempts:6 -retryInterval:10000.

További webtelepítési argumentumok a -key:valueszintaxist követve. Ezek az Azure App Service üzembe helyezésekor lesznek alkalmazva. Példák: -disableLink:AppPoolExtension -disableLink:ContentExtension. További információ a webtelepítési műveleti beállításokról.

RenameFilesFlag - Zárolt fájlok átnevezése
boolean. Optional. Használja a UseWebDeploy == true && DeploymentType == webDeploy && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. Alapértelmezett érték: true.

Adja meg az alapértelmezett értéket az msdeploy jelző engedélyezéséhez, MSDEPLOY_RENAME_LOCKED_FILES=1 az Azure App Service alkalmazásbeállításaiban. Ha be van állítva, 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. Optional. Használja a WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war. Alapértelmezett érték: false.

A konfigurációátalakítások *.Release.config és *.<EnvironmentName>.config futnak a *.config file. A konfigurációs átalakítások a változó helyettesítése előtt futnak. Az XML-átalakítások csak a Windows platformon támogatottak.

enableXmlVariableSubstitution - XML-változó helyettesítési
Bemeneti alias: XmlVariableSubstitution. boolean. Optional. Használja a WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war. Alapértelmezett érték: false.

A buildelési vagy kiadási folyamatban definiált változók a konfigurációs fájlok és configSections fájlok appSettings, applicationSettings, connectionStringsés parameters.xml szakaszaiban lévő kulcs- vagy névbejegyzésekkel lesznek egyezőek. A változó-helyettesítés a konfigurációátalakítások után fut.

Ha ugyanazok a változók vannak definiálva a kiadási folyamatban és a fázisban, a fázisváltozók felülírják a kiadási folyamat változóit. További információ az [XML-változó helyettesítéséről]](/azure/devops/pipelines/tasks/transforms-variable-substitution#xml-variable-substitution).

JSONFiles - JSON-változó helyettesítési
string. Optional. Használja a WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war.

A változóértékeket helyettesítő JSON-fájlok új vonallal tagolt listáját tartalmazza. A fájlneveknek a gyökérmappához viszonyítva kell lenniük. Beágyazott vagy hierarchikus JSON-változók helyettesítéséhez adja meg őket JSONPath kifejezések használatával. Ha például az alábbi mintában szereplő ConnectionString értékét szeretné lecserélni, definiáljon egy Data.DefaultConnection.ConnectionString nevű változót a buildelési vagy kiadási folyamatban (vagy a kiadási folyamatok szakaszában).

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

A konfigurációátalakítások után változó-helyettesítés fut. Megjegyzés: A buildelési és kiadási folyamat változói ki vannak zárva a helyettesítésből. További információ JSON-változó helyettesítéséről.

Tevékenységvezérlési beállítások

Minden tevékenység a tevékenységbemeneteken kívül vezérlési lehetőségekkel is rendelkezik. További információ: Vezérlők és gyakori feladattulajdonságok.

Kimeneti változók

Ez a feladat a következő kimeneti változókat határozza meg, amelyeket az alsóbb rétegbeli lépésekben, feladatokban és szakaszokban használhat fel.

AppServiceApplicationUrl
kijelölt App Service alkalmazás URL-címét.

Remarks

• feladat előfeltételei
• Használati megjegyzések
• Telepítési módszerek
• Troubleshooting
• FAQs

Ezzel a feladatsal üzembe helyezheti az Azure-beli App Services egy tartományát. A feladat Windows, Linux vagy Mac rendszert futtató platformfüggetlen ügynökökön működik, és számos különböző mögöttes üzembehelyezési technológiát használ.

A feladat ASP.NET, ASP.NET Core, PHP, Java, Python, Go és Node.js alapú webes alkalmazásokon működik.

A feladat az Azure App Services egy tartományában való üzembe helyezésre használható, például:

• Web Apps windowsos és linuxos
• Webalkalmazások tárolókhoz
• Függvényalkalmazások Windows és Linux
• függvényalkalmazások tárolókhoz
• WebJobs
• Az Azure App Service-környezetek alatt konfigurált alkalmazások

A feladat előfeltételei

A feladat megfelelő működéséhez a következő előfeltételeket kell beállítani a célgép(ek)ben.

• App Service-példány. A feladat webalkalmazás-projekt vagy Azure-függvényprojekt üzembe helyezésére szolgál egy meglévő Azure App Service-példányon, amelynek a feladat futtatása előtt léteznie kell. A App Service példány a Azure Portal hozható létre, és ott konfigurálható . Másik lehetőségként az Azure PowerShell-feladat is használható Azure PowerShell-szkriptek futtatására, a webalkalmazás kiépítéséhez és konfigurálásához.

• Azure-előfizetés. Az Azure-ban való üzembe helyezéshez egy Azure-előfizetést kell csatolni a folyamathoz. A feladat nem működik a klasszikus Azure-szolgáltatáskapcsolattal, és nem sorolja fel ezeket a kapcsolatokat a tevékenység beállításai között.

Használati megjegyzések

• A feladat csak az Azure Resource Manager API-k működik.
• Az SSL-hibák figyelmen kívül hagyásához definiáljon egy VSTS_ARM_REST_IGNORE_SSL_ERRORS nevű változót, amelynek értéke true a folyamatban. Ha automatikus felcserélésre konfigurált ponton helyezi üzembe az üzembe helyezést, a felcserélés sikertelen lesz, hacsak nem állítja be SCM_SKIP_SSL_VALIDATION vagy SCM_SKIP_ASE_SSL_VALIDATION1 az App Services konfigurációs beállításai között.
• A Windows rendszeren webalkalmazást célzó .NET-alkalmazások esetén kerülje a ERROR_FILE_IN_USE hiba miatti üzembe helyezési hibát, mert így Zárolt fájlok átnevezése és Az alkalmazás offline állapotba helyezése beállításai engedélyezve vannak. A nulla állásidő üzembe helyezéséhez használja a pontcserélési lehetőséget.
• Ha olyan App Service-ben van üzembe helyezve, amelyben az Application Insights konfigurálva van, és engedélyezte További fájlok eltávolítása a cél, győződjön meg arról is, hogy engedélyezi Fájlok kizárása a App_Data mappából annak érdekében, hogy az Application Insights bővítmény biztonságos állapotban maradjon. Erre azért van szükség, mert az Application Insights folyamatos webfeladata telepítve van a App_Data mappába.

Üzembe helyezési módszerek

Ebben a feladatban számos üzembe helyezési módszer érhető el. A Web Deploy (msdeploy.exe) az alapértelmezett. Az üzembe helyezési beállítás módosításához bontsa ki További üzembehelyezési beállítások, és engedélyezze Telepítési mód kiválasztása lehetőséget a további csomagalapú üzembe helyezési lehetőségek közül való választáshoz.

Az Azure App Service és az ügynök típusától függően a feladat egy megfelelő üzembehelyezési technológiát választ. A feladat által használt különböző üzembehelyezési technológiák a következők:

• Webes telepítés
• Kudu REST API-k
• Tárolóregisztrációs adatbázis
• Zip üzembe helyezése
• Futtatás csomagból
• Háborús bevetés

Alapértelmezés szerint a feladat megpróbálja kiválasztani a megfelelő üzembehelyezési technológiát a bemeneti csomag típusa, az App Service típusa és az ügynök operációs rendszere alapján.

Logika automatikus észlelése

Windows-alapú ügynökök esetén.

App Service-típus	Csomag típusa	Telepítési módszer
WebApp Linuxon vagy függvényalkalmazás Linuxon	Mappa/Zip/jar háború	Zip Telepítés Háború telepítése
WebApp for Containers (Linux) vagy Függvényalkalmazás tárolókhoz (Linux)	Az alkalmazás beállításainak frissítése	NA
WebApp Windows rendszeren, Függvényalkalmazás Windows rendszeren, API-alkalmazás vagy mobilalkalmazás	War Jar MsBuild csomagtípus vagy üzembe helyezés virtuális alkalmazásba Mappa/Zip	Háború Telepítés Zip Telepítés Webes telepítés if postDeploymentScript == true, Zip Deploy else, Run From Package

Nem Windows-ügynökök esetén (bármely App Service-típus esetén) a feladat Kudu REST API-kra az alkalmazás üzembe helyezéséhez.

Web Deploy

A Web Deploy (msdeploy.exe) használatával webalkalmazást helyezhet üzembe Windows vagy függvényalkalmazást a Azure App Service egy Windows-ügynök használatával. A Web Deploy funkciógazdag, és olyan lehetőségeket kínál, mint például:

• Zárolt fájlok átnevezése: Nevezze át a webkiszolgáló által még használatban lévő fájlokat úgy, hogy engedélyezi az msdeploy jelölő MSDEPLOY\_RENAME\_LOCKED\_FILES=1 az Azure App Service beállításai között. Ezzel a beállítással az msdeploy átnevezheti az alkalmazástelepítés során zárolt fájlokat.

• További fájlok eltávolítása a célhelyen: Törli azOkat a fájlokat az Azure App Service-ben, amelyek nem rendelkeznek egyező fájlokkal az App Service összetevőcsomagjában vagy mappájában.

• Fájlok kizárása a App_Data mappából: A App_Data mappában (az üzembe helyezett összetevőcsomagban/mappában) lévő fájlok azure App Service-ben való üzembe helyezésének megakadályozása

• További webes üzembe helyezési argumentumok: Az Azure App Service telepítésekor alkalmazott argumentumok. Példa: -disableLink:AppPoolExtension -disableLink:ContentExtension. További példák a Web Deploy műveleti beállításaira: Web Deploy Operation Settings.

A Web Deploy telepítése az ügynökre a Web Deploy 3.6. A Web Deploy 3.5-öt a csomagban lévő SQL-támogatás nélkül kell telepíteni. A Web Deploy telepítésekor nem kell egyéni beállításokat választania. A Web Deploy telepítése a C:/Program Files (x86)/IIS/Microsoft Web Deploy V3.

Kudu REST API-k

Kudu REST API-k windowsos és Linuxos automatizálási ügynökökön is működnek, ha a cél egy Web App a Windowson, a Web App on Linux (beépített forrás) vagy a Függvényalkalmazás. A feladat a Kudu használatával másolja a fájlokat az Azure App Service-be.

Container Registry

Windows és Linux rendszerű automatizálási ügynökökön is működik, ha a cél egy webalkalmazás tárolókhoz. A feladat a megfelelő tárolóregisztrációs adatbázis, adattár, képnév és címkeadatok beállításával frissíti az alkalmazást. A feladat használatával is átadhat egy indítási parancsot a tárolólemezképhez.

Zip-üzembe helyezés

.zip üzembe helyezési csomagot vár, és üzembe helyezi a fájl tartalmát az Azure-beli App Service vagy függvényalkalmazás wwwroot mappájában. Ez az opció felülírja a wwwroot mappa összes meglévő tartalmát. További információ: Zip üzembe helyezése az Azure Functions.

Futtatás csomagból

Ugyanazt az üzembehelyezési csomagot várja, mint a Zip Deploy. A fájlok wwwroot mappába való telepítése helyett azonban a teljes csomagot a Functions-futtatókörnyezet csatlakoztatja, és a wwwroot mappában lévő fájlok írásvédetté válnak. További információ: Az Azure Functions futtatása csomagfájlból.

Háborús bevetés

Üzembe helyezési csomagot vár, és üzembe helyezi a fájl tartalmát az Azure-beli App Service wwwroot mappájában vagy webapps mappájában.

Troubleshooting

Nem tudom webre telepíteni az Azure App Service-t a Windows-ügynökömRől származó Microsoft Entra ID-hitelesítéssel

Az Azure App Service üzembe helyezési feladata támogatja a Microsoft Azure-hoz való csatlakozást ARM-szolgáltatáskapcsolattal a Microsoft Entra ID használatával, kivéve, ha a következő 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 üzemeltetett ügynök rendszerképének használatakor)
• Az Alapszintű hitelesítés le van tiltva az Azure App Service-ben

Ha ez a három feltétel jelenik meg, hibaüzenet jelenik meg, például 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 a következő lehetőségek közül választhat a beállítások sorrendjében.

1. Frissítse az ügynök rendszerképét. Ha üzemeltetett ügynököket használ, váltson a windows-2019-ről a windows-2022-re (vagy a windows-legújabbra). Ha saját üzemeltetésű ügynököket használ, telepítse a Visual Studio 2022-t az ügynökre, hogy újabb verziót szerezzen bemsdeploy.exe.
2. 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-legújabb) rendszeren fusson.
3. Ha egyik lehetőség sem lehetséges, engedélyezheti az Azure App Service alapszintű hitelesítési.

Hiba: Nem sikerült lekérni az Azure hozzáférési jogkivonatát. Ellenőrizze, hogy a használt szolgáltatásnév érvényes-e, és nem járt-e le.

A feladat a szolgáltatáskapcsolatban lévő szolgáltatásnevet használja az Azure-ral való hitelesítéshez. Ha a szolgáltatásnév lejárt, vagy nincs engedélye az App Service-hez, a feladat ezzel a hibával meghiúsul. Ellenőrizze a használt szolgáltatásnév érvényességét, és hogy szerepel-e az alkalmazásregisztrációban. További információ: Szerepköralapú hozzáférés-vezérlés használata az Azure-előfizetés erőforrásaihoz való hozzáférés kezeléséhez. Ez a blogbejegyzés további információt tartalmaz a szolgáltatásnév-hitelesítés használatáról.

SSL-hiba

Ha tanúsítványt szeretne használni az App Service-ben, a tanúsítványt megbízható hitelesítésszolgáltatónak kell aláírnia. Ha a webalkalmazás tanúsítványérvényesítési hibákat jelez, valószínűleg önaláírt tanúsítványt használ. Állítson be egy VSTS_ARM_REST_IGNORE_SSL_ERRORS nevű változót a buildelési vagy kiadási folyamat true értékére a hiba megoldásához.

A kiadás hosszú ideig lefagy, majd meghiúsul

Ez a probléma az App Service-csomag kapacitásának elégtelensége lehet. A probléma megoldásához felskálázhatja az App Service-példányt a rendelkezésre álló processzor-, RAM- és lemezterület növeléséhez, vagy kipróbálhat egy másik App Service-csomagot.

5xx hibakód

Ha 5xx hibát lát, ellenőrizze az Azure-szolgáltatásállapotát.

Az Azure-függvény hirtelen leállt

Az Azure Functions hirtelen leállhat, ha az utolsó üzembe helyezés óta több mint egy év telt el. Ha a "RunFromPackage" használatával telepít a "deploymentMethod" fájlban, a rendszer létrehoz egy 1 éves lejárati dátumú SAS-t, és az alkalmazáskonfigurációban a "WEBSITE_RUN_FROM_PACKAGE" értékként van beállítva. Az Azure Functions ezzel az SAS-szel hivatkozik a csomagfájlra a függvény végrehajtásához, így ha az SAS lejárt, a függvény nem lesz végrehajtva. A probléma megoldásához telepítse újra a telepítést, hogy létrehoz egy SAS-t egyéves lejárati dátummal.

Hiba: Nem található megadott mintával rendelkező csomag

Ellenőrizze, hogy a feladatban említett csomag összetevőként van-e közzétéve a buildben vagy az előző szakaszban, és letöltődik-e az aktuális feladatba.

Hiba: Az msBuild csomagtípus esetében nem támogatott a zip-alapú üzembe helyezési beállítással való közzététel

Az MSBuild feladaton (alapértelmezett argumentumokkal) létrehozott webcsomagok beágyazott mappastruktúrával rendelkeznek, amelyet csak a Web Deploy helyezhet üzembe megfelelően. A közzététel a zip-hez üzembe helyezési lehetőséggel nem telepíthetők. A csomagolási struktúra átalakításához hajtsa végre az alábbi lépéseket:

1. A Megoldás összeállítása feladatban módosítsa a MSBuild argumentumokat/p:DeployOnBuild=true /p:DeployDefaultTarget=WebPublish /p:WebPublishMethod=FileSystem /p:DeleteExistingFiles=True /p:publishUrl="$(System.DefaultWorkingDirectory)\\WebAppContent":

   

2. Adjon hozzá egy archív feladatot, és módosítsa az értékeket az alábbiak szerint:

   1. Módosítsa gyökérmappát vagy fájlt úgy, hogy archiválja $(System.DefaultWorkingDirectory)\\WebAppContent.

   2. Törölje az Előpend gyökérmappa nevét az elérési utak archiválásához jelölőnégyzetből:

      

A webalkalmazás üzembe helyezése Windows rendszeren sikeres, de az alkalmazás nem működik

Ennek az lehet az oka, hogy web.config nincs jelen az alkalmazásban. Hozzáadhat egy web.config fájlt a forráshoz, vagy automatikusan létrehozhat egyet a feladat Fájlátalakítások és változóhelyettesítési beállításaival.

• Kattintson a feladatra, és válassza a Python, a Node.js, a Go és a Java-alkalmazások web.config paramétereinek létrehozása lehetőséget.

  

• A paraméterek szerkesztéséhez kattintson a Továbbiak gombra: web.config paraméterek létrehozása a Pythonhoz, Node.js, Go és Java alkalmazásokhoz.

  

• Válassza ki az alkalmazás típusát a legördülő listában.

• Kattintson az OK gombra. Ez feltölti web.config web.configlétrehozásához szükséges paramétereket.

Note

Ez a szakasz elavult, és a Fájlátalakítás feladat váltotta fel.

ERROR_FILE_IN_USE

NET-alkalmazások Windows rendszeren futó Web App telepítésekor az üzembe helyezés hibakód ERROR_FILE_IN_USE dal meghiúsulhat. A hiba elhárításához győződjön meg arról, hogy Zárolt fájlok átnevezése és Alkalmazás offline állapotba helyezése beállítások engedélyezve vannak a feladatban. Nulla állásidős üzembe helyezéshez használjon pontcserét.

Az erőforrás-zárolás elkerülése érdekében használhatja a Futtatás csomagból üzembe helyezési metódust is.

Webes üzembe helyezési hiba

Ha webes üzembe helyezést használ az alkalmazás üzembe helyezéséhez, bizonyos hibahelyzetekben a Web Deploy hibakódot fog megjeleníteni a naplóban. A webes üzembe helyezési hibák elhárításához tekintse meg a Web Deploy hibakódjait.

Nem működik a webalkalmazás üzembe helyezése az App Service-környezetben (ASE)

• Győződjön meg arról, hogy az Azure DevOps buildügynök ugyanazon a virtuális hálózaton van (az alhálózat eltérő lehet), mint az ASE belső Terheléselosztója (ILB). Így az ügynök lekérhet kódot az Azure DevOpsból, és üzembe helyezheti az ASE-ben.
• Az Azure DevOps használata esetén az ügynöknek nem kell az internetről elérhetőnek lennie, csak kimenő hozzáférésre van szüksége az Azure DevOps Service-hez való csatlakozáshoz.
• Ha virtuális hálózaton üzembe helyezett TFS/Azure DevOps Servert használ, az ügynök teljesen elkülöníthető.
• A buildügynököt annak a webalkalmazásnak a DNS-konfigurációjával kell konfigurálni, amelyen üzembe kell helyeznie. Mivel a virtuális hálózat privát erőforrásai nem rendelkeznek bejegyzésekkel az Azure DNS-ben, ezt hozzá kell adni az ügynökgép gazdagépfájljaihoz.
• Ha az ASE-konfigurációhoz önaláírt tanúsítványt használ, a -allowUntrusted beállítást be kell állítani az MSDeploy üzembe helyezési feladatában. Azt is javasoljuk, hogy a VSTS_ARM_REST_IGNORE_SSL_ERRORS változót igaz értékre állítsa. Ha egy hitelesítésszolgáltató tanúsítványát használják az ASE-konfigurációhoz, ez nem szükséges. Ha automatikus felcserélésre konfigurált ponton helyezi üzembe az üzembe helyezést, a felcserélés sikertelen lesz, hacsak nem állítja be SCM_SKIP_SSL_VALIDATION vagy SCM_SKIP_ASE_SSL_VALIDATION1 az App Services konfigurációs beállításai között.

FAQs

Mi a különbség a AzureWebApp és a AzureRmWebAppDeployment tevékenységek között?

Az Azure Web App-feladat (AzureWebApp) a legegyszerűbb módszer az Azure Web Appban való üzembe helyezésre. Alapértelmezés szerint az üzembe helyezés az Azure Web App gyökéralkalmazásával történik.

Az Azure App Service Üzembe helyezési feladat (AzureRmWebAppDeployment) több egyéni forgatókönyvet is képes kezelni, például:

• Konfigurációs beállítások módosítása webes csomagokban és XML-paraméterek fájljaiban.
• Üzembe helyezés webes üzembe helyezéssel, ha az IIS üzembe helyezési folyamatához van szokva.
• Üzembe helyezés virtuális alkalmazásokban.
• Üzembe helyezés más alkalmazástípusokban, például Tárolóalkalmazásokban, Függvényalkalmazásokban, WebJobs-alkalmazásokban vagy API- és Mobilalkalmazásokban.

Note

A fájlátalakításokat és a változók helyettesítését a különálló Fájlátalakítás feladat is támogatja az Azure Pipelinesban való használatra. A Fájlátalakítás feladat használatával fájlátalakításokat és változóhelyettesítéseket alkalmazhat bármilyen konfigurációs és paraméterfájlra.

Hogyan konfigurálhatom a szolgáltatáskapcsolatot?

Ehhez a feladathoz Azure Resource Manager-szolgáltatáskapcsolatiszükséges.

Hogyan konfigurálhatom a webes feladatok üzembe helyezését az Application Insights használatával?

Az App Service-ben való üzembe helyezéskor, ha Application Insights van konfigurálva, és engedélyezte Remove additional files at destination, engedélyeznie kell a Exclude files from the App_Data folderis. Ennek a beállításnak az engedélyezése biztonságos állapotban tartja az Application Insights bővítményt. Erre a lépésre azért van szükség, mert az Application Insights folyamatos webfeladata telepítve van a App_Data mappába.

Hogyan konfiguráljam az ügynökömet, ha proxy mögött van az App Service-ben való üzembe helyezés során?

Ha a saját üzemeltetésű ügynökhöz webproxy szükséges, a konfiguráció során tájékoztathatja az ügynököt a proxyról. Így az ügynök a proxyn keresztül csatlakozhat az Azure Pipelineshoz vagy az Azure DevOps Serverhez. További információ a saját üzemeltetésű ügynök webproxy mögötti futtatásáról.

Examples

• Üzembe helyezés adott alkalmazástípusra
• Üzembe helyezés az Azure Web App Linux-tárolóban
• Webalkalmazás üzembe helyezése Windows App Service-ben üzembehelyezési pontokon
• üzembehelyezési példaszkript

Üzembe helyezés adott alkalmazástípuson

Ha egy adott alkalmazástípusra szeretne üzembe helyezni, állítsa a appType a következő elfogadott értékek bármelyikére: webApp (Windows webalkalmazás), webAppLinux (Web App on Linux), webAppContainer (Web App for Containers - Linux), functionApp (Függvényalkalmazás Windows rendszeren), functionAppLinux (Függvényalkalmazás Linuxon), functionAppContainer (Függvényalkalmazás tárolókhoz – Linux), apiApp (API-alkalmazás), mobileApp (Mobilalkalmazás). Ha nem említi, a webApp lesz az alapértelmezett érték.

A speciális üzembehelyezési beállítások engedélyezéséhez adja hozzá a enableCustomDeployment: true paramétert, és szükség szerint adja hozzá a következő paramétereket.

# deploymentMethod: 'runFromPackage' # supports zipDeploy as well
    # appOffline: boolean    # Not applicable for 'runFromPackage'
    # setParametersFile: string
    # removeAdditionalFilesFlag: boolean
    # additionalArguments: string

Üzembe helyezés Az Azure Web App Linux-tárolóban

Az alábbi YAML-példa egy Azure Web App-tárolóban (Linuxon) telepedik le.

pool:
  vmImage: ubuntu-latest

variables:
  azureSubscriptionEndpoint: Contoso
  DockerNamespace: contoso.azurecr.io
  DockerRepository: aspnetcore
  WebAppName: containersdemoapp

steps:

- task: AzureRMWebAppDeployment@4
  displayName: Azure App Service Deploy
  inputs:
    appType: webAppContainer
    ConnectedServiceName: $(azureSubscriptionEndpoint)
    WebAppName: $(WebAppName)
    DockerNamespace: $(DockerNamespace)
    DockerRepository: $(DockerRepository)
    DockerImageTag: $(Build.BuildId)

Webalkalmazás üzembe helyezése Windows App Service-ben üzembehelyezési pontok között

Az alábbi példa egy webalkalmazást helyez üzembe egy Windows App Service-ben az üzembehelyezési pontok között.

pool:
  vmImage: 'windows-latest'

variables:
  solution: '**/*.sln'
  buildPlatform: 'Any CPU'
  buildConfiguration: 'Release'

stages:
 - stage: DeployDevStage
    displayName: 'Deploy App to Dev Slot'
    jobs:
      - job:  DeployApp
        displayName: 'Deploy App'
        steps:
        - task: DownloadPipelineArtifact@2
          inputs:
            buildType: 'current'
            artifactName: 'drop'
            targetPath: '$(System.DefaultWorkingDirectory)'
        - task: AzureRmWebAppDeployment@4
          inputs:
            ConnectionType: 'AzureRM'
            azureSubscription: 'Fabrikam Azure Subscription - PartsUnlimited'
            appType: 'webApp'
            WebAppName: 'partsunlimited'
            ResourceGroupName: 'rgPartsUnlimited'
            deployToSlotOrASE: true
            SlotName: 'Dev'
            packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip'

  - stage: DeployStagingStage
    displayName: 'Deploy App to Staging Slot'
    dependsOn: DeployDevStage
    jobs:
      - job:  DeployApp
        displayName: 'Deploy App'
        steps:
        - task: DownloadPipelineArtifact@2
          inputs:
            buildType: 'current'
            artifactName: 'drop'
            targetPath: '$(System.DefaultWorkingDirectory)'
        - task: AzureRmWebAppDeployment@4
          inputs:
            ConnectionType: 'AzureRM'
            azureSubscription: 'Fabrikam Azure Subscription - PartsUnlimited'
            appType: 'webApp'
            WebAppName: 'partsunlimited'
            ResourceGroupName: 'rgPartsUnlimited'
            deployToSlotOrASE: true
            SlotName: 'staging'
            packageForLinux: '$(System.DefaultWorkingDirectory)/**/*.zip'

Üzembe helyezés utáni példaszkript

A feladat lehetővé teszi az üzembe helyezés testreszabását egy olyan szkript biztosításával, amely az Azure App Service-ben fog futni, miután az alkalmazás összetevőit sikeresen átmásolta az App Service-be. Megadhatja a beágyazott üzembehelyezési szkriptet, vagy egy szkriptfájl elérési útját és nevét az összetevőmappában.

Ez nagyon hasznos, ha közvetlenül az App Service-ben szeretné visszaállítani az alkalmazásfüggőségeket. A Node-, PHP- és Python-alkalmazások csomagjainak visszaállítása segít elkerülni az időtúllépéseket, ha az alkalmazásfüggőség egy nagy összetevőt másol át az ügynökből az Azure App Service-be.

Egy üzembehelyezési szkript például a következő:

@echo off
if NOT exist requirements.txt (
 echo No Requirements.txt found.
 EXIT /b 0
)
if NOT exist "$(PYTHON_EXT)/python.exe" (
 echo Python extension not available >&2
 EXIT /b 1
)
echo Installing dependencies
call "$(PYTHON_EXT)/python.exe" -m pip install -U setuptools
if %errorlevel% NEQ 0 (
 echo Failed to install setuptools >&2
 EXIT /b 1
)
call "$(PYTHON_EXT)/python.exe" -m pip install -r requirements.txt
if %errorlevel% NEQ 0 (
 echo Failed to install dependencies>&2
 EXIT /b 1
)

Requirements

Requirement	Description
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás bekapcsolva	Ügynök, DeploymentGroup
Demands	None
Capabilities	Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
parancskorlátozások	Any
Változók beállítása	Any
Ügynök verzió	2.104.1 vagy újabb
Tevékenységkategória	Deploy

Lásd még

• Ez a feladat nyílt forráskódú a GitHubon. Visszajelzéseket és hozzájárulásokat szívesen fogadunk.