Konfigurieren einer App Service-App

In diesem Artikel wird erläutert, wie Allgemeine Einstellungen für Web-Apps, ein mobiles Back-End oder eine API-App konfiguriert werden. Informationen zu Azure Functions finden Sie unter Referenz zu App-Einstellungen für Azure Functions.

Konfigurieren von App-Einstellungen

In Azure App Service sind App-Einstellungen Variablen, die als Umgebungsvariablen an den Anwendungscode übergeben werden. Die folgenden Bedingungen gelten für App-Einstellungen:

• App-Einstellungsnamen dürfen nur Buchstaben, Zahlen (0-9), Punkte (.) und Unterstriche (_) enthalten.
• Sonderzeichen im Wert einer App-Einstellung müssen je nach Anforderungen des Zielbetriebssystems mit Escapezeichen versehen werden.

Um beispielsweise eine Umgebungsvariable in App Service für Linux mit dem Wert "pa$$w0rd\"festzulegen, sollte die Zeichenfolge für die App-Einstellung sein "pa\$\$w0rd\\".

Bei Linux-Apps und benutzerdefinierten Containern übergibt App Service App-Einstellungen an den Container, indem das --env Flag verwendet wird, um die Umgebungsvariable im Container festzulegen. In beiden Fällen werden sie beim Start der App in Ihre App-Umgebung eingeschleust. Wenn Sie App-Einstellungen hinzufügen, entfernen oder bearbeiten, löst App Service einen App-Neustart aus.

Für ASP.NET und ASP.NET Core-Entwickler ist das Konfigurieren von App-Einstellungen in App Service wie das Konfigurieren in <appSettings>Web.config oder appsettings.json. Die Werte in App Service überschreiben die Werte in Web.config oder appsettings.json. Entwicklungseinstellungen wie das lokale MySQL-Kennwort können Sie in Web.config oder appsettings.json speichern. Sie können Produktionsgeheimnisse wie das Azure MySQL-Datenbankkennwort sicher in App Service speichern. Derselbe Code verwendet ihre Entwicklungseinstellungen, wenn Sie lokal debuggen. Sie verwendet Ihre Produktionsgeheimnisse, wenn Sie sie in Azure bereitstellen.

Andere Programmiersprachen-Stacks erhalten die App-Einstellungen als Umgebungsvariablen zur Laufzeit. Schritte, die für jeden Sprachstapel spezifisch sind, finden Sie unter:

• ASP.NET Core
• Java
• Node.js
• Python
• PHP
• Benutzerdefinierte Container

App-Einstellungen werden immer verschlüsselt, wenn sie gespeichert werden (im Ruhezustand verschlüsselt).

Hinweis

Wenn Sie geheime Schlüssel in App-Einstellungen speichern, sollten Sie Azure Key Vault-Verweise verwenden. Wenn Ihre geheimen Schlüssel für die Konnektivität mit Back-End-Ressourcen vorgesehen sind, sollten Sie Konnektivitätsoptionen in Betracht ziehen, die sicherer sind und keine geheimen Schlüssel erfordern. Weitere Informationen finden Sie unter Sichere Konnektivität mit Azure-Diensten und -Datenbanken aus Azure App Service.

Azure-Portal

1. Suchen Sie im Azure-Portal die Option App Services, wählen Sie sie aus, und wählen Sie anschließend Ihre App aus.

2. Wählen Sie im linken Menü der App "Einstellungsumgebungsvariablen> aus. Wählen Sie dann "App-Einstellungen" aus.

   

   Standardmäßig werden Werte für App-Einstellungen aus Sicherheitsgründen im Portal ausgeblendet. Um einen ausgeblendeten Wert einer App-Einstellung anzuzeigen, wählen Sie unter "Wert" die Option "Wert anzeigen" aus. Um die ausgeblendeten Werte aller App-Einstellungen anzuzeigen, wählen Sie "Werte anzeigen" aus.

   Hinweis

   Lese-/Schreibberechtigungen für Benutzer sind erforderlich, um diesen Abschnitt im Azure-Portal anzuzeigen. Integrierte RBAC-Rollen mit ausreichenden Berechtigungen sind Eigentum, Mitwirkende und Webseiten-Beitragende. Die Rolle "Leser" allein würde nicht auf diese Seite zugreifen dürfen.

