Skonfiguruj aplikację usługi App Service

W tym artykule wyjaśniono, jak skonfigurować typowe ustawienia dla aplikacji internetowych, zaplecza mobilnego lub aplikacji interfejsu API. Aby zapoznać się z usługą Azure Functions, zobacz Dokumentacja ustawień aplikacji dla usługi Azure Functions.

Konfigurowanie ustawień aplikacji

W usłudze Azure App Service ustawienia aplikacji są zmiennymi przekazywanymi jako zmienne środowiskowe do kodu aplikacji. Następujące warunki dotyczą ustawień aplikacji:

• Nazwy ustawień aplikacji mogą zawierać tylko litery, cyfry (0–9), kropki (.) i podkreślenia (_).
• Znaki specjalne w wartości ustawienia aplikacji muszą być ucieczone zgodnie z wymaganiami docelowego systemu operacyjnego.

Aby na przykład ustawić zmienną środowiskową w usłudze App Service dla systemu Linux z wartością "pa$$w0rd\", ciąg ustawienia aplikacji powinien mieć wartość "pa\$\$w0rd\\".

W przypadku aplikacji systemu Linux i kontenerów niestandardowych usługa App Service przekazuje ustawienia aplikacji do kontenera przy użyciu --env flagi w celu ustawienia zmiennej środowiskowej w kontenerze. W obu przypadkach są one wstrzykiwane do środowiska aplikacji podczas uruchamiania aplikacji. Podczas dodawania, usuwania lub edytowania ustawień aplikacji usługa App Service wyzwala ponowne uruchomienie aplikacji.

W przypadku programistów ASP.NET i ASP.NET Core konfigurowanie ustawień aplikacji w usłudze App Service jest podobne do konfigurowania ich w <appSettings>Web.config lub appsettings.json. Wartości w usłudze App Service zastępują wartości w elemencie Web.config lub appsettings.json. Możesz zachować ustawienia programistyczne, takie jak lokalne hasło MySQL, w Web.config lub appsettings.json. W usłudze App Service można bezpiecznie przechowywać tajne produkcyjne, takie jak hasło do bazy danych Azure MySQL. Ten sam kod używa ustawień programowania podczas lokalnego debugowania. Podczas wdrażania na platformę Azure wykorzystuje ona twoje tajne dane produkcyjne.

Inne stosy języków pobierają ustawienia aplikacji jako zmienne środowiskowe w czasie wykonywania. Aby uzyskać instrukcje specyficzne dla każdego stosu języków, zobacz:

• ASP.NET Rdzeń
• Jawa
• Node.js
• Pyton
• PHP
• Kontenery niestandardowe

Ustawienia aplikacji są zawsze szyfrowane, gdy są przechowywane (zaszyfrowane w spoczynku).

Uwaga

Jeśli przechowujesz dane poufne w ustawieniach aplikacji, rozważ użycie odwołań usługi Azure Key Vault. Jeśli wpisy tajne są przeznaczone do łączności z zasobami zaplecza, rozważ opcje łączności, które są bezpieczniejsze i które nie wymagają wpisów tajnych. Aby uzyskać więcej informacji, zobacz Bezpieczne łączenie z usługami i bazami danych platformy Azure z usługi Azure App Service.

Portal Azure

1. W witrynie Azure Portal wyszukaj i wybierz pozycję App Services, a następnie wybierz aplikację.

2. W menu po lewej stronie aplikacji wybierz pozycję Ustawienia>Zmienne środowiskowe. Następnie wybierz pozycję Ustawienia aplikacji.

   

   Wartości ustawień aplikacji są domyślnie ukryte w portalu ze względów bezpieczeństwa. Aby wyświetlić ukrytą wartość ustawienia aplikacji, w obszarze Wartość wybierz pozycję Pokaż wartość. Aby wyświetlić ukryte wartości wszystkich ustawień aplikacji, wybierz pozycję Pokaż wartości.

   Uwaga

   Uprawnienia użytkownika do odczytu/zapisu są wymagane do wyświetlenia tej sekcji w witrynie Azure Portal. Wbudowane role RBAC z wystarczającymi uprawnieniami to Właściciel, Współautor i Współautor witryny internetowej. Sama rola Czytelnika nie pozwala na dostęp do tej strony.

