Distribuera filer till App Service

Artikel
06/01/2024

Kommentar

Från och med den 1 juni 2024 har alla nyligen skapade App Service-appar möjlighet att generera ett unikt standardvärdnamn med hjälp av namngivningskonventionen <app-name>-<random-hash>.<region>.azurewebsites.net. Befintliga appnamn förblir oförändrade.

Exempel: myapp-ds27dh7271aah175.westus-01.azurewebsites.net

Mer information finns i Unikt standardvärdnamn för App Service-resurs.

Den här artikeln visar hur du distribuerar koden som ett ZIP-, WAR-, JAR- eller EAR-paket till Azure App Service. Den visar också hur du distribuerar enskilda filer till App Service, separat från ditt programpaket.

Förutsättningar

Om du vill slutföra stegen i den här artikeln skapar du en App Service-app eller använder en app som du har skapat för en annan självstudie.

Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.

Skapa ett projekt-ZIP-paket

Viktigt!

När du skapar ZIP-paketet för distribution ska du inte ta med rotkatalogen, utan bara filerna och katalogerna i den. Om du laddar ned en GitHub-lagringsplats som en ZIP-fil kan du inte distribuera filen som den är till App Service. GitHub lägger till ytterligare kapslade kataloger på den översta nivån, som inte fungerar med App Service.

I ett lokalt terminalfönster navigerar du till rotkatalogen för ditt appprojekt.

Den här katalogen bör innehålla postfilen till webbappen, till exempel index.html, index.php och app.js. Den kan också innehålla pakethanteringsfiler som project.json, composer.json, package.json, bower.json och requirements.txt.

Om du inte vill att App Service ska köra distributionsautomation åt dig kör du alla bygguppgifter (till exempel npm, , bowergulp, composeroch ) och pipser till att du har alla filer som du behöver för att köra appen. Det här steget krävs om du vill köra paketet direkt.

Skapa ett ZIP-arkiv med allt i projektet. För dotnet projekt är detta allt i utdatakatalogen för dotnet publish kommandot (exklusive själva utdatakatalogen). Följande kommando i terminalen för att skapa ett ZIP-paket med innehållet i den aktuella katalogen:

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

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

Distribuera ett ZIP-paket

När du distribuerar ett ZIP-paket packar App Service upp innehållet i standardsökvägen för din app (D:\home\site\wwwroot för Windows, /home/site/wwwroot för Linux).

Den här ZIP-paketdistributionen använder samma Kudu-tjänst som driver kontinuerliga integreringsbaserade distributioner. Kudu har stöd för följande funktioner för distribution av ZIP-paket:

Borttagning av filer som har lämnats över från en tidigare distribution.
Alternativ för att aktivera standardversionsprocessen, som innehåller paketåterställning.
Distributionsanpassning, inklusive körning av distributionsskript.
Distributionsloggar.
En paketstorleksgräns på 2 048 MB.

Kommentar

Filer i ZIP-paketet kopieras endast om deras tidsstämplar inte matchar det som redan har distribuerats.

Med zip deploy UI i Kudu

I webbläsaren navigerar du till https://<app_name>.scm.azurewebsites.net/ZipDeployUI (se anteckning överst).

Ladda upp ZIP-paketet som du skapade i Skapa ett projekt-ZIP-paket genom att dra det till utforskarens område på webbsidan.

När distribueringen pågår visar en ikon i det övre högra hörnet förloppet i procent. På sidan visas även utförliga meddelanden för åtgärden under utforskarområdet. När distributionen är klar ska det sista meddelandet stå Deployment successful.

Slutpunkten ovan fungerar inte för Linux App Services just nu. Överväg att använda FTP eller ZIP-distributions-API:et i stället.

Utan zip-distribution av användargränssnittet i Kudu

Distribuera ett ZIP-paket till webbappen med hjälp av kommandot az webapp deploy . CLI-kommandot använder Kudu-publicerings-API:et för att distribuera filerna och kan anpassas helt.

I följande exempel skickas ett ZIP-paket till din webbplats. Ange sökvägen till ditt lokala ZIP-paket för --src-path.

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

Det här kommandot startar om appen när zip-paketet har distribuerats.

I följande exempel används Publish-AzWebapp för att ladda upp ZIP-paketet. Ersätt platshållarna <group-name>, <app-name>och <zip-package-path>

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

I följande exempel används cURL-verktyget för att distribuera ett ZIP-paket. Ersätt platshållarna <zip-package-path> och <app-name>. Om du väljer grundläggande autentisering anger du autentiseringsuppgifterna för distributionen i <username> och <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"

Kommentar

Information om det fullständiga domännamnet som ska användas i URL:en finns i anteckningen överst