3. Um eine neue App-Einstellung hinzuzufügen, wählen Sie Hinzufügen aus. Um eine Einstellung zu bearbeiten, wählen Sie die Einstellung aus.

4. Im Dialogfeld können Sie die Einstellung im aktuellen Slot beibehalten.

   Hinweis

   In einem Standardmäßigen Linux-App-Dienst oder einem benutzerdefinierten Linux-Container muss jede geschachtelte JSON-Schlüsselstruktur im App-Einstellungsnamen für den Schlüsselnamen anders konfiguriert werden. Ersetzen Sie einen beliebigen Doppelpunkt (:) durch einen doppelten Unterstrich (__). Ersetzen Sie Punkte (.) durch einen einzelnen Unterstrich (_). Zum Beispiel muss ApplicationInsights:InstrumentationKey im App Service als ApplicationInsights__InstrumentationKey für den Schlüsselnamen konfiguriert werden.

5. Wählen Sie nach Abschluss die Option Anwenden aus. Wählen Sie dann auf der Seite Umgebungsvariablen die Option Übernehmen aus.

Azure-Befehlszeilenschnittstelle

Mithilfe von az webapp config app settings set können Sie eine App-Einstellung hinzufügen oder bearbeiten:

az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings <setting-name>="<value>"

Ersetzen Sie <setting-name> durch den Namen der Einstellung. Ersetzen Sie den <value> Wert durch den Wert, der der Einstellung zugewiesen werden soll.

Zeigen Sie alle Einstellungen und deren Werte mithilfe der Az webapp config appsettings-Liste an:

az webapp config appsettings list --resource-group <group-name> --name <app-name>

Entfernen Sie eine oder mehrere Einstellungen, indem Sie die App-Einstellungen von az webapp config löschen:

az webapp config appsettings delete --resource-group <group-name> --name <app-name> --setting-names {<setting-name1>,<setting-name2>,...}

Azure PowerShell

Legen Sie eine oder mehrere App-Einstellungen mithilfe von Set-AzWebApp fest:

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -AppSettings @{"<setting-name1>"="<value1>"; "<setting-name2>"="<value2>";...}

Dieses Cmdlet ersetzt den gesamten Satz von App-Einstellungen durch die von Ihnen angegebenen Einstellungen. Um eine App-Einstellung innerhalb einer vorhandenen Gruppe hinzuzufügen oder zu bearbeiten, fügen Sie die vorhandenen App-Einstellungen in die Eingabehashtabelle ein, indem Sie das Cmdlet "Get-AzWebApp " verwenden. Zum Beispiel:

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy app settings to a new hash table
$appSettings = @{}
ForEach ($item in $webapp.SiteConfig.AppSettings) {
$appSettings[$item.Name] = $item.Value
}

# Add or edit one or more app settings
$appSettings['<setting-name1>'] = '<value1>'
$appSettings['<setting-name2>'] = '<value2>'

# Save changes
Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -AppSettings $appSettings

Verwenden Sie Get-AzWebAppSlotConfigName, um zu überprüfen, ob eine App-Einstellung slot-spezifisch ist:

Get-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> | select AppSettingNames

Verwenden Sie Set-AzWebAppSlotConfigName, um eine oder mehrere App-Einstellungen slotspezifisch zu machen:

Set-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> -AppSettingNames <setting-name1>,<setting-name2>,...

Massenbearbeiten von App-Einstellungen

Azure-Portal

1. Wählen Sie "Erweitert bearbeiten" aus.
2. Bearbeiten Sie die Einstellungen im Textbereich.
3. Wenn Sie fertig sind, klicken Sie auf OK. Wählen Sie dann auf der Seite Umgebungsvariablen die Option Übernehmen aus.

App-Einstellungen haben folgende JSON-Formatierung:

[
  {
    "name": "<key-1>",
    "value": "<value-1>",
    "slotSetting": false
  },
  {
    "name": "<key-2>",
    "value": "<value-2>",
    "slotSetting": false
  },
  ...
]

