Dokumentacja ustawień aplikacji dla usługi Azure Functions

Ustawienia aplikacji w aplikacji funkcji zawierają opcje konfiguracji, które mają wpływ na wszystkie funkcje dla tej aplikacji funkcji. Te ustawienia są dostępne jako zmienne środowiskowe. W tym artykule wymieniono ustawienia aplikacji, które są dostępne w aplikacjach funkcji.

Istnieje kilka sposobów dodawania, aktualizowania i usuwania ustawień aplikacji funkcji:

• W witrynie Azure Portal
• Za pomocą interfejsu wiersza polecenia platformy Azure.
• Za pomocą programu Azure PowerShell.

Zmiany ustawień aplikacji funkcji wymagają ponownego uruchomienia aplikacji funkcji.

W tym artykule przykładowe wartości parametry połączenia są obcinane w celu zapewnienia czytelności.

Zagadnienia dotyczące ustawień aplikacji

Podczas korzystania z ustawień aplikacji należy pamiętać o następujących kwestiach:

• Zmiany ustawień aplikacji funkcji wymagają ponownego uruchomienia aplikacji funkcji.

• W nazwach ustawień podwójne podkreślenie (__) i średnik (:) są traktowane jako wartości zarezerwowane. Podwójne podkreślenia są interpretowane jako ograniczniki hierarchiczne w systemach Windows i Linux, a dwukropki są interpretowane w taki sam sposób tylko w systemie Linux. Na przykład ustawienie AzureFunctionsWebHost__hostid=somehost_123456 zostanie zinterpretowane jako następujący obiekt JSON:

  "AzureFunctionsWebHost": {
      "hostid": "somehost_123456"
  }
  

  W tym artykule są używane tylko podkreślenia podwójne, ponieważ są one obsługiwane w obu systemach operacyjnych. Większość ustawień obsługujących połączenia tożsamości zarządzanej używa podwójnych podkreśleń.

• Gdy funkcje działają lokalnie, ustawienia aplikacji są określone w Values kolekcji w local.settings.json.

• Istnieją inne opcje konfiguracji aplikacji funkcji w pliku host.json i w pliku local.settings.json .

• Ustawienia aplikacji umożliwiają zastąpienie wartości ustawień host.json bez konieczności zmieniania samego pliku host.json. Jest to przydatne w scenariuszach, w których należy skonfigurować lub zmodyfikować określone ustawienia host.json dla określonego środowiska. Umożliwia to również zmianę ustawień host.json bez konieczności ponownego publikowania projektu. Aby dowiedzieć się więcej, zobacz artykuł referencyjny dotyczący host.json.

• W tym artykule opisano ustawienia, które są najbardziej istotne dla aplikacji funkcji. Ponieważ usługa Azure Functions działa w usłudze App Service, obsługiwane są również inne ustawienia aplikacji. Aby uzyskać więcej informacji, zobacz Zmienne środowiskowe i ustawienia aplikacji w usłudze aplikacja systemu Azure Service.

• Niektóre scenariusze wymagają również pracy z ustawieniami udokumentowanymi w ustawieniach witryny usługi App Service.

• Zmiana wszystkich ustawień aplikacji usługi App Service tylkodo odczytu może umieścić aplikację funkcji w stanie nieodpowiadczym.

• Należy zachować ostrożność podczas aktualizowania ustawień aplikacji przy użyciu interfejsów API REST, w tym szablonów usługi ARM. Ponieważ te interfejsy API zastępują istniejące ustawienia aplikacji, należy uwzględnić wszystkie istniejące ustawienia podczas dodawania lub modyfikowania ustawień przy użyciu interfejsów API REST lub szablonów usługi ARM. Jeśli to możliwe, użyj interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell, aby programowo pracować z ustawieniami aplikacji. Aby uzyskać więcej informacji, zobacz Praca z ustawieniami aplikacji.

APPINSIGHTS_INSTRUMENTATIONKEY

Klucz instrumentacji dla Szczegółowe informacje aplikacji. Nie używaj funkcji i APPINSIGHTS_INSTRUMENTATIONKEYAPPLICATIONINSIGHTS_CONNECTION_STRING. Jeśli to możliwe, użyj polecenia APPLICATIONINSIGHTS_CONNECTION_STRING. Gdy aplikacja Szczegółowe informacje działa w suwerennej chmurze, należy użyć polecenia APPLICATIONINSIGHTS_CONNECTION_STRING. Aby uzyskać więcej informacji, zobacz How to configure monitoring for Azure Functions (Jak skonfigurować monitorowanie dla usługi Azure Functions).

Klucz	Przykładowa wartość
APPINSIGHTS_INSTRUMENTATIONKEY	55555555-af77-484b-9032-64f83bb83bb

Nie używaj funkcji i APPINSIGHTS_INSTRUMENTATIONKEYAPPLICATIONINSIGHTS_CONNECTION_STRING. APPLICATIONINSIGHTS_CONNECTION_STRING Zalecane jest użycie polecenia .

Uwaga

31 marca 2025 r. zostanie zakończone świadczenie pomocy technicznej dla pozyskiwania klucza instrumentacji. Pozyskiwanie klucza instrumentacji będzie nadal działać, ale nie udostępnimy już aktualizacji ani obsługi funkcji. Przejście do parametry połączenia w celu skorzystania z nowych funkcji.

APPLICATIONINSIGHTS_CONNECTION_STRING

Parametry połączenia for Application Szczegółowe informacje. Nie używaj funkcji i APPINSIGHTS_INSTRUMENTATIONKEYAPPLICATIONINSIGHTS_CONNECTION_STRING. Chociaż stosowanie polecenia APPLICATIONINSIGHTS_CONNECTION_STRING jest zalecane we wszystkich przypadkach, jest wymagane w następujących przypadkach:

• Gdy aplikacja funkcji wymaga dodanych dostosowań obsługiwanych przy użyciu parametry połączenia.
• Gdy wystąpienie aplikacji Szczegółowe informacje działa w suwerennej chmurze, co wymaga niestandardowego punktu końcowego.

Aby uzyskać więcej informacji, zobacz ciągi Połączenie ion.

Klucz	Przykładowa wartość
APPLICATIONINSIGHTS_CONNECTION_STRING	InstrumentationKey=...

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

Ważne

Serwery proxy usługi Azure Functions to starsza funkcja dla wersji 1.x do 3.x środowiska uruchomieniowego usługi Azure Functions. Aby uzyskać więcej informacji na temat starszej obsługi w wersji 4.x, zobacz Serwery proxy usługi Functions.

Domyślnie serwery proxy usługi Functions używają skrótu do wysyłania wywołań interfejsu API z serwerów proxy bezpośrednio do funkcji w tej samej aplikacji funkcji. Ten skrót jest używany zamiast tworzenia nowego żądania HTTP. To ustawienie umożliwia wyłączenie tego zachowania skrótu.

Key	Wartość	Opis
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL	true	Wywołania z adresem URL zaplecza wskazującym funkcję w lokalnej aplikacji funkcji nie będą wysyłane bezpośrednio do funkcji. Zamiast tego żądania są kierowane z powrotem do frontonu HTTP dla aplikacji funkcji.
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL	false	Wywołania z adresem URL zaplecza wskazującym funkcję w lokalnej aplikacji funkcji są przekazywane bezpośrednio do funkcji. false jest wartością domyślną.

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES

Ważne

Serwery proxy usługi Azure Functions to starsza funkcja dla wersji 1.x do 3.x środowiska uruchomieniowego usługi Azure Functions. Aby uzyskać więcej informacji na temat starszej obsługi w wersji 4.x, zobacz Serwery proxy usługi Functions.

To ustawienie określa, czy znaki %2F są dekodowane jako ukośniki w parametrach trasy po wstawieniu ich do adresu URL zaplecza.

Key	Wartość	Opis
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES	true	Parametry trasy z zakodowanymi ukośnikami są dekodowane.
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES	false	Wszystkie parametry trasy są przekazywane bez zmian, co jest zachowaniem domyślnym.

Rozważmy na przykład plik proxies.json dla aplikacji funkcji w domenie myfunction.com .

{
    "$schema": "http://json.schemastore.org/proxies",
    "proxies": {
        "root": {
            "matchCondition": {
                "route": "/{*all}"
            },
            "backendUri": "example.com/{all}"
        }
    }
}

