AzureWebApp@1 – Azure Web App v1 feladat

Ez a feladat üzembe helyez egy Azure Web App for Linux vagy Windows rendszert.

Szinopszis

# Azure Web App v1
# Deploy an Azure Web App for Linux or Windows.
- task: AzureWebApp@1
  inputs:
    azureSubscription: # string. Required. Azure subscription. 
    appType: # 'webApp' | 'webAppLinux'. Required. App type. 
    appName: # string. Required. App name. 
    #deployToSlotOrASE: false # boolean. Optional. Use when appType != "". Deploy to Slot or App Service Environment. Default: false.
    #resourceGroupName: # string. Required when deployToSlotOrASE = true. Resource group. 
    #slotName: 'production' # string. Required when deployToSlotOrASE = true. Slot. Default: production.
    package: '$(System.DefaultWorkingDirectory)/**/*.zip' # string. Required. Package or folder. Default: $(System.DefaultWorkingDirectory)/**/*.zip.
    #customDeployFolder: # string. Optional. Use when package EndsWith .war. Custom Deploy Folder. 
    #runtimeStack: # 'DOTNETCORE|9.0' | 'DOTNETCORE|8.0' | 'DOTNETCORE|7.0' | 'DOTNETCORE|6.0' | 'NODE|22-lts' | 'NODE|20-lts' | 'NODE|18-lts' | 'NODE|16-lts' | 'PYTHON|3.13' | 'PYTHON|3.12' | 'PYTHON|3.11' | 'PYTHON|3.10' | 'PYTHON|3.9' | 'PYTHON|3.8' | 'PHP|8.3' | 'PHP|8.2' | 'PHP|8.1' | 'PHP|8.0' | 'JAVA|21-java21' | 'JAVA|17-java17' | 'JAVA|11-java11' | 'JAVA|8-jre8' | 'JBOSSEAP|8-java17' | 'JBOSSEAP|8-java11' | 'JBOSSEAP|7-java17' | 'JBOSSEAP|7-java11' | 'JBOSSEAP|7-java8' | 'TOMCAT|10.1-java21' | 'TOMCAT|10.1-java17' | 'TOMCAT|10.1-java11' | 'TOMCAT|10.0-java17' | 'TOMCAT|10.0-java11' | 'TOMCAT|10.0-jre8' | 'TOMCAT|9.0-java21' | 'TOMCAT|9.0-java17' | 'TOMCAT|9.0-java11' | 'TOMCAT|9.0-jre8' | 'TOMCAT|8.5-java11' | 'TOMCAT|8.5-jre8'. Optional. Use when appType = webAppLinux. Runtime stack. 
    #startUpCommand: # string. Optional. Use when appType = webAppLinux. Startup command. 
    #siteContainersConfig: # string. Site Containers Config. 
  # Application and Configuration Settings
    #customWebConfig: # string. Optional. Use when appType != webAppLinux && package NotEndsWith .war. Generate web.config parameters for Python, Node.js, Go and Java apps. 
    #appSettings: # string. App settings. 
    #configurationStrings: # string. Configuration settings. 
  # Additional Deployment Options
    #deploymentMethod: 'auto' # 'auto' | 'zipDeploy' | 'runFromPackage'. Required when appType != webAppLinux && appType != "" && package NotEndsWith .war && package NotEndsWith .jar. Deployment method. Default: auto.

Bemenetek

Azure-előfizetés azureSubscription -
string. Szükséges.

Megadja az üzembe helyezéshez Azure Resource Manager-előfizetési.

appType - alkalmazástípus
string. Szükséges. Engedélyezett értékek: webApp (Windows webalkalmazás), webAppLinux (Linux webalkalmazás).

Megadja az Azure Web App típusát.

appName - alkalmazásnév
string. Szükséges.

Egy meglévő Azure App Service nevét adja meg. Csak a kiválasztott alkalmazástípuson alapuló alkalmazásszolgáltatások lesznek felsorolva.

deployToSlotOrASE - Üzembe helyezés pont- vagy App Service-környezetben
boolean. Opcionális. Használja a appType != "". Alapértelmezett érték: false.

Kiválasztja a meglévő üzembehelyezési ponton vagy egy Azure App Service-környezetben való üzembe helyezés lehetőségét.
Mindkét cél esetében a tevékenységnek erőforráscsoport-névre van szüksége.
Ha az üzembehelyezési cél egy pont, az alapértelmezett az éles pont. Bármely más meglévő pontnév is megadható.
Ha az üzembehelyezési cél egy Azure App Service-környezet, hagyja a pontnevet "éles" néven, és adja meg az erőforráscsoport nevét.

resourceGroupName - erőforráscsoport
string. deployToSlotOrASE = 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 Azure App Service-környezet.
Megadja a fent megjelölt Azure App Service-t tartalmazó Azure-erőforráscsoportot.

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

Egy meglévő pontot határoz meg, az éles pont kivételével.

