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.
Ponieważ usługa Azure Functions używa platformy usługi aplikacja systemu Azure do hostowania, niektóre ustawienia są istotne dla twojej aplikacji funkcji, które są udokumentowane w temacie Zmienne środowiskowe i ustawienia aplikacji w usłudze aplikacja systemu Azure Service.
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 dwukropek (:
) są uznawane za 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 Windows. Na przykład ustawienieAzureFunctionsWebHost__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 tylko do 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 usługi Application Insights. Nie używaj funkcji i APPINSIGHTS_INSTRUMENTATIONKEY
APPLICATIONINSIGHTS_CONNECTION_STRING
. Jeśli to możliwe, użyj polecenia APPLICATIONINSIGHTS_CONNECTION_STRING
. Gdy usługa Application Insights 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_INSTRUMENTATIONKEY
APPLICATIONINSIGHTS_CONNECTION_STRING
. APPLICATIONINSIGHTS_CONNECTION_STRING
Zalecane jest użycie polecenia .
APPLICATIONINSIGHTS_AUTHENTICATION_STRING
Umożliwia dostęp do usługi Application Insights przy użyciu uwierzytelniania firmy Microsoft Entra. Użyj tego ustawienia, jeśli musisz nawiązać połączenie z obszarem roboczym usługi Application Insights przy użyciu uwierzytelniania firmy Microsoft Entra. Aby uzyskać więcej informacji, zobacz Microsoft Entra authentication for Application Insights (Uwierzytelnianie entra firmy Microsoft dla usługi Application Insights).
W przypadku użycia parametru APPLICATIONINSIGHTS_AUTHENTICATION_STRING
określona wartość zależy od typu tożsamości zarządzanej:
Tożsamość zarządzana | Wartość ustawienia |
---|---|
Przypisane przez system | Authorization=AAD |
Przypisane przez użytkownika | Authorization=AAD;ClientId=<USER_ASSIGNED_CLIENT_ID> |
To wymaganie uwierzytelniania jest stosowane do połączeń z hosta usługi Functions, debugera migawek, profilera i wszystkich agentów specyficznych dla języka. Aby użyć tego ustawienia, tożsamość zarządzana musi być już dostępna dla aplikacji funkcji z przypisaną rolą równoważną wydawcy metryk monitorowania.
Uwaga
W przypadku używania polecenia APPLICATIONINSIGHTS_AUTHENTICATION_STRING
w celu nawiązania połączenia z usługą Application Insights przy użyciu uwierzytelniania entra firmy Microsoft należy również wyłączyć uwierzytelnianie lokalne dla usługi Application Insights. Ta konfiguracja wymaga uwierzytelnienia firmy Microsoft w celu pozyskiwania danych telemetrycznych do obszaru roboczego.
APPLICATIONINSIGHTS_CONNECTION_STRING
Parametry połączenia dla usługi Application Insights. Nie używaj funkcji i APPINSIGHTS_INSTRUMENTATIONKEY
APPLICATIONINSIGHTS_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 usługi Application Insights działa w suwerennej chmurze, co wymaga niestandardowego punktu końcowego
Aby uzyskać więcej informacji, zobacz Parametry połączenia.
Klucz | Przykładowa wartość |
---|---|
APPLICATIONINSIGHTS_CONNECTION_STRING | InstrumentationKey=... |
Aby nawiązać połączenie z usługą Application Insights przy użyciu uwierzytelniania firmy Microsoft Entra, należy użyć polecenia APPLICATIONINSIGHTS_AUTHENTICATION_STRING
.
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 false
wartość , zostanie wyświetlona strona podobna do poniższego przykładu w odpowiedzi na adres URL <functionappname>.azurewebsites.net
.
AzureWebJobsDotNetReleaseCompilation
true
oznacza użycie Release
trybu 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 AzureWebJobsSecretStorageType
kubernetes
wartość . 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 Zarządzanie magazynem kluczy.
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 AzureWebJobsSecretStorageType
keyvault
wartość . 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 Zarządzanie magazynem kluczy.
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 AzureWebJobsSecretStorageType
keyvault
wartość . 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 Zarządzanie magazynem kluczy.
AzureWebJobsSecretStorageKeyVaultName
To ustawienie jest przestarzałe i było używane tylko podczas uruchamiania w wersji 3.x środowiska uruchomieniowego usługi Azure Functions.
Nazwa wystąpienia magazynu kluczy używanego do przechowywania kluczy. To ustawienie było używane tylko w wersji 3.x środowiska uruchomieniowego usługi Functions, które nie jest już obsługiwane. W przypadku wersji 4.x zamiast tego użyj polecenia AzureWebJobsSecretStorageKeyVaultUri
. To ustawienie wymaga ustawienia na AzureWebJobsSecretStorageType
keyvault
wartość .
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
, List
i 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 Zarządzanie magazynem kluczy.
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 AzureWebJobsSecretStorageType
keyvault
wartość . Obsługiwane w wersji 4.x i nowszych wersjach środowiska uruchomieniowego usługi Functions. Aby dowiedzieć się więcej, zobacz Zarządzanie magazynem kluczy.
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 AzureWebJobsSecretStorageType
keyvault
wartość .
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
, List
i 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 Zarządzanie magazynem kluczy.
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 AzureWebJobsSecretStorageKeyVaultName program . |
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 Zarządzanie magazynem kluczy.
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 1
wartość .
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 ~4
). Gdy są dostępne nowe wersje pomocnicze tej samej wersji głównej, są one automatycznie instalowane w aplikacji funkcji.
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 |
~1 |
1.x | Wsparcie kończy się 14 września 2026 r. |
Wartość ~4
oznacza, że aplikacja działa w wersji 4.x środowiska uruchomieniowego. Wartość ~1
przypina aplikację do wersji 1.x środowiska uruchomieniowego. Wersje środowiska uruchomieniowego 2.x i 3.x nie są już obsługiwane. Aby uzyskać więcej informacji, zobacz Omówienie wersji środowiska uruchomieniowego usługi Azure Functions.
Jeśli zażądasz pomocy technicznej, aby przypiąć aplikację do określonej wersji pomocniczej, użyj pełnego numeru wersji (na przykład 4.0.12345
). Aby uzyskać więcej informacji, zobacz Wybieranie wersji środowiska uruchomieniowego usługi Azure Functions.
FUNCTIONS_INPROC_NET8_ENABLED
Wskazuje, czy aplikacja może używać platformy .NET 8 w modelu przetwarzania. Aby użyć platformy .NET 8 w modelu przetwarzania, ta wartość musi być ustawiona na 1
wartość . Aby uzyskać pełne instrukcje, łącznie z innymi wymaganymi wartościami konfiguracji, zobacz Aktualizowanie do docelowej platformy .NET 8 .
Klucz | Przykładowa wartość |
---|---|
FUNCTIONS_INPROC_NET8_ENABLED | 1 |
Ustaw wartość na wartość , aby 0
wyłączyć obsługę platformy .NET 8 w modelu przetwarzania.
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 usłudze Application Insights.
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 jest używane ustawienie 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 usłudze Application Insights. |
FUNCTIONS_NODE_BLOCK_ON_ENTRY_POINT_ERROR | false |
Ignoruj błędy punktu wejścia i nie loguj ich w usłudze Application Insights. |
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT
Zastępuje domyślny limit rozmiaru treści żądań wysyłanych do punktów końcowych HTTP. Wartość jest podana w bajtach z domyślnym maksymalnym rozmiarem żądania wynoszącym 104 857 600 bajtów.
Klucz | Przykładowa wartość |
---|---|
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT | 250000000 |
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_WORKER_PROCESS_COUNT
Określa maksymalną liczbę procesów roboczych języka z wartością 1
domyś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 MDNewSnapshotCheckPeriod
programu 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 MDMinBackgroundUpgradePeriod
elemecie .
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-url
i 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-url
zależ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 0
wartość .
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ą parametru 0
tylko 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 None
wartość . 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 usługi AppInsights upewnij się, że usługa Application Insights jest włączona w aplikacji funkcji.Po ustawieniu miejsca docelowego na Blob wartość 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 , Warning i Verbose .W przypadku ustawienia wartości Verbose kontroler 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
Parametry połączenia dla konta magazynu, na 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
Ważne
WEBSITE_CONTENTOVERVNET to starsze ustawienie aplikacji, które zostało zastąpione przez właściwość witryny vnetContentShareEnabled .
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 i WEBSITE_CONTENTSHARE
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING
. Aby dowiedzieć się więcej, zobacz Ograniczanie konta magazynu do sieci wirtualnej.
Klucz | Przykładowa wartość |
---|---|
WEBSITE_CONTENTOVERVNET | 1 |
To ustawienie aplikacji jest wymagane w planach Elastic Premium i Dedicated (App Service) (wersja Standardowa i nowsza). Nieobsługiwane podczas uruchamiania w planie Zużycie.
Uwaga
Podczas kierowania do udziału zawartości na koncie magazynu współużytkowanego przez wiele aplikacji funkcji w tym samym planie należy zachować szczególną ostrożność. Aby uzyskać więcej informacji, zobacz Spójny routing za pośrednictwem sieci wirtualnych w artykule Zagadnienia dotyczące magazynu.
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_CONTENTSHARE
Ustawienie 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_CONTENTSHARE
parametru 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 ~18
uż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 1
wartość 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 1
wartość , 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 aplikacji jest kierowany przez sieć wirtualną. To ustawienie będzie potrzebne podczas konfigurowania regionalnej integracji sieci wirtualnej w planach hostingu Elastic Premium i Dedicated. 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ą true
domyślną . Należy ustawić tę opcję na false
wartość podczas wdrażania aplikacji funkcji w kontenerze.
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:
AcrUseManagedIdentityCreds
Wskazuje, czy obraz jest uzyskiwany z wystąpienia usługi Azure Container Registry przy użyciu uwierzytelniania tożsamości zarządzanej. Wartość wymaga użycia tożsamości zarządzanej true
, która jest zalecana w odniesieniu do przechowywanych poświadczeń uwierzytelniania jako najlepsze rozwiązanie w zakresie zabezpieczeń.
AcrUserManagedIdentityID
Wskazuje tożsamość zarządzaną do użycia podczas uzyskiwania obrazu z wystąpienia usługi Azure Container Registry. Wymaga, aby AcrUseManagedIdentityCreds
ustawiono wartość true
. Są to prawidłowe wartości:
Wartość | Opis |
---|---|
system |
Używana jest tożsamość zarządzana przypisana przez system aplikacji funkcji. |
<USER_IDENTITY_RESOURCE_ID> |
W pełni kwalifikowany identyfikator zasobu tożsamości zarządzanej przypisanej przez użytkownika. |
Określona tożsamość musi zostać dodana do ACRPull
roli w rejestrze kontenerów. Aby uzyskać więcej informacji, zobacz Tworzenie i konfigurowanie aplikacji funkcji na platformie Azure przy użyciu obrazu.
alwaysOn
W przypadku aplikacji funkcji działającej w ramach planu dedykowanego (App Service) środowisko uruchomieniowe usługi Functions przechodzi w stan bezczynności po kilku minutach braku aktywności, co oznacza, że tylko żądania do wyzwalacza HTTP wznawiają aplikację funkcji. Aby upewnić się, że funkcje wyzwalane przez protokół HTTP działają poprawnie, w tym funkcje wyzwalacza czasomierza, włącz opcję Zawsze włączone dla aplikacji funkcji, ustawiając alwaysOn
ustawienie witryny na wartość true
.
functionsRuntimeAdminIsolationEnabled
Określa, czy można uzyskać dostęp do wbudowanych punktów końcowych administratora (/admin
) w aplikacji funkcji. Po ustawieniu false
wartości (wartość domyślna) aplikacja zezwala na żądania do punktów końcowych w obszarze /admin
, gdy te żądania przedstawiają klucz główny w żądaniu. /admin
Gdy true
nie można uzyskać dostępu do punktów końcowych, nawet przy użyciu klucza głównego.
Nie można ustawić tej właściwości dla aplikacji uruchomionych w jednostce SKU Zużycie systemu Linux i nie można jej ustawić dla aplikacji działających w wersji 1.x usługi Azure Functions. Jeśli używasz wersji 1.x, musisz najpierw przeprowadzić migrację do wersji 4.x.
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.
vnetContentShareEnabled
Aplikacje działające w planie Premium używają udziału plików do przechowywania zawartości. Nazwa tego udziału zawartości jest przechowywana w WEBSITE_CONTENTSHARE
ustawieniu aplikacji, a jego parametry połączenia jest przechowywana w pliku WEBSITE_CONTENTAZUREFILECONNECTIONSTRING
. Aby kierować ruch między aplikacją funkcji a udziałem zawartości za pośrednictwem sieci wirtualnej, należy również ustawić wartość vnetContentShareEnabled
true
. Włączenie tej właściwości witryny jest wymagane podczas ograniczania konta magazynu do sieci wirtualnej w planach hostingu Elastic Premium i Dedicated.
Uwaga
Podczas kierowania do udziału zawartości na koncie magazynu współużytkowanego przez wiele aplikacji funkcji w tym samym planie należy zachować szczególną ostrożność. Aby uzyskać więcej informacji, zobacz Spójny routing za pośrednictwem sieci wirtualnych w artykule Zagadnienia dotyczące magazynu.
Ta właściwość witryny zastępuje starsze WEBSITE_CONTENTOVERVNET
ustawienie.
vnetImagePullEnabled
Funkcje obsługują aplikacje funkcji działające w kontenerach systemu Linux. Aby nawiązać połączenie i ściągnąć z rejestru kontenerów wewnątrz sieci wirtualnej, musisz ustawić wartość vnetImagePullEnabled
true
. Ta właściwość witryny jest obsługiwana w planach hostingu Elastic Premium i Dedicated. Plan Flex Consumption nie polega na właściwościach witryny ani ustawieniach aplikacji w celu skonfigurowania sieci. Aby uzyskać więcej informacji, zobacz Flex Consumption plan deprecations (Wycofywanie planu Flex Consumption).
vnetRouteAllEnabled
Wskazuje, czy cały ruch wychodzący z aplikacji jest kierowany przez sieć wirtualną. Wartość true
ustawienia wskazuje, że cały ruch aplikacji jest kierowany przez sieć wirtualną. Użyj tego ustawienia podczas konfigurowania regionalnej integracji sieci wirtualnej w planach Elastic Premium i Dedicated. 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 .
Wycofanie planu Flex Consumption
W planie Flex Consumption te właściwości witryny i ustawienia aplikacji są przestarzałe i nie powinny być używane podczas tworzenia zasobów aplikacji funkcji:
Ustawienie/właściwość | Przyczyna |
---|---|
ENABLE_ORYX_BUILD |
Zastąpiony parametrem podczas wdrażania w rozwiązaniu remoteBuild Flex Consumption |
FUNCTIONS_EXTENSION_VERSION |
Ustawienie aplikacji jest ustawiane przez zaplecze. Wartość ~1 można zignorować. |
FUNCTIONS_WORKER_RUNTIME |
Zastąpione przez name w properties.functionAppConfig.runtime |
FUNCTIONS_WORKER_RUNTIME_VERSION |
Zastąpione przez version w properties.functionAppConfig.runtime |
FUNCTIONS_MAX_HTTP_CONCURRENCY |
Zamieniono sekcję wyzwalacza skalowania i współbieżności |
FUNCTIONS_WORKER_PROCESS_COUNT |
Nieprawidłowe ustawienie |
FUNCTIONS_WORKER_DYNAMIC_CONCURRENCY_ENABLED |
Nieprawidłowe ustawienie |
SCM_DO_BUILD_DURING_DEPLOYMENT |
Zastąpiony parametrem podczas wdrażania w rozwiązaniu remoteBuild Flex Consumption |
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING |
Zastąpiona przez sekcję wdrażania funkcjiAppConfig |
WEBSITE_CONTENTOVERVNET |
Nie jest używany do obsługi sieci w środowisku Flex Consumption |
WEBSITE_CONTENTSHARE |
Zastąpiona przez sekcję wdrażania funkcjiAppConfig |
WEBSITE_DNS_SERVER |
System DNS jest dziedziczony ze zintegrowanej sieci wirtualnej w rozwiązaniu Flex |
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT |
Zastąpione przez maximumInstanceCount w properties.functionAppConfig.scaleAndConcurrency |
WEBSITE_NODE_DEFAULT_VERSION |
Zastąpione przez version w properties.functionAppConfig.runtime |
WEBSITE_RUN_FROM_PACKAGE |
Nieużytne w przypadku wdrożeń w rozwiązaniu Flex Consumption |
WEBSITE_SKIP_CONTENTSHARE_VALIDATION |
Udział zawartości nie jest używany w rozwiązaniu Flex Consumption |
WEBSITE_VNET_ROUTE_ALL |
Nie jest używany do obsługi sieci w środowisku Flex Consumption |
properties.alwaysOn |
Nieprawidłowe |
properties.containerSize |
Zmieniono nazwę jako instanceMemoryMB |
properties.ftpsState |
Usługa FTPS nie jest obsługiwana |
properties.isReserved |
Nieprawidłowe |
properties.IsXenon |
Nieprawidłowe |
properties.javaVersion |
Zastąpione przez version w properties.functionAppConfig.runtime |
properties.LinuxFxVersion |
Zastępuje properties.functionAppConfig.runtime |
properties.netFrameworkVersion |
Zastąpione przez version w properties.functionAppConfig.runtime |
properties.powerShellVersion |
Zastąpione przez version w properties.functionAppConfig.runtime |
properties.siteConfig.functionAppScaleLimit |
Zmieniono nazwę jako maximumInstanceCount |
properties.siteConfig.preWarmedInstanceCount |
Zmieniono nazwę jako alwaysReadyInstances |
properties.use32BitWorkerProcess |
32-bitowe nieobsługiwane |
properties.vnetBackupRestoreEnabled |
Nie jest używany do obsługi sieci w środowisku Flex Consumption |
properties.vnetContentShareEnabled |
Nie jest używany do obsługi sieci w środowisku Flex Consumption |
properties.vnetImagePullEnabled |
Nie jest używany do obsługi sieci w środowisku Flex Consumption |
properties.vnetRouteAllEnabled |
Nie jest używany do obsługi sieci w środowisku Flex Consumption |
properties.windowsFxVersion |
Nieprawidłowe |
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