Gdy AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES jest ustawiona wartość true, adres URL example.com/api%2ftest jest rozpoznawany jako example.com/api/test. Domyślnie adres URL pozostaje niezmieniony jako example.com/test%2fapi. Aby uzyskać więcej informacji, zobacz Serwery proxy usługi Functions.

AZURE_FUNCTIONS_ENVIRONMENT

Konfiguruje środowisko uruchomieniowe hostowania aplikacji funkcji podczas uruchamiania na platformie Azure. Ta wartość jest odczytywana podczas inicjowania, a tylko te wartości są honorowane przez środowisko uruchomieniowe:

Wartość	Opis
Production	Reprezentuje środowisko produkcyjne z ograniczonym rejestrowaniem i optymalizacjami pełnej wydajności. Jest to wartość domyślna, jeśli AZURE_FUNCTIONS_ENVIRONMENT nie jest ustawiona lub jest ustawiona na nieobsługiwaną wartość.
Staging	Reprezentuje środowisko przejściowe, takie jak podczas uruchamiania w miejscu przejściowym.
Development	Programowanie wsparcie środowiska bardziej pełne rejestrowanie i inne zmniejszone optymalizacje wydajności. Narzędzia Azure Functions Core Tools ustawia wartość AZURE_FUNCTIONS_ENVIRONMENT na Development podczas uruchamiania na komputerze lokalnym. Tego ustawienia nie można zastąpić w pliku local.settings.json.

Użyj tego ustawienia zamiast ASPNETCORE_ENVIRONMENT wtedy, gdy musisz zmienić środowisko uruchomieniowe na platformie Azure na inną niż Production. Aby uzyskać więcej informacji, zobacz Environment-based Startup class and methods (Klasy i metody uruchamiania oparte na środowisku).

To ustawienie nie jest dostępne w wersji 1.x środowiska uruchomieniowego usługi Functions.

AzureFunctionsJobHost__*

W wersji 2.x lub nowszej środowiska uruchomieniowego usługi Functions ustawienia aplikacji mogą zastąpić ustawienia host.json w bieżącym środowisku. Te przesłonięcia są wyrażane jako ustawienia aplikacji o nazwie AzureFunctionsJobHost__path__to__setting. Aby uzyskać więcej informacji, zobacz Zastępowanie wartości pliku host.json.

AzureFunctionsWebHost__hostid

Ustawia identyfikator hosta dla danej aplikacji funkcji, która powinna być unikatowym identyfikatorem. To ustawienie zastępuje automatycznie wygenerowaną wartość identyfikatora hosta dla aplikacji. Użyj tego ustawienia tylko wtedy, gdy musisz zapobiec kolizjom identyfikatora hosta między aplikacjami funkcji, które współużytkować to samo konto magazynu.

Identyfikator hosta musi spełniać następujące wymagania:

• Długość od 1 do 32 znaków
• zawierają tylko małe litery, cyfry i kreski
• Nie zaczynaj ani kończy się kreską
• Nie zawiera kolejnych kreski

Łatwym sposobem wygenerowania identyfikatora jest usunięcie identyfikatora GUID, usunięcie kreski i zmniejszenie wielkości liter, na przykład przez przekonwertowanie identyfikatora GUID 1835D7B5-5C98-4790-815D-072CC94C6F71 na wartość 1835d7b55c984790815d072cc94c6f71.

Klucz	Przykładowa wartość
AzureFunctionsWebHost__hostid	myuniquefunctionappname123456789

Aby uzyskać więcej informacji, zobacz Zagadnienia dotyczące identyfikatora hosta.

AzureWebJobsDashboard

To ustawienie jest przestarzałe i jest obsługiwane tylko w przypadku uruchamiania w wersji 1.x środowiska uruchomieniowego usługi Azure Functions.

Opcjonalne konto magazynu parametry połączenia do przechowywania dzienników i wyświetlania ich na karcie Monitorowanie w portalu. Konto magazynu musi być kontem ogólnego przeznaczenia obsługującym obiekty blob, kolejki i tabele. Aby dowiedzieć się więcej, zobacz Wymagania dotyczące konta magazynu.

Klucz	Przykładowa wartość
AzureWebJobsDashboard	DefaultEndpointsProtocol=https;AccountName=...

AzureWebJobsDisableHomepage

Wartość true wyłącza domyślną stronę docelową wyświetlaną dla głównego adresu URL aplikacji funkcji. Domyślna wartość to false.

Klucz	Przykładowa wartość
AzureWebJobsDisableHomepage	true

Gdy to ustawienie aplikacji zostanie pominięte lub ustawione na falsewartość , zostanie wyświetlona strona podobna do poniższego przykładu w odpowiedzi na adres URL <functionappname>.azurewebsites.net.

AzureWebJobsDotNetReleaseCompilation

true oznacza użycie trybu wydania podczas kompilowania kodu platformy .NET; false oznacza użycie trybu debugowania. Wartość domyślna to true.

Klucz	Przykładowa wartość
AzureWebJobsDotNetReleaseCompilation	true

AzureWebJobsFeatureFlags

Rozdzielana przecinkami lista funkcji beta do włączenia. Funkcje w wersji beta włączone przez te flagi nie są gotowe do produkcji, ale można je włączyć do użytku eksperymentalnego przed rozpoczęciem ich działania.

Klucz	Przykładowa wartość
AzureWebJobsFeatureFlags	feature1,feature2,EnableProxies

Dodaj EnableProxies do tej listy, aby ponownie włączyć serwery proxy w wersji 4.x środowiska uruchomieniowego usługi Functions podczas planowania migracji do usługi Azure API Management. Aby uzyskać więcej informacji, zobacz Ponowne włączanie serwerów proxy w usłudze Functions w wersji 4.x.

AzureWebJobsKubernetesSecretName

Wskazuje zasób Kubernetes Secrets używany do przechowywania kluczy. Obsługiwane tylko w przypadku uruchamiania na platformie Kubernetes. To ustawienie wymaga ustawienia na AzureWebJobsSecretStorageTypekuberneteswartość . Jeśli AzureWebJobsKubernetesSecretName nie zostanie ustawione, repozytorium jest uznawane za tylko do odczytu. W takim przypadku przed wdrożeniem należy wygenerować wartości. Narzędzia Azure Functions Core Tools generują wartości automatycznie podczas wdrażania na platformie Kubernetes.

Klucz	Przykładowa wartość
AzureWebJobsKubernetesSecretName	<SECRETS_RESOURCE>

Aby dowiedzieć się więcej, zobacz Repozytoria wpisów tajnych.

AzureWebJobsSecretStorageKeyVaultClientId

Identyfikator klienta tożsamości zarządzanej przypisanej przez użytkownika lub rejestracja aplikacji używana do uzyskiwania dostępu do magazynu, w którym są przechowywane klucze. To ustawienie wymaga ustawienia na AzureWebJobsSecretStorageTypekeyvaultwartość . Obsługiwane w wersji 4.x i nowszych wersjach środowiska uruchomieniowego usługi Functions.

Klucz	Przykładowa wartość
AzureWebJobsSecretStorageKeyVaultClientId	<CLIENT_ID>

Aby dowiedzieć się więcej, zobacz Repozytoria wpisów tajnych.

AzureWebJobsSecretStorageKeyVaultClientSecret

Wpis tajny dla identyfikatora klienta tożsamości zarządzanej przypisanej przez użytkownika lub rejestracji aplikacji używanej do uzyskiwania dostępu do magazynu, w którym są przechowywane klucze. To ustawienie wymaga ustawienia na AzureWebJobsSecretStorageTypekeyvaultwartość . Obsługiwane w wersji 4.x i nowszych wersjach środowiska uruchomieniowego usługi Functions.

Klucz	Przykładowa wartość
AzureWebJobsSecretStorageKeyVaultClientSecret	<CLIENT_SECRET>

Aby dowiedzieć się więcej, zobacz Repozytoria wpisów tajnych.

AzureWebJobsSecretStorageKeyVaultName

Nazwa wystąpienia magazynu kluczy używanego do przechowywania kluczy. To ustawienie jest obsługiwane tylko w wersji 3.x środowiska uruchomieniowego usługi Functions. W przypadku wersji 4.x zamiast tego użyj polecenia AzureWebJobsSecretStorageKeyVaultUri. To ustawienie wymaga ustawienia na AzureWebJobsSecretStorageTypekeyvaultwartość .

