Uwaga
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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 , , Shared Basic i 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 true wartość , 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 0 wszystkich 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 1 wartość . |
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 , , Error Warning , 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. |