Bereitstellen von Dateien in App Service

Hinweis

Ab dem 1. Juni 2024 haben alle neu erstellten App Service-Apps die Möglichkeit, einen eindeutigen Standardhostnamen mit der Namenskonvention <app-name>-<random-hash>.<region>.azurewebsites.net zu erstellen. Vorhandene App-Namen bleiben unverändert.

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

Ausführlichere Informationen finden Sie unter Eindeutiger Standardhostname für App Service-Ressourcen.

In diesem Artikel erfahren Sie, wie Sie Ihren Code als ZIP-, WAR-, JAR- oder EAR-Paket für Azure App Service bereitstellen. Außerdem wird gezeigt, wie einzelne Dateien getrennt von Ihrem Anwendungspaket in App Service bereitgestellt werden.

Voraussetzungen

Um die Schritte in diesem Artikel durchzuführen, erstellen Sie eine App Service-App, oder verwenden Sie eine App, die Sie für ein anderes Tutorial erstellt haben.

Sollten Sie über kein Azure-Abonnement verfügen, können Sie zunächst ein kostenloses Azure-Konto erstellen.

Erstellen eines ZIP-Pakets für das Projekt

Wichtig

Schließen Sie beim Erstellen des ZIP-Pakets für die Bereitstellung nicht das Stammverzeichnis, sondern nur die darin enthaltenen Dateien und Verzeichnisse ein. Wenn Sie ein GitHub-Repository als ZIP-Datei herunterladen, können Sie diese Datei nicht unverändert in App Service bereitstellen. GitHub fügt auf der obersten Ebene zusätzliche geschachtelte Verzeichnisse hinzu, die nicht mit App Service funktionieren.

Navigieren Sie in einem lokalen Terminalfenster zum Stammverzeichnis Ihres App-Projekts.

Dieses Verzeichnis sollte die Eingabedatei für Ihre Web-App enthalten, z.B. index.html, index.php oder app.js. Sie kann auch Dateien zur Paketverwaltung enthalten, z.B. project.json, composer.json, package.json, bower.json oder requirements.txt.

Wenn Sie nicht möchten, dass App Service die Bereitstellungsautomatisierung für Sie ausführt, führen Sie alle Buildaufgaben (z. B. npm, bower, gulp, composer und pip) aus, und stellen Sie sicher, dass Sie über alle Dateien verfügen, die Sie zum Ausführen der App benötigen. Dieser Schritt ist erforderlich, wenn Sie Ihr Paket direkt ausführen möchten.

Erstellen Sie ein ZIP-Archiv mit allen Elementen Ihres Projekts. Bei dotnet-Projekten handelt es sich dabei um den gesamten Inhalt im Ausgabeverzeichnis des dotnet publish-Befehls (mit Ausnahme des Ausgabeverzeichnisses selbst). Führen Sie beispielsweise den folgenden Befehl in Ihrem Terminal aus, um ein ZIP-Paket mit dem Inhalt des aktuellen Verzeichnisses zu erstellen:

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

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

Bereitstellen eines ZIP-Pakets

Wenn Sie ein ZIP-Paket bereitstellen, entpackt App Service seinen Inhalt im Standardpfad für Ihre App (D:\home\site\wwwroot für Windows, /home/site/wwwroot für Linux).

Bei dieser Bereitstellung per ZIP-Paket wird der gleiche Kudu-Dienst verwendet, der auch bei der Continuous Integration-basierten Bereitstellungen zum Einsatz kommt. Kudu unterstützt die folgenden Funktionen für die Bereitstellung per ZIP-Paket:

• Löschen von Dateien aus einer vorherigen Bereitstellung
• Aktivieren des Standarderstellungsprozesses, der die Paketwiederherstellung umfasst
• Anpassen der Bereitstellung, einschließlich der Ausführung von Bereitstellungsskripts
• Bereitstellungsprotokolle
• Eine maximale Paketgröße von 2048 MB

Hinweis

Dateien im ZIP-Paket werden nur kopiert, wenn ihre Zeitstempel nicht mit dem übereinstimmen, was bereits bereitgestellt wurde.

Mit Benutzeroberfläche für ZIP-Bereitstellung in Kudu

Navigieren Sie im Browser zu https://<app_name>.scm.azurewebsites.net/ZipDeployUI (siehe Hinweis oben).

Laden Sie das unter Erstellen eines ZIP-Pakets für das Projekt erstellte ZIP-Paket hoch, indem Sie sie auf der Webseite in den Bereich für den Datei-Explorer ziehen.

