Udostępnij za pośrednictwem


Zmienne środowiskowe i ustawienia aplikacji w Azure App Service

W usłudze aplikacja systemu Azure niektóre ustawienia są dostępne dla środowiska wdrażania lub środowiska uruchomieniowego jako zmienne środowiskowe. Możesz dostosować niektóre z tych ustawień ręcznie, definiując je jako ustawienia 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
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 pingowania w celu przygotowania aplikacji, zaczynająca się od ukośnika. Wartość domyślna to /robots933456.txt.

Za każdym razem, gdy platforma uruchamia kontener, orkiestrator wysyła powtarzające się żądania względem tego punktu końcowego. Platforma traktuje wszelkie odpowiedzi z tego punktu końcowego jako wskazanie, że kontener jest gotowy. Gdy platforma uzna kontener za gotowy, rozpoczyna przekazywanie ruchu organicznego do nowo uruchomionego kontenera. O ile WEBSITE_WARMUP_STATUSES nie zostanie skonfigurowane, platforma uznaje każdą odpowiedź z kontenera w tym punkcie końcowym (nawet kody błędów, takie jak 404 lub 502) za wskazanie, że kontener jest gotowy.

To ustawienie aplikacji nie zmienia ścieżki używanej przez funkcję Always On.
WEBSITE_WARMUP_STATUSES Oddzielona przecinkami lista kodów stanu HTTP uznawanych za pomyślne, gdy platforma wysyła pingi rozgrzewkowe względem nowo uruchomionego kontenera. Używany z WEBSITE_WARMUP_PATH.

Domyślnie każdy kod stanu jest uważany za sygnał, że kontener jest gotowy na ruch organiczny. Możesz użyć tej aplikacji, aby przed skierowaniem ruchu organicznego do kontenera, wymagać konkretnej odpowiedzi.

Przykładem jest 200,202. Jeśli zapytania ping względem skonfigurowanej ścieżki rozgrzewki aplikacji otrzymają odpowiedź z kodem stanu 200 lub 202, ruch organiczny jest kierowany do kontenera. Jeśli zostanie odebrany kod stanu, który nie znajduje się na liście (na przykład 502), platforma będzie nadal wysyłać polecenia ping aż do momentu otrzymania kodu 200 lub 202, bądź do osiągnięcia limitu czasu uruchamiania kontenera. (Zobacz WEBSITES_CONTAINER_START_TIME_LIMIT w dalszej części tej tabeli).

Jeśli kontener nie odpowiada kodem stanu HTTP, który znajduje się na liście, platforma ostatecznie nie zdoła uruchomić próby i ponowi ją, co prowadzi do otrzymania błędów 503.
WEBSITE_COMPUTE_MODE Tylko do odczytu. Określa, czy aplikacja działa na dedykowanych (Dedicated) lub udostępnionych (Shared) maszynach wirtualnych.
WEBSITE_SKU Tylko do odczytu. Poziom cenowy aplikacji. Możliwe wartości to Free, , SharedBasici 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. To ustawienie nie uwzględnia niestandardowych nazw hostów.
WEBSITE_VOLUME_TYPE Tylko do odczytu. Pokazuje aktualnie używany typ woluminu magazynu.
WEBSITE_NPM_DEFAULT_VERSION Domyślna wersja narzędzia npm używana przez aplikację.
WEBSOCKET_CONCURRENT_REQUEST_LIMIT Tylko do odczytu. Limit dla współbieżnych żądań protokołu WebSocket. W przypadku warstwy Standard i wyższej, wartość to -1, ale nadal istnieje limit na maszynę wirtualną w zależności od jej rozmiaru. Zobacz Limity numeryczne między maszynami wirtualnymi.
WEBSITE_PRIVATE_EXTENSIONS Ustaw na 0, aby wyłączyć korzystanie z rozszerzeń prywatnych stron.
WEBSITE_TIME_ZONE Domyślnie strefa czasowa aplikacji jest zawsze utc. Możesz ją zmienić na dowolną z prawidłowych wartości wymienionych w Domyślne strefy czasowe. Jeśli określona wartość nie jest rozpoznawana, aplikacja używa czasu UTC.

Przykład: Atlantic Standard Time
WEBSITE_ADD_SITENAME_BINDINGS_IN_APPHOST_CONFIG Po zmianach miejsc, aplikacja może doświadczać nieoczekiwanych ponownych uruchomień. Przyczyną jest to, że po zamianie konfiguracja powiązania nazwy hosta nie jest zsynchronizowana, co samo w sobie nie powoduje ponownego uruchomienia. Jednak niektóre podstawowe zdarzenia w pamięci (takie jak przełączenie awaryjne woluminu pamięci) 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 1 na wszystkich gniazdach. (Wartość domyślna to 0.) Nie ustawiaj jednak tej wartości, jeśli używasz aplikacji Windows Communication Foundation. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z zamianami.
WEBSITE_PROACTIVE_AUTOHEAL_ENABLED Domyślnie instancja VM jest proaktywnie korygowana, gdy używa ponad 90% przydzielonej pamięci przez ponad 30 sekund lub gdy 80% łącznych żądań w ciągu ostatnich dwóch minut przekracza 200 sekund. Jeśli wystąpienie maszyny wirtualnej wyzwoli jedną z tych reguł, proces odzyskiwania obejmuje współbieżne ponowne uruchomienie wystąpienia.

Ustaw wartość na false, aby wyłączyć to zachowanie odzyskiwania. Wartość domyślna to true.

Aby uzyskać więcej informacji, zobacz wpis na blogu "Introducing Proactive Auto Heal".
WEBSITE_PROACTIVE_CRASHMONITORING_ENABLED Za każdym razem, gdy proces w3wp.exe w wystąpieniu maszyny wirtualnej Twojej aplikacji ulegnie awarii z powodu nieobsługiwanego wyjątku więcej niż trzy razy w ciągu 24 godzin, proces debugera jest dołączany do głównego procesu w tym wystąpieniu. Kiedy proces roboczy ulega awarii ponownie, proces debuggera zbiera zrzut pamięci. 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 false, aby wyłączyć to zachowanie automatycznego monitorowania. Wartość domyślna to true.