package - Csomag vagy mappa
string. Szükséges. Alapértelmezett érték: $(System.DefaultWorkingDirectory)/**/*.zip.

Az MSBuild által létrehozott App Service-tartalmat, tömörített zip-fájlt vagy háborús fájlt tartalmazó csomag vagy mappa elérési útja. A változók (Build | Release) és a helyettesítő karakterek támogatottak. Például, $(System.DefaultWorkingDirectory)/**/*.zip vagy $(System.DefaultWorkingDirectory)/**/*.war.

customDeployFolder - egyéni üzembe helyezési mappa
string. Opcionális. Használja a package EndsWith .war.

Megadja az üzembe helyezni kívánt egyéni mappanevet.
Ha a mező üres, a csomag <appname>.azurewebsites.net/<warpackagename>lesz üzembe helyezve.
A ROOT megadásakor a csomag üzembe lesz helyezve <appname>.azurewebsited.net.
Az összes többi példányban az <appname>.azurewebsited.net/<customWarName>lesz üzembe helyezve.

runtimeStack - futtatókörnyezeti verem
string. Opcionális. Használja a appType = webAppLinux. Engedélyezett értékek: DOTNETCORE|9.0 (.NET 9.0), DOTNETCORE|8.0 (.NET 8.0), DOTNETCORE|7.0 (.NET 7.0), DOTNETCORE|6.0 (.NET 6.0), NODE|22-lts (22 LTS csomópont), NODE|20-lts (20 LTS csomópont), NODE|18-lts (18. LTS-csomópont), NODE|16-lts (16. LTS-csomópont), PYTHON|3.13 (Python 3.13), PYTHON|3.12 (Python 3.12), PYTHON|3.11 (Python 3.11), PYTHON|3.10 (Python 3.10), PYTHON|3.9 (Python 3.9), PYTHON|3.8 (Python 3.8), PHP|8.3 (PHP 8.3), PHP|8.2 (PHP 8.2), PHP|8.1 (PHP 8.1), PHP|8.0 (PHP 8.0), JAVA|21-java21 (Java 21), JAVA|17-java17 (Java 17), JAVA|11-java11 (Java 11), JAVA|8-jre8 (Java 8), JBOSSEAP|8-java17 (JBoss EAP 8 (Java 17)), JBOSSEAP|8-java11 (JBoss EAP 8 (Java 11)), JBOSSEAP|7-java17 (JBoss EAP 7 (Java 17)), JBOSSEAP|7-java11 (JBoss EAP 7 (Java 11)), JBOSSEAP|7-java8 (JBoss EAP 7 (Java 8)), TOMCAT|10.1-java21 (Tomcat 10.1 (Java 21)), TOMCAT|10.1-java17 (Tomcat 10.1 (Java 17)), TOMCAT|10.1-java11 (Tomcat 10.1 (Java 11)), TOMCAT|10.0-java17 (Tomcat 10.0 (Java 17)), TOMCAT|10.0-java11 (Tomcat 10.0 (Java 11)), TOMCAT|10.0-jre8 (Tomcat 10.0 (Java 8)), TOMCAT|9.0-java21 (Tomcat 9.0 (Java 21)), TOMCAT|9.0-java17 (Tomcat 9.0 (Java 17)), TOMCAT|9.0-java11 (Tomcat 9.0 (Java 11)), TOMCAT|9.0-jre8 (Tomcat 9.0 (Java 8)), ( TOMCAT|8.5-java11 Tomcat 8.5 (Java 11)), ( TOMCAT|8.5-jre8 Tomcat 8.5 (Java 8)).

A Linuxon futó Web App két különböző lehetőséget kínál az alkalmazás közzétételére: az egyéni rendszerkép üzembe helyezését (Web App for Containers) és egy beépített platformrendszerképet tartalmazó alkalmazástelepítést (Linuxon futó Web App). Ez a paraméter csak akkor érhető el, ha Linux Web App van kiválasztva alkalmazástípusként a feladatban.

startUpCommand - indítási parancs
string. Opcionális. Használja a appType = webAppLinux.

Az indítási parancsot adja meg.
Például:
dotnet run
dotnet filename.dll.

customWebConfig - Python-, Node.js-, Go- és Java-alkalmazásokhoz web.config-paraméterek létrehozása
string. Opcionális. Használja a appType != webAppLinux && 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. Az web.config értékei az alkalmazás keretrendszerétől függően változnak, és szerkeszthetők. Az node.js alkalmazás esetében például a web.config egy indítási fájllal és iis_node modulértékekkel fog rendelkezni. Ez a szerkesztési funkció csak a létrehozott web.config.

appSettings - alkalmazásbeállítások
string.

Adja meg a webalkalmazás-alkalmazás beállításait a szintaxis -key value (például: -Port 5000-RequestTimeout 5000-WEBSITE_TIME_ZONE). A szóközöket tartalmazó értékeket dupla idézőjelek közé foglalja (például: "Eastern Standard Time").

configurationStrings - konfigurációs beállítások
string.