Magazyn musi mieć zasady dostępu odpowiadające tożsamości zarządzanej przypisanej przez system zasobu hostingu. Zasady dostępu powinny przyznać tożsamości następujące uprawnienia wpisu tajnego: Get,Set, Listi Delete.
Gdy funkcje działają lokalnie, używana jest tożsamość dewelopera, a ustawienia muszą znajdować się w pliku local.settings.json.

Klucz	Przykładowa wartość
AzureWebJobsSecretStorageKeyVaultName	<VAULT_NAME>

Aby dowiedzieć się więcej, zobacz Repozytoria wpisów tajnych.

AzureWebJobsSecretStorageKeyVaultTenantId

Identyfikator dzierżawy rejestracji aplikacji używany do uzyskiwania dostępu do magazynu, w którym są przechowywane klucze. To ustawienie wymaga ustawienia na AzureWebJobsSecretStorageTypekeyvaultwartość . Obsługiwane w wersji 4.x i nowszych wersjach środowiska uruchomieniowego usługi Functions. Aby dowiedzieć się więcej, zobacz Repozytoria wpisów tajnych.

Klucz	Przykładowa wartość
AzureWebJobsSecretStorageKeyVaultTenantId	<TENANT_ID>

AzureWebJobsSecretStorageKeyVaultUri

Identyfikator URI wystąpienia magazynu kluczy używany do przechowywania kluczy. Obsługiwane w wersji 4.x i nowszych wersjach środowiska uruchomieniowego usługi Functions. Jest to zalecane ustawienie dotyczące używania wystąpienia magazynu kluczy dla magazynu kluczy. To ustawienie wymaga ustawienia na AzureWebJobsSecretStorageTypekeyvaultwartość .

Wartość AzureWebJobsSecretStorageKeyVaultUri powinna być pełną wartością identyfikatora URI magazynu wyświetlaną na karcie Przegląd usługi Key Vault, w tym https://.

Magazyn musi mieć zasady dostępu odpowiadające tożsamości zarządzanej przypisanej przez system zasobu hostingu. Zasady dostępu powinny przyznać tożsamości następujące uprawnienia wpisu tajnego: Get,Set, Listi Delete.
Gdy funkcje działają lokalnie, używana jest tożsamość dewelopera, a ustawienia muszą znajdować się w pliku local.settings.json.

Klucz	Przykładowa wartość
AzureWebJobsSecretStorageKeyVaultUri	https://<VAULT_NAME>.vault.azure.net

Aby dowiedzieć się więcej, zobacz Używanie odwołań do magazynu kluczy dla usługi Azure Functions.

AzureWebJobsSecretStorageSas

Adres URL sygnatury dostępu współdzielonego usługi Blob Storage dla drugiego konta magazynu używanego na potrzeby magazynu kluczy. Domyślnie usługa Functions używa konta ustawionego w programie AzureWebJobsStorage. W przypadku korzystania z tej opcji magazynu wpisów tajnych upewnij się, że AzureWebJobsSecretStorageType nie ustawiono jawnie lub ustawiono wartość blob. Aby dowiedzieć się więcej, zobacz Repozytoria wpisów tajnych.

Klucz	Przykładowa wartość
AzureWebJobsSecretStorageSas	<BLOB_SAS_URL>

AzureWebJobsSecretStorageType

Określa repozytorium lub dostawcę do użycia w magazynie kluczy. Klucze są zawsze szyfrowane przed zapisaniem przy użyciu wpisu tajnego unikatowego dla aplikacji funkcji.

Key	Wartość	Opis
AzureWebJobsSecretStorageType	blob	Klucze są przechowywane w kontenerze usługi Blob Storage na koncie dostarczonym AzureWebJobsStorage przez to ustawienie. Usługa Blob Storage jest zachowaniem domyślnym, jeśli AzureWebJobsSecretStorageType nie jest ustawiona. Aby określić inne konto magazynu, użyj AzureWebJobsSecretStorageSas ustawienia , aby wskazać adres URL sygnatury dostępu współdzielonego drugiego konta magazynu.
AzureWebJobsSecretStorageType	files	Klucze są utrwalane w systemie plików. Jest to domyślne zachowanie funkcji w wersji 1.x.
AzureWebJobsSecretStorageType	keyvault	Klucze są przechowywane w wystąpieniu magazynu kluczy ustawionym przez AzureWebJobsSecretStorageKeyVaultNameprogram .
AzureWebJobsSecretStorageType	kubernetes	Jest obsługiwany tylko w przypadku uruchamiania środowiska uruchomieniowego usługi Functions na platformie Kubernetes. Jeśli AzureWebJobsKubernetesSecretName nie zostanie ustawione, repozytorium jest uznawane za tylko do odczytu. W takim przypadku przed wdrożeniem należy wygenerować wartości. Narzędzia Azure Functions Core Tools generują wartości automatycznie podczas wdrażania na platformie Kubernetes.

Aby dowiedzieć się więcej, zobacz Repozytoria wpisów tajnych.

AzureWebJobsStorage

Określa parametry połączenia dla konta usługi Azure Storage używanego przez środowisko uruchomieniowe usługi Functions na potrzeby normalnych operacji. Niektóre zastosowania tego konta magazynu przez funkcje obejmują zarządzanie kluczami, zarządzanie wyzwalaczem czasomierza i punkty kontrolne usługi Event Hubs. Konto magazynu musi być kontem ogólnego przeznaczenia obsługującym obiekty blob, kolejki i tabele. Aby uzyskać więcej informacji, zobacz Wymagania dotyczące konta magazynu.

Klucz	Przykładowa wartość
AzureWebJobsStorage	DefaultEndpointsProtocol=https;AccountName=...

Zamiast parametry połączenia można użyć połączenia opartego na tożsamości dla tego konta magazynu. Aby uzyskać więcej informacji, zobacz Nawiązywanie połączenia z magazynem hostów przy użyciu tożsamości.

AzureWebJobsStorage__accountName

W przypadku korzystania z połączenia magazynu opartego na tożsamości ustawia nazwę konta magazynu zamiast używać parametry połączenia w programie AzureWebJobsStorage. Ta składnia jest unikatowa AzureWebJobsStorage dla innych połączeń opartych na tożsamościach i nie może być używana.

Klucz	Przykładowa wartość
AzureWebJobsStorage__accountName	<STORAGE_ACCOUNT_NAME>

W przypadku suwerennych chmur lub w przypadku używania niestandardowego systemu DNS należy zamiast tego użyć ustawień specyficznych dla AzureWebJobsStorage__*ServiceUri usługi.

AzureWebJobsStorage__blobServiceUri

W przypadku korzystania z połączenia magazynu opartego na tożsamości ustawia identyfikator URI płaszczyzny danych usługi blob konta magazynu.

Klucz	Przykładowa wartość
AzureWebJobsStorage__blobServiceUri	https://<STORAGE_ACCOUNT_NAME>.blob.core.windows.net

Użyj tego ustawienia zamiast AzureWebJobsStorage__accountName w suwerennych chmurach lub w przypadku korzystania z niestandardowego systemu DNS. Aby uzyskać więcej informacji, zobacz Nawiązywanie połączenia z magazynem hostów przy użyciu tożsamości.

AzureWebJobsStorage__queueServiceUri

W przypadku korzystania z połączenia magazynu opartego na tożsamościach ustawia identyfikator URI płaszczyzny danych usługi kolejki konta magazynu.

Klucz	Przykładowa wartość
AzureWebJobsStorage__queueServiceUri	https://<STORAGE_ACCOUNT_NAME>.queue.core.windows.net

Użyj tego ustawienia zamiast AzureWebJobsStorage__accountName w suwerennych chmurach lub w przypadku korzystania z niestandardowego systemu DNS. Aby uzyskać więcej informacji, zobacz Nawiązywanie połączenia z magazynem hostów przy użyciu tożsamości.

AzureWebJobsStorage__tableServiceUri

W przypadku korzystania z połączenia magazynu opartego na tożsamości ustawia identyfikator URI płaszczyzny danych usługi tabeli konta magazynu.

Klucz	Przykładowa wartość
AzureWebJobsStorage__tableServiceUri	https://<STORAGE_ACCOUNT_NAME>.table.core.windows.net

Użyj tego ustawienia zamiast AzureWebJobsStorage__accountName w suwerennych chmurach lub w przypadku korzystania z niestandardowego systemu DNS. Aby uzyskać więcej informacji, zobacz Nawiązywanie połączenia z magazynem hostów przy użyciu tożsamości.

AzureWebJobs_TypeScriptPath