Aby uzyskać więcej informacji, zobacz wpis na blogu Proaktywne monitorowanie awarii w usłudze Azure App Service.
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 magazynu dla obiektów blob, należy określić identyfikator URI sygnatury współdzielonego dostępu (SAS).
WEBSITE_CRASHMONITORING_ENABLED Ustaw wartość na true, aby 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 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 systemu, jeśli WEBSITE_CRASHMONITORING_ENABLED jest określony. Aby zarejestrować stos wywołań bez zapisywania zrzutu awaryjnego w koncie przechowywania, dodaj ,"UseStorageAccount":"false" w JSON.
REMOTEDEBUGGINGVERSION Wersja zdalnego debugowania.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING Domyślnie usługa App Service tworzy udostępnioną przestrzeń dyskową podczas tworzenia aplikacji. Aby zamiast tego użyć niestandardowego konta magazynu, ustaw wartość parametry połączenia konta magazynu. W celu uzyskania informacji o funkcjach, zobacz Dokumentację ustawień aplikacji dla Azure Functions.

Przykład: DefaultEndpointsProtocol=https;AccountName=<name>;AccountKey=<key>
WEBSITE_CONTENTSHARE Gdy określisz niestandardowe konto magazynu za pomocą WEBSITE_CONTENTAZUREFILECONNECTIONSTRING, App Service tworzy udział plików na tym koncie magazynu dla twojej 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.

Przykład: 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 rozwiązania nazw.
WEBSITE_DNS_TIMEOUT Liczba sekund oczekiwania na rozwiązanie nazwy.
WEBSITES_CONTAINER_START_TIME_LIMIT Czas (w sekundach) oczekiwania platformy na przygotowanie kontenera podczas uruchamiania. To ustawienie dotyczy zarówno aplikacji opartych na kodzie, jak i opartych na kontenerach w usłudze App Service dla systemu Linux. Domyślna wartość to 230.

Po uruchomieniu kontenera jest on poddawany wielokrotnym pingom, aby ocenić jego gotowość do obsługi ruchu organicznego. (Zobacz WEBSITE_WARMUP_PATH i WEBSITE_WARMUP_STATUSES.) Te pingi są stale wykonywane aż do momentu odebrania pomyślnej odpowiedzi lub osiągnięcia limitu czasu rozpoczęcia pingowania. Jeśli kontener nie jest uznawany za gotowy w ramach skonfigurowanego limitu czasu, platforma nie powiedzie się w próbie uruchomienia i ponowi próbę, co prowadzi do błędów 503.

W przypadku kontenerów dla usługi App Service w systemie Windows domyślny limit czasu rozpoczęcia to 10 mins. Limit czasu rozpoczęcia można zmienić, określając przedział czasu. Na przykład 00:05:00 oznacza 5 minut.

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 klient ustawia zmienną 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, że zmienna jest specyficzna dla aplikacji Kudu.
SQLCONNSTR_ Parametry połączenia programu SQL Server w konfiguracji aplikacji. Jest on wstrzykiwany do aplikacji .NET jako ciąg połączenia.
SQLAZURECONNSTR_ Parametry połączenia usługi Azure SQL Database w konfiguracji aplikacji. Jest on wstrzykiwany do aplikacji .NET jako ciąg połączenia.
POSTGRESQLCONNSTR_ Ciąg połączenia PostgreSQL w konfiguracji aplikacji. Jest on wstrzykiwany do aplikacji .NET jako ciąg połączenia.
CUSTOMCONNSTR_ Niestandardowy łańcuch połączenia w konfiguracji aplikacji. Jest on wstrzykiwany do aplikacji .NET jako ciąg połączenia.
MYSQLCONNSTR_ Parametry połączenia bazy danych MySQL w konfiguracji aplikacji. Jest on wstrzykiwany do aplikacji .NET jako ciąg połączenia.
AZUREFILESSTORAGE_ Parametry połączenia z udziałem niestandardowym dla kontenera niestandardowego w usłudze Azure Files.
AZUREBLOBSTORAGE_ Łańcuch połączenia do niestandardowego konta magazynu dla niestandardowego kontenera w usłudze Azure Blob Storage.
NOTIFICATIONHUBCONNSTR_ Parametry połączenia z centrum powiadomień w usłudze Azure Notification Hubs.
SERVICEBUSCONNSTR_ Parametry połączenia z wystąpieniem usługi Azure Service Bus.
EVENTHUBCONNSTR_ Łańcuch połączenia z centrum zdarzeń w Azure Event Hubs.
DOCDBCONNSTR_ Parametry połączenia z bazą danych w usłudze Azure Cosmos DB.
REDISCACHECONNSTR_ Ciąg połączeniowy do pamięci podręcznej w usłudze Azure Cache for Redis.
FILESHARESTORAGE_ Łańcuch połączenia do niestandardowego udostępniania plików.

Wdrożenie

Następujące zmienne środowiskowe są powiązane z wdrażaniem aplikacji. Aby uzyskać zmienne związane z automatyzacją kompilacji usługi App Service, zobacz Automatyzacja kompilacji w dalszej części artykułu.

