Konfigurieren einer App Service-App

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 Umgebungsvariablen>App-Einstellungen aus.

   

   Standardmäßig werden Werte für App-Einstellungen aus Sicherheitsgründen im Portal ausgeblendet. Wählen Sie zum Anzeigen eines ausgeblendeten Werts einer App-Einstellung das zugehörige Wert-Feld aus. Wählen Sie zum Anzeigen der ausgeblendeten Werte aller App-Einstellungen die Schaltfläche Werte anzeigen aus.

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

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

   Hinweis

   In einem standardmäßigen Linux-App Service oder einem benutzerdefinierten Linux-Container muss jede geschachtelte JSON-Schlüsselstruktur im App-Einstellungsnamen wie ApplicationInsights:InstrumentationKey in App Service als ApplicationInsights__InstrumentationKey für den Schlüsselnamen konfiguriert werden. Mit anderen Worten: Jedes : muss durch __ (doppelter Unterstrich) ersetzt werden. Alle Punkte im Namen der App-Einstellung werden durch einen _ (einzelnen Unterstrich) ersetzt.

5. Wählen Sie abschließend Anwenden aus. Vergessen Sie nicht, Anwenden auszuwählen, wenn Sie sich wieder auf der Seite Umgebungsvariablen befinden.

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

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

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

Zeigen Sie alle Einstellungen und deren Werte mit az webapp config appsettings list an:

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

Entfernen Sie mindestens eine Einstellung mit az webapp config app settings delete:

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

Legen Sie mindestens eine App-Einstellung mit Set-AzWebApp fest:

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

Dieses Cmdlet ersetzt die gesamten App-Einstellungen durch die von Ihnen angegebenen Einstellungen. Schließen Sie die vorhandenen App-Einstellungen mithilfe des Cmdlets Get-AzWebApp in die Eingabehashtabelle ein, um eine App-Einstellung innerhalb eines vorhandenen Satzes hinzuzufügen oder zu bearbeiten. Beispiel:

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

# Copy app settings to a new Hashtable
$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 slotspezifisch ist:

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

Verwenden Sie Set-AzWebAppSlotConfigName, um mindestens eine App-Einstellung als slotspezifisch festzulegen:

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

Wählen Sie die Schaltfläche Erweiterte Bearbeitung aus. Bearbeiten Sie die Einstellungen im Textbereich. Wenn Sie fertig sind, wählen Sie OK aus. Vergessen Sie nicht, Anwenden auszuwählen, wenn Sie sich wieder auf der Seite Umgebungsvariablen befinden.

App-Einstellungen haben folgende JSON-Formatierung:

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

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"

Das benötigte Dateiformat ist ein JSON-Array von Einstellungen, bei dem das Sloteinstellungsfeld optional ist. Beispiel:

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

Der Einfachheit halber können Sie vorhandene Einstellungen mit az webapp config appsettings list in einer JSON-Datei speichern. Das folgende Beispiel kann in Bash ausgeführt werden.

# Save the settings
az webapp config appsettings list --name <app-name> --resource-group <group-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

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

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 Umgebungsvariablen>Verbindungszeichenfolgen aus.

   

   Standardmäßig werden Werte für Verbindungszeichenfolgen aus Sicherheitsgründen im Portal ausgeblendet. Wählen Sie zum Anzeigen eines ausgeblendeten Werts einer Verbindungszeichenfolge das zugehörige Wert-Feld aus. Wählen Sie zum Anzeigen der ausgeblendeten Werte aller Verbindungszeichenfolgen die Schaltfläche Wert 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 abschließend Anwenden aus. Vergessen Sie nicht, Anwenden auszuwählen, wenn Sie sich wieder auf der Seite Umgebungsvariablen befinden.

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

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

Ersetzen Sie <string-name> durch den Namen der Verbindungszeichenfolge und <value> durch den Wert, der ihr zugewiesen werden soll. Mögliche Werte von <type> (z. B. SQLAzure) finden Sie in der CLI-Dokumentation zur Befehlszeilenschnittstelle.

Zeigen Sie mit az webapp config connection-string list alle Verbindungszeichenfolgen und ihre Werte an:

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

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

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

Legen Sie mit Set-AzWebApp mindestens eine Verbindungszeichenfolge 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, bei dem es sich um einen numerischen Wert handelt, der einem der ConnectionStringType-Enumerationsfelder entspricht. Geben Sie beispielsweise für SQL Azure type="2" an.

Dieses Cmdlet ersetzt die gesamten Verbindungszeichenfolgen durch die von Ihnen angegebenen. Schließen Sie die vorhandenen App-Einstellungen mithilfe des Cmdlets Get-AzWebApp in die Eingabehashtabelle ein, um eine App-Einstellung innerhalb eines vorhandenen Satzes hinzuzufügen oder zu bearbeiten. Beispiel:

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