Adja meg a webalkalmazás konfigurációs beállításait a szintaxis -key value (például: -phpVersion 5.6-linuxFxVersion: node|6.11). Olyan értékeket foglal össze, amelyek szóközöket tartalmaznak dupla idézőjelekben.

deploymentMethod - üzembe helyezési módszer
string. appType != webAppLinux && appType != "" && package NotEndsWith .war && package NotEndsWith .jaresetén kötelező. Engedélyezett értékek: auto (automatikus észlelés), zipDeploy (Zip Deploy), runFromPackage (csomagból futtatás). Alapértelmezett érték: auto.

Válassza ki az alkalmazáshoz üzembe helyezési módszert. Elfogadható értékek automatikus, zipDeployés runFromPackage.

siteContainersConfig - Helytárolók konfigurációja
string.

Adja meg a siteContainers-config JSON-t a SiteContainers üzemelő példányaihoz.

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ő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
A kiválasztott Azure App Service alkalmazás URL-címe.

Megjegyzések

Ezzel a feladattal webalkalmazásokat helyezhet üzembe az Azure App Service-ben.

Üzembe helyezési módszerek

Ebben a feladatban számos üzembe helyezési módszer érhető el. Auto az alapértelmezett beállítás.

Ha módosítani szeretné a csomagalapú üzembe helyezési lehetőséget a tervezői feladatban, bontsa ki További üzembehelyezési beállítások, és engedélyezze Telepítési módszer kiválasztásalehetőséget.

Az Azure App Service és az Azure Pipelines-ügynök típusa alapján 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:

• Kudu REST API-k
• Zip-üzembe helyezés
• RunFromPackage

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

• Ha az app service típusa Web App linuxos alkalmazás, használja Zip Deploy
• Ha war-fájl van megadva, használja War Deploy
• Jar-fájl megadása esetén használja a Futtatás csomagból
• Mindenki más számára használja a Futtatás Zip- használatával (Zip Deploy használatával)

Nem Windows-ügynökön (bármely app service-típus esetén) a feladat a webalkalmazás üzembe helyezéséhez Kudu REST API-kra támaszkodik.

Kudu REST API-k

Kudu REST API-k windowsos vagy linuxos automatizálási ügynökökön működnek, ha a cél a Windows webalkalmazása, a Linux webalkalmazása (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.

Zip-üzembe helyezés

Létrehozza a kiválasztott csomag vagy mappa .zip üzembehelyezési csomagját. A fájl tartalma ezután üzembe lesz helyezve a függvényalkalmazás wwwroot mappájában az Azure App Service-ben. Ez a beállítás felülírja a wwwroot mappában lévő összes meglévő tartalmat. További információ: Zip üzembe helyezése az Azure Functions.

RunFromPackage

Ugyanazt az üzembehelyezési csomagot hozza létre, mint a Zip Deploy. Ahelyett azonban, hogy fájlokat helyez üzembe a wwwroot mappában, a teljes csomagot az Azure Functions-futtatókörnyezet csatlakoztatja. Ezzel a beállítással a wwwroot mappában lévő fájlok írásvédettekké válnak. További információ: Az Azure Functions futtatása csomagfájlból.

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:

      

Gyakori kérdések

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.

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

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 alkalmazás- és konfigurációs beállításokhasználatával.

• Kattintson a feladatra, és lépjen Python- web.config-paraméterek létrehozása, Node.js, Go és Java-alkalmazások.

  

• Kattintson a további gombra ... a paraméterek szerkesztéséhez.

  

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

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

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. A virtuális hálózat privát erőforrásai nem rendelkeznek bejegyzésekkel az Azure DNS-ben, ezért ezt hozzá kell adni a gazdagép fájlához az ügynökgépen.
• 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 trueé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.

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.

Példák

Az alábbiakban egy példa YAML-kódrészletet láthat a webalkalmazás Windows rendszeren futó Azure Web App Service-ben való üzembe helyezéséhez.

variables:
  azureSubscription: Contoso
  # To ignore SSL error uncomment the below variable
  # VSTS_ARM_REST_IGNORE_SSL_ERRORS: true

steps:

- task: AzureWebApp@1
  displayName: Azure Web App Deploy
  inputs:
    azureSubscription: $(azureSubscription)
    appName: samplewebapp
    package: $(System.DefaultWorkingDirectory)/**/*.zip

A Web App Linuxon való üzembe helyezéséhez adja hozzá a appType paramétert, és állítsa be appType: webAppLinux.

Az üzembe helyezési módszer Zip Deployként való megadásához adja hozzá a deploymentMethod: zipDeployparamétert. A paraméter egy másik támogatott értéke a runFromPackage.

Ha nincs megadva, a auto az alapértelmezett érték.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás bekapcsolva	Ügynök, DeploymentGroup
Követelmények	Egyik sem
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ármely
Változók beállítása	Bármely
Ügynök verziója	2.209.0 vagy újabb
Tevékenységkategória	Üzembe helyezés