Nazwa ustawienia opis
DEPLOYMENT_BRANCH W przypadku wdrożenia lokalnego Git lub Git w chmurze (np. GitHub), ustaw gałąź w Azure, na którą chcesz wdrożyć. Domyślnie jest to master.
WEBSITE_RUN_FROM_PACKAGE Ustaw wartość na 1, aby uruchomić aplikację z lokalnego pakietu ZIP, lub ustaw na zewnętrzny adres URL, aby uruchomić aplikację ze zdalnego pakietu ZIP. Aby uzyskać więcej informacji, zobacz Uruchamianie aplikacji w usłudze Azure App Service bezpośrednio z pliku ZIP.
WEBSITE_USE_ZIP Przestarzałe. Użyj WEBSITE_RUN_FROM_PACKAGE.
WEBSITE_RUN_FROM_ZIP Przestarzałe. Użyj WEBSITE_RUN_FROM_PACKAGE.
SCM_MAX_ZIP_PACKAGE_COUNT Aplikacja przechowuje pięć najnowszych plików ZIP wdrożonych za pośrednictwem ZIP deploy. Możesz zachować więcej lub mniej, zmieniając ustawienie aplikacji na inną liczbę.
WEBSITE_WEBDEPLOY_USE_SCM Ustaw na false w Web Deploy, aby zatrzymać korzystanie z silnika wdrażania Kudu. Wartość domyślna to true. Aby wdrożyć aplikacje w systemie Linux przy użyciu programu Visual Studio (Web Deploy/MSDeploy), ustaw na false.
MSDEPLOY_RENAME_LOCKED_FILES Ustaw wartość na 1, aby spróbować zmienić nazwy bibliotek DLL, jeśli nie można ich skopiować podczas wdrażania za pomocą Web Deploy. 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. Gdy zatrzymasz aplikację, aplikacja Kudu jest nadal uruchomiona i możesz nadal korzystać z wdrożenia Git oraz narzędzia 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 1, aby upewnić się, że wywołania interfejsu API REST do aktualizacji site i siteconfig są całkowicie stosowane do wszystkich wystąpień przed ich zwróceniem. Wartość domyślna to 1, jeśli wdrażasz przy użyciu szablonu Azure Resource Manager (szablon ARM), aby uniknąć warunków wyścigu z kolejnymi wywołaniami Resource Manager.
WEBSITE_START_SCM_ON_SITE_CREATION Podczas wdrażania szablonu ARM ustaw wartość na 1 w szablonie, aby wstępnie uruchomić aplikację Kudu w ramach tworzenia aplikacji.
WEBSITE_START_SCM_WITH_PRELOAD W przypadku aplikacji systemu Linux ustaw na true w celu wymuszenia wstępnego załadowania aplikacji Kudu, gdy Always On jest włączone, poprzez pingowanie jej adresu URL. Wartość domyślna to false. W przypadku aplikacji systemu Windows aplikacja Kudu jest zawsze ładowana wstępnie.

Automatyzacja procesu budowania

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
SCM_BUILD_ARGS Dodaj elementy na końcu wiersza polecenia msbuild, tak aby zastąpić wszystkie poprzednie części domyślnego wiersza polecenia.

Przykładowo, aby wykonać czystą kompilację: #B0.
SCM_SCRIPT_GENERATOR_ARGS Kudu używa polecenia azure site deploymentscript do 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 na przykład 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 na wyższe wartości, maksymalnie 4, aby uzyskać dokładniejsze śledzenie.
SCM_COMMAND_IDLE_TIMEOUT Limit czasu, w sekundach, dla każdego polecenia uruchamianego przez proces kompilacji, zanim zostaną utworzone jakiekolwiek dane wyjściowe. Następnie polecenie jest uznawane za bezczynne i zatrzymane. 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 nadal działa po stronie serwera po tym.
SCM_LOGSTREAM_TIMEOUT Limit czasu braku aktywności (w sekundach) przed zatrzymaniem transmisji strumieniowej 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 0, aby używać git.exe zamiast libgit2sharp do operacji Git.
WEBSITE_LOAD_USER_PROFILE W przypadku błędu The specified user does not have a valid profile podczas automatyzacji kompilacji ASP.NET (np. podczas wdrażania Git) ustaw tę zmienną na 1, aby załadować pełny profil użytkownika w środowisku kompilacji. To ustawienie ma zastosowanie tylko wtedy, gdy WEBSITE_COMPUTE_MODE jest Dedicated.
WEBSITE_SCM_IDLE_TIMEOUT_IN_MINUTES Czas oczekiwania, w minutach, dla strony Menedżera Kontroli Źródła (Kudu). Wartość domyślna to 20.
SCM_DO_BUILD_DURING_DEPLOYMENT Przy użyciu wdrożenia ZIP, aparat wdrażania zakłada, że plik ZIP jest w stanie gotowym do uruchomienia i nie uruchamia żadnej automatyzacji kompilacji. Aby włączyć taką samą automatyzację kompilacji jak w wdrożeniu Git, skonfiguruj ustawienie na .

Ustawienia specyficzne dla języka

W tej sekcji przedstawiono konfigurowalne ustawienia środowiska uruchomieniowego dla każdej obsługiwanej platformy językowej. Więcej ustawień jest dostępnych 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 na magazyn udostępniony (/home).
DUMP_DIR Tylko do odczytu. Katalog zrzutów pamięci awaryjnych (/home/logs/dumps).
APP_SVC_RUN_FROM_COPY Tylko aplikacje systemu Linux. Domyślnie aplikacja jest uruchamiana z /home/site/wwwroot katalogu udostępnionego dla wszystkich wystąpień skalowanych poziomo. Ustaw tę zmienną na true, aby skopiować aplikację do lokalnego katalogu w kontenerze i uruchomić ją stamtąd. Jeśli używasz tej opcji, pamiętaj, aby nie dodać na stałe żadnych odwołań do /home/site/wwwroot. Zamiast tego użyj ścieżki względem /home/site/wwwroot.
MACHINEKEY_Decryption W przypadku natywnych aplikacji systemu Windows lub konteneryzowanych aplikacji systemu Windows ta zmienna jest wstrzykiwana do środowiska aplikacji lub kontenera w celu włączenia ASP.NET procedur kryptograficznych. (Zobacz element machineKey.) Aby zastąpić domyślną wartość decryption, skonfiguruj ją jako ustawienie aplikacji App Service lub ustaw ją bezpośrednio w elemencie machineKey pliku Web.config.
MACHINEKEY_DecryptionKey W przypadku natywnych aplikacji systemu Windows lub konteneryzowanych aplikacji systemu Windows ta zmienna jest wprowadzana do środowiska aplikacji lub kontenera, aby umożliwić ASP.NET procedury kryptograficzne. (Zobacz machineKey Element.) Aby zastąpić automatycznie wygenerowaną wartość decryptionKey, skonfiguruj ją jako ustawienie aplikacji App Service lub ustaw bezpośrednio w elemencie machineKey pliku Web.config.
MACHINEKEY_Validation W przypadku natywnych aplikacji systemu Windows lub konteneryzowanych aplikacji systemu Windows ta zmienna jest wprowadzana do środowiska aplikacji lub kontenera, aby umożliwić ASP.NET procedury kryptograficzne. (Zobacz element machineKey.) Aby zastąpić domyślną wartość validation, skonfiguruj ją jako ustawienie aplikacji App Service lub ustaw ją bezpośrednio w elemencie machineKey pliku Web.config.
MACHINEKEY_ValidationKey W przypadku natywnych aplikacji systemu Windows lub konteneryzowanych aplikacji systemu Windows ta zmienna jest wprowadzana do środowiska aplikacji lub kontenera, aby umożliwić ASP.NET procedury kryptograficzne. (Zobacz machineKey Element.) Aby zastąpić automatycznie wygenerowaną wartość validationKey, skonfiguruj ją jako ustawienie aplikacji App Service lub ustaw bezpośrednio w elemencie machineKey pliku Web.config.

