Udostępnij za pośrednictwem

Zmienne środowiskowe i ustawienia aplikacji w usłudze aplikacja systemu Azure

  • Artykuł

Uwaga

Od 1 czerwca 2024 r. wszystkie nowo utworzone aplikacje usługi App Service będą miały możliwość wygenerowania unikatowej domyślnej nazwy hosta przy użyciu konwencji <app-name>-<random-hash>.<region>.azurewebsites.netnazewnictwa . Istniejące nazwy aplikacji pozostaną niezmienione.

Przykład: myapp-ds27dh7271aah175.westus-01.azurewebsites.net

Aby uzyskać więcej informacji, zapoznaj się z unikatową domyślną nazwą hosta zasobu usługi App Service.

W usłudze aplikacja systemu Azure niektóre ustawienia są dostępne dla środowiska wdrażania lub środowiska uruchomieniowego jako zmienne środowiskowe. Niektóre z tych ustawień można dostosować podczas ręcznego ustawiania ich jako ustawień aplikacji. W tej dokumentacji przedstawiono zmienne, których można użyć lub dostosować.

Środowisko aplikacji

Następujące zmienne środowiskowe są ogólnie powiązane ze środowiskiem aplikacji.

Nazwa ustawienia opis Przykład
WEBSITE_SITE_NAME Tylko do odczytu. Nazwa aplikacji.
WEBSITE_RESOURCE_GROUP Tylko do odczytu. Nazwa grupy zasobów platformy Azure zawierająca zasób aplikacji.
WEBSITE_OWNER_NAME Tylko do odczytu. Zawiera identyfikator subskrypcji platformy Azure, który jest właścicielem aplikacji, grupy zasobów i przestrzeni internetowej.
REGION_NAME Tylko do odczytu. Nazwa regionu aplikacji.
WEBSITE_PLATFORM_VERSION Tylko do odczytu. Wersja platformy usługi App Service.
HOME Tylko do odczytu. Ścieżka do katalogu macierzystego (na przykład D:\home dla systemu Windows).
SERVER_PORT Tylko do odczytu. Port, na który aplikacja powinna nasłuchiwać.
WEBSITE_WARMUP_PATH Względna ścieżka do polecenia ping w celu rozgrzewania aplikacji, począwszy od ukośnika. Wartość domyślna to /, która wysyła polecenie ping do ścieżki głównej. Konkretna ścieżka może być wysyłana za pomocą polecenia ping przez nieuwierzytelnionego klienta, takiego jak usługa Azure Traffic Manager, nawet jeśli uwierzytelnianie usługi App Service jest ustawione na odrzucanie nieuwierzytelnionych klientów. (UWAGA: To ustawienie aplikacji nie zmienia ścieżki używanej przez funkcję AlwaysOn).
WEBSITE_COMPUTE_MODE Tylko do odczytu. Określa, czy aplikacja działa na dedykowanej (Dedicated) lub udostępnionej () maszynie wirtualnej/Shareds.
WEBSITE_SKU Tylko do odczytu. Jednostka SKU aplikacji. Możliwe wartości to Free, , BasicSharedi Standard.
SITE_BITNESS Tylko do odczytu. Pokazuje, czy aplikacja jest 32-bitowa (x86) czy 64-bitowa (AMD64).
WEBSITE_HOSTNAME Tylko do odczytu. Nazwa hosta podstawowego dla aplikacji. Nazwy hostów niestandardowych nie są tutaj uwzględniane.
WEBSITE_VOLUME_TYPE Tylko do odczytu. Pokazuje aktualnie używany typ woluminu magazynu.
WEBSITE_NPM_DEFAULT_VERSION Domyślna wersja npm używana przez aplikację.
WEBSOCKET_CONCURRENT_REQUEST_LIMIT Tylko do odczytu. Limit żądań współbieżnych protokołu Websocket. W przypadku warstwy Standardowa i nowszej wartość to -1, ale nadal istnieje limit na maszynę wirtualną na podstawie rozmiaru maszyny wirtualnej (zobacz Limity liczbowe między maszynami wirtualnymi).
WEBSITE_PRIVATE_EXTENSIONS Ustaw wartość , aby 0 wyłączyć korzystanie z rozszerzeń lokacji prywatnej.
WEBSITE_TIME_ZONE Domyślnie strefa czasowa aplikacji jest zawsze utc. Można zmienić ją na dowolną z prawidłowych wartości wymienionych w domyślnych strefach czasowych. Jeśli określona wartość nie jest rozpoznawana, używany jest czas UTC. Atlantic Standard Time
WEBSITE_ADD_SITENAME_BINDINGS_IN_APPHOST_CONFIG Po zamianie miejsca aplikacja może napotkać nieoczekiwane ponowne uruchomienie. Jest to spowodowane tym, że po zamianie konfiguracja powiązania nazwy hosta nie jest zsynchronizowana, co samo w sobie nie powoduje ponownego uruchomienia. Jednak niektóre bazowe zdarzenia magazynu (takie jak tryb failover woluminu magazynu) mogą wykryć te rozbieżności i wymusić ponowne uruchomienie wszystkich procesów roboczych. Aby zminimalizować te typy ponownych uruchomień, ustaw wartość ustawienia aplikacji na 1wartość na wszystkie miejsca (wartość domyślna to0). Nie ustawiaj jednak tej wartości, jeśli używasz aplikacji Windows Communication Foundation (WCF). Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z zamianami
WEBSITE_PROACTIVE_AUTOHEAL_ENABLED Domyślnie wystąpienie maszyny wirtualnej jest aktywnie "autohealed", gdy używa ponad 90% przydzielonej pamięci przez ponad 30 sekund lub gdy 80% łącznych żądań w ciągu ostatnich dwóch minut trwa dłużej niż 200 sekund. Jeśli wystąpienie maszyny wirtualnej wyzwoliło jedną z tych reguł, proces odzyskiwania to nakładające się ponowne uruchomienie wystąpienia. Ustaw wartość na , aby false wyłączyć to zachowanie odzyskiwania. Wartość domyślna to true. Aby uzyskać więcej informacji, zobacz Proaktywne automatyczne korygowanie.
WEBSITE_PROACTIVE_CRASHMONITORING_ENABLED Za każdym razem, gdy proces w3wp.exe w wystąpieniu maszyny wirtualnej aplikacji ulegnie awarii z powodu nieobsługiwanego wyjątku przez ponad trzy razy w ciągu 24 godzin, proces debugera jest dołączany do głównego procesu roboczego w tym wystąpieniu i zbiera zrzut pamięci, gdy proces roboczy ulegnie awarii ponownie. Ten zrzut pamięci jest następnie analizowany, a stos wywołań wątku, który spowodował awarię, jest rejestrowany w dziennikach usługi App Service. Ustaw wartość na , aby false wyłączyć to zachowanie automatycznego monitorowania. Wartość domyślna to true. Aby uzyskać więcej informacji, zobacz Proaktywne monitorowanie awarii.
WEBSITE_DAAS_STORAGE_SASURI Podczas monitorowania awarii (proaktywne lub ręczne) zrzuty pamięci są domyślnie usuwane. Aby zapisać zrzuty pamięci w kontenerze obiektów blob magazynu, określ identyfikator URI sygnatury dostępu współdzielonego.
WEBSITE_CRASHMONITORING_ENABLED Ustaw wartość na , aby true ręcznie włączyć monitorowanie awarii . Należy również ustawić WEBSITE_DAAS_STORAGE_SASURI i WEBSITE_CRASHMONITORING_SETTINGS. Wartość domyślna to false. To ustawienie nie ma wpływu, jeśli zdalne debugowanie jest włączone. Ponadto jeśli to ustawienie jest ustawione na truewartość , aktywne monitorowanie awarii jest wyłączone.
WEBSITE_CRASHMONITORING_SETTINGS Kod JSON z następującym formatem:{"StartTimeUtc": "2020-02-10T08:21","MaxHours": "<elapsed-hours-from-StartTimeUtc>","MaxDumpCount": "<max-number-of-crash-dumps>"} Wymagane do skonfigurowania monitorowania awarii, jeśli WEBSITE_CRASHMONITORING_ENABLED jest określony. Aby zarejestrować tylko stos wywołań bez zapisywania zrzutu awaryjnego na koncie magazynu, dodaj ,"UseStorageAccount":"false" kod JSON.
REMOTEDEBUGGINGVERSION Wersja zdalnego debugowania.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING Domyślnie usługa App Service tworzy udostępniony magazyn podczas tworzenia aplikacji. Aby zamiast tego użyć niestandardowego konta magazynu, ustaw wartość parametry połączenia konta magazynu. Aby uzyskać informacje o funkcjach, zobacz Dokumentacja ustawień aplikacji dla usługi Functions. DefaultEndpointsProtocol=https;AccountName=<name>;AccountKey=<key>
WEBSITE_CONTENTSHARE W przypadku użycia określenia niestandardowego konta magazynu za WEBSITE_CONTENTAZUREFILECONNECTIONSTRINGpomocą usługi App Service usługa App Service tworzy udział plików na tym koncie magazynu dla aplikacji. Aby użyć nazwy niestandardowej, ustaw tę zmienną na odpowiednią nazwę. Jeśli udział plików o określonej nazwie nie istnieje, usługa App Service utworzy go dla Ciebie. myapp123
WEBSITE_SCM_ALWAYS_ON_ENABLED Tylko do odczytu. Pokazuje, czy opcja Always On jest włączona (1) czy nie (0).
WEBSITE_SCM_SEPARATE_STATUS Tylko do odczytu. Pokazuje, czy aplikacja Kudu jest uruchomiona w osobnym procesie (1), czy nie (0).
WEBSITE_DNS_ATTEMPTS Liczba prób rozpoznania nazwy.
WEBSITE_DNS_TIMEOUT Liczba sekund oczekiwania na rozpoznawanie nazwy