Ścieżka do kompilatora używanego dla języka TypeScript. Umożliwia zastąpienie wartości domyślnej, jeśli jest to konieczne.

Klucz	Przykładowa wartość
AzureWebJobs_TypeScriptPath	%HOME%\typescript

DOCKER_REGISTRY_SERVER_PASSWORD

Wskazuje hasło używane do uzyskiwania dostępu do prywatnego rejestru kontenerów. To ustawienie jest wymagane tylko podczas wdrażania konteneryzowanej aplikacji funkcji z prywatnego rejestru kontenerów. Aby uzyskać więcej informacji, zobacz Zmienne środowiskowe i ustawienia aplikacji w usłudze aplikacja systemu Azure Service.

DOCKER_REGISTRY_SERVER_URL

Wskazuje adres URL prywatnego rejestru kontenerów. To ustawienie jest wymagane tylko podczas wdrażania konteneryzowanej aplikacji funkcji z prywatnego rejestru kontenerów. Aby uzyskać więcej informacji, zobacz Zmienne środowiskowe i ustawienia aplikacji w usłudze aplikacja systemu Azure Service.

DOCKER_REGISTRY_SERVER_USERNAME

Wskazuje konto używane do uzyskiwania dostępu do prywatnego rejestru kontenerów. To ustawienie jest wymagane tylko podczas wdrażania konteneryzowanej aplikacji funkcji z prywatnego rejestru kontenerów. Aby uzyskać więcej informacji, zobacz Zmienne środowiskowe i ustawienia aplikacji w usłudze aplikacja systemu Azure Service.

DOCKER_SHM_SIZE

Ustawia rozmiar pamięci udostępnionej (w bajtach), gdy proces roboczy języka Python używa pamięci udostępnionej. Aby dowiedzieć się więcej, zobacz Pamięć udostępniona.

Klucz	Przykładowa wartość
DOCKER_SHM_SIZE	268435456

Wartość powyżej ustawia rozmiar pamięci udostępnionej wynoszący ok. 256 MB.

Wymaga ustawienia FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED na 1wartość .

ENABLE_ORYX_BUILD

Wskazuje, czy system kompilacji Oryx jest używany podczas wdrażania. ENABLE_ORYX_BUILD Musi być ustawiona na true wartość podczas wykonywania zdalnych wdrożeń kompilacji w systemie Linux. Aby uzyskać więcej informacji, zobacz Kompilacja zdalna.

Klucz	Przykładowa wartość
ENABLE_ORYX_BUILD	true

FUNCTION_APP_EDIT_MODE

Wskazuje, czy możesz edytować aplikację funkcji w witrynie Azure Portal. Prawidłowe wartości to readwrite i readonly.

Klucz	Przykładowa wartość
FUNCTION_APP_EDIT_MODE	readonly

Wartość jest ustawiana przez środowisko uruchomieniowe na podstawie stosu języka i stanu wdrożenia aplikacji funkcji. Aby uzyskać więcej informacji, zobacz Ograniczenia programistyczne w witrynie Azure Portal.

FUNCTIONS_EXTENSION_VERSION

Wersja środowiska uruchomieniowego usługi Functions, która hostuje aplikację funkcji. Tylda (~) z wersją główną oznacza użycie najnowszej wersji wersji głównej (na przykład ~3). Gdy są dostępne nowe wersje dla tej samej wersji głównej, są one automatycznie instalowane w aplikacji funkcji. Aby przypiąć aplikację do określonej wersji, użyj pełnego numeru wersji (na przykład 3.0.12345). Wartość domyślna to ~3. Wartość ~1 przypina aplikację do wersji 1.x środowiska uruchomieniowego. Aby uzyskać więcej informacji, zobacz Omówienie wersji środowiska uruchomieniowego usługi Azure Functions. Wartość ~4 oznacza, że aplikacja działa w wersji 4.x środowiska uruchomieniowego.

Klucz	Przykładowa wartość
FUNCTIONS_EXTENSION_VERSION	~4

Obsługiwane są następujące główne wartości wersji środowiska uruchomieniowego:

Wartość	Cel środowiska uruchomieniowego	Komentarz
~4	4.x	Zalecane
~3	3.x	Nieobsługiwane
~2	2.x	Nieobsługiwane
~1	1.x	Wsparcie kończy się 14 września 2026 r.

FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR

To ustawienie aplikacji jest tymczasowym sposobem Node.js aplikacji w celu włączenia zmiany powodującej niezgodność, która ułatwia rozwiązywanie problemów z błędami punktu wejścia w Node.js w wersji 18 lub niższej. Zdecydowanie zaleca się używanie funkcji true, szczególnie w przypadku aplikacji modelu programowania w wersji 4, które zawsze używają plików punktu wejścia. Zachowanie bez zmiany powodującej niezgodność (false) ignoruje błędy punktu wejścia i nie rejestruje ich w aplikacji Szczegółowe informacje.

Począwszy od Node.js wersji 20, ustawienie aplikacji nie ma wpływu i zachowanie zmiany powodującej niezgodność jest zawsze włączone.

W przypadku Node.js wersji 18 lub niższej można użyć ustawienia aplikacji, a domyślne zachowanie zależy od tego, czy błąd występuje przed zarejestrowaniem lub po zarejestrowaniu funkcji modelu w wersji 4:

• Jeśli błąd jest zgłaszany wcześniej (na przykład jeśli używasz modelu w wersji 3 lub pliku punktu wejścia nie istnieje), domyślne zachowanie jest zgodne z false.
• Jeśli błąd zostanie zgłoszony po (na przykład jeśli spróbujesz zarejestrować zduplikowane funkcje modelu w wersji 4), domyślne zachowanie jest zgodne z true.

Key	Wartość	Opis
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR	true	Blokuj błędy punktu wejścia i rejestruj je w Szczegółowe informacje aplikacji.
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR	false	Ignoruj błędy punktu wejścia i nie loguj ich w aplikacji Szczegółowe informacje.

FUNCTIONS_V2_COMPATIBILITY_MODE

Ważne

To ustawienie nie jest już obsługiwane. Pierwotnie udostępniono mu krótkoterminowe obejście dla aplikacji przeznaczonych dla środowiska uruchomieniowego w wersji 2.x, aby móc zamiast tego uruchamiać je w środowisku uruchomieniowym w wersji 3.x, mimo że było nadal obsługiwane. Z wyjątkiem starszych aplikacji uruchamianych w wersji 1.x wszystkie aplikacje funkcji muszą działać w wersji 4.x środowiska uruchomieniowego usługi Functions: FUNCTIONS_EXTENSION_VERSION=~4. Aby uzyskać więcej informacji, zobacz Omówienie wersji środowiska uruchomieniowego usługi Azure Functions.

FUNCTIONS_REQUEST_BODY_SIZE_LIMIT

Zastępuje domyślny limit rozmiaru treści żądań wysyłanych do punktów końcowych HTTP. Wartość jest podawana w bajtach z domyślnym maksymalnym rozmiarem żądania 104857600 bajtów.

Klucz	Przykładowa wartość
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT	250000000

FUNCTIONS_WORKER_PROCESS_COUNT

Określa maksymalną liczbę procesów roboczych języka z wartością 1domyślną . Dozwolona maksymalna wartość to 10. Wywołania funkcji są równomiernie dystrybuowane między procesami roboczymi języka. Procesy robocze języka są tworzone co 10 sekund do momentu osiągnięcia liczby ustawionej przez FUNCTIONS_WORKER_PROCESS_COUNT . Używanie wielu procesów roboczych języka nie jest takie samo jak skalowanie. Rozważ użycie tego ustawienia, gdy obciążenie ma kombinację wywołań powiązanych z procesorem CPU i we/wy. To ustawienie dotyczy wszystkich środowisk uruchomieniowych języka, z wyjątkiem platformy .NET działającej w procesie (FUNCTIONS_WORKER_RUNTIME=dotnet).

Klucz	Przykładowa wartość
FUNCTIONS_WORKER_PROCESS_COUNT	2

FUNCTIONS_WORKER_RUNTIME

Język lub stos języka środowiska uruchomieniowego procesu roboczego do załadowania w aplikacji funkcji. Odpowiada to językowi używanemu w aplikacji (na przykład python). Począwszy od wersji 2.x środowiska uruchomieniowego usługi Azure Functions, dana aplikacja funkcji może obsługiwać tylko jeden język.