Azure-Befehlszeilenschnittstelle

Führen Sie az webapp config app settings set mit dem Namen der JSON-Datei aus:

az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings "@fileName.json"

Tipp

Das Umschließen des Dateinamens mit Anführungszeichen ist nur in PowerShell erforderlich.

Das erforderliche Dateiformat ist ein JSON-Array mit Einstellungen, bei denen das Feld für die Sloteinstellung optional ist. Zum Beispiel:

[
  {
    "name": "key1",
    "slotSetting": false,
    "value": "value1"
  },
  {
    "name": "key2",
    "value": "value2"
  }
]

Aus Gründen der Einfachheit können Sie vorhandene Einstellungen in einer JSON-Datei speichern, indem Sie az webapp config appsettings list verwenden.

# Save the settings
az webapp config appsettings list --resource-group <group-name> --name <app-name>  > settings.json

# Edit the JSON file
...

# Update the app with the JSON file
az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings @settings.json

Azure PowerShell

Es ist nicht möglich, App-Einstellungen in Massen zu bearbeiten, indem Sie eine JSON-Datei mit Azure PowerShell verwenden.

Konfigurieren von Verbindungszeichenfolgen

In diesem Abschnitt wird beschrieben, wie Verbindungszeichenfolgen konfiguriert werden.

Hinweis

Erwägen Sie Konnektivitätsoptionen, die sicherer sind und keine Verbindungsschlüssel erfordern. Weitere Informationen finden Sie unter Sichere Konnektivität mit Azure-Diensten und -Datenbanken aus Azure App Service.

Für ASP.NET- und ASP.NET Core-Entwickler ist das Festlegen von Verbindungszeichenfolgen im App Service so, als ob es im <connectionStrings> in Web.config geschehen würde. Die Werte, die Sie in App Service festlegen, überschreiben die Werte in Web.config. Sie können Entwicklungseinstellungen, wie z. B. eine Datenbankdatei, in Web.config beibehalten. Sie können Produktionsgeheimnisse, z. B. SQL-Datenbankanmeldeinformationen, sicher in App Service aufbewahren. Derselbe Code verwendet ihre Entwicklungseinstellungen, wenn Sie lokal debuggen. Sie verwendet Ihre Produktionsgeheimnisse, wenn Sie sie in Azure bereitstellen.

Für andere Sprachstapel ist es besser, stattdessen App-Einstellungen zu verwenden. Verbindungszeichenfolgen erfordern eine spezielle Formatierung in den Variablenschlüsseln, um auf die Werte zuzugreifen.

Es gibt einen Fall, in dem Sie Verbindungszeichenfolgen anstelle von App-Einstellungen für non-.NET Sprachen verwenden möchten. Bestimmte Azure-Datenbanktypen werden zusammen mit der App nur gesichert, wenn Sie eine Verbindungszeichenfolge für die Datenbank in Ihrer App Service-App konfigurieren. Weitere Informationen finden Sie unter Erstellen eines benutzerdefinierten Backups. Wenn Sie diese automatisierte Sicherung nicht benötigen, verwenden Sie App-Einstellungen.

Zur Laufzeit stehen Verbindungszeichenfolgen als Umgebungsvariablen zur Verfügung, wobei sie mit Präfixen für die folgenden Verbindungstypen versehen werden:

• SQL Server: SQLCONNSTR_
• MySQL: MYSQLCONNSTR_
• Azure SQL: SQLAZURECONNSTR_
• Benutzerdefiniert: CUSTOMCONNSTR_
• PostgreSQL: POSTGRESQLCONNSTR_
• Azure Notification Hubs: NOTIFICATIONHUBCONNSTR_
• Azure Service Bus: SERVICEBUSCONNSTR_
• Azure Event Hubs: EVENTHUBCONNSTR_
• Azure Cosmos DB: DOCDBCONNSTR_
• Redis Cache: REDISCACHECONNSTR_

Hinweis

.NET-Apps, die PostgreSQL, Notification Hubs, Service Bus, Event Hubs, Azure Cosmos DB und Redis Cache verwenden, sollten als Workaround für ein bekanntes Problem im .NET EnvironmentVariablesConfigurationProvider die Verbindungszeichenfolge auf Custom festlegen.