WordPress

Ustawienie aplikacji Zakres Wartość Maksimum opis
WEBSITES_ENABLE_APP_SERVICE_STORAGE Aplikacja internetowa true Nie dotyczy Po ustawieniu wartości true, zawartość pliku jest zachowywana podczas ponownego uruchamiania.
WP_MEMORY_LIMIT WordPress 128M 512M Front-end lub ogólny limit pamięci PHP w WordPressie (na skrypt). Nie może być więcej niż PHP_MEMORY_LIMIT.
WP_MAX_MEMORY_LIMIT WordPress 256M 512M Limit pamięci php pulpitu nawigacyjnego administratora (na skrypt). Ogólnie rzecz biorąc, pulpit nawigacyjny administratora i skrypty zaplecza zużywają więcej pamięci w porównaniu do skryptów front-end. Nie może być więcej niż PHP_MEMORY_LIMIT.
PHP_MEMORY_LIMIT PHP 512M 512M Limit pamięci dla ogólnych skryptów PHP. Można tylko zmniejszyć.
FILE_UPLOADS PHP On Nie dotyczy Włącza lub wyłącza przekazywanie plików. Może to być wartość On lub Off. Należy pamiętać, że w wartościach uwzględniana jest wielkość liter.
UPLOAD_MAX_FILESIZE PHP 50M 256M Limit rozmiaru przekazywania plików. Można zwiększyć do 256M.
POST_MAX_SIZE PHP 128M 256M Można zwiększyć do 256M. Ogólnie wartość powinna być większa niż UPLOAD_MAX_FILESIZE.
MAX_EXECUTION_TIME PHP 120 120 Można tylko zmniejszyć. Rozbij skrypty, jeśli zajmują więcej niż 120 sekund. Dodano, aby uniknąć spowolnienia systemu przez nieprawidłowe skrypty.
MAX_INPUT_TIME PHP 120 120 Limit czasu analizowania żądań wejściowych. Można tylko zmniejszyć.
MAX_INPUT_VARS PHP 10000 10000 Maksymalna liczba zmiennych dla żądań wejściowych.
DATABASE_HOST baza danych Nie dotyczy Nie dotyczy Host bazy danych używany do nawiązywania połączenia z platformą WordPress.
DATABASE_NAME baza danych Nie dotyczy Nie dotyczy Nazwa bazy danych używana do nawiązywania połączenia z platformą WordPress.
DATABASE_USERNAME baza danych Nie dotyczy Nie dotyczy Nazwa użytkownika bazy danych używana do nawiązywania połączenia z platformą WordPress.
DATABASE_PASSWORD baza danych Nie dotyczy Nie dotyczy Hasło bazy danych używane do nawiązywania połączenia z bazą danych MySQL. Aby zmienić hasło bazy danych MySQL, zapoznaj się z 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 Nie dotyczy Nie dotyczy Adres e-mail administratora platformy WordPress.
WORDPRESS_ADMIN_PASSWORD Tylko wdrożenie Nie dotyczy Nie dotyczy Hasło administratora platformy WordPress. To ustawienie jest 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 Zresetuj hasło.
WORDPRESS_ADMIN_USER Tylko wdrożenie Nie dotyczy Nie dotyczy Nazwa użytkownika administratora platformy WordPress.
WORDPRESS_ADMIN_LOCALE_CODE Tylko wdrożenie Nie dotyczy Nie dotyczy Nazwa użytkownika bazy danych używana do nawiązywania połączenia z platformą WordPress.

Domena i DNS