Klucz	Przykładowa wartość
FUNCTIONS_WORKER_RUNTIME	node

Prawidłowe wartości:

Wartość	Stos języka/języka
dotnet	C# (biblioteka klas) C# (skrypt)
dotnet-isolated	C# (izolowany proces roboczy)
java	Java
node	JavaScript TypeScript
powershell	Program PowerShell
python	Python
custom	Inne

FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED

To ustawienie umożliwia procesowi roboczemu języka Python używanie pamięci udostępnionej w celu zwiększenia przepływności. Włącz pamięć współdzieloną, gdy aplikacja funkcji języka Python osiąga wąskie gardła pamięci.

Klucz	Przykładowa wartość
FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED	1

Po włączeniu tego ustawienia można użyć ustawienia DOCKER_SHM_SIZE , aby ustawić rozmiar pamięci udostępnionej. Aby dowiedzieć się więcej, zobacz Pamięć udostępniona.

JAVA_OPTS

Służy do dostosowywania maszyny wirtualnej Java (JVM) używanej do uruchamiania funkcji Java podczas uruchamiania w planie Premium lub w planie dedykowanym. W przypadku uruchamiania w planie Zużycie zamiast tego użyj polecenia languageWorkers__java__arguments. Aby uzyskać więcej informacji, zobacz Dostosowywanie maszyny JVM.

languageWorkers__java__arguments

Służy do dostosowywania maszyny wirtualnej Java (JVM) używanej do uruchamiania funkcji Języka Java podczas uruchamiania w planie Zużycie. To ustawienie zwiększa zimny czas uruchamiania funkcji Języka Java uruchomionych w planie Zużycie. W przypadku planu premium lub dedykowanego zamiast tego użyj polecenia JAVA_OPTS. Aby uzyskać więcej informacji, zobacz Dostosowywanie maszyny JVM.

MDMaxBackgroundUpgradePeriod

Określa okres aktualizacji w tle zarządzanych zależności dla aplikacji funkcji programu PowerShell z wartością 7.00:00:00 domyślną (co tydzień).

Każdy proces roboczy programu PowerShell inicjuje sprawdzanie uaktualnień modułów na Galeria programu PowerShell podczas uruchamiania procesu i co MDMaxBackgroundUpgradePeriod po tym. Gdy nowa wersja modułu jest dostępna w Galeria programu PowerShell, zostanie zainstalowana w systemie plików i udostępniona procesom roboczym programu PowerShell. Zmniejszenie tej wartości pozwala aplikacji funkcji uzyskać nowsze wersje modułów wcześniej, ale zwiększa również użycie zasobów aplikacji (operacje we/wy sieci, procesor, magazyn). Zwiększenie tej wartości zmniejsza użycie zasobów aplikacji, ale może również opóźnić dostarczanie nowych wersji modułów do aplikacji.

Klucz	Przykładowa wartość
MDMaxBackgroundUpgradePeriod	7.00:00:00

Aby dowiedzieć się więcej, zobacz Zarządzanie zależnościami.

MDNewSnapshotCheckPeriod

Określa, jak często każdy proces roboczy programu PowerShell sprawdza, czy zainstalowano uaktualnienia zależności zarządzanych. Domyślna częstotliwość to 01:00:00 (co godzinę).

Po zainstalowaniu nowych wersji modułów w systemie plików należy ponownie uruchomić każdy proces roboczy programu PowerShell. Ponowne uruchamianie procesów roboczych programu PowerShell wpływa na dostępność aplikacji, ponieważ może przerwać bieżące wykonywanie funkcji. Do momentu ponownego uruchomienia wszystkich procesów roboczych programu PowerShell wywołania funkcji mogą używać starych lub nowych wersji modułów. Ponowne uruchamianie wszystkich procesów roboczych programu PowerShell kończy się w programie MDNewSnapshotCheckPeriod.

W ramach każdego MDNewSnapshotCheckPeriodprogramu proces roboczy programu PowerShell sprawdza, czy zainstalowano uaktualnienia zależności zarządzanych. Po zainstalowaniu uaktualnień inicjowane jest ponowne uruchomienie. Zwiększenie tej wartości zmniejsza częstotliwość przerw w działaniu z powodu ponownych uruchomień. Jednak wzrost może również zwiększyć czas, w którym wywołania funkcji mogą używać starych lub nowych wersji modułów, nieokreślono.

Klucz	Przykładowa wartość
MDNewSnapshotCheckPeriod	01:00:00

Aby dowiedzieć się więcej, zobacz Zarządzanie zależnościami.

MDMinBackgroundUpgradePeriod

Okres czasu po wcześniejszym sprawdzeniu uaktualnienia zależności zarządzanych przed rozpoczęciem innego sprawdzania uaktualnienia z wartością domyślną 1.00:00:00 (codziennie).

Aby uniknąć nadmiernych uaktualnień modułów w przypadku częstych ponownych uruchomień procesów roboczych, sprawdzanie pod kątem uaktualnień modułów nie jest wykonywane, gdy żaden proces roboczy już zainicjował ten proces zaewidencjonowania w ostatnim MDMinBackgroundUpgradePeriodelemecie .

Klucz	Przykładowa wartość
MDMinBackgroundUpgradePeriod	1.00:00:00

Aby dowiedzieć się więcej, zobacz Zarządzanie zależnościami.

PIP_INDEX_URL

To ustawienie umożliwia zastąpienie podstawowego adresu URL indeksu pakietów języka Python, który domyślnie to https://pypi.org/simple. Użyj tego ustawienia, gdy musisz uruchomić kompilację zdalną przy użyciu zależności niestandardowych. Te niestandardowe zależności mogą znajdować się w repozytorium indeksów pakietów zgodnym z interfejsem PEP 503 (interfejs API prostego repozytorium) lub w katalogu lokalnym, który jest zgodny z tym samym formatem.

Klucz	Przykładowa wartość
PIP_INDEX_URL	http://my.custom.package.repo/simple

Aby dowiedzieć się więcej, zobacz pip dokumentację dotyczącą--index-urli używanie zależności niestandardowych w dokumentacji dla deweloperów języka Python.

PIP_EXTRA_INDEX_URL

Wartość tego ustawienia wskazuje dodatkowy adres URL indeksu dla pakietów niestandardowych dla aplikacji języka Python, który ma być używany oprócz elementu --index-url. Użyj tego ustawienia, gdy musisz uruchomić kompilację zdalną przy użyciu niestandardowych zależności, które znajdują się w dodatkowym indeksie pakietów. Powinny być zgodne z tymi samymi regułami co --index-url.

Klucz	Przykładowa wartość
PIP_EXTRA_INDEX_URL	http://my.custom.package.repo/simple

Aby dowiedzieć się więcej, zobacz pip dokumentację dotyczącą--extra-index-urlzależności niestandardowych i w dokumentacji dla deweloperów języka Python.

PROJEKT

Ustawienie ciągłego wdrażania, które informuje usługę wdrażania Kudu o folderze w połączonym repozytorium w celu lokalizacji możliwego do wdrożenia projektu.

Klucz	Przykładowa wartość
PROJEKT	WebProject/WebProject.csproj

PYTHON_ISOLATE_WORKER_DEPENDENCIES

Konfiguracja jest specyficzna dla aplikacji funkcji języka Python. Definiuje priorytetyzację kolejności ładowania modułu. Domyślnie ta wartość jest ustawiona na 0wartość .

Key	Wartość	Opis
PYTHON_ISOLATE_WORKER_DEPENDENCIES	0	Określanie priorytetów ładowania bibliotek języka Python z wewnętrznych zależności procesu roboczego języka Python, co jest zachowaniem domyślnym. Biblioteki innych firm zdefiniowane w requirements.txt mogą być w tle.
PYTHON_ISOLATE_WORKER_DEPENDENCIES	1	Określanie priorytetów ładowania bibliotek języka Python z pakietu aplikacji zdefiniowanego w requirements.txt. Zapobiega to kolizji bibliotek z wewnętrznymi bibliotekami procesu roboczego języka Python.

PYTHON_ENABLE_DEBUG_LOGGING

Włącza rejestrowanie na poziomie debugowania w aplikacji funkcji języka Python. Wartość 1 umożliwia rejestrowanie na poziomie debugowania. Bez tego ustawienia lub z wartością 0tylko informacje i dzienniki wyższego poziomu są wysyłane z procesu roboczego języka Python do hosta usługi Functions. Użyj tego ustawienia podczas debugowania lub śledzenia wykonań funkcji języka Python.