Wenn beispielsweise eine MySQL-Verbindungszeichenfolge connectionstring1 heißt, kann sie über die Umgebungsvariable MYSQLCONNSTR_connectionString1 aufgerufen werden. Schritte, die für jeden Sprachstapel spezifisch sind, finden Sie unter:

• ASP.NET Core
• Java
• Node.js
• Python
• PHP
• Benutzerdefinierte Container

Verbindungszeichenfolgen sind beim Speichern immer verschlüsselt (verschlüsselt im Ruhezustand).

Hinweis

Sie können auch Verbindungszeichenfolgen aus Key Vault mithilfe von Key Vault-Verweisen auflösen.

Azure-Portal

1. Suchen Sie im Azure-Portal die Option App Services, wählen Sie sie aus, und wählen Sie anschließend Ihre App aus.

2. Wählen Sie im linken Menü der App "Einstellungsumgebungsvariablen> aus. Wählen Sie dann Verbindungszeichenfolgen aus.

   Standardmäßig werden Werte für Verbindungszeichenfolgen aus Sicherheitsgründen im Portal ausgeblendet. Um einen ausgeblendeten Wert einer Verbindungszeichenfolge anzuzeigen, wählen Sie unter "Wert" die Option "Wert anzeigen" aus. Um die ausgeblendeten Werte aller Verbindungszeichenfolgen anzuzeigen, wählen Sie "Werte anzeigen" aus.

3. Um eine neue Verbindungszeichenfolge hinzuzufügen, wählen Sie Hinzufügen aus. Zum Bearbeiten einer Verbindungszeichenfolge wählen Sie die Verbindungszeichenfolge aus.

4. Im Dialogfeld können Sie die Verbindungszeichenfolge im aktuellen Slot beibehalten.

5. Wählen Sie nach Abschluss die Option Anwenden aus. Wählen Sie dann auf der Seite Umgebungsvariablen die Option Übernehmen aus.

Azure-Befehlszeilenschnittstelle

Verwenden Sie az webapp config connection-string set, um eine App-Einstellung hinzuzufügen oder zu bearbeiten:

az webapp config connection-string set --resource-group <group-name> --name <app-name> --connection-string-type <type> --settings <string-name>='<value>'

Ersetzen Sie <string-name> durch den Namen der Verbindungszeichenfolge. Ersetzen Sie den <value> Wert durch den Wert, der der Verbindungszeichenfolge zugewiesen werden soll. Für mögliche Werte von <type>, wie zum Beispiel SQLAzure, siehe die CLI-Befehlsdokumentation.

Zeigen Sie alle Verbindungszeichenfolgen und deren Werte mithilfe der Az webapp config verbindungszeichenfolgenliste an:

az webapp config connection-string list --resource-group <group-name> --name <app-name>

Entfernen Sie eine oder mehrere Verbindungszeichenfolgen mithilfe von az webapp config connection-string delete:

az webapp config connection-string delete --resource-group <group-name>  --name <app-name>--setting-names {<string-name1>,<string-name2>,...}

Azure PowerShell

Legen Sie eine oder mehrere Verbindungszeichenfolgen mithilfe von Set-AzWebApp fest:

$PropertiesObject = @{
  "<string-name1>" = @{
    value="<connection-string1>";
    type="<type>"};
  "<string-name2>" = @{
    value="<connection-string2>";
    type="<type>"}
}

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -ConnectionStrings $PropertiesObject

Jede Verbindungszeichenfolge enthält einen Namen (<string-name1>), einen Wert (<connection-string1>) und den Typ. Der Typ ist ein numerischer Wert, der einem der ConnectionStringType-Enumerationsfelder entspricht. Geben Sie type="2"z. B. für Azure SQL an.

Dieses Cmdlet ersetzt den gesamten Satz von Verbindungszeichenfolgen durch die von Ihnen angegebenen. Um eine App-Einstellung innerhalb einer vorhandenen Gruppe hinzuzufügen oder zu bearbeiten, fügen Sie die vorhandenen App-Einstellungen in die Eingabehashtabelle ein, indem Sie das Cmdlet "Get-AzWebApp " verwenden. Zum Beispiel:

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy connection strings to a new hash table
$connStrings = @{}
ForEach ($item in $webapp.SiteConfig.ConnectionStrings) {
    $connStrings[$item.Name] = @{value=$item.ConnectionString; type=$item.Type.ToString()}
}