3. Aby dodać nowe ustawienie aplikacji, wybierz pozycję Dodaj. Aby edytować ustawienie, wybierz ustawienie.

4. W oknie dialogowym możesz przypiąć ustawienie do bieżącego slotu.

   Uwaga

   W domyślnej usłudze aplikacji systemu Linux lub niestandardowym kontenerze systemu Linux każda zagnieżdżona struktura klucza JSON w nazwie ustawienia aplikacji musi być skonfigurowana inaczej dla nazwy klucza. Zastąp dowolny dwukropek (:) podwójnym podkreśleniem (__). Zastąp dowolną kropkę (.) pojedynczym podkreśleniem (_). Na przykład ApplicationInsights:InstrumentationKey należy skonfigurować w usłudze App Service jako nazwę klucza ApplicationInsights__InstrumentationKey.

5. Po zakończeniu wybierz pozycję Zastosuj. Następnie wybierz pozycję Zastosuj na stronie Zmienne środowiskowe .

Interfejs wiersza polecenia platformy Azure

Dodaj lub edytuj ustawienie aplikacji, używając polecenia az webapp config app settings set:

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

Zastąp <setting-name> nazwą ustawienia. Zastąp <value> wartością, która ma zostać przypisana do ustawienia.

Pokaż wszystkie ustawienia i ich wartości przy użyciu az webapp config appsettings list:

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

Usuń jedno lub więcej ustawień za pomocą polecenia az webapp config app settings delete:.

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

Azure PowerShell

Ustaw co najmniej jedno ustawienie aplikacji przy użyciu polecenia Set-AzWebApp:

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

To polecenie cmdlet zastępuje cały zestaw ustawień aplikacji określonymi przez Ciebie. Aby dodać lub edytować ustawienie aplikacji w istniejącym zestawie, uwzględnij istniejące ustawienia aplikacji w tabeli skrótów wejściowych przy użyciu polecenia cmdlet Get-AzWebApp . Na przykład:

# 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

Aby sprawdzić, czy ustawienie aplikacji jest specyficzne dla slotu, użyj polecenia Get-AzWebAppSlotConfigName:

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

Aby uczynić jedno lub więcej ustawień aplikacji specyficznymi dla slotu, użyj Set-AzWebAppSlotConfigName:

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

Zbiorcze edytowanie ustawień aplikacji

Portal Azure

1. Wybierz pozycję Edytuj zaawansowane.
2. Edytuj ustawienia w obszarze tekstowym.
3. Po zakończeniu wybierz pozycję OK. Następnie wybierz pozycję Zastosuj na stronie Zmienne środowiskowe .

Ustawienia aplikacji mają następujące formatowanie JSON:

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

Interfejs wiersza polecenia platformy Azure

Uruchom az webapp config app settings set z nazwą pliku JSON:

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

Wskazówka

Zawijanie nazwy pliku cudzysłowami jest wymagane tylko w programie PowerShell.

Wymagany format pliku to tablica ustawień JSON, w której pole ustawienia miejsca jest opcjonalne. Na przykład:

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

Dla wygody można zapisać obecne ustawienia do pliku JSON, używając polecenia az webapp config appsettings list.

# 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

Nie można zbiorczo edytować ustawień aplikacji przy użyciu pliku JSON za pomocą programu Azure PowerShell.

Konfigurowanie parametrów połączenia

W tej sekcji opisano sposób konfigurowania parametrów połączenia.

Uwaga

Rozważ bezpieczniejsze opcje łączności, które nie wymagają hasła lub klucza. Aby uzyskać więcej informacji, zobacz Bezpieczne łączenie z usługami i bazami danych platformy Azure z usługi Azure App Service.

W przypadku deweloperów ASP.NET i ASP.NET Core ustawienie parametrów połączenia w usłudze App Service jest podobne do ich ustawiania w <connectionStrings> w Web.config. Wartości ustawione w usłudze App Service zastępują te w pliku Web.config. Ustawienia programowania, takie jak plik bazy danych, można zachować w pliku Web.config. W usłudze App Service można bezpiecznie przechowywać tajemnice produkcyjne, takie jak poświadczenia bazy danych SQL. Ten sam kod używa ustawień programowania podczas lokalnego debugowania. Podczas wdrażania na platformę Azure wykorzystuje ona twoje tajne dane produkcyjne.

