Distribuera filer till App Service

Anteckning

Från och med den 1 juni 2024 kan nyligen skapade App Service-appar generera ett unikt standardvärdnamn som använder namngivningskonventionen <app-name>-<random-hash>.<region>.azurewebsites.net. Befintliga appnamn förblir oförändrade. Till 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. Inkludera endast filer och kataloger i rotkatalogen. 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 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, npmtill exempel , bower, gulp, composeroch pip. Kontrollera 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 lägger du till allt i kommandots dotnet publish utdatakatalog, exklusive själva utdatakatalogen. Följande kommando i terminalen för att skapa ett ZIP-paket med innehållet i den aktuella katalogen:

Windows Command Prompt

# 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 megabyte.

Anteckning

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. För appnamnet, se anteckningen ö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 säga Att distributionen lyckades.

Den här slutpunkten 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

Azure CLI

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.

Azure CLI

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.

Azure PowerShell

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

Azure PowerShell

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

Kudu API

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< användarnamn> och <lösenord>.

Bash

# 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"

Anteckning

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

ARM-mall

ARM-mallar stöder endast distributioner från fjärranslutna paket.

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:

Azure CLI

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. Mer information finns i Kudu publicera API-referens. Vi rekommenderar den här 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.

Azure CLI

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.

Azure CLI

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.

Azure PowerShell

I följande exempel används Publish-AzWebapp för att ladda upp WAR-filen. Ersätt platshållarna gruppnamn>,< appnamn> och< paketsökväg>.< Azure PowerShell stöder endast WAR- och JAR-filer.

PowerShell

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

Kudu API

I följande exempel används cURL-verktyget för att distribuera en WAR-, JAR- eller EAR-fil. Ersätt platshållarna filsökväg>,< appnamn> och< pakettyp> (war, jareller ).ear< Om du väljer grundläggande autentisering anger du autentiseringsuppgifterna för distributionen i< användarnamn> och <lösenord>.

Bash

# 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>"

Anteckning

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.

ARM-mall

ARM-mallar stöder endast distributioner från fjärranslutna paket.

Distribuera enskilda filer

Azure CLI

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. Kommandot kan anpassas helt.

Distribuera ett startskript

Azure CLI

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

Distribuera en biblioteksfil

Azure CLI

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

Distribuera en statisk fil

Azure CLI

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

Azure PowerShell

Stöds ej. Se Azure CLI eller Kudu API.

Kudu API

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< användarnamn> och <lösenord>.

Bash

# 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"

Anteckning

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< användarnamn> och <lösenord>.

Bash

# 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"

Anteckning

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< användarnamn> och <lösenord>.

Bash

# 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"

Anteckning

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

ARM-mall

ARM-mallar stöder endast distributioner från fjärranslutna paket.

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.

Azure CLI

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.

Azure CLI

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

Azure PowerShell

Stöds ej. Se Azure CLI, Kudu API eller ARM-mall.

Kudu API

Anropa Kudu-publicerings-API:et på samma sätt som i de andra avsnitten. I stället för att ladda upp en fil skickar du 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. Typen anges fortfarande som en frågesträng. Om du väljer grundläggande autentisering anger du autentiseringsuppgifterna för distributionen i< användarnamn> och <lösenord>.

Bash

# 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"

Anteckning

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

ARM-mall

Lägg till följande JSON i ARM-mallen. Ersätt platshållarappens <namn>.

JSON

{
    "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 rekommenderar vi 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

Relaterat innehåll

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.

• Kudu: Distribuera från en zip-fil
• Referens för miljövariabler och appinställningar