# Add or edit one or more connection strings
$connStrings['<string-name1>'] = @{value='<connection-string1>'; type='<type>'}
$connStrings['<string-name2>'] = @{value='<connection-string2>'; type='<type>'}

# Save changes
Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -ConnectionStrings $connStrings

Verwenden Sie Get-AzWebAppSlotConfigName, um zu überprüfen, ob eine Verbindungszeichenfolge slotspezifisch ist.

Get-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> | select ConnectionStringNames

Verwenden Sie Set-AzWebAppSlotConfigName, um eine oder mehrere Verbindungszeichenfolgen slot-spezifisch zu machen:

Set-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> -ConnectionStringNames <string-name1>,<string-name2>,...

Massenbearbeitung von Verbindungszeichenfolgen

Azure-Portal

1. Wählen Sie "Erweitert bearbeiten" aus.
2. Bearbeiten Sie die Verbindungszeichenfolgen im Textbereich.
3. Wählen Sie nach Abschluss die Option Anwenden aus. Vergessen Sie nicht, auf der Seite Umgebungsvariablen die Option Anwenden auszuwählen.

Verbindungszeichenfolgen haben folgende JSON-Formatierung:

[
  {
    "name": "name-1",
    "value": "conn-string-1",
    "type": "SQLServer",
    "slotSetting": false
  },
  {
    "name": "name-2",
    "value": "conn-string-2",
    "type": "PostgreSQL",
    "slotSetting": false
  },
  ...
]

Azure-Befehlszeilenschnittstelle

Führen Sie az webapp config connection-string set mit dem Namen der JSON-Datei aus.

az webapp config connection-string set --resource-group <group-name> --name <app-name> --settings "@fileName.json"

Tipp

Das Umschließen des Dateinamens mit Anführungszeichen ist nur in PowerShell erforderlich.

Das erforderliche Dateiformat ist ein JSON-Array von Verbindungszeichenfolgen, bei dem das Feld für die Sloteinstellung optional ist. Zum Beispiel:

[
  {
    "name": "name-1",
    "value": "conn-string-1",
    "type": "SQLServer",
    "slotSetting": false
  },
  {
    "name": "name-2",
    "value": "conn-string-2",
    "type": "PostgreSQL",
  },
  ...
]

Aus Gründen der Einfachheit können Sie vorhandene Verbindungszeichenfolgen in einer JSON-Datei speichern, indem Sie die Verbindungszeichenfolgenliste az webapp config verwenden.

# Save the connection strings
az webapp config connection-string list --resource-group <group-name> --name <app-name> > settings.json

# Edit the JSON file
...

# Update the app with the JSON file
az webapp config connection-string set --resource-group <group-name> --name <app-name> --settings @settings.json

Azure PowerShell

Es ist nicht möglich, Verbindungszeichenfolgen in Massen zu bearbeiten, indem Sie eine JSON-Datei mit Azure PowerShell verwenden.

Konfigurieren von Sprachstapeleinstellungen

Informationen zum Konfigurieren von Sprachstapeleinstellungen finden Sie in den folgenden Ressourcen:

• ASP.NET Core
• Java
• Node.js
• Python
• PHP

Konfigurieren allgemeiner Einstellungen

Führen Sie die Schritte für Ihre bevorzugten Tools aus, um allgemeine Einstellungen zu konfigurieren.

Azure-Portal

1. Suchen Sie im Azure-Portal die Option App Services, wählen Sie sie aus, und wählen Sie anschließend Ihre App aus.

2. Wählen Sie im linken Menü der App die Option "Einstellungenkonfiguration"> aus. Wählen Sie dann "Allgemeine Einstellungen" aus.

   

Hier können Sie einige allgemeine Einstellungen für die App konfigurieren. Einige Einstellungen erfordern das Hochskalieren auf höhere Tarife.