W przypadku innych stosów języków lepiej zamiast tego używać ustawień aplikacji . Parametry połączenia wymagają specjalnego formatowania w kluczach zmiennych w celu uzyskania dostępu do wartości.

Istnieje jeden przypadek, w którym można użyć parametrów połączenia zamiast ustawień aplikacji dla języków non-.NET. Kopie zapasowe niektórych typów baz danych platformy Azure są tworzone razem z aplikacją tylko wtedy, gdy skonfigurujesz parametry połączenia dla bazy danych w aplikacji usługi App Service. Aby uzyskać więcej informacji, zobacz Tworzenie niestandardowej kopii zapasowej. Jeśli nie potrzebujesz tej automatycznej kopii zapasowej, użyj ustawień aplikacji.

W czasie wykonywania parametry połączenia są dostępne jako zmienne środowiskowe, poprzedzone następującymi typami połączeń:

• SQL Server: SQLCONNSTR_
• MySQL: MYSQLCONNSTR_
• Azure SQL: SQLAZURECONNSTR_
• Niestandardowy: CUSTOMCONNSTR_
• PostgreSQL: POSTGRESQLCONNSTR_
• Azure Notification Hubs: NOTIFICATIONHUBCONNSTR_
• Azure Service Bus: SERVICEBUSCONNSTR_
• Azure Event Hubs: EVENTHUBCONNSTR_
• Azure Cosmos DB: DOCDBCONNSTR_
• Pamięć podręczna Redis: REDISCACHECONNSTR_

Uwaga

Aplikacje platformy .NET przeznaczone dla baz danych PostgreSQL, Notification Hubs, Service Bus, Event Hubs, Azure Cosmos DB i Redis Cache powinny ustawić parametry połączenia na Custom jako obejście znanego problemu w elemencie .NET EnvironmentVariablesConfigurationProvider.

Na przykład można uzyskać dostęp do parametry połączenia MySQL o nazwie connectionstring1 jako zmiennej środowiskowej MYSQLCONNSTR_connectionString1. Aby uzyskać instrukcje specyficzne dla każdego stosu języków, zobacz:

• ASP.NET Rdzeń
• Jawa
• Node.js
• Pyton
• PHP
• Kontenery niestandardowe

Parametry połączenia są zawsze szyfrowane, gdy są przechowywane (zaszyfrowane w spoczynku).

Uwaga

Również można rozwiązać parametry połączenia z Key Vault używając odwołań do Key Vault.

Portal Azure

1. W witrynie Azure Portal wyszukaj i wybierz pozycję App Services, a następnie wybierz aplikację.

2. W menu po lewej stronie aplikacji wybierz pozycję Ustawienia>Zmienne środowiskowe. Następnie wybierz pozycję Parametry połączenia.

   Domyślnie wartości łańcuchów połączeń są ukryte w portalu dla bezpieczeństwa. Aby wyświetlić ukrytą wartość parametrów połączenia, w obszarze Wartość wybierz pozycję Pokaż wartość. Aby wyświetlić ukryte wartości wszystkich parametrów połączenia, wybierz pozycję Pokaż wartości.

3. Aby dodać nowy parametry połączenia, wybierz pozycję Dodaj. Aby edytować parametry połączenia, wybierz parametry połączenia.

4. W oknie dialogowym możesz przypiąć ciąg połączenia do bieżącego slotu.

5. Po zakończeniu wybierz pozycję Zastosuj. Następnie wybierz pozycję Zastosuj na stronie Zmienne środowiskowe .

Interfejs wiersza polecenia platformy Azure

Dodaj lub edytuj ustawienia aplikacji za pomocą polecenia az webapp config connection-string set:

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

Zastąp <string-name> ciąg nazwą parametrów połączenia. Zastąp <value> wartością, którą należy przypisać do ciągu połączenia. Aby uzyskać możliwe wartości <type> takie jak SQLAzure, zobacz dokumentację polecenia CLI.

Pokaż wszystkie ciągi połączenia i ich wartości przy użyciu az webapp config connection-string list:

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

Usuń co najmniej jeden parametr połączenia za pomocą polecenia 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

Ustaw co najmniej jeden parametr połączenia przy użyciu polecenia Set-AzWebApp:

$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