Wenn die Bereitstellung gerade ausgeführt wird, zeigt ein Symbol in der oberen rechten Ecke den Status in Prozent an. Auf der Seite werden darüber hinaus unterhalb des Explorer-Bereichs ausführliche Meldungen für den Vorgang angezeigt. Wenn die Bereitstellung abgeschlossen ist, sollte die letzte Meldung Deployment successful lauten.

Der oben erwähnte Endpunkt funktioniert zurzeit nicht für App Services unter Linux. Verwenden Sie stattdessen FTP oder die ZIP Deploy-API.

Ohne Benutzeroberfläche für ZIP-Bereitstellung in Kudu

Azure-Befehlszeilenschnittstelle

Stellen Sie mithilfe des Befehls az webapp deploy ein ZIP-Paket für Ihre Web-App bereit. Der CLI-Befehl verwendet die Kudu-Veröffentlichungs-API zum Bereitstellen der Dateien und kann vollständig angepasst werden.

Im folgenden Beispiel wird ein ZIP-Paket an Ihre Website gepusht. Geben Sie den Pfad zu Ihrem lokalen ZIP-Paket für --src-path an.

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

Mit diesem Befehl wird die App nach der Bereitstellung des ZIP-Pakets neu gestartet.

Azure PowerShell

Im folgenden Beispiel wird das ZIP-Paket mit Publish-AzWebapp hochgeladen. Ersetzen Sie die Platzhalter <group-name>, <app-name> und <zip-package-path>.

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

Kudu-API

Im folgenden Beispiel wird das cURL-Tool verwendet, um eine ZIP-Datei bereitzustellen. Ersetzen Sie die Platzhalter <zip-package-path> und <app-name>. Wenn Sie die Standardauthentifizierung auswählen, geben Sie die Anmeldeinformationen für die Bereitstellung in <username> und <password> an.

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

Hinweis

Den vollqualifizierten Domänennamen, der in der URL verwendet werden soll, finden Sie im Hinweis oben

ARM-Vorlage

ARM-Vorlagen unterstützen nur Bereitstellungen aus remote gehosteten Paketen.

Aktivieren der Buildautomatisierung für die ZIP-Bereitstellung

Standardmäßig geht die Bereitstellungs-Engine davon aus, dass ein ZIP-Paket ohne weitere Maßnahmen ausführungsfähig ist, und führt deshalb auch keine Buildautomatisierung aus. Um dieselbe Buildautomatisierung wie bei einer Git-Bereitstellung zu aktivieren, legen Sie die App-Einstellung SCM_DO_BUILD_DURING_DEPLOYMENT fest, indem Sie in den folgenden Befehl in Cloud Shell ausführen:

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

Weitere Informationen finden Sie in der Kudu-Dokumentation.

Bereitstellen von WAR-/JAR-/EAR-Paketen

Sie können Ihr WAR-, JAR- oder EAR-Paket auf App Service bereitstellen, um Ihre Java-Web-App mithilfe der Azure CLI, PowerShell oder der Kudu-Veröffentlichungs-API auszuführen.

Der hier gezeigte Bereitstellungsprozess platziert das Paket unter Verwendung der richtigen Namenskonvention und Verzeichnisstruktur in der Inhaltsfreigabe der App (siehe Referenz zur Kudu-Veröffentlichungs-API) und stellt den empfohlenen Ansatz dar. Wenn Sie WAR/JAR/EAR-Pakete stattdessen über FTP oder WebDeploy bereitstellen, kann es aufgrund von Fehlern in der Namensgebung oder Struktur zu unbekannten Fehlern kommen.

Azure-Befehlszeilenschnittstelle

Stellen Sie mithilfe des Befehls az webapp deploy ein WAR-Paket für Tomcat oder JBoss EAP bereit. Geben Sie den Pfad zu Ihrem lokalen Java-Paket für --src-path an.

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

Der CLI-Befehl verwendet die Kudu-Veröffentlichungs-API zum Bereitstellen des Pakets und kann vollständig angepasst werden.

Azure PowerShell

Im folgenden Beispiel wird die .war-Datei mit Publish-AzWebapp hochgeladen. Ersetzen Sie die Platzhalter <group-name>, <app-name> und <package-path> (nur WAR- und JAR-Dateien werden in Azure PowerShell unterstützt).

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

Kudu-API

Im folgenden Beispiel wird das cURL-Tool verwendet, um eine .war-, .jar-, oder .ear-Datei bereitzustellen. Ersetzen Sie die Platzhalter <file-path>, <app-name>, <package-type> (jeweils war, jar oder ear). Wenn Sie die Standardauthentifizierung auswählen, geben Sie die Anmeldeinformationen für die Bereitstellung in <username> und <password> an.

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

Hinweis

Den vollqualifizierten Domänennamen, der in der URL verwendet werden soll, finden Sie im Hinweis oben

