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

Ezzel a feladattal üzembe helyezhet egy webes, mobil- vagy API-alkalmazás 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.

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' | '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.

Bevitelek

ConnectionType - Kapcsolat típusa
string. Kötelező. 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álni kívánt szolgáltatáskapcsolat típusát.

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

azureSubscription - Azure-előfizetés
Bemeneti alias: ConnectedServiceName. string. Akkor szükséges, ha ConnectionType = AzureRM.

Adja meg az üzembe helyezésHez tartozó Azure Resource Manager-előfizetést.

PublishProfilePath - Profil elérési útjának közzététele
string. Akkor szükséges, ha ConnectionType = PublishProfile. 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. Akkor szükséges, ha ConnectionType = PublishProfile.

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

appType - App Service típusa
Bemeneti alias: WebAppKind. string. Akkor szükséges, ha ConnectionType = AzureRM. 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 (Function App on Windows (Not Recommended, Use Azure Functions Task)), functionAppLinux (Function App on Linux (Not Recommended, Use Azure Functions Task)), functionAppContainer (Function App for Containers (Linux) (Not Recommended, Use Azure Functions tárolófeladat)), apiApp (API-alkalmazás), mobileApp (Mobilalkalmazás). Alapértelmezett érték: webApp.

Válasszon a Web App On Windows, a Web App On Linux, a Web App for Containers, a Function App, a Function App on Linux, a Function App for Containers és a Mobile App közül.

WebAppName - App Service neve
string. Akkor szükséges, ha ConnectionType = AzureRM.

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.

deployToSlotOrASE - Üzembe helyezés pontban vagy App Service Environment
Bemeneti alias: DeployToSlotOrASEFlag. boolean. Választható. Használja a következőt: ConnectionType = AzureRM && WebAppKind != "". Alapértelmezett érték: false.

Adja meg a meglévő üzembehelyezési ponton vagy 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 üzembehelyezési cél egy pont, az üzembe helyezés alapértelmezés szerint az éles üzembehelyezési ponton van. Bármely más meglévő tárolóhelynév megadható. Ha az üzembehelyezési cél egy Azure App Service környezet, hagyja meg a tárolóhely nevét, Production és csak az erőforráscsoport nevét adja meg.

ResourceGroupName - Erőforráscsoport
string. Akkor szükséges, ha DeployToSlotOrASEFlag = true.

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

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

SlotName - Slot
string. Akkor szükséges, ha DeployToSlotOrASEFlag = true. Alapértelmezett érték: production.

Adjon meg egy, az éles ponttól eltérő meglévő tárolóhelyet.

DockerNamespace - Beállításjegyzék vagy névtér
string. Akkor szükséges, ha WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContainer.

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 a következő formátumú lesz: {registry or namespace}/{repository}:{tag}. Például: myregistry.azurecr.io/nginx:latest.

DockerRepository - Kép
string. Akkor szükséges, ha WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = webAppHyperVContainer.

Annak az adattárnak a neve, amelyben a tárolólemezké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 = 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-lemezképekre. 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.

VirtualApplication - Virtuális alkalmazás
string. Választható. Használja a következőt: WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != functionApp && webAppKind != functionAppLinux && WebAppKind != "".

Adja meg a Azure Portal 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. Akkor szükséges, ha ConnectionType = PublishProfile || WebAppKind = webApp || WebAppKind = apiApp || WebAppKind = functionApp || WebAppKind = mobileApp || WebAppKind = webAppLinux || webAppKind = functionAppLinux. Alapértelmezett érték: $(System.DefaultWorkingDirectory)/**/*.zip.

A csomag vagy az MSBuild által létrehozott App Service-tartalmakat tartalmazó mappa elérési útja, illetve tömörített zip- vagy háborús fájl.

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. Választható. Használja a következőt: WebAppKind = webAppLinux.

Adja meg a linuxos függvényalkalmazás keretrendszerét és verzióját.