Aktivera byggautomatisering för zip-distribution

Som standard förutsätter distributionsmotorn att ett ZIP-paket är redo att köras som det är och inte kör någon byggautomatisering. Om du vill aktivera samma byggautomatisering som i en Git-distribution anger du appinställningen SCM_DO_BUILD_DURING_DEPLOYMENT genom att köra följande kommando i Cloud Shell:

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

Mer information finns i Kudu-dokumentationen.

Distribuera WAR/JAR/EAR-paket

Du kan distribuera ditt WAR-, JAR- eller EAR-paket till App Service för att köra din Java-webbapp med azure CLI, PowerShell eller Kudu-publicerings-API:et.

Distributionsprocessen som visas här placerar paketet på appens innehållsresurs med rätt namngivningskonvention och katalogstruktur (se Kudu publicera API-referens) och det är den rekommenderade metoden. Om du distribuerar WAR/JAR/EAR-paket med FTP eller WebDeploy i stället kan du se okända fel på grund av misstag i namngivningen eller strukturen.

Distribuera ett WAR-paket till Tomcat eller JBoss EAP med hjälp av kommandot az webapp deploy . Ange sökvägen till ditt lokala Java-paket för --src-path.

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

CLI-kommandot använder Kudu-publicerings-API:et för att distribuera paketet och kan anpassas helt.

I följande exempel används Publish-AzWebapp för att ladda upp .war-filen. Ersätt platshållarna <group-name>, <app-name>och <package-path> (endast WAR- och JAR-filer stöds i Azure PowerShell).

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

I följande exempel används cURL-verktyget för att distribuera en .war-, .jar- eller .ear-fil. Ersätt platshållarna <file-path>, <app-name>, och <package-type> (war, jareller ear, i enlighet med detta). Om du väljer grundläggande autentisering anger du autentiseringsuppgifterna för distributionen i <username> och <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>"

Kommentar

Information om det fullständiga domännamnet som ska användas i URL:en finns i anteckningen överst

Mer information finns i Kudu publicera API-referens

Distribuera enskilda filer

Distribuera ett startskript, ett bibliotek och en statisk fil till webbappen med hjälp av kommandot az webapp deploy med parametern --type .

Om du distribuerar ett startskript på det här sättet använder App Service automatiskt skriptet för att starta appen.

CLI-kommandot använder Kudu-publicerings-API:et för att distribuera filerna och kan anpassas helt.

Distribuera ett startskript

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

Distribuera en biblioteksfil

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

Distribuera en statisk fil

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

Distribuera ett startskript

I följande exempel används cURL-verktyget för att distribuera en startfil för programmet. Ersätt platshållarna <startup-file-path> och <app-name>. Om du väljer grundläggande autentisering anger du autentiseringsuppgifterna för distributionen i <username> och <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"

Kommentar

Information om det fullständiga domännamnet som ska användas i URL:en finns i anteckningen överst

Distribuera en biblioteksfil

I följande exempel används cURL-verktyget för att distribuera en biblioteksfil för programmet. Ersätt platshållarna <lib-file-path> och <app-name>. Om du väljer grundläggande autentisering anger du autentiseringsuppgifterna för distributionen i <username> och <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"

Kommentar

Information om det fullständiga domännamnet som ska användas i URL:en finns i anteckningen överst

Distribuera en statisk fil

I följande exempel används cURL-verktyget för att distribuera en konfigurationsfil för programmet. Ersätt platshållarna <config-file-path> och <app-name>. Om du väljer grundläggande autentisering anger du autentiseringsuppgifterna för distributionen i <username> och <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"

Kommentar

Information om det fullständiga domännamnet som ska användas i URL:en finns i anteckningen överst

Distribuera till nätverksskyddade appar

Beroende på webbappens nätverkskonfiguration kan direktåtkomst till appen från utvecklingsmiljön blockeras (se Distribuera till nätverksskyddade platser och Distribuera till nätverksskyddade platser, del 2). I stället för att skicka paketet eller filen direkt till webbappen kan du publicera det till ett lagringssystem som är tillgängligt från webbappen och utlösa appen för att hämta ZIP-filen från lagringsplatsen.

Fjärr-URL:en kan vara valfri offentligt tillgänglig plats, men det är bäst att använda en bloblagringscontainer med en SAS-nyckel för att skydda den.

Använd kommandot az webapp deploy som du skulle göra i de andra avsnitten, men använd --src-url i stället för --src-path. I följande exempel används parametern --src-url för att ange URL:en för en ZIP-fil som finns i ett Azure Storage-konto.

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