Każde parametry połączenia zawierają nazwę (<string-name1>), wartość (<connection-string1>) i typ. Typ jest wartością liczbową odpowiadającą jednemu z pól modułu wyliczającego ConnectionStringType . Na przykład w przypadku usługi Azure SQL określ wartość type="2".

To polecenie cmdlet zastępuje cały zestaw parametrów połączenia określonymi przez Użytkownika. Aby dodać lub edytować ustawienie aplikacji w istniejącym zestawie, uwzględnij istniejące ustawienia aplikacji w tabeli skrótów wejściowych przy użyciu polecenia cmdlet Get-AzWebApp . Na przykład:

# 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

Aby sprawdzić, czy łańcuch połączenia jest specyficzny dla slotu, użyj polecenia Get-AzWebAppSlotConfigName:

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

Aby określić jedno lub więcej ciągów połączenia specyficznych dla slotu, użyj Set-AzWebAppSlotConfigName:

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

Zbiorcze edytowanie parametrów połączenia

Portal Azure

1. Wybierz pozycję Edytuj zaawansowane.
2. Edytuj parametry połączenia w obszarze tekstowym.
3. Po zakończeniu wybierz pozycję Zastosuj. Nie zapomnij również wybrać pozycji Zastosuj na stronie Zmienne środowiskowe .

Parametry połączenia mają następujące formatowanie JSON:

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

Interfejs wiersza polecenia platformy Azure

Uruchom az webapp config connection-string set z nazwą pliku JSON:

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

Wskazówka

Zawijanie nazwy pliku cudzysłowami jest wymagane tylko w programie PowerShell.

Wymagany format pliku to tablica parametrów połączenia JSON, w której pole ustawienia miejsca jest opcjonalne. Na przykład:

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

Dla wygody można zapisać istniejące parametry połączenia w pliku JSON za pomocą az webapp config connection-string list.

# 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

Nie można zbiorczo edytować parametry połączenia przy użyciu pliku JSON w programie Azure PowerShell.

Konfiguruj ustawienia stosu języka

Aby skonfigurować ustawienia stosu języka, zobacz następujące zasoby:

• ASP.NET Rdzeń
• Jawa
• Node.js
• Pyton
• PHP

Skonfiguruj ustawienia ogólne

Aby skonfigurować ustawienia ogólne, wykonaj kroki dla preferowanych narzędzi.

Portal Azure

1. W witrynie Azure Portal wyszukaj i wybierz pozycję App Services, a następnie wybierz aplikację.

2. W menu po lewej stronie aplikacji wybierz pozycję Konfiguracja ustawień>. Następnie wybierz pozycję Ustawienia ogólne.

   

W tym miejscu można skonfigurować niektóre typowe ustawienia aplikacji. Niektóre ustawienia wymagają skalowania w górę do wyższych warstw cenowych.

• Ustawienia stosu: skonfiguruj ustawienia dla stosu oprogramowania, aby uruchomić aplikację, w tym język i wersje zestawu SDK.

  W przypadku aplikacji systemu Linux możesz wybrać wersję środowiska uruchomieniowego języka i ustawić opcjonalne polecenie uruchamiania.