Podczas debugowania funkcji języka Python należy również ustawić poziom rejestrowania debugowania lub śledzenia w pliku host.json zgodnie z potrzebami. Aby dowiedzieć się więcej, zobacz Jak skonfigurować monitorowanie dla usługi Azure Functions.

PYTHON_ENABLE_WORKER_EXTENSIONS

Konfiguracja jest specyficzna dla aplikacji funkcji języka Python. Ustawienie tego 1 ustawienia umożliwia procesowi roboczemu ładowanie w rozszerzeniach procesu roboczego języka Python zdefiniowanych w requirements.txt. Umożliwia aplikacji funkcji dostęp do nowych funkcji udostępnianych przez pakiety innych firm. Może również zmienić zachowanie ładowania i wywołania funkcji w aplikacji. Upewnij się, że wybrane rozszerzenie jest wiarygodne, ponieważ ponosisz ryzyko jego użycia. Usługa Azure Functions nie udziela ekspresowych gwarancji na wszelkie rozszerzenia. Aby dowiedzieć się, jak używać rozszerzenia, odwiedź stronę ręczną rozszerzenia lub dokument readme. Domyślnie ta wartość ustawia wartość na 0.

Key	Wartość	Opis
PYTHON_ENABLE_WORKER_EXTENSIONS	0	Wyłącz dowolne rozszerzenie procesu roboczego języka Python.
PYTHON_ENABLE_WORKER_EXTENSIONS	1	Zezwalaj procesowi roboczemu języka Python na ładowanie rozszerzeń z requirements.txt.

PYTHON_THREADPOOL_THREAD_COUNT

Określa maksymalną liczbę wątków używanych przez proces roboczy języka Python do wykonywania wywołań funkcji z wartością 1 domyślną dla wersji 3.8 języka Python i poniżej. W przypadku wersji 3.9 języka Python i nowszej wartość jest ustawiona na Nonewartość . To ustawienie nie gwarantuje liczby wątków, które zostaną ustawione podczas wykonywania. Ustawienie umożliwia językowi Python rozszerzanie liczby wątków na określoną wartość. Ustawienie dotyczy tylko aplikacji funkcji języka Python. Ponadto ustawienie dotyczy wywołania funkcji synchronicznych, a nie dla kohroutines.

Klucz	Przykładowa wartość	Wartość maksymalna
PYTHON_THREADPOOL_THREAD_COUNT	2	32

SCALE_CONTROLLER_LOGGING_ENABLED

To ustawienie jest obecnie dostępne w wersji zapoznawczej.

To ustawienie steruje rejestrowaniem z kontrolera skalowania usługi Azure Functions. Aby uzyskać więcej informacji, zobacz Skalowanie dzienników kontrolera.

Klucz	Przykładowa wartość
SCALE_CONTROLLER_LOGGING_ENABLED	AppInsights:Verbose

Wartość tego klucza jest dostarczana w formacie <DESTINATION>:<VERBOSITY>, który jest zdefiniowany w następujący sposób:

Właściwości	opis
<DESTINATION>	Miejsce docelowe, do którego są wysyłane dzienniki. Prawidłowe wartości to AppInsights i Blob. W przypadku korzystania z programu AppInsightsupewnij się, że aplikacja Szczegółowe informacje jest włączona w aplikacji funkcji. Po ustawieniu miejsca docelowego na Blobwartość dzienniki są tworzone w kontenerze obiektów blob o nazwie azure-functions-scale-controller w domyślnym koncie magazynu ustawionym w ustawieniu AzureWebJobsStorage aplikacji.
<VERBOSITY>	Określa poziom rejestrowania. Obsługiwane wartości to None, Warningi Verbose. W przypadku ustawienia wartości Verbosekontroler skalowania rejestruje przyczynę każdej zmiany liczby procesów roboczych oraz informacje o wyzwalaczach, które uwzględniają te decyzje. Pełne dzienniki obejmują ostrzeżenia wyzwalacza i skróty używane przez wyzwalacze przed uruchomieniem kontrolera skalowania i po nim.

Napiwek

Należy pamiętać, że pozostawienie włączonego rejestrowania kontrolera skalowania wpływa na potencjalne koszty monitorowania aplikacji funkcji. Rozważ włączenie rejestrowania, dopóki nie zebrano wystarczającej ilości danych, aby zrozumieć, jak działa kontroler skalowania, a następnie wyłączyć go.

SCM_DO_BUILD_DURING_DEPLOYMENT

Steruje zachowaniem kompilacji zdalnej podczas wdrażania. Gdy SCM_DO_BUILD_DURING_DEPLOYMENT jest ustawiona wartość true, projekt jest kompilowany zdalnie podczas wdrażania.

Klucz	Przykładowa wartość
SCM_DO_BUILD_DURING_DEPLOYMENT	true

SCM_LOGSTREAM_TIMEOUT

Określa limit czasu (w sekundach) po nawiązaniu połączenia z dziennikami przesyłania strumieniowego. Wartość domyślna to 7200 (2 godziny).

Klucz	Przykładowa wartość
SCM_LOGSTREAM_TIMEOUT	1800

Powyższa przykładowa wartość 1800 ustawia limit czasu 30 minut. Aby uzyskać więcej informacji, zobacz Włączanie dzienników wykonywania przesyłania strumieniowego w usłudze Azure Functions.

WEBSITE_CONTENTAZUREFILECONNECTIONSTRING

Połączenie ciąg dla konta magazynu, w którym kod i konfiguracja aplikacji funkcji są przechowywane w planach skalowania opartych na zdarzeniach. Aby uzyskać więcej informacji, zobacz Ustawienia połączenia konta magazynu.

Klucz	Przykładowa wartość
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING	DefaultEndpointsProtocol=https;AccountName=...

To ustawienie jest wymagane w przypadku aplikacji z planu Consumption i Elastic Premium działających zarówno w systemach Windows, jak i Linux. Nie jest to wymagane w przypadku aplikacji w planie dedykowanym, które nie są dynamicznie skalowane przez usługę Functions.

Zmiana lub usunięcie tego ustawienia może spowodować, że aplikacja funkcji nie zostanie uruchomiona. Aby dowiedzieć się więcej, zobacz ten artykuł dotyczący rozwiązywania problemów.

Usługa Azure Files nie obsługuje używania tożsamości zarządzanej podczas uzyskiwania dostępu do udziału plików. Aby uzyskać więcej informacji, zobacz Scenariusze uwierzytelniania obsługiwane przez usługę Azure Files.

WEBSITE_CONTENTOVERVNET

Wartość 1 umożliwia aplikacji funkcji skalowanie, gdy masz konto magazynu ograniczone do sieci wirtualnej. To ustawienie należy włączyć podczas ograniczania konta magazynu do sieci wirtualnej. Wymagane tylko w przypadku używania polecenia WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. Aby dowiedzieć się więcej, zobacz Ograniczanie konta magazynu do sieci wirtualnej.

Klucz	Przykładowa wartość
WEBSITE_CONTENTOVERVNET	1

Obsługiwane w planach Premium i Dedicated (App Service) (wersja Standardowa i nowsza). Nieobsługiwane podczas uruchamiania w planie Zużycie.

WEBSITE_CONTENTSHARE

Nazwa udziału plików używanego przez usługę Functions do przechowywania kodu aplikacji funkcji i plików konfiguracji. Ta zawartość jest wymagana przez plany skalowania oparte na zdarzeniach. Używany z .WEBSITE_CONTENTAZUREFILECONNECTIONSTRING Wartość domyślna to unikatowy ciąg wygenerowany przez środowisko uruchomieniowe, który zaczyna się od nazwy aplikacji funkcji. Aby uzyskać więcej informacji, zobacz Ustawienia połączenia konta magazynu.

Klucz	Przykładowa wartość
WEBSITE_CONTENTSHARE	functionapp091999e2

To ustawienie jest wymagane dla aplikacji Zużycie i Plan Premium zarówno w systemach Windows, jak i Linux. Nie jest to wymagane w przypadku aplikacji w planie dedykowanym, które nie są dynamicznie skalowane przez usługę Functions.

Udział jest tworzony podczas tworzenia aplikacji funkcji. Zmiana lub usunięcie tego ustawienia może spowodować, że aplikacja funkcji nie zostanie uruchomiona. Aby dowiedzieć się więcej, zobacz ten artykuł dotyczący rozwiązywania problemów.