Nazwa ustawienia opis
WEBSITE_DNS_SERVER Adres IP głównego serwera DNS dla połączeń wychodzących (na przykład do usługi 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 używa integracji sieci wirtualnej lub znajduje się w środowisku App Service, dziedziczy konfigurację serwera DNS z sieci wirtualnej domyślnie.

Przykład: 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 są opróżniane (oprócz istniejącej pamięci podręcznej) co 4,5 minut.

TLS/SSL

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

Nazwa ustawienia opis
WEBSITE_LOAD_CERTIFICATES Wartości odcisków palca, rozdzielone przecinkami, dla certyfikatu, który chcesz załadować w kodzie. Lub użyj *, aby zezwolić na ł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 do załadowanych certyfikatów publicznych w kontenerze systemu Windows.
WEBSITE_INTERMEDIATE_CERTS_PATH Tylko do odczytu. Ścieżka dostępu 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 (root).

Miejsca wdrożenia

Aby uzyskać więcej informacji na temat slotów wdrożeniowych, zobacz Konfigurowanie środowisk przejściowych w usłudze Azure App Service.

Nazwa ustawienia opis
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS Domyślnie wersje rozszerzeń witryny są specyficzne dla każdego gniazda. To ustawienie domyślne uniemożliwia nieoczekiwane zachowanie aplikacji z powodu zmiany wersji rozszerzeń po zamianie. Jeśli chcesz również zamienić wersje rozszerzeń, ustaw na 0wszystkich gniazdach.
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 tę wartość na false lub 0 dla wszystkich miejsc wdrożenia, aby je zamieniać. Nie ma precyzyjnej kontrolki dla określonych typów ustawień.
WEBSITE_SWAP_WARMUP_PING_PATH Ścieżka do wykonania ping, aby przygotować docelowy slot podczas przełączenia, zaczynając od ukośnika. Domyślną wartością jest /, która wykonuje ping na ścieżce głównej za pośrednictwem HTTP.

Przykład: /statuscheck
WEBSITE_SWAP_WARMUP_PING_STATUSES Prawidłowe kody odpowiedzi HTTP dla operacji rozgrzewania podczas przełączania. Jeśli zwrócony kod stanu nie znajduje się na liście, operacje rozruchu i przełączania zostaną zatrzymane. Domyślnie wszystkie kody odpowiedzi są prawidłowe.

Przykład: 200,202
WEBSITE_SLOT_NUMBER_OF_TIMEOUTS_BEFORE_RESTART Podczas zamiany gniazda maksymalna liczba przekroczeń limitu czasu przed przymusowym ponownym uruchomieniem witryny w określonym wystąpieniu maszyny wirtualnej. Wartość domyślna to 3.
WEBSITE_SLOT_MAX_NUMBER_OF_TIMEOUTS Podczas zamiany slotu maksymalna liczba żądań timeoutu dla pojedynczego adresu URL przed rezygnacją. Wartość domyślna to 5.
WEBSITE_SKIP_ALL_BINDINGS_IN_APPHOST_CONFIG Ustaw na true lub 1, aby pominąć wszystkie powiązania w applicationHost.config. Wartość domyślna to false. Jeśli aplikacja inicjuje ponowne uruchomienie z powodu aktualizacji, gdzie applicationHost.config zmienia nazwy hostów dla slotów, ustaw tę zmienną na true, aby uniknąć ponownego uruchamiania tego rodzaju. Jeśli używasz aplikacji Windows Communication Foundation, 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
WEBSITES_ENABLE_APP_SERVICE_STORAGE W przypadku kontenerów systemu Linux, jeśli to ustawienie aplikacji nie jest określone, ten katalog /home jest domyślnie współużytkowany w skalowanych wystąpieniach. Można ją ustawić tak, false aby wyłączyć udostępnianie.

W przypadku kontenerów systemu Windows ustaw wartość true , aby umożliwić udostępnianie katalogu c:\home w skalowanych wystąpieniach. Domyślną wartością jest true dla kontenerów Windows.
WEBSITES_CONTAINER_STOP_TIME_LIMIT Czas oczekiwania na bezproblemowe zakończenie kontenera w sekundach. Wartość domyślna to 5. Można zwiększyć do maksymalnie 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.

Przykład: 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 na true, aby włączyć ciągłe wdrażanie dla kontenerów niestandardowych. Wartość domyślna to false dla kontenerów niestandardowych.
WEBSITE_PULL_IMAGE_OVER_VNET Łącz się i pobieraj z rejestru w sieci wirtualnej lub lokalnej. Aplikacja musi być połączona z siecią wirtualną za pośrednictwem funkcji integracji sieci wirtualnej. 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 nazwę kontenera zdefiniowanego w pliku konfiguracji, aby zastąpić ten domyślny wybór kontenera. Domyślnie kontener dostępny z Internetu jest pierwszym kontenerem do zdefiniowania portu 80 lub 8080. Jeśli taki kontener nie zostanie znaleziony, wartość domyślna to pierwszy kontener zdefiniowany w pliku konfiguracji.
WEBSITES_PORT Dla kontenera niestandardowego, niestandardowy numer portu w kontenerze, do którego usługa App Service przekierowuje żądania. 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 liczby żą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 App Service mają skonfigurowany limit pamięci w zależności od warstwy planu usługi App Service. Ustaw żądany limit pamięci w megabajtach. Skumulowana suma tego ustawienia dla aplikacji w tym samym planie nie może przekraczać kwoty, jaką zezwala wybrana warstwa cenowa. Aby uzyskać więcej informacji, zobacz Dostosowywanie pamięci kontenera.

Skalowanie

Nazwa ustawienia opis
WEBSITE_INSTANCE_ID Tylko do odczytu. Unikatowy identyfikator aktualnej instancji maszyny wirtualnej, gdy aplikacja jest skalowana do wielu wystąpień.
WEBSITE_IIS_SITE_NAME Przestarzałe. Użyj WEBSITE_INSTANCE_ID.
WEBSITE_DISABLE_OVERLAPPED_RECYCLING Zachodzące na siebie ponowne użycie gwarantuje, że zanim bieżąca instancja maszyny wirtualnej aplikacji zostanie zamknięta, uruchomiona zostanie nowa instancja maszyny wirtualnej. W niektórych przypadkach może to spowodować problemy z blokowaniem plików. Możesz spróbować go wyłączyć, ustawiając na 1.
WEBSITE_DISABLE_CROSS_STAMP_SCALE Domyślnie aplikacje mogą być skalowane między pieczęciami, jeśli używają usługi Azure Files lub kontenera platformy Docker. Ustaw wartość na 1 lub true, aby wyłączyć skalowanie krzyżowe w regionie aplikacji. Wartość domyślna to 0. Niestandardowe kontenery Docker, które ustawiają WEBSITES_ENABLE_APP_SERVICE_STORAGE na true lub 1, nie mogą się skalować między stemplami, ponieważ ich zawartość nie jest całkowicie zamknięta w kontenerze Docker.

Logowanie

Nazwa ustawienia opis
WEBSITE_HTTPLOGGING_ENABLED Tylko do odczytu. Pokazuje, czy rejestrowanie serwera internetowego dla natywnych aplikacji systemu Windows jest włączone (1) czy nie (0).
WEBSITE_HTTPLOGGING_RETENTION_DAYS Okres przechowywania (w dniach) dzienników serwera internetowego, jeśli dzienniki serwera internetowego są włączone dla natywnej aplikacji systemu Windows lub Linux.

Przykład: 10
WEBSITE_HTTPLOGGING_CONTAINER_URL SAS URL kontenera pamięci masowej blob do przechowywania dzienników serwera internetowego dla natywnych aplikacji systemu Windows, jeśli dzienniki serwera internetowego są włączone. Jeśli ustawienie nie jest skonfigurowane, dzienniki serwera WWW są przechowywane w systemie plików aplikacji (domyślna wspólna przestrzeń dyskowa).
DIAGNOSTICS_AZUREBLOBRETENTIONINDAYS Okres przechowywania (w dniach) dzienników aplikacji dla natywnych aplikacji systemu Windows, jeśli dzienniki aplikacji są włączone.

Przykład: 10
DIAGNOSTICS_AZUREBLOBCONTAINERSASURL Adres SAS kontenera usługi Blob Storage do przechowywania logów aplikacji dla natywnych programów Windows, jeśli logi aplikacji są włączone.
APPSERVICEAPPLOGS_TRACE_LEVEL Minimalny poziom logów do wysyłania do Log Analytics dla typu dziennika AppServiceAppLogs.
DIAGNOSTICS_LASTRESORTFILE Nazwa pliku do utworzenia lub ścieżka względna do katalogu logów, 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).