Weitere Informationen finden Sie in der Referenz zur Kudu-Veröffentlichungs-API.

ARM-Vorlage

ARM-Vorlagen unterstützen nur Bereitstellungen aus remote gehosteten Paketen.

Bereitstellen einzelner Dateien

Azure-Befehlszeilenschnittstelle

Stellen Sie ein Startskript, eine Bibliothek und eine statische Datei in Ihrer Web-App bereit, indem Sie den Befehl az webapp deploy mit dem --type-Parameter verwenden.

Wenn Sie ein Startskript auf diese Weise bereitstellen, verwendet App Service automatisch Ihr Skript, um Ihre App zu starten.

Der CLI-Befehl verwendet die Kudu-Veröffentlichungs-API zum Bereitstellen der Dateien und kann vollständig angepasst werden.

Bereitstellen eines Startskripts

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

Bereitstellen einer Bibliotheksdatei

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

Bereitstellen einer statischen Datei

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

Azure PowerShell

Wird nicht unterstützt. Weitere Informationen finden Sie unter Azure CLI- oder Kudu-API.

Kudu-API

Bereitstellen eines Startskripts

Im folgenden Beispiel wird das cURL-Tool verwendet, um eine Startdatei für die Anwendung bereitzustellen. Ersetzen Sie die Platzhalter <startup-file-path> und <app-name>. Wenn Sie die Standardauthentifizierung auswählen, geben Sie die Anmeldeinformationen für die Bereitstellung in <username> und <password> an.

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

Hinweis

Den vollqualifizierten Domänennamen, der in der URL verwendet werden soll, finden Sie im Hinweis oben

Bereitstellen einer Bibliotheksdatei

Im folgenden Beispiel wird das cURL-Tool verwendet, um eine Bibliotheksdatei für die Anwendung bereitzustellen. Ersetzen Sie die Platzhalter <lib-file-path> und <app-name>. Wenn Sie die Standardauthentifizierung auswählen, geben Sie die Anmeldeinformationen für die Bereitstellung in <username> und <password> an.

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

Hinweis

Den vollqualifizierten Domänennamen, der in der URL verwendet werden soll, finden Sie im Hinweis oben

Bereitstellen einer statischen Datei

Im folgenden Beispiel wird das cURL-Tool verwendet, um eine Konfigurationsdatei für die Anwendung bereitzustellen. Ersetzen Sie die Platzhalter <config-file-path> und <app-name>. Wenn Sie die Standardauthentifizierung auswählen, geben Sie die Anmeldeinformationen für die Bereitstellung in <username> und <password> an.

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

Hinweis

Den vollqualifizierten Domänennamen, der in der URL verwendet werden soll, finden Sie im Hinweis oben

ARM-Vorlage

ARM-Vorlagen unterstützen nur Bereitstellungen aus remote gehosteten Paketen.

Bereitstellen in netzwerkgeschützten Apps

Je nach Netzwerkkonfiguration Ihrer Web-App kann der direkte Zugriff auf die App über Ihre Entwicklungsumgebung blockiert werden (siehe Bereitstellen an netzwerkgeschützten Standorten und Bereitstellen an netzwerkgeschützten Standorten, Teil 2). Anstatt das Paket oder die Datei direkt an die Web-App zu pushen, können Sie es bzw. sie in einem über die Web-App zugänglichen Speichersystem veröffentlichen und die App auslösen, um die ZIP-Datei aus dem Speicherort zu pullen.

Die Remote-URL kann ein beliebiger öffentlich zugänglicher Speicherort sein, aber es ist am besten, einen Blobspeichercontainer mit einem SAS-Schlüssel zu verwenden, um ihn zu schützen.

Azure-Befehlszeilenschnittstelle

Verwenden Sie den Befehl az webapp deploy wie in den anderen Abschnitten, verwenden Sie jedoch --src-url anstelle von --src-path. Im folgenden Beispiel wird der --src-url-Parameter verwendet, um die URL einer ZIP-Datei anzugeben, die in einem Azure Storage-Konto gehostet wird.

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

Wird nicht unterstützt. Siehe Azure CLI-, Kudu-API oder ARM-Vorlage.

Kudu-API

Rufen Sie die Kudu-Veröffentlichungs-API wie in den anderen Abschnitten auf, übergeben Sie jedoch ein JSON-Objekt mit packageUri im Anforderungstext anstatt eine Datei hochzuladen. Im folgenden Beispiel wird diese Methode verwendet, um die URL einer ZIP-Datei anzugeben, die in einem Azure Storage-Konto gehostet wird. Beachten Sie, dass der Typ weiterhin als Abfragezeichenfolge angegeben wird. Wenn Sie die Standardauthentifizierung auswählen, geben Sie die Anmeldeinformationen für die Bereitstellung in <username> und <password> an.

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