Prefiksy zmiennych

W poniższej tabeli przedstawiono prefiksy zmiennych środowiskowych używane przez usługę App Service do różnych celów.

Nazwa ustawienia opis
APPSETTING_ Oznacza, że zmienna jest ustawiana przez klienta jako ustawienie aplikacji w konfiguracji aplikacji. Jest ona wprowadzana do aplikacji .NET jako ustawienia aplikacji.
MAINSITE_ Oznacza, że zmienna jest specyficzna dla samej aplikacji.
SCMSITE_ Oznacza zmienną specyficzną dla aplikacji Kudu.
SQLCONNSTR_ Oznacza parametry połączenia programu SQL Server w konfiguracji aplikacji. Jest on wstrzykiwany do aplikacji .NET jako parametry połączenia.
SQLAZURECONNSTR_ Oznacza parametry połączenia usługi Azure SQL Database w konfiguracji aplikacji. Jest on wstrzykiwany do aplikacji .NET jako parametry połączenia.
POSTGRESQLCONNSTR_ Oznacza parametry połączenia PostgreSQL w konfiguracji aplikacji. Jest on wstrzykiwany do aplikacji .NET jako parametry połączenia.
CUSTOMCONNSTR_ Oznacza niestandardowe parametry połączenia w konfiguracji aplikacji. Jest on wstrzykiwany do aplikacji .NET jako parametry połączenia.
MYSQLCONNSTR_ Oznacza parametry połączenia bazy danych MySQL w konfiguracji aplikacji. Jest on wstrzykiwany do aplikacji .NET jako parametry połączenia.
AZUREFILESSTORAGE_ Parametry połączenia do udziału niestandardowego dla kontenera niestandardowego w usłudze Azure Files.
AZUREBLOBSTORAGE_ Parametry połączenia do niestandardowego konta magazynu dla niestandardowego kontenera w usłudze Azure Blob Storage.
NOTIFICATIONHUBCONNSTR_ Oznacza parametry połączenia do centrum powiadomień w usłudze Azure Notification Hubs.
SERVICEBUSCONNSTR_ Oznacza parametry połączenia do wystąpienia usługi Azure Service Bus.
EVENTHUBCONNSTR_ Oznacza parametry połączenia do centrum zdarzeń w usłudze Azure Event Hubs.
DOCDBCONNSTR_ Oznacza parametry połączenia do bazy danych w usłudze Azure Cosmos DB.
REDISCACHECONNSTR_ Oznacza parametry połączenia do pamięci podręcznej w usłudze Azure Cache for Redis.
FILESHARESTORAGE_ Oznacza parametry połączenia do niestandardowego udziału plików.

Wdrożenie

Następujące zmienne środowiskowe są powiązane z wdrażaniem aplikacji. Aby uzyskać informacje o zmiennych związanych z automatyzacją kompilacji usługi App Service, zobacz Build Automation (Automatyzacja kompilacji).

Nazwa ustawienia opis
DEPLOYMENT_BRANCH W przypadku lokalnego wdrożenia git lub usługi Git w chmurze (takiego jak GitHub) ustaw gałąź na platformie Azure, do której chcesz wdrożyć. Domyślnie jest masterto .
WEBSITE_RUN_FROM_PACKAGE Ustaw wartość na , aby 1 uruchomić aplikację z lokalnego pakietu ZIP, lub ustaw adres URL zewnętrznego adresu URL, aby uruchomić aplikację ze zdalnego pakietu ZIP. Aby uzyskać więcej informacji, zobacz Uruchamianie aplikacji w usłudze aplikacja systemu Azure bezpośrednio z pakietu ZIP.
WEBSITE_USE_ZIP Przestarzałe. Użyj witryny WEBSITE_RUN_FROM_PACKAGE.
WEBSITE_RUN_FROM_ZIP Przestarzałe. Użyj witryny WEBSITE_RUN_FROM_PACKAGE.
SCM_MAX_ZIP_PACKAGE_COUNT Aplikacja przechowuje 5 najnowszych plików zip wdrożonych przy użyciu narzędzia zip deploy. Możesz zachować więcej lub mniej, ustawiając ustawienie aplikacji na inną liczbę.
WEBSITE_WEBDEPLOY_USE_SCM Ustaw wartość na false dla narzędzia WebDeploy, aby zatrzymać korzystanie z aparatu wdrażania Kudu. Wartość domyślna to true. Aby wdrożyć w aplikacjach systemu Linux przy użyciu programu Visual Studio (WebDeploy/MSDeploy), ustaw ją na false.
MSDEPLOY_RENAME_LOCKED_FILES Ustaw wartość na , aby 1 podjąć próbę zmiany nazwy bibliotek DLL, jeśli nie można ich skopiować podczas wdrażania narzędzia WebDeploy. To ustawienie nie ma zastosowania, jeśli WEBSITE_WEBDEPLOY_USE_SCM jest ustawione na false.
WEBSITE_DISABLE_SCM_SEPARATION Domyślnie główna aplikacja i aplikacja Kudu działają w różnych piaskownicach. Po zatrzymaniu aplikacji aplikacja Kudu jest nadal uruchomiona i możesz nadal korzystać z narzędzia Git deploy i MSDeploy. Każda aplikacja ma własne pliki lokalne. Wyłączenie tej separacji (ustawienie na true) jest trybem starszym, który nie jest już w pełni obsługiwany.
WEBSITE_ENABLE_SYNC_UPDATE_SITE Ustaw wartość , aby upewnić się 1 , że wywołania interfejsu API REST do aktualizacji site i siteconfig są całkowicie stosowane do wszystkich wystąpień przed zwróceniem. Ustawieniem domyślnym jest 1 wdrożenie przy użyciu szablonu usługi ARM, aby uniknąć warunków wyścigu z kolejnymi wywołaniami usługi ARM.
WEBSITE_START_SCM_ON_SITE_CREATION We wdrożeniu szablonu usługi ARM ustaw wartość na 1 w szablonie usługi ARM, aby wstępnie uruchomić aplikację Kudu w ramach tworzenia aplikacji.
WEBSITE_START_SCM_WITH_PRELOAD W przypadku aplikacji systemu Linux ustaw wartość na true wartość , aby wymusić wstępne ładowanie aplikacji Kudu po włączeniu funkcji Always On przez polecenie ping do adresu URL. Wartość domyślna to false. W przypadku aplikacji systemu Windows aplikacja Kudu jest zawsze ładowana wstępnie.