Przykład: ..\..\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 Czas oczekiwania (w milisekundach) aby utrzymać włączone rejestrowanie aplikacji. Wartość domyślna to 43200000 (12 godzin).
WEBSITE_LOG_BUFFERING Domyślnie buforowanie dzienników jest włączone. Ustaw na 0, aby to wyłączyć.
WEBSITE_ENABLE_PERF_MODE W przypadku natywnych aplikacji systemu Windows ustaw na TRUE aby wyłączyć wpisy dziennika IIS dla żądań zakończonych powodzeniem, które zostały zwrócone 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 "fałszywe" zmienne środowiskowe, które nie istnieją, jeśli je wyliczasz, ale zwracają ich wartość, jeśli wyszukujesz 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 sandbox.
WEBSITE_COUNTERS_CLR Obiekt JSON, który zawiera liczniki środowiska uruchomieniowego języka wspólnego.
WEBSITE_COUNTERS_ALL Obiekt JSON zawierający kombinację pozostałych trzech zmiennych.

Buforowanie

Nazwa ustawienia opis
WEBSITE_LOCAL_CACHE_OPTION Czy lokalna pamięć podręczna jest włączona? Dostępne opcje to:

- Default: Dziedzicz ustawienie globalne na poziomie stempla.
- Always: Włącz dla aplikacji.
- OnStorageUnavailability
- Disabled: Wyłącz dla tej aplikacji.
WEBSITE_LOCAL_CACHE_READWRITE_OPTION Opcje odczytu/zapisu lokalnej pamięci podręcznej. Dostępne opcje to:

- ReadOnly: Pamięć podręczna jest w trybie tylko do odczytu.
- WriteButDiscardChanges: Zezwalaj na zapisy w lokalnej pamięci podręcznej, ale wycofuj wprowadzone lokalnie zmiany.
WEBSITE_LOCAL_CACHE_SIZEINMB Rozmiar lokalnej pamięci podręcznej w megabajtach. 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 Z uwagi na to, że sieciowe udostępnianie plików umożliwia dostęp wielu instancjom, dynamiczna pamięć cache zwiększa wydajność, poprzez buforowanie ostatnio używanych plików lokalnie na instancji. Pamięć podręczna jest unieważniona po zmodyfikowaniu pliku. Lokalizacja pamięci podręcznej to %SYSTEMDRIVE%\local\DynamicCache. (Zastosowano ten sam %SYSTEMDRIVE%\local limit).