• Ustawienia platformy: skonfiguruj ustawienia dla platformy hostingu, w tym:

  • Platforma: wybierz 32-bitowe lub 64-bitowe. Tylko w przypadku aplikacji systemu Windows.

  • Stan FTP: Zezwalaj tylko na FTPS, lub całkowicie wyłącz FTP.

  • Wersja HTTP: ustaw wartość 2.0 , aby włączyć obsługę protokołu HTTPS/2 .

    Uwaga

    Większość nowoczesnych przeglądarek obsługuje tylko protokół HTTP/2 za pośrednictwem protokołu TLS. Niezaszyfrowany ruch nadal używa protokołu HTTP/1.1. Aby upewnić się, że przeglądarki klienckie łączą się z aplikacją przy użyciu protokołu HTTP/2, zabezpiecz niestandardową nazwę DNS. Aby uzyskać więcej informacji, zobacz Zapewnianie zabezpieczeń niestandardowej nazwy DNS z powiązaniem TLS/SSL w usłudze App Service.

  • Web sockets: Skonfiguruj dla ASP.NET SignalR lub socket.io, na przykład.

  • Zawsze włączone: włącz, jeśli chcesz zachować załadowaną aplikację nawet wtedy, gdy nie ma ruchu.

    Gdy ustawienie Zawsze włączone jest wyłączone (ustawienie domyślne), aplikacja zostanie zwolniona po 20 minutach bez żadnych żądań przychodzących. Rozładowana aplikacja może powodować duże opóźnienie dla nowych żądań ze względu na czas rozruchu.

    Po włączeniu Always On przedni moduł równoważenia obciążenia wysyła GET żądanie do katalogu głównego aplikacji co pięć minut. Ciągłe polecenie ping zapobiega wyładowaniu aplikacji.

    "Zawsze włączone" jest wymagane w przypadku ciągłych zadań WebJobs lub zadań WebJobs wyzwalanych przez wyrażenie Cron.

  • Afinacja sesji: W wdrożeniu wielowarstwowym, upewnij się, że klient jest kierowany do tej samej instancji przez cały czas trwania sesji. Tę opcję można ustawić na Wyłączone dla aplikacji bezstanowych.

  • Proxy do utrzymania sesji: Włącz tę opcję, jeśli Twoja aplikacja znajduje się za zwrotnym proxy (na przykład Azure Application Gateway lub Azure Front Door) i używasz domyślnej nazwy hosta. Domena pliku cookie przyległości sesji jest zgodna z nazwą przesłanego hosta ze zwrotnego serwera proxy.

  • Tylko protokół HTTPS: włącz, jeśli chcesz przekierować cały ruch HTTP do protokołu HTTPS.

  • Minimalna wersja protokołu TLS: wybierz minimalną wersję szyfrowania TLS wymaganą przez aplikację.

• Debugowanie: włącz zdalne debugowanie dla aplikacji ASP.NET, ASP.NET Core lub Node.js . Ta opcja wyłącza się automatycznie po 48 godzinach.

• Przychodzące certyfikaty klienta: wymagaj certyfikatów klienta w wzajemnym uwierzytelnianiu.

Interfejs wiersza polecenia platformy Azure

Wiele typowych opcji konfigurowalnych można ustawić za pomocą az webapp config set. W poniższym przykładzie przedstawiono podzbiór konfigurowalnych opcji:

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

Aby wyświetlić istniejące ustawienia, użyj polecenia az webapp config show.

Azure PowerShell

Wiele typowych opcji konfigurowalnych można ustawić przy użyciu polecenia Set-AzWebApp. W poniższym przykładzie przedstawiono podzbiór konfigurowalnych opcji:

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

Aby wyświetlić istniejące ustawienia, użyj polecenia Get-AzWebApp .

Konfigurowanie dokumentów domyślnych

Domyślnym dokumentem jest strona internetowa wyświetlana pod głównym adresem URL aplikacji usługi App Service. Jest używany pierwszy pasujący plik na liście. Jeśli aplikacja używa modułów, które są kierowane na podstawie adresu URL zamiast obsługiwania zawartości statycznej, nie ma potrzeby tworzenia domyślnych dokumentów.

Ustawienie konfigurowania dokumentów domyślnych dotyczy tylko aplikacji systemu Windows.

Portal Azure

1. W witrynie Azure Portal wyszukaj i wybierz pozycję App Services, a następnie wybierz aplikację.
2. W menu po lewej stronie aplikacji wybierz pozycję Konfiguracja. Następnie wybierz pozycję Dokumenty domyślne.
3. Aby dodać dokument domyślny, wybierz pozycję Nowy dokument. Aby usunąć dokument domyślny, wybierz pozycję Usuń po prawej stronie.

Interfejs wiersza polecenia platformy Azure

Dodaj dokument domyślny przy użyciu polecenia az resource update:

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

Azure PowerShell

Dodaj dokument domyślny, modyfikując obiekt programu PowerShell aktualizacji aplikacji:

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

Mapowanie ścieżki adresu URL do katalogu

Domyślnie, usługa aplikacji uruchamia twoją aplikację z katalogu głównego kodu aplikacji. Jednak niektóre frameworki internetowe nie są uruchamiane w katalogu głównym. Na przykład platforma Laravel uruchamia się w podkatalogu public. Taka aplikacja będzie dostępna na przykład pod http://contoso.com/public, ale zazwyczaj chcesz przekierować http://contoso.com do katalogu public. Jeśli plik startowy aplikacji znajduje się w innym folderze lub jeśli repozytorium ma więcej niż jedną aplikację, możesz edytować lub dodawać aplikacje wirtualne i katalogi.