RuntimeStackFunction - Futtatókörnyezeti verem
string. Választható. Használja a következőt: WebAppKind = functionAppLinux. Engedélyezett értékek: DOTNET|2.2 (DOTNET|2.2 (functionapp v2)), DOTNET|3.1 (DOTNET|3.1 (functionapp v3)), JAVA|8 (JAVA|8 (functionapp v2/v3)), JAVA|11 (JAVA|11 (functionapp v3)), NODE|8 (NODE|8 (functionapp v2)), NODE|10 (NODE|10 (functionapp v2/v3)), NODE|12 (NODE|12 (functionapp v3)), NODE|14 (NODE|14 (functionapp v3)), PYTHON|3.6 (PYTHON|3.6 (functionapp v2/v3)), PYTHON|3.7 (PYTHON|3.7 (functionapp v2/v3)), PYTHON|3.8 (PYTHON|3.8 (functionapp v3)).

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

StartupCommand - Indítási parancs
string. Választható. Használja a következőt: WebAppKind = webAppLinux || WebAppKind = webAppContainer || WebAppkind = functionAppContainer || WebAppKind = functionAppLinux || WebAppKind = webAppHyperVContainer.

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

dotnet exec filename.dll

dotnet filename.dll.

ScriptType - Üzembehelyezési szkript típusa
string. Választható. Használja a következőt: ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer. Engedélyezett értékek: Inline Script, File Path (Szkriptfájl elérési útja).

Az üzembe helyezés testreszabásához adjon meg egy szkriptet, amely a sikeres üzembe helyezés után fut a Azure App Service. Válassza a beágyazott üzembehelyezési szkriptet vagy egy szkriptfájl elérési útját és nevét. További információ Azure App Service üzembe helyezésről.

InlineScript - Beágyazott szkript
string. Akkor szükséges, ha ScriptType == Inline Script && ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer. Alapértelmezett érték: :: You can provide your deployment commands here. One command per line..

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

ScriptPath - Üzembehelyezési szkript elérési útja
string. Akkor szükséges, ha ScriptType == File Path && ConnectionType = AzureRM && WebAppKind != "" && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer.

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

WebConfigParameters - web.config paraméterek létrehozása Python-, Node.js-, Go- és Java-alkalmazásokhoz
string. Választható. Használja a következőt: WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war.

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ások web.config esetében node.js például egy indítási fájllal és iis_node modulértékekkel fog rendelkezni. Ez a szerkesztési funkció csak a létrehozott web.configszolgáltatáshoz tartozik. További információ a Azure App Service üzembe helyezésről.

AppSettings - Alkalmazásbeállítások
string. Választható. Használja a következőt: ConnectionType = AzureRM.

Szerkessze a webalkalmazás alkalmazásbeállításait a szintaxis -key valuehasználatával. 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. Választható. Használja a következőt: ConnectionType = AzureRM.

A webalkalmazás konfigurációs beállításait a szintaxissal -key valueszerkessze. 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 - Üzembe helyezési módszer kiválasztása
Bemeneti alias: UseWebDeploy. boolean. Választható. Használja a következőt: 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 csomagformátum és más paraméterek alapján. Ellenőrizze ezt a lehetőséget a feladat segéd a támogatott üzembehelyezési módszerek megtekintéséhez, és válasszon egyet az alkalmazás üzembe helyezéséhez.

DeploymentType - Üzembehelyezési módszer
string. Akkor szükséges, ha UseWebDeploy == true && ConnectionType = AzureRM && WebAppKind != webAppLinux && WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && webAppKind != functionAppLinux && WebAppKind != "" && Package NotEndsWith .war && Package NotEndsWith .jar. 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. Választható. Használja a következőt: 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.

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 gyökérkönyvtárban. A szinkronizálás sikeres befejezése után a fájl el lesz távolítva.

SetParametersFile - SetParameters fájl
string. Választható. Használja a következőt: 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 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 && 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.

A "true" (igaz) érték megadásával törölheti azokat a fájlokat a Azure App Service, amelyek nem rendelkeznek egyező fájlokkal a App Service csomagban vagy mappában. 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 && 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 a Azure App Service.