# Copy connection strings to a new hashtable
$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 mindestens eine Verbindungszeichenfolge als slotspezifisch festzulegen:

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

Wählen Sie die Schaltfläche Erweiterte Bearbeitung aus. Bearbeiten Sie die Verbindungszeichenfolgen im Textbereich. Wählen Sie abschließend Anwenden aus. Vergessen Sie nicht, Anwenden auszuwählen, wenn Sie sich wieder auf der Seite Umgebungsvariablen befinden.

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
  },
  ...
]

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"

Das benötigte Dateiformat ist ein JSON-Array von Verbindungszeichenfolgen, bei dem das Sloteinstellungsfeld optional ist. Beispiel:

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

Der Einfachheit halber können Sie vorhandene Verbindungszeichenfolgen mit az webapp config connection-string list in einer JSON-Datei speichern. Das folgende Beispiel kann in Bash ausgeführt werden.

# 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

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

Suchen Sie im Azure-Portal die Option App Services, wählen Sie sie aus, und wählen Sie anschließend Ihre App aus. Wählen Sie im linken Menü der App Konfiguration>Allgemeine Einstellungen aus.

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

• Stapeleinstellungen: Der Softwarestapel zum Ausführen der App, einschließlich der Sprach- und SDK-Version.

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

  

• Plattformeinstellungen: Ermöglicht das Konfigurieren von Einstellungen für die Hostingplattform, einschließlich:

  • Plattformbitanzahl: 32-Bit oder 64-Bit. Nur für Windows-Apps.
  • FTP-Zustand: Lassen Sie nur FTPS zu, oder deaktivieren Sie FTP vollständig.
  • HTTP-Version: Legen Sie die Einstellung auf 2.0 fest, um die Unterstützung für das HTTPS/2-Protokoll zu aktivieren.

  Hinweis

  Die aktuellen Browser unterstützen das HTTP/2-Protokoll in der Regel nur über TLS, während unverschlüsselter Datenverkehr weiterhin HTTP/1.1 verwendet. Um sicherzustellen, dass Clientbrowser eine Verbindung mit Ihrer App mit HTTP/2 herstellen, sichern Sie Ihren benutzerdefinierten DNS-Namen. Weitere Informationen finden Sie unter Schützen eines benutzerdefinierten DNS-Namens mit einer TLS/SSL-Bindung in Azure App Service.

  • Web-Sockets: Beispielsweise für ASP.NET SignalR oder socket.io.

  • Always On: Hält die App auch dann geladen, wenn kein Datenverkehr stattfindet. Wenn Always On nicht aktiviert ist (Standard), 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. Es ist wichtig, dass diese Anforderung eine Antwort vom Typ „200 OK“ erhält, um sicherzustellen, dass alle Reimagingvorgänge ordnungsgemäß ausgeführt werden. Der fortlaufende Ping verhindert, dass die App entladen wird.

    AlwaysOn ist für fortlaufende WebJobs oder WebJobs, die mithilfe eines CRON-Ausdrucks ausgelöst werden, erforderlich.

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

  • Proxy für Sitzungsaffinität: Der Proxy für die Sitzungsaffinität kann aktiviert werden, 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 für das Cookie für die Sitzungsaffinität richtet sich nach dem weitergeleiteten Hostnamen vom Reverseproxy.

  • Nur HTTPS: Wenn aktiviert, wird der gesamte HTTP-Datenverkehr an HTTPS umgeleitet.

  • Mindest-TLS-Version: Wählen Sie die Mindestversion der TLS-Verschlüsselung aus, die für Ihre App erforderlich ist.

• 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.

Sie können viele der gängigen konfigurierbaren Optionen mit az webapp config set festlegen. 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.

Sie können viele der gängigen konfigurierbaren Optionen mit 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.

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

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>

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

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>Pfadzuordnungen aus.

3. Wählen Sie Neue virtuelle Anwendung oder neues virtuelles Verzeichnis aus.

   • Wenn Sie ein virtuelles Verzeichnis einem physischen Pfad zuordnen möchten, lassen Sie das Kontrollkästchen Verzeichnis aktiviert. 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 das Kontrollkästchen Verzeichnis.

   

4. Wählen Sie OK aus. Vergessen Sie nicht, Speichern auf der Seite Konfiguration auszuwählen.

Im folgenden Beispiel wird der Stammpfad / auf das Unterverzeichnis public (das für Laravel funktioniert) festgelegt und außerdem eine zweite virtuelle Anwendung am Pfad /app2 hinzugefügt. Um sie auszuführen, erstellen Sie eine Datei namens json.txt mit folgenden Inhalten.

[
  {
    "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"

Im folgenden Beispiel wird der Stammpfad / auf das Unterverzeichnis public (das für Laravel funktioniert) festgelegt und außerdem eine zweite virtuelle Anwendung am Pfad /app2 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