• Stapeinstellungen: Konfigurieren Sie Einstellungen für den Software-Stack, um die App auszuführen, einschließlich der Sprach- und SDK-Versionen.

  Für Linux-Apps können Sie die Sprachlaufzeitversion auswählen und einen optionalen Startbefehl festlegen.

• Plattformeinstellungen: Konfigurieren von Einstellungen für die Hostingplattform, einschließlich:

  • Plattform: Wählen Sie 32-Bit oder 64-Bit aus. Nur für Windows-Apps.

  • FTP-Zustand: Nur FTPS zulassen oder FTP vollständig deaktivieren.

  • HTTP-Version: Legen Sie auf 2.0 fest, um die Unterstützung für das HTTPS/2-Protokoll zu aktivieren.

    Hinweis

    Die meisten modernen Browser unterstützen nur das HTTP/2-Protokoll über TLS. Unverschlüsselter Datenverkehr verwendet weiterhin HTTP/1.1. Um sicherzustellen, dass Clientbrowser eine Verbindung mit Ihrer App mit HTTP/2 herstellen, sichern Sie Ihren benutzerdefinierten DNS-Namen. Weitere Informationen finden Sie unter Bereitstellen von Sicherheit für einen benutzerdefinierten DNS-Namen mit einer TLS/SSL-Bindung in App Service.

  • Websockets: Konfigurieren Sie z. B. ASP.NET SignalR oder socket.io.

  • Always On: Aktivieren Sie diese Funktion, wenn Sie die App geladen halten möchten, auch wenn kein Datenverkehr besteht.

    Wenn Always On deaktiviert ist (Standardeinstellung), wird die App nach 20 Minuten ohne eingehende Anforderungen entladen. Die entladene App kann aufgrund ihrer Aufwärmzeit zu hoher Latenz für neue Anforderungen führen.

    Wenn Always On aktiviert ist, sendet der Front-End-Lastenausgleich alle fünf Minuten eine GET Anforderung an den Anwendungsstamm. Der fortlaufende Ping verhindert, dass die App entladen wird.

    Always On ist für fortlaufende WebJobs oder für WebJobs erforderlich, die ein cron-Ausdruck auslöst.

  • Sitzungsaffinität: Stellen Sie bei einer Bereitstellung mit mehreren Instanzen sicher, dass der Client für die Lebensdauer der Sitzung an dieselbe Instanz weitergeleitet wird. Sie können diese Option für zustandslose Anwendungen auf Aus festlegen.

  • Proxy für Sitzungsaffinität: Aktivieren Sie diesen Proxy, wenn sich Ihre App hinter einem Reverseproxy (z. B. Azure Application Gateway oder Azure Front Door) befindet und Sie den Standardhostnamen verwenden. Die Domäne des Sitzungsaffinitäts-Cookies entspricht dem weitergeleiteten Hostnamen vom Reverse-Proxy.

  • Nur HTTPS: Aktivieren Sie, wenn Sie den gesamten HTTP-Datenverkehr zu HTTPS umleiten möchten.

  • Minimale TLS-Version: Wählen Sie die mindest erforderliche TLS-Verschlüsselungsversion aus.

• Debuggen: Aktivieren Sie das Remotedebuggen für ASP.NET-, ASP.NET Core- oder Node.js-Apps. Diese Option wird nach 48 Stunden automatisch deaktiviert.

• Eingehende Clientzertifikate: erforderliche Clientzertifikate bei gegenseitiger Authentifizierung.

Azure-Befehlszeilenschnittstelle

Sie können viele der gängigen konfigurierbaren Optionen festlegen, indem Sie az webapp config set verwenden. Das folgende Beispiel zeigt eine Teilmenge der konfigurierbaren Optionen:

az webapp config set --resource-group <group-name> --name <app-name>  --use-32bit-worker-process [true|false] --web-sockets-enabled [true|false] --always-on [true|false]--http20-enabled --auto-heal-enabled [true|false] --remote-debugging-enabled [true|false] --number-of-workers

Verwenden Sie zum Anzeigen der vorhandenen Einstellungen den Befehl az webapp config show.

Azure PowerShell