AdditionalArguments - További argumentumok
string. Választható. Használja a következőt: 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 Web Deploy argumentumok a szintaxist -key:valuekövetve. Ezek a Azure App Service telepítésekor lesznek alkalmazva. Példák: -disableLink:AppPoolExtension -disableLink:ContentExtension. További információ a webes üzembe helyezés műveleti beállításairól.

RenameFilesFlag - Zárolt fájlok átnevezése
boolean. Választható. Használja a következőt: 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ő MSDEPLOY_RENAME_LOCKED_FILES=1 engedélyezéséhez Azure App Service alkalmazásbeállításokban. 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. Választható. Használja a következőt: WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war. Alapértelmezett érték: false.

A konfigurációs átalakítások a és a *.config filerendszeren lesznek futtatva.*.Release.config*.<EnvironmentName>.config A konfigurációá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ése
Bemeneti alias: XmlVariableSubstitution. boolean. Választható. Használja a következőt: 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 egyeznek a konfigurációs fájlok és fájlok kulcs- vagy névbejegyzésével, valamint a configSections, appSettings, applicationSettingsés connectionStringsparameters.xml szakaszaival. A változóhelyettesítés konfigurációátalakítások után fut.

Ha ugyanazokat a változókat definiálja 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ése
string. Választható. Használja a következőt: WebAppKind != webAppContainer && WebAppKind != webAppHyperVContainer && WebAppkind != functionAppContainer && WebAppKind != webAppLinux && webAppKind != functionAppLinux && Package NotEndsWith .war.

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

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

A változó-helyettesítés konfigurációátalakítások után 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ó a JSON-változó helyettesítésérő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

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
A kijelölt App Service alkalmazás URL-címe.

Megjegyzések

• A tevékenység előfeltételei
• Használati megjegyzések
• Üzembehelyezési módszerek
• Hibaelhárítás
• Gyakori kérdések

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 üzembe helyezési technológiát használ.

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

A feladat több Azure-alkalmazás-szolgáltatásban is üzembe helyezhető, például:

• Web Apps Windows és Linux rendszeren is
• Tárolókhoz készült Web Apps
• Függvényalkalmazások Windows és Linux rendszeren is
• Függvényalkalmazások tárolókhoz
• WebJobs-feladatok
• A 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 egy webalkalmazás-projekt vagy egy Azure-függvényprojekt üzembe helyezésére szolgál egy meglévő Azure App Service példányon, amelynek léteznie kell a tevékenység futtatása előtt. A App Service példány a Azure Portal alapján hozható létre, és ott konfigurálható. Másik lehetőségként a Azure PowerShell feladat használható AzureRM 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 fogja listázni ezeket a kapcsolatokat a feladat beállításai között.

Használati megjegyzések

• A feladat csak az Azure Resource Manager API-kkal működik.
• Az SSL-hibák figyelmen kívül hagyásához definiáljon egy nevű VSTS_ARM_REST_IGNORE_SSL_ERRORS változót, amelynek értéke true szerepel a folyamatban. Ha egy automatikus felcserélésre konfigurált ponton helyezi üzembe az üzembe helyezést, a felcserélés sikertelen lesz, kivéve, ha az App Services konfigurációs beállításai között vagy értékre van állítva SCM_SKIP_SSL_VALIDATIONSCM_SKIP_ASE_SSL_VALIDATION1 .
• Windows rendszeren futó webalkalmazást megcélzó .NET-alkalmazások esetén kerülje a hibával ERROR_FILE_IN_USE kapcsolatos üzembehelyezési hibákat, mert győződjön meg arról, hogy a Zárolt fájlok átnevezése és az Alkalmazás offline állapotba helyezése beállítás engedélyezve van. A nulla állásidős üzembe helyezéshez használja a pontcserét.
• Ha olyan App Service helyez üzembe, amelyben az Application Insights konfigurálva van, és engedélyezte a További fájlok eltávolítása a célhelyen beállítást, győződjön meg arról, hogy a Fájlok kizárása a App_Data mappából beállítást is engedélyezi, hogy az Application Insights bővítmény biztonságos állapotban maradjon. Erre azért van szükség, mert az Application Insights folyamatos webes feladata telepítve van a App_Data mappába.