Funkcja mapowania katalogu wirtualnego na ścieżkę fizyczną jest dostępna tylko w aplikacjach systemu Windows.

Portal Azure

1. W witrynie Azure Portal wyszukaj i wybierz pozycję App Services, a następnie wybierz aplikację.

2. W menu po lewej stronie aplikacji wybierz pozycję Konfiguracja ustawień>. Następnie wybierz Path mappings.

3. Wybierz pozycję Nowa aplikacja wirtualna lub katalog. Następnie wykonaj jedną z następujących czynności:

   • Aby zamapować katalog wirtualny na ścieżkę fizyczną, pozostaw wybraną opcję Katalog . Określ katalog wirtualny i odpowiednią względną (fizyczną) ścieżkę do katalogu głównego witryny internetowej (D:\home).
   • Aby oznaczyć katalog wirtualny jako aplikację internetową, usuń zaznaczenie pozycji Katalog.

   

4. Wybierz OK Następnie wybierz pozycję Zapisz na stronie Konfiguracja .

Interfejs wiersza polecenia platformy Azure

Poniższy przykład ustawia ścieżkę / główną do podkatalogu public , który działa dla platformy Laravel. Dodaje również drugą aplikację wirtualną w ścieżce /app2 . Aby go uruchomić, utwórz plik o nazwie json.txt o następującej zawartości:

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

Zmień <group-name> oraz <app-name> dla swoich zasobów i uruchom następujące polecenie. Należy pamiętać o znakach ucieczki podczas uruchamiania tego polecenia. Aby uzyskać więcej informacji na temat znaków ucieczki, zobacz Porady dotyczące skutecznego korzystania z interfejsu wiersza polecenia platformy Azure.

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

Poniższy przykład ustawia ścieżkę / główną do podkatalogu public , który działa dla platformy Laravel. Dodaje również drugą aplikację wirtualną w ścieżce /app2 . Aby go uruchomić, zmień wartości <group-name> i <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

Skonfiguruj mapowania obsługi błędów

W przypadku aplikacji systemu Windows można dostosować mapowania obsługi IIS oraz aplikacje wirtualne i katalogi. Mapowania obsługi umożliwiają dodawanie niestandardowych procesorów skryptów do obsługi żądań dla określonych rozszerzeń plików.

Aby dodać niestandardowy obsługiwacz:

1. W witrynie Azure Portal wyszukaj i wybierz pozycję App Services, a następnie wybierz aplikację.

2. W menu po lewej stronie aplikacji wybierz pozycję Konfiguracja ustawień>. Następnie wybierz Path mappings.

3. Wybierz Nowe mapowanie programu obsługi. Skonfiguruj obsługujący komponent w następujący sposób:

   • Rozszerzenie. Rozszerzenie pliku, które chcesz obsłużyć, takie jak *.php lub handler.fcgi.
   • Procesor skryptów. Całkowita ścieżka do procesora skryptów dla ciebie. Procesor skryptu przetwarza żądania do plików, które są zgodne z rozszerzeniem pliku. Użyj ścieżki D:\home\site\wwwroot , aby odwołać się do katalogu głównego aplikacji.
   • Argumenty. Opcjonalne argumenty wiersza polecenia dla procesora skryptu.

4. Wybierz OK Następnie wybierz pozycję Zapisz na stronie Konfiguracja .

Konfigurowanie kontenerów niestandardowych

• Konfigurowanie niestandardowego kontenera dla usługi Azure App Service
• Zamontuj Azure Storage jako udział lokalny w usłudze App Service

Powiązana zawartość

• Zmienne środowiskowe i ustawienia aplikacji w usłudze Azure App Service
• Konfigurowanie istniejącej domeny niestandardowej w usłudze Azure App Service
• Konfigurowanie środowisk przejściowych w usłudze Azure App Service
• Włączanie protokołu HTTPS dla domeny niestandardowej w usłudze Azure App Service
• Włączanie rejestrowania diagnostyki dla aplikacji w usłudze Azure App Service
• Zwiększenie zasobów aplikacji w usłudze Azure App Service
• limity i alerty w usłudze Azure App Service
• Zmienianie ustawień applicationHost.config za pomocą elementu applicationHost.xdt