Nasazení souborů do služby App Service

Článek
06/01/2024

Poznámka:

Od 1. června 2024 budou mít všechny nově vytvořené aplikace App Service možnost vygenerovat jedinečný výchozí název hostitele pomocí zásad <app-name>-<random-hash>.<region>.azurewebsites.netvytváření názvů . Stávající názvy aplikací zůstanou beze změny.

Příklad: myapp-ds27dh7271aah175.westus-01.azurewebsites.net

Další podrobnosti najdete v tématu Jedinečný výchozí název hostitele pro prostředek služby App Service.

V tomto článku se dozvíte, jak nasadit kód jako balíček ZIP, WAR, JAR nebo EAR do služby Aplikace Azure Service. Také ukazuje, jak nasadit jednotlivé soubory do služby App Service odděleně od balíčku aplikace.

Požadavky

Pokud chcete dokončit kroky v tomto článku, vytvořte aplikaci služby App Service nebo použijte aplikaci, kterou jste vytvořili pro jiný kurz.

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure před tím, než začnete.

Vytvoření balíčku ZIP projektu

Důležité

Při vytváření balíčku ZIP pro nasazení nezahrnujte kořenový adresář, ale pouze soubory a adresáře v něm. Pokud si stáhnete úložiště GitHub jako soubor ZIP, nemůžete tento soubor nasadit tak, jak je ve službě App Service. GitHub přidá další vnořené adresáře na nejvyšší úrovni, které nefungují se službou App Service.

V okně místního terminálu přejděte do kořenového adresáře projektu aplikace.

Tento adresář by měl obsahovat vstupní soubor webové aplikace, například index.html, index.php a app.js. Může také obsahovat soubory správy balíčků, jako jsou project.json, composer.json, package.json, bower.json a requirements.txt.

Pokud nechcete, aby služba App Service spouštěla automatizaci nasazení za vás, spusťte všechny úlohy sestavení (například npm, bower, gulp, composera) a pipujistěte se, že máte všechny soubory, které potřebujete ke spuštění aplikace. Tento krok se vyžaduje, pokud chcete balíček spustit přímo.

Vytvořte archiv ZIP se všemi položkami ve vašem projektu. U dotnet projektů je to všechno ve výstupním adresáři dotnet publish příkazu (s výjimkou samotného výstupního adresáře). Například následující příkaz v terminálu pro vytvoření balíčku ZIP s obsahem aktuálního adresáře:

# Bash
zip -r <file-name>.zip .

# PowerShell
Compress-Archive -Path * -DestinationPath <file-name>.zip

Nasazení balíčku ZIP

Když nasadíte balíček ZIP, App Service rozbalí jeho obsah ve výchozí cestě pro vaši aplikaci (D:\home\site\wwwroot pro Windows, /home/site/wwwroot pro Linux).

Toto nasazení balíčku ZIP používá stejnou službu Kudu, která zajišťuje průběžné nasazování založené na integraci. Kudu podporuje následující funkce pro nasazení balíčku ZIP:

Odstranění souborů z předchozího nasazení.
Možnost zapnout výchozí proces sestavení, který zahrnuje obnovení balíčku.
Přizpůsobení nasazení, včetně spouštění skriptů nasazení
Protokoly nasazení
Omezení velikosti balíčku 2048 MB.

Poznámka:

Soubory v balíčku ZIP se zkopírují jenom v případě, že jejich časová razítka neodpovídají tomu, co je už nasazené.

S uživatelským rozhraním pro nasazení zip v Kudu

V prohlížeči přejděte na https://<app_name>.scm.azurewebsites.net/ZipDeployUI (viz poznámka nahoře).

Nahrajte balíček ZIP, který jste vytvořili v balíčku ZIP projektu, přetažením do oblasti Průzkumníka souborů na webové stránce.

V průběhu nasazování ukazuje ikona v pravém horním rohu průběh nasazování v procentech. Na stránce se pod oblastí průzkumníka zobrazí také podrobné zprávy o operaci. Po dokončení nasazení by měla poslední zpráva říct Deployment successful.

Výše uvedený koncový bod v tuto chvíli nefunguje pro Linux App Services. Místo toho zvažte použití protokolu FTP nebo rozhraní ZIP Deploy API .

Bez uživatelského rozhraní pro nasazení zip v Kudu

Nasaďte do webové aplikace balíček ZIP pomocí příkazu az webapp deploy . Příkaz rozhraní příkazového řádku používá rozhraní API pro publikování Kudu k nasazení souborů a dá se plně přizpůsobit.

Následující příklad nasdílí balíček ZIP na web. Zadejte cestu k místnímu balíčku ZIP pro --src-path.