Hinweis

Den vollqualifizierten Domänennamen, der in der URL verwendet werden soll, finden Sie im Hinweis oben

ARM-Vorlage

Fügen Sie Ihrer ARM-Vorlage den folgenden JSON-Code hinzu. Ersetzen Sie den Platzhalter <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>"
    }
}

Orientieren Sie sich bei der Konfiguration der Eigenschaften an der folgenden Referenz:

Eigenschaft	Beschreibung	Erforderlich
packageUri	Der URI des Pakets oder der Datei. Weitere Informationen finden Sie unter Microsoft.Web sites/extensions „onedeploy“.	Ja
type	Siehe type-Parameter in der Referenz zur Kudu-Veröffentlichungs-API.	Ja
path	Siehe target-path-Parameter in der Referenz zur Kudu-Veröffentlichungs-API.	Nein

Referenz zur Kudu-Veröffentlichungs-API

Mit der publish Kudu-API können Sie die gleichen Parameter aus dem CLI-Befehl wie URL-Abfrageparameter angeben. Zur Authentifizierung bei der Kudu-REST-API wird am besten die Tokenauthentifizierung verwendet. Sie können aber auch die Standardauthentifizierung mit den Anmeldeinformationen für die Bereitstellung Ihrer App verwenden.

Die folgende Tabelle zeigt die verfügbaren Abfrageparameter, ihre zulässigen Werte und Beschreibungen.

Schlüssel	Zulässige Werte	BESCHREIBUNG	Erforderlich	type
type	war|jar|ear|lib|startup|static|zip	Der Typ des bereitgestellten Artefakts. Dadurch wird der Standardzielpfad festgelegt, und die Web-App wird darüber informiert, wie die Bereitstellung behandelt werden soll. - type=zip: Bereitstellen eines ZIP-Pakets durch Entzippen des Inhalts in /home/site/wwwroot Der Parameter target-path ist optional. - type=war: Bereitstellen eines WAR-Pakets Standardmäßig wird das WAR-Paket in /home/site/wwwroot/app.war bereitgestellt. Der Zielpfad kann mit target-path angegeben werden. - type=jar: Bereitstellen eines JAR-Pakets in /home/site/wwwroot/app.jar Der target-path-Parameter wird ignoriert. - type=ear: Bereitstellen eines EAR-Pakets in /home/site/wwwroot/app.ear Der target-path-Parameter wird ignoriert. - type=lib: Bereitstellen einer JAR-Bibliotheksdatei Standardmäßig wird die Datei in /home/site/libs bereitgestellt. Der Zielpfad kann mit target-path angegeben werden. - type=static: Bereitstellen einer statischen Datei (z. B. eines Skripts). Standardmäßig wird die Datei in /home/site/wwwroot bereitgestellt. - type=startup: Stellen Sie ein Skript bereit, das App Service automatisch als Startskript für Ihre App verwendet. Standardmäßig wird das Skript in D:\home\site\scripts\<name-of-source> für Windows und home/site/wwwroot/startup.sh für Linux bereitgestellt. Der Zielpfad kann mit target-path angegeben werden.	Ja	String
restart	true|false	Standardmäßig startet die API die App nach dem Bereitstellungsvorgang (restart=true) neu. Um mehrere Artefakte bereitzustellen, verhindern Sie Neustarts für alle bis auf die endgültige Bereitstellung, indem Sie restart=false festlegen.	Nein	Boolean
clean	true|false	Gibt an, ob die Zielbereitstellung bereinigt (gelöscht) werden soll, bevor das Artefakt dort bereitgestellt wird	Nein	Boolean
ignorestack	true|false	Die Veröffentlichungs-API verwendet die Umgebungsvariable WEBSITE_STACK, um je nach Sprachstapel Ihrer Website sichere Standardwerte zu wählen. Wenn Sie diesen Parameter auf false festlegen, werden alle sprachspezifischen Standardwerte deaktiviert.	Nein	Boolean
target-path	Ein absoluter Pfad	Der absolute Pfad, in dem das Artefakt bereitgestellt werden soll Platzhalter in einer derartigen Schreibweise sind z.B. "/home/site/deployments/tools/driver.jar" und "/home/site/scripts/helper.sh".	Nein	String

Nächste Schritte

Für komplexere Bereitstellungsszenarien versuchen Sie die Bereitstellung in Azure mit Git. Die Git-basierte Bereitstellung in Azure ermöglicht Versionskontrolle, Paketwiederherstellung, MSBuild und mehr.

Weitere Ressourcen

• Kudu: Bereitstellen aus einer ZIP-Datei
• Referenz zu Umgebungsvariablen und App-Einstellungen