Anropa Kudu-publicerings-API:et på samma sätt som i de andra avsnitten, men i stället för att ladda upp en fil skickar du in ett JSON-objekt med packageUri i begärandetexten. I följande exempel används den här metoden för att ange URL:en för en ZIP-fil som finns i ett Azure Storage-konto. Observera att typen fortfarande anges som en frågesträng. Om du väljer grundläggande autentisering anger du autentiseringsuppgifterna för distributionen i <username> och <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"

Kommentar

Information om det fullständiga domännamnet som ska användas i URL:en finns i anteckningen överst

Lägg till följande JSON i ARM-mallen. Ersätt platshållaren <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>"
    }
}

Använd följande referens för att konfigurera egenskaperna:

Property	Beskrivning	Obligatoriskt
`packageUri`	URI:n för paketet eller filen. Mer information finns i Microsoft.Web sites/extensions 'onedeploy'.	Ja
`type`	Se parametern `type` i Kudu publicera API-referens.	Ja
`path`	Se parametern `target-path` i Kudu publicera API-referens.	Nej

Kudu publicera API-referens

Med publish Kudu-API:et kan du ange samma parametrar från CLI-kommandot som URL-frågeparametrar. För att autentisera med Kudu REST API är det bäst att använda tokenautentisering, men du kan också använda grundläggande autentisering med appens autentiseringsuppgifter för distribution.

I följande tabell visas tillgängliga frågeparametrar, deras tillåtna värden och beskrivningar.

Nyckel	Tillåtna värden	beskrivning	Obligatoriskt	Typ
`type`	`war`\|`jar`\|`ear`\|`lib`\|`startup`\|`static`\|`zip`	Typen av artefakt som distribueras anger standardmålsökvägen och informerar webbappen om hur distributionen ska hanteras. - `type=zip`: Distribuera ett ZIP-paket genom att packa upp innehållet till `/home/site/wwwroot`. `target-path` parametern är valfri. - `type=war`: Distribuera ett WAR-paket. Som standard distribueras WAR-paketet till `/home/site/wwwroot/app.war`. Målsökvägen kan anges med `target-path`. - `type=jar`: Distribuera ett JAR-paket till `/home/site/wwwroot/app.jar`. Parametern `target-path` ignoreras - `type=ear`: Distribuera ett EAR-paket till `/home/site/wwwroot/app.ear`. Parametern `target-path` ignoreras - `type=lib`: Distribuera en JAR-biblioteksfil. Som standard distribueras filen till `/home/site/libs`. Målsökvägen kan anges med `target-path`. - `type=static`: Distribuera en statisk fil (till exempel ett skript). Som standard distribueras filen till `/home/site/wwwroot`. - `type=startup`: Distribuera ett skript som App Service automatiskt använder som startskript för din app. Som standard distribueras skriptet till `D:\home\site\scripts\<name-of-source>` för Windows och `home/site/wwwroot/startup.sh` för Linux. Målsökvägen kan anges med `target-path`.	Ja	String
`restart`	`true`\|`false`	Som standard startar API:et om appen efter distributionsåtgärden (`restart=true`). Om du vill distribuera flera artefakter förhindrar du omstarter av alla utom den slutliga distributionen genom att ange `restart=false`.	Nej	Booleskt
`clean`	`true`\|`false`	Anger om måldistributionen ska rensas (tas bort) innan artefakten distribueras där.	Nej	Booleskt
`ignorestack`	`true`\|`false`	Publicerings-API:et `WEBSITE_STACK` använder miljövariabeln för att välja säkra standardvärden beroende på webbplatsens språkstack. Om du ställer in den här parametern på `false` inaktiveras alla språkspecifika standardvärden.	Nej	Booleskt
`target-path`	En absolut sökväg	Den absoluta sökväg som artefakten ska distribueras till. Till exempel `"/home/site/deployments/tools/driver.jar"`, `"/home/site/scripts/helper.sh"`.	Nej	String

Nästa steg

Om du vill ha mer avancerade distributionsscenarier kan du prova att distribuera till Azure med Git. Git-baserad distribution till Azure möjliggör versionskontroll, paketåterställning, MSBuild med mera.

Dela via

Distribuera filer till App Service

Förutsättningar

Skapa ett projekt-ZIP-paket

Distribuera ett ZIP-paket

Med zip deploy UI i Kudu

Utan zip-distribution av användargränssnittet i Kudu

Aktivera byggautomatisering för zip-distribution

Distribuera WAR/JAR/EAR-paket

Distribuera enskilda filer

Distribuera ett startskript

Distribuera en biblioteksfil

Distribuera en statisk fil

Distribuera ett startskript

Distribuera en biblioteksfil

Distribuera en statisk fil

Distribuera till nätverksskyddade appar

Kudu publicera API-referens

Nästa steg

Fler resurser

Feedback

Ytterligare resurser