az webapp deploy --resource-group <group-name> --name <app-name> --src-path <zip-package-path>

Tento příkaz restartuje aplikaci po nasazení balíčku ZIP.

V následujícím příkladu se k nahrání balíčku ZIP používá Publish-AzWebapp . Nahraďte zástupné symboly <group-name><app-name>a<zip-package-path>

Publish-AzWebApp -ResourceGroupName Default-Web-WestUS -Name MyApp -ArchivePath <zip-package-path>

Následující příklad používá nástroj cURL k nasazení balíčku ZIP. Nahraďte zástupné symboly <zip-package-path> a <app-name>. Pokud zvolíte základní ověřování, zadejte přihlašovací údaje pro nasazení do <username> a <password>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<zip-package-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=zip"

# Basic authentication
curl -X POST \
     -u '<username>:<password>' \
     -T "<zip-package-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=zip"

Poznámka:

Skutečný plně kvalifikovaný název domény, který se má použít v adrese URL, najdete v horní části poznámky.

Povolení automatizace sestavení pro nasazení souboru ZIP

Ve výchozím nastavení modul nasazení předpokládá, že balíček ZIP je připravený spustit tak, jak je, a nespustí žádnou automatizaci sestavení. Pokud chcete povolit stejnou automatizaci sestavení jako v nasazení Git, nastavte SCM_DO_BUILD_DURING_DEPLOYMENT nastavení aplikace spuštěním následujícího příkazu v Cloud Shellu:

az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true

Další informace najdete v dokumentaci k Kudu.

Nasazení balíčků WAR/JAR/EAR

Balíček WAR, JAR nebo EAR můžete nasadit do služby App Service a spustit webovou aplikaci v Javě pomocí Azure CLI, PowerShellu nebo rozhraní API pro publikování Kudu.

Tady uvedený proces nasazení umístí balíček do sdílené složky obsahu aplikace se správnou konvencí pojmenování a adresářovou strukturou (viz referenční informace k rozhraní API pro publikování Kudu) a je to doporučený postup. Pokud místo toho nasadíte balíčky WAR/JAR/EAR pomocí protokolu FTP nebo WebDeploy, může dojít k neznámým selháním kvůli chybám v pojmenování nebo struktuře.

Nasaďte balíček WAR do protokolu Tomcat nebo JBoss EAP pomocí příkazu az webapp deploy . Zadejte cestu k místnímu balíčku Java pro --src-path.

az webapp deploy --resource-group <group-name> --name <app-name> --src-path ./<package-name>.war

Příkaz rozhraní příkazového řádku používá rozhraní API pro publikování Kudu k nasazení balíčku a je možné ho plně přizpůsobit.

Následující příklad používá publish-AzWebapp k nahrání souboru .war. Nahraďte zástupné symboly <group-name><app-name>a <package-path> (v Azure PowerShellu se podporují jenom soubory WAR a JAR).

Publish-AzWebapp -ResourceGroupName <group-name> -Name <app-name> -ArchivePath <package-path>

Následující příklad používá nástroj cURL k nasazení souboru .war, .jar nebo .ear. Zástupné symboly <file-path>, <app-name>a <package-type> (war, jarnebo ear) nahraďte odpovídajícím způsobem. Pokud zvolíte základní ověřování, zadejte přihlašovací údaje pro nasazení do <username> a <password>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=<package-type>"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=<package-type>"

Poznámka:

Skutečný plně kvalifikovaný název domény, který se má použít v adrese URL, najdete v horní části poznámky.

Další informace najdete v referenčních informacích k rozhraní API pro publikování Kudu.

Nasazení jednotlivých souborů

Nasaďte do webové aplikace spouštěcí skript, knihovnu a statický soubor pomocí příkazu az webapp deploy s parametrem --type .

Pokud tímto způsobem nasadíte spouštěcí skript, app Service automaticky spustí vaši aplikaci pomocí skriptu.

Příkaz rozhraní příkazového řádku používá rozhraní API pro publikování Kudu k nasazení souborů a dá se plně přizpůsobit.

Nasazení spouštěcího skriptu

az webapp deploy --resource-group <group-name> --name <app-name> --src-path scripts/startup.sh --type=startup

Nasazení souboru knihovny

az webapp deploy --resource-group <group-name> --name <app-name> --src-path driver.jar --type=lib

Nasazení statického souboru

az webapp deploy --resource-group <group-name> --name <app-name> --src-path config.json --type=static

Nasazení spouštěcího skriptu