Aby włączyć buforowanie pełnej zawartości, ustaw wartość na 1, która obejmuje zarówno zawartość pliku, jak i metadane katalogu/pliku (znaczniki czasu, rozmiar, zawartość katalogu). Aby zaoszczędzić zużycie miejsca na dysku lokalnym, ustaw na 2, w celu buforowania tylko metadanych katalogu/pliku (znaczniki 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 Aby wyłączyć dostęp do zapisu w katalogu głównym aplikacji (D:\home\site\wwwroot lub /home/site/wwwroot) podczas korzystania z dynamicznej pamięci podręcznej, ustaw tę zmienną na 1. Z wyjątkiem katalogu App_Data, nie są dozwolone żadne wyłączne blokady, aby zablokowane pliki nie blokowały wdrożeń.

Networkowanie

Następujące zmienne środowiskowe są zwią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 integracji z regionalną siecią wirtualną, aplikacja kieruje tylko ruch zgodny z RFC1918 do twojej sieci wirtualnej. Ustaw wartość na 1, aby kierować cały ruch wychodzący do sieci wirtualnej i podlegać tym samym sieciowym grupom zabezpieczeń oraz trasom zdefiniowanym 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ą zintegrowaną z siecią wirtualną. W przypadku regionalnej integracji sieci wirtualnej wartość jest adresem IP z zakresu adresów delegowanej podsieci. W przypadku integracji z siecią wirtualną wymagającą bramy, wartością jest adres IP z zakresu adresów puli adresów punkt-do-lokacji skonfigurowanej na bramie sieci wirtualnej.

Aplikacja używa tego adresu IP 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 sieci wirtualnej pokazuje, które porty aplikacja może używać do komunikowania się z innymi węzłami.
WEBSITE_CONTENTOVERVNET Jeśli instalujesz udział plików Azure w usłudze App Service i konto magazynu jest ograniczone do sieci wirtualnej, włącz to ustawienie z wartością #c0.

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ń do magazynu kluczy, 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 magazynu kluczy, 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 przy użyciu sieci wirtualnej.

Aby uniknąć błędów podczas tworzenia lub aktualizowania, ustaw tę zmienną na 1wartość .
WEBSITE_DELAY_CERT_DELETION Ustawienie tej zmiennej środowiskowej na 1 zapewnia, że certyfikat, od którego zależy proces roboczy, nie zostanie usunięty, dopóki proces ten się nie zakończy.

CORS (Cross-Origin Resource Sharing)

Następujące zmienne środowiskowe są zwią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 jest włączone (True) czy 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 na true, program wyłącza przypisywanie tożsamości wątku w aplikacjach internetowych opartych na ASP.NET (w tym aplikacjach funkcji wersji v1). Ta funkcja umożliwia deweloperom ochronę dostępu do witryny przy użyciu uwierzytelniania, ale nadal korzysta z oddzielnego mechanizmu logowania w ramach logiki aplikacji. Wartość domyślna to false.
WEBSITE_AUTH_HIDE_DEPRECATED_SID true lub false. Domyślna wartość to false. To ustawienie dla starszej integracji Mobile Apps z usługą Azure App Service. Ustawienie wartości true rozwiązuje problem, polegający na tym, że 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 formacie hours:minutes:seconds. Wartość domyślna to 00:05:00, lub 5 minut. To ustawienie określa czas istnienia kryptograficznego nonce'a generowanego dla wszystkich logowań wykonywanych za pomocą przeglądarki. Jeśli logowanie nie zakończy się w określonym czasie, proces logowania zostanie ponowiony automatycznie.

To ustawienie aplikacji jest przeznaczone do użycia ze środowiskiem konfiguracji w wersji 1 (klasycznej). Jeśli korzystasz z schematu konfiguracji uwierzytelniania w wersji 2, zamiast tego należy użyć wartości konfiguracji login.nonce.nonceExpirationInterval.
WEBSITE_AUTH_PRESERVE_URL_FRAGMENT Po ustawieniu na true i wybraniu przez użytkowników linków aplikacji zawierających fragmenty adresów URL, proces logowania zapewnia, że fragment adresu URL nie zgubi się podczas przekierowywania logowania. Aby uzyskać więcej informacji, zobacz Dostosowywanie logowania i wylogowywania w usłudze Azure App Service.
WEBSITE_AUTH_USE_LEGACY_CLAIMS Aby zachować zgodność z poprzednimi wersjami podczas uaktualnień, moduł uwierzytelniania używa starszego mapowania roszczeń krótkich na długie nazwy w interfejsie API /.auth/me, więc niektóre mapowania są wykluczone (na przykład "role"). Aby uzyskać bardziej nowoczesną wersję mapowania oświadczeń, ustaw tę zmienną na False. W przykładzie "roles" będzie on mapowany na długą nazwę klucza roszczenia http://schemas.microsoft.com/ws/2008/06/identity/claims/role.
WEBSITE_AUTH_DISABLE_WWWAUTHENTICATE true lub false. Domyślna wartość to false. Po ustawieniu na true, usuwa nagłówek WWW-Authenticate z odpowiedzi HTTP 401 generowanych przez moduł.

To ustawienie aplikacji jest przeznaczone do użycia ze środowiskiem konfiguracji w wersji 1 (klasycznej). Jeśli korzystasz z schematu konfiguracji uwierzytelniania w wersji 2, zamiast tego należy użyć wartości konfiguracji identityProviders.azureActiveDirectory.login.disableWwwAuthenticate.
WEBSITE_AUTH_STATE_DIRECTORY Ścieżka katalogu lokalnego 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 korzystasz z schematu konfiguracji uwierzytelniania w wersji 2, zamiast tego należy użyć wartości konfiguracji login.tokenStore.fileSystem.directory.
WEBSITE_AUTH_TOKEN_CONTAINER_SASURL W pełni kwalifikowany adres URL kontenera 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 kontroluje czas, przez jaki interfejs API /.auth/refresh może być używany do odświeżenia tokenu po wygaśnięciu sesji. Próby odświeżenia po tym okresie kończą się niepowodzeniem, a użytkownicy muszą się ponownie zalogować.

To ustawienie aplikacji jest przeznaczone do użycia ze środowiskiem konfiguracji w wersji 1 (klasycznej). Jeśli korzystasz z schematu konfiguracji uwierzytelniania w wersji 2, zamiast tego należy użyć wartości konfiguracji login.tokenStore.tokenRefreshExtensionHours.
WEBSITE_AUTH_TRACE_LEVEL Steruje szczegółowością śladów uwierzytelniania zapisywanych w rejestrowaniu aplikacji. Prawidłowe wartości to Off, , ErrorWarning, Information, i Verbose. Domyślna wartość to Verbose.
WEBSITE_AUTH_VALIDATE_NONCE true lub false. Domyślna wartość to true. Ta wartość nigdy nie powinna być ustawiona na false z wyjątkiem sytuacji, gdy tymczasowo debugujesz niepowodzenia w weryfikacji jednokrotnych wartości w kryptograficznej występujące podczas logowania interaktywnego.

To ustawienie aplikacji jest przeznaczone do użycia ze środowiskiem konfiguracji w wersji 1 (klasycznej). Jeśli korzystasz z schematu konfiguracji uwierzytelniania w wersji 2, zamiast tego należy użyć wartości konfiguracji login.nonce.validateNonce.
WEBSITE_AUTH_V2_CONFIG_JSON Usługa Azure App Service automatycznie wypełnia tę zmienną środowiskową. Ta zmienna służy do konfigurowania zintegrowanego modułu uwierzytelniania. Jego wartość 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 na wybrany klucz. Zalecamy tę zmienną środowiskową, jeśli chcesz udostępniać tokeny lub sesje w wielu aplikacjach. Jeśli to określisz, zastępuje ustawienie MACHINEKEY_DecryptionKey.
WEBSITE_AUTH_SIGNING_KEY Domyślnie automatycznie wygenerowany klucz jest używany jako klucz podpisywania. Aby zastąpić, ustaw na wybrany klucz. Zalecamy tę zmienną środowiskową, jeśli chcesz udostępniać tokeny lub sesje w wielu aplikacjach. Jeśli to określisz, zastępuje ustawienie MACHINEKEY_ValidationKey.

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. URL do pobrania tokenu zarządzanej tożsamości aplikacji.
MSI_ENDPOINT Przestarzałe. Użyj IDENTITY_ENDPOINT.
IDENTITY_HEADER Tylko do odczytu. Wartość, która musi zostać dodana do nagłówka X-IDENTITY-HEADER, podczas wykonywania żądania HTTP GET do IDENTITY_ENDPOINT. Platforma zmienia wartość.
MSI_SECRET Przestarzałe. Użyj IDENTITY_HEADER.

Sprawdzanie kondycji

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

Nazwa ustawienia opis
WEBSITE_HEALTHCHECK_MAXPINGFAILURES Maksymalna liczba nieudanych pingów przed usunięciem instancji. Ustaw wartość między 2 i 10. Podczas skalowania w górę lub na zewnątrz usługa App Service pinguje ścieżkę 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 instancji, które są w dobrej kondycji, nie wyklucza się więcej niż połowy z nich. Jeśli na przykład plan usługi App Service jest skalowany do czterech wystąpień, a trzy są w złej kondycji, maksymalnie dwa zostaną wykluczone. Pozostałe dwie instancje (jedna w dobrej kondycji i jedna w złej kondycji) nadal przyjmują żądania. W najgorszym scenariuszu, w którym wszystkie przypadki są w złej kondycji, żaden nie jest wykluczony.

Aby zastąpić to zachowanie, ustaw wartość między 1 i 100. Wyższa wartość oznacza, że usunięto więcej niezdrowych przypadków. Wartość domyślna to 50 (50%).

Powiadomienia push

Zmienne środowiskowe dotyczące funkcji powiadomień push są następujące.

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

Uwaga

Poprzednia tabela odnosi się do białej listy, terminu, którego firma Microsoft już nie używa. Gdy termin zostanie usunięty z oprogramowania, usuniemy go z tego artykułu.

Zadania WebJob

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, które występuje, gdy proces zadania zostaje zatrzymany z jakiegokolwiek powodu, przed jego ponownym uruchomieniem.
WEBJOBS_IDLE_TIMEOUT W przypadku wyzwalanych zadań limit czasu w sekundach. Po upływie tego limitu czasowego zadanie zostanie zatrzymane, jeśli pozostaje bezczynne, nie ma czasu CPU lub nie generuje żadnych danych wyjściowych.
WEBJOBS_HISTORY_SIZE W przypadku zadań wyzwalanych maksymalna liczba przebiegów przechowywanych w katalogu historii przypada na każde zadanie. Wartość domyślna to 50.
WEBJOBS_STOPPED Ustaw wartość na 1, aby uniemożliwić uruchamianie jakiegokolwiek zadania i zatrzymać wszystkie aktualnie uruchomione zadania.
WEBJOBS_DISABLE_SCHEDULE Ustaw na 1, aby 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 zadań 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 na true, aby wysyłać dane wyjściowe z wyzwalanych WebJobs do potoku dzienników aplikacji (które obsługują systemy plików, obiekty blob i tabele).
WEBJOBS_SHUTDOWN_FILE Plik tworzony przez usługę App Service po wykryciu żądania zamknięcia. To proces WebJob, który jest odpowiedzialny za wykrywanie obecności tego pliku i inicjowanie zamknięcia. Jeśli używasz zestawu SDK usługi WebJobs, ta część jest obsługiwana automatycznie.
WEBJOBS_PATH Tylko do odczytu. Ścieżka główna aktualnie uruchomionego zadania, znajdująca 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. Ścieżka metadanych do przechowywania dzienników, historii i artefaktów bieżącego zadania.
WEBJOBS_RUN_ID Tylko do odczytu. W przypadku wyzwolonych zadań identyfikator aktualnego uruchomienia zadania.

Funkcje

Nazwa ustawienia opis
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED Ustaw na 0, aby wyłączyć pamięć podręczną funkcji.
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT Zobacz Odnoszenie się do ustawień aplikacji dla Azure Functions.
AzureWebJobsSecretStorageType Zobacz Odnoszenie się do ustawień aplikacji dla Azure Functions.
FUNCTIONS_EXTENSION_VERSION Zobacz Odnoszenie się do ustawień aplikacji dla Azure Functions.
FUNCTIONS_WORKER_RUNTIME Zobacz Odnoszenie się do ustawień aplikacji dla Azure Functions.
AzureWebJobsStorage Zobacz Odnoszenie się do ustawień aplikacji dla Azure Functions.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING Zobacz Odnoszenie się do ustawień aplikacji dla Azure Functions.
WEBSITE_CONTENTSHARE Zobacz Odnoszenie się do ustawień aplikacji dla Azure Functions.
WEBSITE_CONTENTOVERVNET Zobacz Odnoszenie się do ustawień aplikacji dla Azure Functions.
WEBSITE_ENABLE_BROTLI_ENCODING Zobacz Odnoszenie się do ustawień aplikacji dla Azure Functions.
WEBSITE_USE_PLACEHOLDER Zobacz Odnoszenie się do ustawień aplikacji dla 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 działa z pakietu ZIP, pięć ostatnio zastosowanych pakietów ZIP jest przechowywanych w pamięci podręcznej systemu plików aplikacji. Ustaw tę zmienną na 1, aby wyłączyć tę pamięć podręczną. W przypadku aplikacji z użyciem systemu Linux pamięć podręczna pakietu ZIP jest domyślnie wyłączona.