W przypadku korzystania z szablonu usługi Azure Resource Manager (ARM) lub pliku Bicep w celu utworzenia aplikacji funkcji podczas wdrażania należy wziąć pod uwagę następujące kwestie:

• Jeśli nie ustawisz WEBSITE_CONTENTSHARE wartości dla głównej aplikacji funkcji ani żadnych aplikacji w miejscach, unikatowe wartości udziału są generowane dla Ciebie. WEBSITE_CONTENTSHAREUstawienie Nie jest zalecanym podejściem do wdrożenia szablonu usługi ARM.
• Istnieją scenariusze, w których należy ustawić WEBSITE_CONTENTSHARE wartość na wstępnie zdefiniowaną wartość, na przykład w przypadku korzystania z zabezpieczonego konta magazynu w sieci wirtualnej. W takim przypadku należy ustawić unikatową nazwę udziału dla głównej aplikacji funkcji i aplikację dla każdego miejsca wdrożenia. W przypadku konta magazynu zabezpieczonego przez sieć wirtualną należy również utworzyć sam udział w ramach zautomatyzowanego wdrażania. Aby uzyskać więcej informacji, zobacz Zabezpieczone wdrożenia.
• Nie ustawiaj WEBSITE_CONTENTSHARE ustawienia miejsca.
• Po określeniu WEBSITE_CONTENTSHAREparametru wartość musi być zgodna z poniższymi wskazówkami dotyczącymi nazw udziałów.

WEBSITE_DNS_SERVER

Ustawia serwer DNS używany przez aplikację podczas rozpoznawania adresów IP. To ustawienie jest często wymagane w przypadku korzystania z niektórych funkcji sieciowych, takich jak strefy prywatne usługi Azure DNS i prywatne punkty końcowe.

Klucz	Przykładowa wartość
WEBSITE_DNS_SERVER	168.63.129.16

WEBSITE_ENABLE_BROTLI_ENCODING

Określa, czy kodowanie Brotli jest używane do kompresji zamiast domyślnej kompresji gzip. Gdy WEBSITE_ENABLE_BROTLI_ENCODING jest ustawiona wartość 1, używane jest kodowanie Brotli. W przeciwnym razie jest używane kodowanie gzip.

WEBSITE_FUNCTIONS_ARMCACHE_ENABLED

Wyłącza buforowanie podczas wdrażania aplikacji funkcji przy użyciu szablonów usługi Azure Resource Manager (ARM).

Klucz	Przykładowa wartość
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED	0

WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT

Maksymalna liczba wystąpień, do których aplikacja może być skalowana w poziomie. Wartość domyślna to brak limitu.

Ważne

To ustawienie jest w wersji zapoznawczej. Dodano właściwość aplikacji dla maksymalnego skalowania funkcji w poziomie i jest zalecanym sposobem ograniczenia skalowania w poziomie.

Klucz	Przykładowa wartość
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT	5

WEBSITE_NODE_DEFAULT_VERSION

Tylko system Windows. Ustawia wersję Node.js do użycia podczas uruchamiania aplikacji funkcji w systemie Windows. Należy użyć tyldy (~), aby środowisko uruchomieniowe używało najnowszej dostępnej wersji docelowej wersji głównej. Na przykład w przypadku ustawienia wartości jest ~18używana najnowsza wersja Node.js 18. Jeśli wersja główna jest przeznaczona dla tyldy, nie trzeba ręcznie aktualizować wersji pomocniczej.

Klucz	Przykładowa wartość
WEBSITE_NODE_DEFAULT_VERSION	~18

WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS

Podczas zamiany miejsca w aplikacji funkcji uruchomionej w planie Premium zamiana może zakończyć się niepowodzeniem, gdy dedykowane konto magazynu używane przez aplikację jest ograniczone do sieci. Ten błąd jest spowodowany przez starszą funkcję rejestrowania aplikacji, która jest współużytkowany zarówno przez funkcje, jak i usługę App Service. To ustawienie zastępuje funkcję rejestrowania starszej wersji i umożliwia zamianę.

Klucz	Przykładowa wartość
WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS	0

Dodaj WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS wartość z 0 wartością do wszystkich miejsc, aby upewnić się, że starsze ustawienia diagnostyczne nie blokują zamian. Możesz również dodać to ustawienie i wartość tylko do miejsca produkcyjnego jako ustawienie miejsca wdrożenia (sticky).

WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS

Domyślnie ustawienia wersji aplikacji funkcji są specyficzne dla każdego miejsca. To ustawienie jest używane podczas uaktualniania funkcji przy użyciu miejsc wdrożenia. Zapobiega to nieoczekiwanym zachowaniom ze względu na zmianę wersji po zamianie. Ustaw wartość na 0 w środowisku produkcyjnym i w miejscu, aby upewnić się, że wszystkie ustawienia wersji są również zamieniane. Aby uzyskać więcej informacji, zobacz Uaktualnianie przy użyciu miejsc.

Klucz	Przykładowa wartość
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS	0

WEBSITE_RUN_FROM_PACKAGE

Umożliwia uruchamianie aplikacji funkcji z pliku pakietu, który może być instalowany lokalnie lub wdrażany w zewnętrznym adresie URL.

Klucz	Przykładowa wartość
WEBSITE_RUN_FROM_PACKAGE	1

Prawidłowe wartości to adres URL rozpoznawany jako lokalizacja pliku pakietu wdrożenia zewnętrznego lub 1. W przypadku ustawienia na 1wartość pakiet musi znajdować się w folderze d:\home\data\SitePackages . Jeśli używasz wdrożenia zip z włączoną obsługą WEBSITE_RUN_FROM_PACKAGE , pakiet zostanie automatycznie przekazany do tej lokalizacji. W wersji zapoznawczej to ustawienie miało nazwę WEBSITE_RUN_FROM_ZIP. Aby uzyskać więcej informacji, zobacz Uruchamianie funkcji z pliku pakietu.

Podczas wdrażania z zewnętrznego adresu URL pakietu należy również ręcznie zsynchronizować wyzwalacze. Aby uzyskać więcej informacji, zobacz Wyzwalanie synchronizacji.

WEBSITE_SKIP_CONTENTSHARE_VALIDATION

Ustawienia WEBSITE_CONTENTAZUREFILECONNECTIONSTRING i WEBSITE_CONTENTSHARE mają dodatkowe kontrole poprawności, aby upewnić się, że aplikacja może zostać prawidłowo uruchomiona. Tworzenie ustawień aplikacji kończy się niepowodzeniem, gdy aplikacja funkcji nie może prawidłowo wywołać podrzędnego konta magazynu lub usługi Key Vault z powodu ograniczeń sieciowych lub innych czynników ograniczania. Gdy WEBSITE_SKIP_CONTENTSHARE_VALIDATION jest ustawiona na 1wartość , sprawdzanie poprawności jest pomijane. W przeciwnym razie wartość domyślna 0 to i walidacja odbywa się.

Klucz	Przykładowa wartość
WEBSITE_SKIP_CONTENTSHARE_VALIDATION	1

Jeśli walidacja zostanie pominięta, a parametry połączenia lub udział zawartości jest nieprawidłowy, aplikacja nie będzie mogła uruchomić się poprawnie. W takim przypadku funkcje zwracają błędy HTTP 500. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z błędem: "Środowisko uruchomieniowe usługi Azure Functions jest niedostępne"

WEBSITE_SLOT_NAME

Tylko do odczytu. Nazwa bieżącego miejsca wdrożenia. Nazwa miejsca produkcyjnego to Production.

Klucz	Przykładowa wartość
WEBSITE_SLOT_NAME	Production

WEBSITE_TIME_ZONE

Umożliwia ustawienie strefy czasowej dla aplikacji funkcji.

Klucz	System operacyjny	Przykładowa wartość
WEBSITE_TIME_ZONE	Windows	Eastern Standard Time
WEBSITE_TIME_ZONE	Linux	America/New_York

Domyślna strefa czasowa używana z wyrażeniami CRON to uniwersalny czas koordynowany (UTC). Aby utworzyć wyrażenie CRON na podstawie innej strefy czasowej, utwórz ustawienie aplikacji dla aplikacji funkcji o nazwie WEBSITE_TIME_ZONE.

Wartość tego ustawienia zależy od systemu operacyjnego i planu, na którym działa aplikacja funkcji.