Následující příklad používá nástroj cURL k nasazení spouštěcího souboru pro aplikaci. Nahraďte zástupné symboly <startup-file-path> a <app-name>. Pokud zvolíte základní ověřování, zadejte přihlašovací údaje pro nasazení do <username> a <password>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<startup-file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=startup"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<startup-file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=startup"

Poznámka:

Skutečný plně kvalifikovaný název domény, který se má použít v adrese URL, najdete v horní části poznámky.

Nasazení souboru knihovny

Následující příklad používá nástroj cURL k nasazení souboru knihovny pro aplikaci. Nahraďte zástupné symboly <lib-file-path> a <app-name>. Pokud zvolíte základní ověřování, zadejte přihlašovací údaje pro nasazení do <username> a <password>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<lib-file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=lib&path=/home/site/deployments/tools/my-lib.jar"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<lib-file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=lib&path=/home/site/deployments/tools/my-lib.jar"

Poznámka:

Skutečný plně kvalifikovaný název domény, který se má použít v adrese URL, najdete v horní části poznámky.

Nasazení statického souboru

Následující příklad používá nástroj cURL k nasazení konfiguračního souboru pro aplikaci. Nahraďte zástupné symboly <config-file-path> a <app-name>. Pokud zvolíte základní ověřování, zadejte přihlašovací údaje pro nasazení do <username> a <password>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<config-file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=static&path=/home/site/deployments/tools/my-config.json"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<config-file-path>" \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=static&path=/home/site/deployments/tools/my-config.json"

Poznámka:

Skutečný plně kvalifikovaný název domény, který se má použít v adrese URL, najdete v horní části poznámky.

Nasazení do aplikací zabezpečených sítí

V závislosti na konfiguraci sítě vaší webové aplikace může být přímý přístup k aplikaci z vašeho vývojového prostředí zablokovaný (viz Nasazení na weby zabezpečené sítí a nasazení do lokalit zabezpečených sítí, část 2). Místo toho, abyste balíček nebo soubor nasdílel přímo do webové aplikace, můžete ho publikovat do systému úložiště přístupného z webové aplikace a aktivovat aplikaci pro načtení souboru ZIP z umístění úložiště.

Vzdálená adresa URL může být libovolné veřejně přístupné umístění, ale nejlepší je použít kontejner úložiště objektů blob s klíčem SAS k jeho ochraně.

Použijte příkaz jako az webapp deploy v ostatních částech, ale použijte --src-url místo --src-path. Následující příklad používá --src-url parametr k určení adresy URL souboru ZIP hostovaného v účtu azure Storage.

az webapp deploy --resource-group <group-name> --name <app-name> --src-url "https://storagesample.blob.core.windows.net/sample-container/myapp.zip?sv=2021-10-01&sb&sig=slk22f3UrS823n4kSh8Skjpa7Naj4CG3 --type zip

V ostatních částech vyvolejte rozhraní API pro publikování Kudu, ale místo nahrání souboru předejte objekt JSON s textem packageUri požadavku. Následující příklady používají tuto metodu k určení adresy URL souboru ZIP hostovaného v účtu služby Azure Storage. Všimněte si, že typ je stále zadaný jako řetězec dotazu. Pokud zvolíte základní ověřování, zadejte přihlašovací údaje pro nasazení do <username> a <password>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"packageUri": "https://storagesample.blob.core.windows.net/sample-container/myapp.zip?sv=2021-10-01&sb&sig=slk22f3UrS823n4kSh8Skjpa7Naj4CG3"}' \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=zip"

# Basic authentication
curl -X POST \
     -u '<username>:<password>' \
     -H "Content-Type: application/json" \
     -d '{"packageUri": "https://storagesample.blob.core.windows.net/sample-container/myapp.zip?sv=2021-10-01&sb&sig=slk22f3UrS823n4kSh8Skjpa7Naj4CG3"}' \
     "https://<app-name>.scm.azurewebsites.net/api/publish?type=zip"

Poznámka:

Skutečný plně kvalifikovaný název domény, který se má použít v adrese URL, najdete v horní části poznámky.

Do šablony ARM přidejte následující JSON. Nahraďte zástupný symbol <app-name>.

{
    "type": "Microsoft.Web/sites/extensions",
    "apiVersion": "2021-03-01",
    "name": "onedeploy",
    "dependsOn": [
        "[resourceId('Microsoft.Web/Sites', <app-name>')]"
    ],
    "properties": {
        "packageUri": "<zip-package-uri>",
        "type": "<type>",
        "path": "<target-path>"
    }
}

Následující referenční informace vám pomůžou s konfigurací vlastností:

Vlastnost	Popis	Povinní účastníci
`packageUri`	Identifikátor URI balíčku nebo souboru. Další informace naleznete v tématu Microsoft.Web sites/extensions 'onedeploy'.	Ano
`type`	Viz parametr v referenčních informacích `type`k rozhraní API pro publikování Kudu.	Ano
`path`	Viz parametr v referenčních informacích `target-path`k rozhraní API pro publikování Kudu.	No

Referenční informace k rozhraní API pro publikování Kudu

Rozhraní publish Kudu API umožňuje zadat stejné parametry z příkazu rozhraní příkazového řádku jako parametry dotazu adresy URL. Pokud se chcete ověřit pomocí rozhraní Kudu REST API, je nejlepší použít ověřování pomocí tokenů, ale můžete také použít základní ověřování s přihlašovacími údaji pro nasazení vaší aplikace.

Následující tabulka ukazuje dostupné parametry dotazu, jejich povolené hodnoty a popisy.

Klíč	Povolené hodnoty	Popis	Povinní účastníci	Typ
`type`	`war`\|`jar`\|`ear`\|`lib`\|`startup`\|`static`\|`zip`	Typ nasazeného artefaktu nastaví výchozí cílovou cestu a informuje webovou aplikaci, jak se má nasazení zpracovat. - `type=zip`: Nasaďte balíček ZIP tak, že obsah rozbalíte do `/home/site/wwwroot`souboru . `target-path` parametr je volitelný. - `type=war`: Nasaďte balíček WAR. Ve výchozím nastavení se balíček WAR nasadí do `/home/site/wwwroot/app.war`souboru . Cílovou cestu lze zadat pomocí parametru `target-path`. - `type=jar`: Nasaďte balíček JAR do `/home/site/wwwroot/app.jar`souboru . Parametr `target-path` je ignorován. - `type=ear`: Nasaďte do souboru EAR balíček `/home/site/wwwroot/app.ear`. Parametr `target-path` je ignorován. - `type=lib`: Nasaďte soubor knihovny JAR. Ve výchozím nastavení se soubor nasadí do `/home/site/libs`souboru . Cílovou cestu lze zadat pomocí parametru `target-path`. - `type=static`: Nasaďte statický soubor (například skript). Ve výchozím nastavení se soubor nasadí do `/home/site/wwwroot`souboru . - `type=startup`: Nasaďte skript, který App Service automaticky používá jako spouštěcí skript pro vaši aplikaci. Ve výchozím nastavení je skript nasazený pro `D:\home\site\scripts\<name-of-source>` Windows a `home/site/wwwroot/startup.sh` Linux. Cílovou cestu lze zadat pomocí parametru `target-path`.	Ano	String
`restart`	`true`\|`false`	Ve výchozím nastavení rozhraní API restartuje aplikaci po operaci nasazení (`restart=true`). Pokud chcete nasadit více artefaktů, zabráníte restartování ve všech, ale i posledním nasazení, nastavením `restart=false`.	No	Logická hodnota
`clean`	`true`\|`false`	Určuje, jestli se má cílové nasazení před nasazením artefaktu vyčistit (odstranit).	No	Logická hodnota
`ignorestack`	`true`\|`false`	Rozhraní API pro publikování používá proměnnou `WEBSITE_STACK` prostředí k výběru bezpečných výchozích hodnot v závislosti na zásobníku jazyka vašeho webu. Nastavením tohoto parametru `false` zakážete všechny výchozí hodnoty specifické pro jazyk.	No	Logická hodnota
`target-path`	Absolutní cesta	Absolutní cesta k nasazení artefaktu. Například , `"/home/site/deployments/tools/driver.jar""/home/site/scripts/helper.sh"`.	No	String

Další kroky

Pokud chcete pokročilejší scénáře nasazení, zkuste nasazení do Azure pomocí Gitu. Nasazení založené na Gitu do Azure umožňuje správu verzí, obnovení balíčků, MSBuild a další.

Sdílet prostřednictvím

Nasazení souborů do služby App Service

Požadavky

Vytvoření balíčku ZIP projektu

Nasazení balíčku ZIP

S uživatelským rozhraním pro nasazení zip v Kudu

Bez uživatelského rozhraní pro nasazení zip v Kudu

Povolení automatizace sestavení pro nasazení souboru ZIP

Nasazení balíčků WAR/JAR/EAR

Nasazení jednotlivých souborů

Nasazení spouštěcího skriptu

Nasazení souboru knihovny

Nasazení statického souboru

Nasazení spouštěcího skriptu

Nasazení souboru knihovny

Nasazení statického souboru

Nasazení do aplikací zabezpečených sítí

Referenční informace k rozhraní API pro publikování Kudu

Další kroky

Další materiály

Váš názor

Další materiály