Automatyzacja kompilacji

Konfiguracja kompilacji Kudu ma zastosowanie do natywnych aplikacji systemu Windows i służy do kontrolowania zachowania wdrożeń opartych na usłudze Git (lub opartych na pliku ZIP).

Nazwa ustawienia opis Przykład
SCM_BUILD_ARGS Dodaj elementy na końcu wiersza polecenia msbuild, tak aby zastąpić wszystkie poprzednie części domyślnego wiersza polecenia. Aby wykonać czystą kompilację: -t:Clean;Compile
SCM_SCRIPT_GENERATOR_ARGS Kudu używa opisanego azure site deploymentscript tutaj polecenia w celu wygenerowania skryptu wdrożenia. Automatycznie wykrywa typ struktury językowej i określa parametry, które mają być przekazywane do polecenia. To ustawienie zastępuje automatycznie wygenerowane parametry. Aby traktować repozytorium jako zwykłe pliki zawartości: --basic -p <folder-to-deploy>
SCM_TRACE_LEVEL Poziom śledzenia kompilacji. Wartość domyślna to 1. Ustaw wartość na wyższe wartości, maksymalnie 4, aby uzyskać więcej śledzenia. 4
SCM_COMMAND_IDLE_TIMEOUT Upłynął limit czasu w sekundach dla każdego polecenia, które proces kompilacji uruchamia, zanim nie generuje żadnych danych wyjściowych. Następnie polecenie jest uznawane za bezczynne i zabite. Wartość domyślna to 60 (jedna minuta). Na platformie Azure istnieje również ogólny limit czasu bezczynności żądania, który rozłącza klientów po 230 sekundach. Jednak polecenie będzie nadal działać po stronie serwera po tej stronie.
SCM_LOGSTREAM_TIMEOUT Przekroczenie limitu czasu braku aktywności w sekundach przed zatrzymaniem przesyłania strumieniowego dzienników. Wartość domyślna to 1800 (30 minut).
SCM_SITEEXTENSIONS_FEED_URL Adres URL galerii rozszerzeń witryny. Wartość domyślna to https://www.nuget.org/api/v2/. Adres URL starego źródła danych to http://www.siteextensions.net/api/v2/.
SCM_USE_LIBGIT2SHARP_REPOSITORY Ustaw wartość na wartość , aby 0 używać git.exe zamiast libgit2sharp na potrzeby operacji git.
WEBSITE_LOAD_USER_PROFILE W przypadku błędu The specified user does not have a valid profile. podczas ASP.NET automatyzacji kompilacji (np. podczas wdrażania usługi Git) ustaw tę zmienną tak, aby załadowała 1 pełny profil użytkownika w środowisku kompilacji. To ustawienie ma zastosowanie tylko wtedy, gdy WEBSITE_COMPUTE_MODE ma wartość Dedicated.
WEBSITE_SCM_IDLE_TIMEOUT_IN_MINUTES Limit czasu w minutach dla lokacji SCM (Kudu). Wartość domyślna to 20.
SCM_DO_BUILD_DURING_DEPLOYMENT W przypadku wdrożenia pliku ZIP aparat wdrażania zakłada, że plik ZIP jest gotowy do uruchomienia jako i nie uruchamia żadnej automatyzacji kompilacji. Aby włączyć tę samą automatyzację kompilacji co w ramach wdrażania git, ustaw wartość true.

Ustawienia specyficzne dla języka

W tej sekcji przedstawiono konfigurowalne ustawienia środowiska uruchomieniowego dla każdej obsługiwanej platformy językowej. Dodatkowe ustawienia są dostępne podczas automatyzacji kompilacji w czasie wdrażania.