Üzembehelyezési módszerek

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

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

• Web Deploy
• Kudu REST API-k
• Container Registry
• Tömörített üzembe helyezés
• Futtatás csomagból
• War Deploy

Alapértelmezés szerint a feladat megpróbálja kiválasztani a megfelelő üzembehelyezési technológiát a bemeneti csomag típusa, 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ípusa	Csomag típusa	Üzembehelyezési módszer
WebApp Linuxon vagy Függvényalkalmazás Linuxon	Mappa/Zip/jar War	Zip Deploy War Deploy
WebApp for Containers (Linux) vagy Függvényalkalmazás tárolókhoz (Linux)	Az alkalmazásbeállítások 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ás mappájában/Zip-ben	War Deploy Zip Deploy Web Deploy if postDeploymentScript == true, Zip Deploy else, Run From Package

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

Web Deploy

A Web Deploy (msdeploy.exe) segítségével windowsos webalkalmazást vagy függvényalkalmazást helyezhet üzembe a Azure App Service Egy Windows-ügynök használatával. A Web Deploy funkciógazdag, és az alábbiakhoz hasonló lehetőségeket kínál:

• Zárolt fájlok átnevezése: Nevezze át a webkiszolgáló által még használatban lévő fájlokat az msdeploy jelző MSDEPLOY\_RENAME\_LOCKED\_FILES=1 engedélyezésével a Azure App Service beállításai között. Ha be van állítva, ez a beállítás lehetővé teszi, hogy az msdeploy átnevezze az alkalmazástelepítés során zárolt fájlokat.

• Távolítsa el a további fájlokat a célhelyen: Törli azokat a fájlokat a Azure App Service, amelyek nem rendelkeznek egyező fájlokkal az üzembe helyezett App Service összetevőcsomagban vagy mappá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

• További Web Deploy argumentumok: A Azure App Service telepítésekor alkalmazandó 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 (Web deploy műveleti beállítások).

A Web Deploy telepítése az ügynökre a Web Deploy 3.6-ból. A Web Deploy 3.5-öt a csomagolt 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 a helyen C:/Program Files (x86)/IIS/Microsoft Web Deploy V3van telepítve.

Kudu REST API-k

A Kudu REST API-k Windows- és Linux-automatizálási ügynökökön is működnek, ha a cél egy Windows-alapú webalkalmazás, a Linuxon futó webalkalmazás (beépített forrás) vagy a függvényalkalmazás. A feladat a Kudu használatával másolja a fájlokat a Azure-alkalmazás szolgáltatásba.

Container Registry

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

Tömörített üzembe helyezés

Egy .zip üzembehelyezési csomagot vár, és telepíti a fájl tartalmát a App Service vagy az Azure-beli függvényalkalmazás wwwroot mappájába. Ez a beállítás felülírja a wwwroot mappa összes meglévő tartalmát. További információ: Zip-alapú üzembe helyezés Azure Functions.

Futtatás csomagból

Ugyanazt az üzembehelyezési csomagot várja, mint a Zip Deploy. Ahelyett azonban, hogy fájlokat helyezna üzembe a wwwroot mappában, a teljes csomagot a Functions-futtatókörnyezet csatlakoztatja, és a wwwroot mappában lévő fájlok írásvédettekké válnak. További információért lásd az Azure Functions csomagfájlból történő futtatásával foglalkozó cikket.

War Deploy

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

Hibaelhárítás

Nem tudom a Web Deploy szolgáltatást üzembe helyezni a Azure App Service a Windows-ügynököm Microsoft Entra ID hitelesítésével

A Azure App Service üzembe helyezési feladat támogatja a Microsoft Azure-hoz arm-szolgáltatáskapcsolattal való csatlakozást Microsoft Entra ID használatával, kivéve, ha az alábbi három feltétel teljesül:

• Web Deploy csomagformátumot használ Egy Windows-ügynökön
• Az ügynök a msdeploy.exe egy 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, tetszés szerint.

1. Frissítse az ügynök rendszerképét. Ha üzemeltetett ügynököket használ, váltsa át a windows-2019-ről a windows-2022-re (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.
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-latest) rendszeren fusson.
3. Ha egyik lehetőség sem lehetséges, engedélyezheti az alapszintű hitelesítést a Azure App Service.

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 nem rendelkezik engedélyekkel a App Service, 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ás regisztrációjában. További információért lásd: Az Azure-előfizetések erőforrásaihoz való hozzáférés kezelése szerepköralapú hozzáférés-vezérléssel. Ez a blogbejegyzés további információkat is tartalmaz a szolgáltatásnév-hitelesítés használatáról.

SSL-hiba

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

Egy kiadás hosszú ideig nem válaszon, majd meghiúsul

Ez a probléma a App Service csomag elégtelen kapacitásának következménye lehet. A probléma megoldásához vertikálisan felskálázhatja a App Service példányt a rendelkezésre álló processzor-, RAM- és lemezterület növeléséhez, vagy megpróbálhat egy másik App Service csomaggal.

5xx hibakódok

Ha 5xx hiba jelenik meg, ellenőrizze az Azure-szolgáltatás állapotát.

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

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ás konfigurációjában a "WEBSITE_RUN_FROM_PACKAGE" értékként van beállítva. Azure Functions ezt az SAS-t használja 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 az üzembe helyezést, hogy létrehoz egy SAS-t egyéves lejárati dátummal.

Hiba: A megadott mintával nem található csomag

Ellenőrizze, hogy a feladatban említett csomag közzé van-e téve összetevőként a buildben vagy egy korábbi fázisban, és le van-e töltve az aktuális feladatban.

Hiba: Az msBuild csomagtípus esetében nem támogatott a közzététel zip-alapú üzembe helyezési lehetőséggel

Az MSBuild feladaton keresztül létrehozott (alapértelmezett argumentumokkal rendelkező) webcsomagok beágyazott mappastruktúrával rendelkeznek, amelyet csak a Web Deploy helyezhet üzembe megfelelően. A közzététel a zip-be üzembe helyezési lehetőség nem használható a csomagok üzembe helyezéséhez. A csomagolás szerkezetének á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 az MSBuild argumentumokat a következőre /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 a gyökérmappát vagy fájlt archiválásra.$(System.DefaultWorkingDirectory)\\WebAppContent

   2. Törölje az Előtag 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 sikeres a Windows rendszeren, 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-, Node.js-, Go- és Java-alkalmazásokhoz készült web.config paraméterek létrehozása lehetőséget.

  

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

  

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

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

Megjegyzés

Ez a szakasz elavult, és a Fájlátalakítás feladatra lett cserélve.

ERROR_FILE_IN_USE

Amikor .NET-alkalmazásokat helyez üzembe a Web Appban Windows rendszeren, az üzembe helyezés meghiúsulhat ERROR_FILE_IN_USE hibakóddal. A hiba elhárításához győződjön meg arról, hogy a feladatban engedélyezve vannak a zárolt fájlok átnevezése és az Alkalmazás offline állapotba helyezése lehetőség. Nulla állásidejű üzembe helyezések esetén használjon pontfelcserélést.

Az erőforrás-zárolás elkerüléséhez a Futtatás csomagból üzembehelyezési módszert is használhatja.

Webes üzembe helyezési hiba

Ha Web Deploy használatával helyezi üzembe az alkalmazást, bizonyos hibaforgatókönyvekben a Web Deploy egy 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 ismertető cikket.

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