System operacyjny	Planowanie	Wartość
Windows	wszystkie	Ustaw wartość na nazwę żądanej strefy czasowej podanej przez drugi wiersz z każdej pary podanej przez polecenie systemu Windows tzutil.exe /L
Linux	Premium Dedykowane	Ustaw wartość na nazwę żądanej strefy czasowej, jak pokazano w bazie danych tz.

Uwaga

WEBSITE_TIME_ZONE i TZ nie są obecnie obsługiwane w przypadku uruchamiania w systemie Linux w planie zużycie. W takim przypadku ustawienie WEBSITE_TIME_ZONE lub TZ może utworzyć problemy związane z protokołem SSL i spowodować, że metryki przestaną działać dla aplikacji.

Na przykład czas wschodni w Stanach Zjednoczonych (reprezentowany przez Eastern Standard Time (Windows) lub America/New_York (Linux)) obecnie używa czasu UTC-05:00 w czasie standardowym i UTC-04:00 w czasie letnim. Aby uruchomić wyzwalacz czasomierza o godzinie 10:00 czasu wschodniego każdego dnia, utwórz ustawienie aplikacji dla aplikacji funkcji o nazwie WEBSITE_TIME_ZONE, ustaw wartość Eastern Standard Time (Windows) lub America/New_York (Linux), a następnie użyj następującego wyrażenia NCRONTAB:

"0 0 10 * * *"

Gdy używasz WEBSITE_TIME_ZONE czasu jest dostosowywany do zmian czasu w określonej strefie czasowej, w tym czasu letniego i zmian w czasie standardowym.

WEBSITE_USE_PLACEHOLDER

Wskazuje, czy używać określonej optymalizacji zimnego startu podczas uruchamiania w planie Zużycie. Ustaw wartość , aby 0 wyłączyć optymalizację zimnego startu w planie Zużycie.

Klucz	Przykładowa wartość
WEBSITE_USE_PLACEHOLDER	1

WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED

Wskazuje, czy należy użyć konkretnej optymalizacji zimnego startu podczas uruchamiania funkcji procesu roboczego izolowanego platformy .NET w planie Zużycie. Ustaw wartość , aby 0 wyłączyć optymalizację zimnego startu w planie Zużycie.

Klucz	Przykładowa wartość
WEBSITE_USE_PLACEHOLDER_DOTNETISOLATED	1

WEBSITE_VNET_ROUTE_ALL

Ważne

WEBSITE_VNET_ROUTE_ALL to starsze ustawienie aplikacji, które zostało zastąpione przez ustawienie witryny vnetRouteAllEnabled .

Wskazuje, czy cały ruch wychodzący z aplikacji jest kierowany przez sieć wirtualną. Wartość 1 ustawienia wskazuje, że cały ruch jest kierowany przez sieć wirtualną. To ustawienie jest potrzebne podczas korzystania z funkcji integracji z siecią wirtualną regionalną. Jest on również używany, gdy brama translatora adresów sieci wirtualnej jest używana do definiowania statycznego wychodzącego adresu IP.

Klucz	Przykładowa wartość
WEBSITE_VNET_ROUTE_ALL	1

WEBSITES_ENABLE_APP_SERVICE_STORAGE

Wskazuje, czy /home katalog jest współużytkowany w skalowanych wystąpieniach z wartością truedomyślną . Należy ustawić tę opcję na false wartość podczas wdrażania aplikacji funkcji w kontenerze. d

Ustawienia witryny usługi App Service

Niektóre konfiguracje muszą być utrzymywane na poziomie usługi App Service jako ustawienia witryny, takie jak wersje językowe. Te ustawienia są zarządzane w portalu przy użyciu interfejsów API REST lub przy użyciu interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell. Poniżej przedstawiono ustawienia lokacji, które mogą być wymagane, w zależności od języka środowiska uruchomieniowego, systemu operacyjnego i wersji:

Alwayson

W przypadku aplikacji funkcji działającej w ramach planu dedykowanego (App Service) środowisko uruchomieniowe funkcji przechodzi w stan bezczynności po kilku minutach braku aktywności, co wskazuje tylko żądania do wyzwalaczy HTTP wznawia działanie funkcji. Aby upewnić się, że funkcje wyzwalane przez protokół HTTP działają poprawnie, w tym wyzwalacz czasomierza, włącz opcję Zawsze włączone dla aplikacji funkcji, ustawiając alwaysOn ustawienie witryny na wartość true.

linuxFxVersion

W przypadku aplikacji funkcji działających w systemie Linux linuxFxVersion wskazuje język i wersję procesu roboczego specyficznego dla języka. Te informacje są używane wraz z elementem FUNCTIONS_EXTENSION_VERSION, aby określić, który obraz kontenera systemu Linux jest zainstalowany w celu uruchomienia aplikacji funkcji. To ustawienie można ustawić na wstępnie zdefiniowaną wartość lub identyfikator URI obrazu niestandardowego.

Ta wartość jest ustawiana podczas tworzenia aplikacji funkcji systemu Linux. Może być konieczne ustawienie go dla szablonu usługi ARM i wdrożeń Bicep oraz w niektórych scenariuszach uaktualniania.

Prawidłowe wartości linuxFxVersion

Możesz użyć następującego polecenia interfejsu wiersza polecenia platformy Azure, aby wyświetlić tabelę bieżących linuxFxVersion wartości według obsługiwanej wersji środowiska uruchomieniowego usługi Functions:

az functionapp list-runtimes --os linux --query "[].{stack:join(' ', [runtime, version]), LinuxFxVersion:linux_fx_version, SupportedFunctionsVersions:to_string(supported_functions_versions[])}" --output table

Poprzednie polecenie wymaga uaktualnienia do wersji 2.40 interfejsu wiersza polecenia platformy Azure.

Obrazy niestandardowe

Podczas tworzenia i obsługi własnego niestandardowego kontenera systemu Linux dla aplikacji linuxFxVersion funkcji wartość jest zamiast tego w formacie DOCKER|<IMAGE_URI>, jak w poniższym przykładzie:

linuxFxVersion = "DOCKER|contoso.com/azurefunctionsimage:v1.0.0"

Wskazuje to źródło rejestru wdrożonego kontenera. Aby uzyskać więcej informacji, zobacz Praca z kontenerami i usługą Azure Functions.

Ważne

Podczas tworzenia własnych kontenerów należy zachować obraz podstawowy kontenera zaktualizowany do najnowszego obsługiwanego obrazu podstawowego. Obsługiwane obrazy podstawowe dla usługi Azure Functions są specyficzne dla języka i znajdują się w repozytoriach obrazów podstawowych usługi Azure Functions.

Zespół usługi Functions zobowiązuje się do publikowania comiesięcznych aktualizacji dla tych obrazów podstawowych. Regularne aktualizacje obejmują najnowsze aktualizacje wersji pomocniczej i poprawki zabezpieczeń dla środowiska uruchomieniowego i języków usługi Functions. Należy regularnie aktualizować kontener z najnowszego obrazu podstawowego i ponownie wdrożyć zaktualizowaną wersję kontenera.

netFrameworkVersion

Ustawia określoną wersję platformy .NET dla funkcji języka C#. Aby uzyskać więcej informacji, zobacz Aktualizowanie aplikacji funkcji na platformie Azure.

PowerShellVersion

Ustawia określoną wersję programu PowerShell, na której działają funkcje. Aby uzyskać więcej informacji, zobacz Zmienianie wersji programu PowerShell.

W przypadku uruchamiania lokalnego FUNCTIONS_WORKER_RUNTIME_VERSION zamiast tego należy użyć ustawienia w pliku local.settings.json.

vnetrouteallenabled

Wskazuje, czy cały ruch wychodzący z aplikacji jest kierowany przez sieć wirtualną. Wartość 1 ustawienia wskazuje, że cały ruch jest kierowany przez sieć wirtualną. To ustawienie jest potrzebne podczas korzystania z funkcji integracji z siecią wirtualną regionalną. Jest on również używany, gdy brama translatora adresów sieci wirtualnej jest używana do definiowania statycznego wychodzącego adresu IP. Aby uzyskać więcej informacji, zobacz Konfigurowanie routingu aplikacji.

To ustawienie witryny zastępuje starsze ustawienie WEBSITE_VNET_ROUTE_ALL .

Następne kroki

Dowiedz się, jak aktualizować ustawienia aplikacji

Zobacz ustawienia konfiguracji w pliku host.json

Zobacz inne ustawienia aplikacji dla aplikacji usługi App Service