Nazwa ustawienia opis
PORT Tylko do odczytu. W przypadku aplikacji systemu Linux port, na który nasłuchuje środowisko uruchomieniowe platformy .NET w kontenerze.
WEBSITE_ROLE_INSTANCE_ID Tylko do odczytu. Identyfikator bieżącego wystąpienia.
HOME Tylko do odczytu. Katalog wskazujący magazyn udostępniony (/home).
DUMP_DIR Tylko do odczytu. Katalog zrzutów awaryjnych (/home/logs/dumps).
APP_SVC_RUN_FROM_COPY Tylko aplikacje systemu Linux. Domyślnie aplikacja jest uruchamiana z /home/site/wwwrootkatalogu udostępnionego dla wszystkich wystąpień skalowanych w poziomie. Ustaw tę zmienną, aby true skopiować aplikację do katalogu lokalnego w kontenerze i uruchomić ją stamtąd. W przypadku korzystania z tej opcji pamiętaj, aby nie kodować żadnych odwołań do /home/site/wwwrootelementu . Zamiast tego użyj ścieżki względem /home/site/wwwroot.
MACHINEKEY_Decryption W przypadku aplikacji natywnych systemu Windows lub aplikacji konteneryzowanych systemu Windows ta zmienna jest wstrzykiwana do środowiska aplikacji lub kontenera w celu włączenia procedur kryptograficznych ASP.NET (zobacz machineKey, element. Aby zastąpić wartość domyślną decryption , skonfiguruj ją jako ustawienie aplikacji usługi App Service lub ustaw ją bezpośrednio w machineKey elemenie pliku Web.config .
MACHINEKEY_DecryptionKey W przypadku aplikacji natywnych systemu Windows lub aplikacji konteneryzowanych systemu Windows ta zmienna jest wstrzykiwana do środowiska aplikacji lub kontenera w celu włączenia procedur kryptograficznych ASP.NET (zobacz machineKey, element. Aby zastąpić automatycznie wygenerowaną decryptionKey wartość, skonfiguruj ją jako ustawienie aplikacji usługi App Service lub ustaw ją bezpośrednio w machineKey elemenie pliku Web.config .
MACHINEKEY_Validation W przypadku aplikacji natywnych systemu Windows lub aplikacji konteneryzowanych systemu Windows ta zmienna jest wstrzykiwana do środowiska aplikacji lub kontenera w celu włączenia procedur kryptograficznych ASP.NET (zobacz machineKey, element. Aby zastąpić wartość domyślną validation , skonfiguruj ją jako ustawienie aplikacji usługi App Service lub ustaw ją bezpośrednio w machineKey elemenie pliku Web.config .
MACHINEKEY_ValidationKey W przypadku aplikacji natywnych systemu Windows lub aplikacji konteneryzowanych systemu Windows ta zmienna jest wstrzykiwana do środowiska aplikacji lub kontenera w celu włączenia procedur kryptograficznych ASP.NET (zobacz machineKey, element. Aby zastąpić automatycznie wygenerowaną validationKey wartość, skonfiguruj ją jako ustawienie aplikacji usługi App Service lub ustaw ją bezpośrednio w machineKey elemenie pliku Web.config .

WordPress

Ustawienie aplikacji Scope Wartość Maksimum opis
WEBSITES_ENABLE_APP_SERVICE_STORAGE Aplikacja internetowa prawda - Po ustawieniu wartości TRUE zawartość pliku jest zachowywana podczas ponownego uruchamiania.
WP_MEMORY_LIMIT WordPress 128 mln 512 mln Fronton lub ogólny limit pamięci php wordpress (na skrypt). Nie można być więcej niż PHP_MEMORY_LIMIT
WP_MAX_MEMORY_LIMIT WordPress 256 mln 512 mln Limit pamięci php pulpitu nawigacyjnego administratora (na skrypt). Ogólnie rzecz biorąc, pulpit nawigacyjny administratora/skrypty zaplecza zajmują dużo pamięci w porównaniu ze skryptami frontonu. Nie można być więcej niż PHP_MEMORY_LIMIT.
PHP_MEMORY_LIMIT PHP 512 mln 512 mln Limity pamięci dla ogólnego skryptu PHP. Można go zmniejszyć tylko.
FILE_UPLOADS PHP Włączone - Może być włączony lub wyłączony. Należy pamiętać, że w wartościach uwzględniana jest wielkość liter. Włącza lub wyłącza przekazywanie plików.
UPLOAD_MAX_FILESIZE PHP 50 mln 256M Maksymalny limit rozmiaru przekazywania plików. Można zwiększyć do 256 mln.
POST_MAX_SIZE PHP 128 mln 256 mln Można zwiększyć do 256 mln. Ogólnie rzecz biorąc, powinno być więcej niż UPLOAD_MAX_FILESIZE.
MAX_EXECUTION_TIME PHP 120 120 Można zmniejszyć tylko. Podziel skrypty, jeśli zajmuje więcej niż 120 sekund. Dodano polecenie , aby uniknąć spowolnienia systemu przez nieprawidłowe skrypty.
MAX_INPUT_TIME PHP 120 120 Maksymalny limit czasu analizowania żądań wejściowych. Można zmniejszyć tylko.
MAX_INPUT_VARS PHP 10 000 10 000 -
DATABASE_HOST baza danych - - Host bazy danych używany do nawiązywania połączenia z platformą WordPress.
DATABASE_NAME baza danych - - Nazwa bazy danych używana do nawiązywania połączenia z platformą WordPress.
DATABASE_USERNAME baza danych - - Nazwa użytkownika bazy danych używana do nawiązywania połączenia z platformą WordPress.
DATABASE_PASSWORD baza danych - - Hasło bazy danych używane do nawiązywania połączenia z bazą danych MySQL. Aby zmienić hasło bazy danych MySQL, zobacz aktualizowanie hasła administratora. Za każdym razem, gdy hasło bazy danych MySQL zostanie zmienione, należy również zaktualizować ustawienia aplikacji.
WORDPRESS_ADMIN_EMAIL Tylko wdrożenie - - Adres e-mail administratora platformy WordPress.
WORDPRESS_ADMIN_PASSWORD Tylko wdrożenie - - Hasło administratora platformy WordPress. Jest to przeznaczone tylko do celów wdrażania. Modyfikowanie tej wartości nie ma wpływu na instalację WordPress. Aby zmienić hasło administratora platformy WordPress, zobacz resetowanie hasła.
WORDPRESS_ADMIN_USER Tylko wdrożenie - - Nazwa użytkownika administratora platformy WordPress
WORDPRESS_ADMIN_LOCALE_CODE Tylko wdrożenie - - Nazwa użytkownika bazy danych używana do nawiązywania połączenia z platformą WordPress.

Domena i system DNS

Nazwa ustawienia opis Przykład
WEBSITE_DNS_SERVER Adres IP podstawowego serwera DNS dla połączeń wychodzących (takich jak usługa zaplecza). Domyślny serwer DNS dla usługi App Service to Azure DNS, którego adres IP to 168.63.129.16. Jeśli aplikacja korzysta z integracji z siecią wirtualną lub znajduje się w środowisku usługi App Service, dziedziczy konfigurację serwera DNS z sieci wirtualnej domyślnie. 10.0.0.1
WEBSITE_DNS_ALT_SERVER Adres IP rezerwowego serwera DNS dla połączeń wychodzących. Zobacz: WEBSITE_DNS_SERVER.
WEBSITE_ENABLE_DNS_CACHE Umożliwia buforowanie pomyślnych rozwiązań DNS. Domyślnie wygasłe wpisy pamięci podręcznej DNS będą opróżniane i oprócz istniejącej pamięci podręcznej do opróżnienia co 4,5 minut.

TLS/SSL

Aby uzyskać więcej informacji, zobacz Używanie certyfikatu TLS/SSL w kodzie w usłudze aplikacja systemu Azure Service.

Nazwa ustawienia opis
WEBSITE_LOAD_CERTIFICATES Rozdzielane przecinkami wartości odcisku palca do certyfikatu, który chcesz załadować w kodzie, lub * aby zezwolić na załadowanie wszystkich certyfikatów w kodzie. Można załadować tylko certyfikaty dodane do aplikacji .
WEBSITE_PRIVATE_CERTS_PATH Tylko do odczytu. Ścieżka w kontenerze systemu Windows do załadowanych certyfikatów prywatnych.
WEBSITE_PUBLIC_CERTS_PATH Tylko do odczytu. Ścieżka w kontenerze systemu Windows do załadowanych certyfikatów publicznych.
WEBSITE_INTERMEDIATE_CERTS_PATH Tylko do odczytu. Ścieżka w kontenerze systemu Windows do załadowanych certyfikatów pośrednich.
WEBSITE_ROOT_CERTS_PATH Tylko do odczytu. Ścieżka w kontenerze systemu Windows do załadowanych certyfikatów głównych.

Miejsca wdrożenia

Aby uzyskać więcej informacji na temat miejsc wdrożenia, zobacz Konfigurowanie środowisk przejściowych w usłudze aplikacja systemu Azure Service.

Nazwa ustawienia opis Przykład
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS Domyślnie wersje rozszerzeń lokacji są specyficzne dla każdego miejsca. Zapobiega to nieoczekiwanym zachowaniom aplikacji ze względu na zmianę wersji rozszerzeń po zamianie. Jeśli chcesz również zamienić wersje rozszerzeń, ustaw wartość 0 na wszystkie miejsca.
WEBSITE_OVERRIDE_PRESERVE_DEFAULT_STICKY_SLOT_SETTINGS Wyznacza pewne ustawienia jako lepkie lub nie domyślnie możliwe do zamiany. Wartość domyślna to true. Ustaw to ustawienie na false lub 0 dla wszystkich miejsc wdrożenia, aby zamienić je zamiast tego. Nie ma precyzyjnej kontroli dla określonych typów ustawień.
WEBSITE_SWAP_WARMUP_PING_PATH Ścieżka do ping, aby rozgrzać miejsce docelowe w zamian, zaczynając od ukośnika. Wartość domyślna to /, która wysyła polecenie ping do ścieżki głównej za pośrednictwem protokołu HTTP. /statuscheck
WEBSITE_SWAP_WARMUP_PING_STATUSES Prawidłowe kody odpowiedzi HTTP dla operacji rozgrzewki podczas zamiany. Jeśli zwrócony kod stanu nie znajduje się na liście, operacje rozgrzewki i zamiany zostaną zatrzymane. Domyślnie wszystkie kody odpowiedzi są prawidłowe. 200,202
WEBSITE_SLOT_NUMBER_OF_TIMEOUTS_BEFORE_RESTART Podczas zamiany miejsca maksymalna liczba limitów czasu, po których wymusimy ponowne uruchomienie lokacji w określonym wystąpieniu maszyny wirtualnej. Wartość domyślna to 3.
WEBSITE_SLOT_MAX_NUMBER_OF_TIMEOUTS Podczas zamiany miejsca maksymalna liczba żądań przekroczenia limitu czasu dla pojedynczego adresu URL do wykonania przed rezygnacją. Wartość domyślna to 5.
WEBSITE_SKIP_ALL_BINDINGS_IN_APPHOST_CONFIG Ustaw wartość lub true 1 , aby pominąć wszystkie powiązania w pliku applicationHost.config. Wartość domyślna to false. Jeśli aplikacja wyzwoli ponowne uruchomienie, ponieważ applicationHost.config jest aktualizowana z zamienione nazwy hostów miejsc, ustaw tę zmienną, aby true uniknąć ponownego uruchomienia tego rodzaju. Jeśli używasz aplikacji Windows Communication Foundation (WCF), nie ustawiaj tej zmiennej.

Kontenery niestandardowe

Aby uzyskać więcej informacji na temat kontenerów niestandardowych, zobacz Uruchamianie niestandardowego kontenera na platformie Azure.

Nazwa ustawienia opis Przykład
WEBSITES_ENABLE_APP_SERVICE_STORAGE W przypadku kontenerów niestandardowych systemu Linux: ustaw wartość na wartość , aby true umożliwić /home udostępnianie katalogu w skalowanych wystąpieniach. Wartość domyślna dotyczy false kontenerów niestandardowych systemu Linux.

W przypadku kontenerów systemu Windows: ustaw wartość na , aby true umożliwić c:\home udostępnianie katalogu w skalowanych wystąpieniach. Wartość domyślna dotyczy true kontenerów systemu Windows.
WEBSITES_CONTAINER_START_TIME_LIMIT Czas w sekundach oczekiwania na ukończenie uruchamiania kontenera przed ponownym uruchomieniem kontenera. Wartość domyślna to 230. Można go zwiększyć do maksymalnej wartości 1800.
WEBSITES_CONTAINER_STOP_TIME_LIMIT Czas oczekiwania na zakończenie kontenera w ciągu kilku sekund. Wartość domyślna to 5. Można zwiększyć do maksymalnej wartości 120
DOCKER_REGISTRY_SERVER_URL Adres URL serwera rejestru podczas uruchamiania niestandardowego kontenera w usłudze App Service. W przypadku zabezpieczeń ta zmienna nie jest przekazywana do kontenera. https://<server-name>.azurecr.io
DOCKER_REGISTRY_SERVER_USERNAME Nazwa użytkownika do uwierzytelniania za pomocą serwera rejestru pod adresem DOCKER_REGISTRY_SERVER_URL. W przypadku zabezpieczeń ta zmienna nie jest przekazywana do kontenera.
DOCKER_REGISTRY_SERVER_PASSWORD Hasło do uwierzytelniania na serwerze rejestru pod adresem DOCKER_REGISTRY_SERVER_URL. W przypadku zabezpieczeń ta zmienna nie jest przekazywana do kontenera.
DOCKER_ENABLE_CI Ustaw wartość , aby true włączyć ciągłe wdrażanie dla kontenerów niestandardowych. Wartość domyślna dotyczy false kontenerów niestandardowych.
WEBSITE_PULL_IMAGE_OVER_VNET Łączenie i ściąganie z rejestru w sieci wirtualnej lub lokalnie. Aplikacja musi być połączona z siecią wirtualną przy użyciu funkcji integracji z siecią wirtualną. To ustawienie jest również wymagane w przypadku usługi Azure Container Registry z prywatnym punktem końcowym.
WEBSITES_WEB_CONTAINER_NAME W aplikacji Docker Compose tylko jeden z kontenerów może być dostępny z Internetu. Ustaw wartość na nazwę kontenera zdefiniowanego w pliku konfiguracji, aby zastąpić domyślny wybór kontenera. Domyślnie kontener dostępny z Internetu jest pierwszym kontenerem do zdefiniowania portu 80 lub 8080 lub, gdy taki kontener nie zostanie znaleziony, pierwszy kontener zdefiniowany w pliku konfiguracji.
WEBSITES_PORT W przypadku kontenera niestandardowego niestandardowy numer portu w kontenerze dla usługi App Service w celu kierowania żądań do. Domyślnie usługa App Service próbuje automatycznie wykrywać porty 80 i 8080. To ustawienie nie jest wstrzykiwane do kontenera jako zmienna środowiskowa.
WEBSITE_CPU_CORES_LIMIT Domyślnie kontener systemu Windows jest uruchamiany ze wszystkimi dostępnymi rdzeniami dla wybranej warstwy cenowej. Aby zmniejszyć liczbę rdzeni, ustaw limit żądanych rdzeni. Aby uzyskać więcej informacji, zobacz Dostosowywanie liczby rdzeni obliczeniowych.
WEBSITE_MEMORY_LIMIT_MB Domyślnie wszystkie kontenery systemu Windows wdrożone w usłudze aplikacja systemu Azure service mają skonfigurowany limit pamięci w zależności od jednostki SKU planu usługi App Service. Ustaw żądany limit pamięci w MB. Skumulowana suma tego ustawienia dla aplikacji w tym samym planie nie może przekraczać kwoty dozwolonej przez wybraną warstwę cenową. Aby uzyskać więcej informacji, zobacz Dostosowywanie pamięci kontenera.

Skalowanie

Nazwa ustawienia opis
WEBSITE_INSTANCE_ID Tylko do odczytu. Unikatowy identyfikator bieżącego wystąpienia maszyny wirtualnej, gdy aplikacja jest skalowana w poziomie do wielu wystąpień.
WEBSITE_IIS_SITE_NAME Przestarzałe. Użyj witryny WEBSITE_INSTANCE_ID.
WEBSITE_DISABLE_OVERLAPPED_RECYCLING Nakładające się odtwarzanie sprawia, że przed zamknięciem bieżącego wystąpienia maszyny wirtualnej aplikacji zostanie uruchomione nowe wystąpienie maszyny wirtualnej. W niektórych przypadkach może to spowodować problemy z blokowaniem plików. Możesz spróbować go wyłączyć, ustawiając wartość .1
WEBSITE_DISABLE_CROSS_STAMP_SCALE Domyślnie aplikacje mogą być skalowane między sygnaturami, jeśli używają usługi Azure Files lub kontenera platformy Docker. Ustaw wartość na 1 lub true wyłącz skalowanie krzyżowe w regionie aplikacji. Wartość domyślna to 0. Niestandardowe kontenery platformy Docker ustawione WEBSITES_ENABLE_APP_SERVICE_STORAGE na lub 1 nie mogą skalować true sygnatur krzyżowych, ponieważ ich zawartość nie jest całkowicie hermetyzowana w kontenerze platformy Docker.

Rejestrowanie

Nazwa ustawienia opis Przykład
WEBSITE_HTTPLOGGING_ENABLED Tylko do odczytu. Pokazuje, czy rejestrowanie serwera internetowego dla aplikacji natywnych systemu Windows jest włączone () lub1 nie (0).
WEBSITE_HTTPLOGGING_RETENTION_DAYS Okres przechowywania w dniach dzienników serwera internetowego, jeśli dzienniki serwera internetowego są włączone dla aplikacji natywnej systemu Windows lub Linux. 10
WEBSITE_HTTPLOGGING_CONTAINER_URL Adres URL sygnatury dostępu współdzielonego kontenera usługi Blob Storage do przechowywania dzienników serwera internetowego dla aplikacji natywnych systemu Windows, jeśli dzienniki serwera internetowego są włączone. Jeśli nie zostanie ustawiona, dzienniki serwera internetowego są przechowywane w systemie plików aplikacji (domyślny magazyn udostępniony).
DIAGNOSTICS_AZUREBLOBRETENTIONINDAYS Okres przechowywania w dniach dzienników aplikacji dla aplikacji natywnych systemu Windows, jeśli dzienniki aplikacji są włączone. 10
DIAGNOSTICS_AZUREBLOBCONTAINERSASURL Adres URL sygnatury dostępu współdzielonego kontenera usługi Blob Storage do przechowywania dzienników aplikacji dla aplikacji natywnych systemu Windows, jeśli dzienniki aplikacji są włączone.
APPSERVICEAPPLOGS_TRACE_LEVEL Minimalny poziom dziennika do wysłania do usługi Log Analytics dla typu dziennika AppServiceAppLogs .
DIAGNOSTICS_LASTRESORTFILE Nazwa pliku do utworzenia lub ścieżki względnej do katalogu dziennika w celu rejestrowania błędów wewnętrznych na potrzeby rozwiązywania problemów z odbiornikiem. Wartość domyślna to logging-errors.txt.
DIAGNOSTICS_LOGGINGSETTINGSFILE Ścieżka do pliku ustawień dziennika względem D:\home lub /home. Wartość domyślna to site\diagnostics\settings.json.
DIAGNOSTICS_TEXTTRACELOGDIRECTORY Folder dziennika względem katalogu głównego aplikacji (D:\home\site\wwwroot lub /home/site/wwwroot). ..\..\LogFiles\Application
DIAGNOSTICS_TEXTTRACEMAXLOGFILESIZEBYTES Maksymalny rozmiar pliku dziennika w bajtach. Wartość domyślna to 131072 (128 KB).
DIAGNOSTICS_TEXTTRACEMAXLOGFOLDERSIZEBYTES Maksymalny rozmiar folderu dziennika w bajtach. Wartość domyślna to 1048576 (1 MB).
DIAGNOSTICS_TEXTTRACEMAXNUMLOGFILES Maksymalna liczba plików dziennika do zachowania. Wartość domyślna to 20.
DIAGNOSTICS_TEXTTRACETURNOFFPERIOD Limit czasu w milisekundach w celu zachowania włączonego rejestrowania aplikacji. Wartość domyślna to 43200000 (12 godzin).
WEBSITE_LOG_BUFFERING Domyślnie buforowanie dzienników jest włączone. Ustaw wartość , aby 0 ją wyłączyć.
WEBSITE_ENABLE_PERF_MODE W przypadku natywnych aplikacji systemu Windows ustaw wartość na wartość , aby TRUE wyłączyć wpisy dziennika usług IIS dla żądań zakończonych powodzeniem zwróconych w ciągu 10 sekund. Jest to szybki sposób wykonywania testów porównawczych wydajności przez usunięcie rozszerzonego rejestrowania.

Liczniki wydajności

Poniżej przedstawiono zmienne środowiskowe "fałszywe", które nie istnieją, jeśli je wyliczysz, ale zwróć ich wartość, jeśli wyszukasz je indywidualnie. Wartość jest dynamiczna i może ulec zmianie w każdym wyszukiwaniu.

Nazwa ustawienia opis
WEBSITE_COUNTERS_ASPNET Obiekt JSON zawierający liczniki wydajności ASP.NET.
WEBSITE_COUNTERS_APP Obiekt JSON zawierający liczniki piaskownicy.
WEBSITE_COUNTERS_CLR Obiekt JSON zawierający liczniki CLR.
WEBSITE_COUNTERS_ALL Obiekt JSON zawierający kombinację pozostałych trzech zmiennych.

Buforowanie

Nazwa ustawienia opis
WEBSITE_LOCAL_CACHE_OPTION Określa, czy jest włączona lokalna pamięć podręczna. Dostępne opcje to:
- Default: Dziedzicz ustawienie globalne na poziomie sygnatury.
- Always: Włącz dla aplikacji.
- OnStorageUnavailability
- Disabled: wyłączone dla aplikacji.
WEBSITE_LOCAL_CACHE_READWRITE_OPTION Opcje odczytu i zapisu lokalnej pamięci podręcznej. Dostępne opcje to:
- ReadOnly: Pamięć podręczna jest tylko do odczytu.
- WriteButDiscardChanges: Zezwalaj na zapisy w lokalnej pamięci podręcznej, ale odrzucaj zmiany wprowadzone lokalnie.
WEBSITE_LOCAL_CACHE_SIZEINMB Rozmiar lokalnej pamięci podręcznej w MB. Wartość domyślna to 1000 (1 GB).
WEBSITE_LOCALCACHE_READY Flaga tylko do odczytu wskazująca, czy aplikacja korzysta z lokalnej pamięci podręcznej.
WEBSITE_DYNAMIC_CACHE Ze względu na charakter udostępniony plików sieciowych w celu umożliwienia dostępu do wielu wystąpień dynamiczna pamięć podręczna zwiększa wydajność przez buforowanie ostatnio używanych plików lokalnie na wystąpieniu. Pamięć podręczna jest unieważniona po zmodyfikowaniu pliku. Lokalizacja pamięci podręcznej to %SYSTEMDRIVE%\local\DynamicCache (stosowany jest ten sam %SYSTEMDRIVE%\local limit przydziału). Aby włączyć buforowanie pełnej zawartości, ustaw wartość 1, która zawiera zarówno zawartość pliku, jak i metadane katalogu/pliku (sygnatury czasowe, rozmiar, zawartość katalogu). Aby zaoszczędzić użycie dysku lokalnego, ustaw wartość na 2 buforowanie tylko metadanych katalogu/pliku (sygnatury czasowe, rozmiar, zawartość katalogu). Aby wyłączyć buforowanie, ustaw wartość 0. W przypadku aplikacji systemu Windows i aplikacji systemu Linux utworzonych za pomocą szablonu WordPress wartość domyślna to 1. W przypadku wszystkich innych aplikacji systemu Linux wartość domyślna to 0.
WEBSITE_READONLY_APP W przypadku korzystania z dynamicznej pamięci podręcznej można wyłączyć dostęp do zapisu w katalogu głównym aplikacji (D:\home\site\wwwroot lub /home/site/wwwroot), ustawiając tę zmienną na 1wartość . App_Data Z wyjątkiem katalogu nie są dozwolone żadne blokady wyłączne, dzięki czemu wdrożenia nie są blokowane przez zablokowane pliki.

Sieć

Następujące zmienne środowiskowe są powiązane z połączeniami hybrydowymi i integracją sieci wirtualnej.

Nazwa ustawienia opis
WEBSITE_RELAYS Tylko do odczytu. Dane potrzebne do skonfigurowania połączenia hybrydowego, w tym punktów końcowych i danych usługi Service Bus.
WEBSITE_REWRITE_TABLE Tylko do odczytu. Używane w czasie wykonywania wyszukiwania i ponownego zapisywania połączeń odpowiednio.
WEBSITE_VNET_ROUTE_ALL Domyślnie, jeśli używasz regionalnej integracji z siecią wirtualną, aplikacja kieruje tylko RFC1918 ruchu do sieci wirtualnej. Ustaw wartość na , aby 1 kierować cały ruch wychodzący do sieci wirtualnej i być objęty tymi samymi sieciowymi grupami zabezpieczeń i trasami zdefiniowanymi przez użytkownika. Ustawienie umożliwia dostęp do punktów końcowych innych niż RFC1918 za pośrednictwem sieci wirtualnej, zabezpieczanie całego ruchu wychodzącego opuszczającego aplikację i wymuszanie tunelowania całego ruchu wychodzącego do wybranego urządzenia sieciowego.
WEBSITE_PRIVATE_IP Tylko do odczytu. Adres IP skojarzony z aplikacją w przypadku integracji z siecią wirtualną. W przypadku regionalnej integracji z siecią wirtualną wartość to adres IP z zakresu adresów delegowanej podsieci, a w przypadku integracji z siecią wirtualną wymagana przez bramę wartość jest adresem IP z zakresu adresów puli adresów punkt-lokacja skonfigurowana w bramie sieci wirtualnej. Ten adres IP jest używany przez aplikację do łączenia się z zasobami za pośrednictwem sieci wirtualnej. Ponadto może ona ulec zmianie w obrębie opisanego zakresu adresów.
WEBSITE_PRIVATE_PORTS Tylko do odczytu. W obszarze Integracja z siecią wirtualną pokazuje, które porty są używane przez aplikację do komunikowania się z innymi węzłami.
WEBSITE_CONTENTOVERVNET Jeśli instalowania udziału plików platformy Azure w usłudze App Service i konto magazynu jest ograniczone do sieci wirtualnej, upewnij się, że to ustawienie ma wartość 1.

Odwołania do magazynu kluczy

Następujące zmienne środowiskowe są powiązane z odwołaniami do magazynu kluczy.

Nazwa ustawienia opis
WEBSITE_KEYVAULT_REFERENCES Tylko do odczytu. Zawiera informacje (w tym stany) dla wszystkich odwołań usługi Key Vault, które są obecnie skonfigurowane w aplikacji.
WEBSITE_SKIP_CONTENTSHARE_VALIDATION Jeśli ustawisz połączenie magazynu udostępnionego aplikacji (przy użyciu WEBSITE_CONTENTAZUREFILECONNECTIONSTRING) na odwołanie do usługi Key Vault, aplikacja nie będzie mogła rozpoznać odwołania do magazynu kluczy podczas tworzenia aplikacji lub aktualizowania, jeśli spełniony jest jeden z następujących warunków:
— Aplikacja uzyskuje dostęp do magazynu kluczy przy użyciu tożsamości przypisanej przez system.
— Aplikacja uzyskuje dostęp do magazynu kluczy przy użyciu tożsamości przypisanej przez użytkownika, a magazyn kluczy jest zablokowany za pomocą sieci wirtualnej.
Aby uniknąć błędów podczas tworzenia lub aktualizowania, ustaw tę zmienną na 1wartość .
WEBSITE_DELAY_CERT_DELETION Tę wariancę env można ustawić na 1 przez użytkowników, aby upewnić się, że certyfikat zależny od procesu roboczego nie zostanie usunięty, dopóki nie zakończy się.

CORS

Następujące zmienne środowiskowe są powiązane z konfiguracją współużytkowania zasobów między źródłami (CORS).

Nazwa ustawienia opis
WEBSITE_CORS_ALLOWED_ORIGINS Tylko do odczytu. Pokazuje dozwolone źródła mechanizmu CORS.
WEBSITE_CORS_SUPPORT_CREDENTIALS Tylko do odczytu. Pokazuje, czy ustawienie nagłówka Access-Control-Allow-Credentials na true wartość jest włączone () lubTrue nie (False).

Uwierzytelnianie i autoryzacja

Następujące zmienne środowiskowe są powiązane z uwierzytelnianiem usługi App Service.

Nazwa ustawienia opis
WEBSITE_AUTH_DISABLE_IDENTITY_FLOW Po ustawieniu wartości truena wartość wyłącza przypisywanie tożsamości podmiotu zabezpieczeń wątku na platformie ASP. Aplikacje internetowe oparte na platformie NET (w tym aplikacje funkcji w wersji 1). Ma to na celu umożliwienie deweloperom ochrony dostępu do witryny za pomocą uwierzytelniania, ale nadal używa oddzielnego mechanizmu logowania w ramach logiki aplikacji. Wartość domyślna to false.
WEBSITE_AUTH_HIDE_DEPRECATED_SID Usługa true lub false. Domyślna wartość to false. Jest to ustawienie dla starszej integracji usługi Azure Mobile Apps dla usługi aplikacja systemu Azure Service. Ustawienie tej wartości w celu true rozwiązania problemu polegającego na tym, że identyfikator SID (identyfikator zabezpieczeń) wygenerowany dla uwierzytelnionych użytkowników może ulec zmianie, jeśli użytkownik zmieni informacje o profilu. Zmiana tej wartości może spowodować zmianę istniejących identyfikatorów użytkowników usługi Azure Mobile Apps. Większość aplikacji nie musi używać tego ustawienia.
WEBSITE_AUTH_NONCE_DURATION Wartość przedziału czasu w formularzu _hours_:_minutes_:_seconds_. Wartość domyślna to 00:05:00, lub 5 minut. To ustawienie określa okres istnienia kryptograficznego, który nie jest generowany dla wszystkich identyfikatorów logowania opartych na przeglądarce. Jeśli logowanie nie powiedzie się w określonym czasie, przepływ logowania zostanie ponowiony automatycznie. To ustawienie aplikacji jest przeznaczone do użycia ze środowiskiem konfiguracji w wersji 1 (klasycznej). Jeśli używasz schematu konfiguracji uwierzytelniania w wersji 2, należy zamiast tego użyć login.nonce.nonceExpirationInterval wartości konfiguracji.
WEBSITE_AUTH_PRESERVE_URL_FRAGMENT Po ustawieniu wartości na wartość i true wybraniu przez użytkowników linków aplikacji zawierających fragmenty adresów URL proces logowania zapewni, że część adresu URL fragmentu adresu URL nie zostanie utracona w procesie przekierowywania logowania. Aby uzyskać więcej informacji, zobacz Dostosowywanie logowania i wylogowywanie się w usłudze aplikacja systemu Azure Service.
WEBSITE_AUTH_USE_LEGACY_CLAIMS Aby zachować zgodność z poprzednimi wersjami w ramach uaktualnień, moduł uwierzytelniania używa starszego mapowania oświadczeń krótkich na długie nazwy w interfejsie /.auth/me API, więc niektóre mapowania są wykluczone (np. "role"). Aby uzyskać bardziej nowoczesną wersję mapowań oświadczeń, ustaw tę zmienną na Falsewartość . W przykładzie "role" zostanie on zamapowany na długą nazwę oświadczenia "http://schemas.microsoft.com/ws/2008/06/identity/claims/role".
WEBSITE_AUTH_DISABLE_WWWAUTHENTICATE Usługa true lub false. Domyślna wartość to false. Gdy jest ustawiona wartość true, usuwa WWW-Authenticate nagłówek odpowiedzi HTTP z odpowiedzi wygenerowanych przez moduły odpowiedzi HTTP 401. To ustawienie aplikacji jest przeznaczone do użycia ze środowiskiem konfiguracji w wersji 1 (klasycznej). Jeśli używasz schematu konfiguracji uwierzytelniania w wersji 2, należy zamiast tego użyć identityProviders.azureActiveDirectory.login.disableWwwAuthenticate wartości konfiguracji.
WEBSITE_AUTH_STATE_DIRECTORY Lokalna ścieżka katalogu systemu plików, w której są przechowywane tokeny po włączeniu magazynu tokenów opartego na plikach. Domyślna wartość to %HOME%\Data\.auth. To ustawienie aplikacji jest przeznaczone do użycia ze środowiskiem konfiguracji w wersji 1 (klasycznej). Jeśli używasz schematu konfiguracji uwierzytelniania w wersji 2, należy zamiast tego użyć login.tokenStore.fileSystem.directory wartości konfiguracji.
WEBSITE_AUTH_TOKEN_CONTAINER_SASURL W pełni kwalifikowany adres URL kontenera obiektów blob. Nakazuje modułowi uwierzytelniania przechowywanie i ładowanie wszystkich zaszyfrowanych tokenów do określonego kontenera magazynu obiektów blob zamiast używania domyślnego lokalnego systemu plików.
WEBSITE_AUTH_TOKEN_REFRESH_HOURS Dowolna dodatnia liczba dziesiętna. Wartość domyślna to 72 (godziny). To ustawienie określa ilość czasu po wygaśnięciu tokenu sesji, za /.auth/refresh pomocą którego można odświeżyć interfejs API. Próby odświeżenia po tym okresie zakończą się niepowodzeniem, a użytkownicy końcowi będą musieli zalogować się ponownie. To ustawienie aplikacji jest przeznaczone do użycia ze środowiskiem konfiguracji w wersji 1 (klasycznej). Jeśli używasz schematu konfiguracji uwierzytelniania w wersji 2, należy zamiast tego użyć login.tokenStore.tokenRefreshExtensionHours wartości konfiguracji.
WEBSITE_AUTH_TRACE_LEVEL Steruje szczegółowością śladów uwierzytelniania zapisanych w rejestrowaniu aplikacji. Prawidłowe wartości to Off, , WarningError, Information, i Verbose. Domyślna wartość to Verbose.
WEBSITE_AUTH_VALIDATE_NONCE Usługa true lub false. Domyślna wartość to true. Ta wartość nigdy nie powinna być ustawiona na false wartość z wyjątkiem przypadków tymczasowego debugowania błędów weryfikacji kryptograficznych , które występują podczas logowania interakcyjnego. To ustawienie aplikacji jest przeznaczone do użycia ze środowiskiem konfiguracji w wersji 1 (klasycznej). Jeśli używasz schematu konfiguracji uwierzytelniania w wersji 2, należy zamiast tego użyć login.nonce.validateNonce wartości konfiguracji.
WEBSITE_AUTH_V2_CONFIG_JSON Ta zmienna środowiskowa jest wypełniana automatycznie przez platformę usługi aplikacja systemu Azure i służy do konfigurowania zintegrowanego modułu uwierzytelniania. Wartość tej zmiennej środowiskowej odpowiada konfiguracji uwierzytelniania w wersji 2 (innej niż klasyczna) dla bieżącej aplikacji w usłudze Azure Resource Manager. Nie jest ona przeznaczona do jawnego skonfigurowania.
WEBSITE_AUTH_ENABLED Tylko do odczytu. Wprowadzone do aplikacji systemu Windows lub Linux w celu wskazania, czy jest włączone uwierzytelnianie usługi App Service.
WEBSITE_AUTH_ENCRYPTION_KEY Domyślnie automatycznie wygenerowany klucz jest używany jako klucz szyfrowania. Aby zastąpić, ustaw odpowiedni klucz. Jest to zalecane, jeśli chcesz udostępniać tokeny lub sesje w wielu aplikacjach. Jeśli zostanie określony, zastępuje MACHINEKEY_DecryptionKey to ustawienie.
WEBSITE_AUTH_SIGNING_KEY Domyślnie automatycznie wygenerowany klucz jest używany jako klucz podpisywania. Aby zastąpić, ustaw odpowiedni klucz. Jest to zalecane, jeśli chcesz udostępniać tokeny lub sesje w wielu aplikacjach. Jeśli zostanie określony, zastępuje MACHINEKEY_ValidationKey to ustawienie.

Tożsamość zarządzana

Następujące zmienne środowiskowe są powiązane z tożsamościami zarządzanymi.

Nazwa ustawienia opis
IDENTITY_ENDPOINT Tylko do odczytu. Adres URL umożliwiający pobranie tokenu tożsamości zarządzanej aplikacji.
MSI_ENDPOINT Przestarzałe. Użyj witryny IDENTITY_ENDPOINT.
IDENTITY_HEADER Tylko do odczytu. Wartość, która musi zostać dodana do nagłówka X-IDENTITY-HEADER podczas tworzenia żądania HTTP GET do IDENTITY_ENDPOINT. Wartość jest obracana przez platformę.
MSI_SECRET Przestarzałe. Użyj witryny IDENTITY_HEADER.

Sprawdzanie kondycji

Następujące zmienne środowiskowe są powiązane z kontrolami kondycji.

Nazwa ustawienia opis
WEBSITE_HEALTHCHECK_MAXPINGFAILURES Maksymalna liczba nieudanych poleceń ping przed usunięciem wystąpienia. Ustaw wartość między 2 i 100. Podczas skalowania w górę lub w górę usługa App Service wysyła polecenie ping do ścieżki sprawdzania kondycji, aby upewnić się, że nowe wystąpienia są gotowe. Aby uzyskać więcej informacji, zobacz Kontrola kondycji.
WEBSITE_HEALTHCHECK_MAXUNHEALTHYWORKERPERCENT Aby uniknąć przeciążenia wystąpień w dobrej kondycji, nie zostanie wykluczona żadna połowa wystąpień. Jeśli na przykład plan usługi App Service jest skalowany do czterech wystąpień, a trzy są w złej kondycji, co najwyżej dwa zostaną wykluczone. Pozostałe dwa wystąpienia (jedna w dobrej kondycji i jedna w złej kondycji) będą nadal otrzymywać żądania. W najgorszym scenariuszu, w którym wszystkie wystąpienia są w złej kondycji, żaden z nich nie zostanie wykluczony. Aby zastąpić to zachowanie, ustaw wartość między 1 i 100. Wyższa wartość oznacza, że więcej wystąpień w złej kondycji zostanie usuniętych. Wartość domyślna to 50 (50%).

Powiadomienia wypychane do aplikacji

Następujące zmienne środowiskowe są powiązane z funkcją powiadomień wypychanych .

Nazwa ustawienia opis
WEBSITE_PUSH_ENABLED Tylko do odczytu. Dodano, gdy powiadomienia wypychane są włączone.
WEBSITE_PUSH_TAG_WHITELIST Tylko do odczytu. Zawiera tagi w rejestracji powiadomień.
WEBSITE_PUSH_TAGS_REQUIRING_AUTH Tylko do odczytu. Zawiera listę tagów w rejestracji powiadomień, która wymaga uwierzytelniania użytkownika.
WEBSITE_PUSH_TAGS_DYNAMIC Tylko do odczytu. Zawiera listę tagów w rejestracji powiadomień, które zostały dodane automatycznie.

Uwaga

Ten artykuł zawiera odwołania do terminu, którego firma Microsoft już nie używa. Po usunięciu terminu z oprogramowania usuniemy go z tego artykułu.

Zadania Web Job

Następujące zmienne środowiskowe są powiązane z zadaniami WebJob.

Nazwa ustawienia opis
WEBJOBS_RESTART_TIME W przypadku zadań ciągłych opóźnienie w sekundach, gdy proces zadania ulegnie awarii z jakiegokolwiek powodu przed ponownym uruchomieniem.
WEBJOBS_IDLE_TIMEOUT W przypadku wyzwalanych zadań limit czasu w sekundach, po którym zadanie zostało przerwane, jeśli jest w stanie bezczynności, nie ma czasu procesora CPU ani danych wyjściowych.
WEBJOBS_HISTORY_SIZE W przypadku wyzwalanych zadań maksymalna liczba przebiegów przechowywanych w katalogu historii na zadanie. Wartość domyślna to 50.
WEBJOBS_STOPPED Ustaw wartość na , aby 1 wyłączyć uruchamianie dowolnego zadania i zatrzymać wszystkie aktualnie uruchomione zadania.
WEBJOBS_DISABLE_SCHEDULE Ustaw wartość , aby 1 wyłączyć wszystkie zaplanowane wyzwalacze. Zadania mogą być nadal wywoływane ręcznie.
WEBJOBS_ROOT_PATH Bezwzględna lub względna ścieżka plików zadania webjob. W przypadku ścieżki względnej wartość jest łączona z domyślną ścieżką główną (D:/home/site/wwwroot/ lub /home/site/wwwroot/).
WEBJOBS_LOG_TRIGGERED_JOBS_TO_APP_LOGS Ustaw wartość true, aby wysyłać dane wyjściowe z wyzwalanych zadań WebJob do potoku dzienników aplikacji (który obsługuje system plików, obiekty blob i tabele).
WEBJOBS_SHUTDOWN_FILE Plik tworzony przez usługę App Service po wykryciu żądania zamknięcia. Jest to proces zadania internetowego odpowiedzialny za wykrycie obecności tego pliku i zainicjowanie zamknięcia. W przypadku korzystania z zestawu SDK usługi WebJobs ta część jest obsługiwana automatycznie.
WEBJOBS_PATH Tylko do odczytu. Ścieżka główna aktualnie uruchomionego zadania (będzie znajdować się w katalogu tymczasowym).
WEBJOBS_NAME Tylko do odczytu. Bieżąca nazwa zadania.
WEBJOBS_TYPE Tylko do odczytu. Bieżący typ zadania (triggered lub continuous).
WEBJOBS_DATA_PATH Tylko do odczytu. Bieżąca ścieżka metadanych zadania zawierająca dzienniki, historię i dowolny artefakt zadania.
WEBJOBS_RUN_ID Tylko do odczytu. W przypadku wyzwolonych zadań bieżący identyfikator uruchomienia zadania.

Funkcje

Nazwa ustawienia opis
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED Ustaw wartość na , aby 0 wyłączyć pamięć podręczną funkcji.
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT Dokumentacja ustawień aplikacji dla usługi Azure Functions
AzureWebJobsSecretStorageType Dokumentacja ustawień aplikacji dla usługi Azure Functions
FUNCTIONS_EXTENSION_VERSION Dokumentacja ustawień aplikacji dla usługi Azure Functions
FUNCTIONS_WORKER_RUNTIME Dokumentacja ustawień aplikacji dla usługi Azure Functions
AzureWebJobsStorage Dokumentacja ustawień aplikacji dla usługi Azure Functions
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING Dokumentacja ustawień aplikacji dla usługi Azure Functions
WEBSITE_CONTENTSHARE Dokumentacja ustawień aplikacji dla usługi Azure Functions
WEBSITE_CONTENTOVERVNET Dokumentacja ustawień aplikacji dla usługi Azure Functions
WEBSITE_ENABLE_BROTLI_ENCODING Dokumentacja ustawień aplikacji dla usługi Azure Functions
WEBSITE_USE_PLACEHOLDER Dokumentacja ustawień aplikacji dla usługi Azure Functions
WEBSITE_PLACEHOLDER_MODE Tylko do odczytu. Pokazuje, czy aplikacja funkcji jest uruchomiona na hoście zastępczym (generalized) lub na własnym hoście (specialized).
WEBSITE_DISABLE_ZIP_CACHE Gdy aplikacja jest uruchamiana z pakietu ZIP ( WEBSITE_RUN_FROM_PACKAGE=1), pięć ostatnio wdrożonych pakietów ZIP jest buforowanych w systemie plików aplikacji (D:\home\data\SitePackages). Ustaw tę zmienną, aby 1 wyłączyć tę pamięć podręczną. W przypadku aplikacji z użyciem systemu Linux pamięć podręczna pakietu ZIP jest domyślnie wyłączona.