• Győződjön meg arról, hogy az Azure DevOps buildügynöke ugyanazon a virtuális hálózaton található (az alhálózat eltérő lehet), mint az ASE belső Load Balancer (ILB). Így az ügynök lekérhet kódot az Azure DevOpsból, és üzembe helyezheti az ASE-ben.
• Ha Azure DevOpsot használ, az ügynöknek nem kell az internetről elérhetőnek lennie, hanem csak kimenő hozzáférésre van szüksége az Azure DevOps Service-hez való csatlakozáshoz.
• Ha egy Virtual Network üzembe helyezett TFS/Azure DevOps Server 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 Virtual Network privát erőforrásai nem rendelkeznek bejegyzésekkel az Azure DNS-ben, ezt hozzá kell adni az ügynökgép gazdagépfájljához.
• Ha önaláírt tanúsítványt használ az ASE-konfigurációhoz, a -allowUntrusted beállítást be kell állítani az MSDeploy üzembe helyezési feladatában. Azt is javasoljuk, hogy állítsa a változót VSTS_ARM_REST_IGNORE_SSL_ERRORS true (igaz) értékre. Ha egy hitelesítésszolgáltatótól származó tanúsítványt használ az ASE-konfigurációhoz, ez nem szükséges. Ha egy 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ásait.

Gyakori kérdések

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

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

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

• Módosítsa a konfigurációs beállításokat a webes csomagokban és az XML-paraméterek fájljaiban.
• Üzembe helyezés a Web Deploy használatával, ha az IIS üzembehelyezé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.

Megjegyzés

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ármely konfigurációs és paraméterfájlra.

Hogyan konfigurálhatom a szolgáltatáskapcsolatot?

Ehhez a feladathoz Azure Resource Manager szolgáltatáskapcsolat szükséges.

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

Ha egy App Service helyez üzembe, ha az Application Insights konfigurálva van, és engedélyezve Remove additional files at destinationvan, engedélyeznie kell Exclude files from the App_Data folderazt is. 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álhatom az ügynökömet, ha proxy mögött van, miközben App Service üzembe helyezem?

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. Ezzel lehetővé teszi az ügynök számára, hogy a proxyn keresztül csatlakozzon az Azure Pipelineshoz vagy Azure DevOps Server. További információ a saját üzemeltetésű ügynök webproxy mögött való futtatásáról.

Példák

• Üzembe helyezés adott alkalmazástípusra
• Üzembe helyezés linuxos Azure Web App-tárolóban
• Webalkalmazás üzembe helyezése Windows App Service üzembehelyezési pontok között
• Üzembe helyezés utáni példaszkript

Üzembe helyezés adott alkalmazástípusra

Ha egy adott alkalmazástípusra szeretne üzembe helyezni, állítsa a appType következő elfogadott értékek egyikére: webApp (Web App on Windows), webAppLinux (Web App on Linux), webAppContainer (Web App for Containers – Linux), functionApp (Function App on Windows), functionAppLinux (Function App on Linux), functionAppContainer (Function App for Containers – Linux), apiApp (API App), mobileApp (Mobile App). Ha nem említi, webApp a rendszer az alapértelmezett értéket veszi figyelembe.

A speciális üzembehelyezési beállítások engedélyezéséhez adja hozzá a paramétert enableCustomDeployment: true , és szükség szerint adja meg 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 linuxos Azure Web App-tárolóban

Az alábbi YAML-példa egy Azure Web App-tárolóban (Linux) 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 üzembehelyezési pontok között

Az alábbi példa egy webalkalmazást helyez üzembe egy Windows App Service 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'
            deployToSlotOrASE: true
            ResourceGroupName: 'rgPartsUnlimited'
            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:
            appType: webApp
            ConnectionType: AzureRM            
            ConnectedServiceName: 'Fabrikam Azure Subscription - PartsUnlimited'
            ResourceGroupName: 'rgPartsUnlimited'
            WebAppName: 'partsunlimited'
            Package: '$(System.DefaultWorkingDirectory)/**/*.zip'
            deployToSlotOrASE: true
            SlotName: 'staging'

Üzembe helyezés utáni példaszkript

A feladat lehetővé teszi az üzemelő példány testreszabását egy szkript megadásával, amely az alkalmazás összetevőinek a App Service való sikeres másolása után fut a Azure App Service. 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 a App Service 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ő másolását eredményezi az ügynökről a Azure App Service.

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
)

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 tevékenység 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

Lásd még

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