Sie können viele der gängigen konfigurierbaren Optionen mithilfe von Set-AzWebApp festlegen. Das folgende Beispiel zeigt eine Teilmenge der konfigurierbaren Optionen:

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -Use32BitWorkerProcess [$True|$False] -WebSocketsEnabled [$True|$False] -AlwaysOn [$True|$False] -NumberOfWorkers

Verwenden Sie zum Anzeigen der vorhandenen Einstellungen den Befehl Get-AzWebApp.

Konfigurieren von Standarddokumenten

Das Standarddokument ist die Webseite, die unter der Stamm-URL einer App-Dienst-App angezeigt wird. Die erste übereinstimmende Datei in der Liste wird verwendet. Wenn die App Module verwendet, die auf Grundlage der URL weiterleiten, anstatt statischen Inhalt bereitzustellen, besteht keine Notwendigkeit für Standarddokumente.

Die Einstellung zum Konfigurieren von Standarddokumenten ist nur für Windows-Apps vorgesehen.

Azure-Portal

1. Suchen Sie im Azure-Portal die Option App Services, wählen Sie sie aus, und wählen Sie anschließend Ihre App aus.
2. Wählen Sie im linken Menü der App " Konfiguration" aus. Wählen Sie dann "Standarddokumente" aus.
3. Wählen Sie zum Hinzufügen eines Standarddokuments die Option Neues Dokument aus. Wählen Sie zum Entfernen eines Standarddokuments rechts neben dem Dokument Löschen aus.

Azure-Befehlszeilenschnittstelle

Fügen Sie mit az resource update ein Standarddokument hinzu:

az resource update --resource-group <group-name> --resource-type "Microsoft.Web/sites/config" --name <app-name>/config/web --add properties.defaultDocuments <filename>

Azure PowerShell

Fügen Sie ein Standarddokument hinzu, indem Sie das PowerShell-Objekt der aktualisierenden App ändern:

$webapp = Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>
$webapp.SiteConfig.DefaultDocuments.Add("<filename>")
Set-AzWebApp $webapp

Zuordnen eines URL-Pfads zu einem Verzeichnis

Standardmäßig startet App Service die App aus dem Stammverzeichnis des App-Codes. Manche Webframeworks starten jedoch nicht im Stammverzeichnis. Laravel startet beispielsweise im Unterverzeichnis public. Auf eine solche App kann zwar z. B. unter http://contoso.com/public zugegriffen werden, normalerweise empfiehlt es sich aber, http://contoso.com stattdessen an das Verzeichnis public weiterzuleiten. Wenn sich die Startdatei der App in einem anderen Ordner befindet oder das Repository über mehrere Anwendungen verfügt, können Sie virtuelle Anwendungen und Verzeichnisse bearbeiten oder hinzufügen.

Das Feature zum Zuordnen eines virtuellen Verzeichnisses zu einem physischen Pfad ist nur in Windows-Apps verfügbar.

Azure-Portal

1. Suchen Sie im Azure-Portal die Option App Services, wählen Sie sie aus, und wählen Sie anschließend Ihre App aus.

2. Wählen Sie im linken Menü der App die Option "Einstellungenkonfiguration"> aus. Wählen Sie dann Pfadzuordnungen aus.

3. Wählen Sie Neue virtuelle Anwendung oder neues virtuelles Verzeichnis aus. Führen Sie dann eine der folgenden Aktionen aus:

   • Um ein virtuelles Verzeichnis einem physischen Pfad zuzuordnen, lassen Sie " Verzeichnis " ausgewählt. Geben Sie das virtuelle Verzeichnis und den entsprechenden relativen (physischen) Pfad zum Stammverzeichnis der Website an (D:\home).
   • Wenn Sie ein virtuelles Verzeichnis als Webanwendung markieren möchten, deaktivieren Sie die Option "Verzeichnis".

   

4. Klicken Sie auf OK. Wählen Sie dann auf der Seite "Konfiguration" die Option "Speichern" aus.

Azure-Befehlszeilenschnittstelle

Im folgenden Beispiel wird der Stammpfad / auf das public Unterverzeichnis festgelegt, das für Laravel funktioniert. Außerdem wird eine zweite virtuelle Anwendung am /app2 Pfad hinzugefügt. Um es auszuführen, erstellen Sie eine Datei namens json.txt mit folgendem Inhalt:

[
  {
    "physicalPath"':' "site\\wwwroot\\public",
    "preloadEnabled"':' false,
    "virtualDirectories"':' null,
    "virtualPath"':' "/"
  },
  {
    "physicalPath"':' "site\\wwwroot\\app2",
    "preloadEnabled"':' false,
    "virtualDirectories"':' null,
    "virtualPath"':' "/app2"
  }
]

Ändern Sie <group-name> und <app-name> für Ihre Ressourcen und führen Sie den folgenden Befehl aus. Achten Sie beim Ausführen dieses Befehls auf Escapezeichen. Weitere Informationen zu Escapezeichen finden Sie unter Tipps zur erfolgreichen Verwendung der Azure CLI.

az resource update --resource-group <group-name> --resource-type Microsoft.Web/sites/config --name <app-name>/config/web --set properties.virtualApplications="@json.txt"

Azure PowerShell

Im folgenden Beispiel wird der Stammpfad / auf das public Unterverzeichnis festgelegt, das für Laravel funktioniert. Außerdem wird eine zweite virtuelle Anwendung am /app2 Pfad hinzugefügt. Zum Ausführen ändern Sie <group-name> und <app-name>.

$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Set default / path to public subdirectory
$webapp.SiteConfig.VirtualApplications[0].PhysicalPath= "site\wwwroot\public"

# Add a virtual application
$virtualApp = New-Object Microsoft.Azure.Management.WebSites.Models.VirtualApplication
$virtualApp.VirtualPath = "/app2"
$virtualApp.PhysicalPath = "site\wwwroot\app2"
$virtualApp.PreloadEnabled = $false
$webapp.SiteConfig.VirtualApplications.Add($virtualApp)

# Save settings
Set-AzWebApp $webapp

Handlerzuordnungen konfigurieren

Für Windows-Apps können Sie die IIS-Handlerzuordnungen und virtuelle Anwendungen und Verzeichnisse anpassen. Mit Handlerzuordnungen können Sie benutzerdefinierte Skriptprozessoren hinzufügen, die Anforderungen für bestimmte Dateierweiterungen verarbeiten.

So fügen Sie einen benutzerdefinierten Handler hinzu

1. Suchen Sie im Azure-Portal die Option App Services, wählen Sie sie aus, und wählen Sie anschließend Ihre App aus.

2. Wählen Sie im linken Menü der App die Option "Einstellungenkonfiguration"> aus. Wählen Sie dann Pfadzuordnungen aus.

3. Wählen Sie Neue Handlerzuordnung aus. Konfigurieren Sie den Handler folgendermaßen:

   • Erweiterung. Die Dateierweiterung, die Sie behandeln möchten, z. B. *.php oder handler.fcgi.
   • Skriptprozessor. Der absolute Pfad des Skriptprozessors. Der Skriptprozessor verarbeitet Anforderungen an Dateien, die der Dateierweiterung entsprechen. Verwenden Sie den Pfad D:\home\site\wwwroot , um auf das Stammverzeichnis Ihrer App zu verweisen.
   • Argumente. Optionale Befehlszeilenargumente für den Skriptprozessor.

4. Klicken Sie auf OK. Wählen Sie dann auf der Seite "Konfiguration" die Option "Speichern" aus.

Konfigurieren eines benutzerdefinierten Containers

• Konfigurieren eines benutzerdefinierten Containers für Azure App Service
• Einbinden von Azure Storage als lokale Freigabe in App Service

Verwandte Inhalte

• Umgebungsvariablen und App-Einstellungen in Azure App Service
• Einrichten einer vorhandenen benutzerdefinierten Domäne in Azure App Service
• Einrichten von Stagingumgebungen in Azure App Service
• Aktivieren von HTTPS für eine benutzerdefinierte Domäne in Azure App Service
• Aktivieren der Diagnoseprotokollierung für Apps in Azure App Service
• Hochskalieren einer App in Azure App Service
• Azure App Service-Kontingente und Warnungen
• Ändern der „applicationHost.config“-Einstellungen mit „applicationHost.xdt“