Azure Functions에 대한 앱 설정 참조

함수 앱의 애플리케이션 설정에는 해당 함수 앱의 모든 함수에 영향을 주는 구성 옵션이 포함되어 있습니다. 이러한 설정은 환경 변수로 액세스됩니다. 이 문서에는 함수 앱에서 사용할 수 있는 앱 설정이 나열되어 있습니다.

함수 앱 설정을 추가, 업데이트 및 삭제할 수 있는 여러 가지 방법이 있습니다.

• Azure Portal에서
• Azure CLI 사용
• Azure PowerShell 사용

함수 앱 설정을 변경하려면 함수 앱을 다시 시작해야 합니다.

이 문서에서는 가독성을 위해 연결 문자열 값 예제가 잘립니다.

앱 설정 고려 사항

앱 설정을 사용하는 경우 다음과 같은 고려 사항을 알고 있어야 합니다.

• 함수 앱 설정을 변경하려면 함수 앱을 다시 시작해야 합니다.

• 설정 이름에서 이중 밑줄(__) 및 세미콜론(:)은 예약된 값으로 간주됩니다. 이중 밑줄은 Windows와 Linux 모두에서 계층적 구분 기호로 해석되며, 콜론은 Linux에서만 동일한 방식으로 해석됩니다. 예를 들어 설정 AzureFunctionsWebHost__hostid=somehost_123456 은 다음 JSON 개체로 해석됩니다.

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

  이 문서에서는 두 운영 체제에서 모두 지원되므로 이중 밑줄만 사용됩니다.

• Functions가 로컬로 실행되면 local.settings.json의 Values 컬렉션에 앱 설정이 지정됩니다.

• host.json 파일 및 local.settings.json 파일에는 다른 함수 앱 구성 옵션이 있습니다.

• 애플리케이션 설정을 사용하여 host.json 파일 자체를 변경할 필요 없이 host.json 설정 값을 재정의할 수 있습니다. 이 기능은 특정 환경에 대한 특정 host.json 설정을 구성하거나 수정해야 하는 경우에 유용합니다. 이렇게 하면 프로젝트를 다시 게시하지 않고도 host.json 설정을 변경할 수 있습니다. 자세한 내용은 host.json 참조 문서를 참조하세요.

• 이 문서에서는 함수 앱과 가장 관련된 설정을 설명합니다. Azure Functions App Service 실행되므로 다른 애플리케이션 설정도 지원될 수 있습니다. 자세한 내용은 Azure App Service 환경 변수 및 앱 설정을 참조하세요.

• 일부 시나리오에서는 App Service 사이트 설정에 설명된 설정을 사용해야 합니다.

• 읽기 전용App Service 애플리케이션 설정을 변경하면 함수 앱이 응답하지 않는 상태가 될 수 있습니다.

• ARM 템플릿을 포함하여 REST API를 사용하여 애플리케이션 설정을 업데이트할 때 주의하세요. 이러한 API는 기존 애플리케이션 설정을 대체하므로 REST API 또는 ARM 템플릿을 사용하여 설정을 추가하거나 수정할 때 모든 기존 설정을 포함해야 합니다. 가능한 경우 Azure CLI 또는 Azure PowerShell 사용하여 프로그래밍 방식으로 애플리케이션 설정을 사용합니다. 자세한 내용은 애플리케이션 설정 작업을 참조하세요.

APPINSIGHTS_INSTRUMENTATIONKEY

Application Insights에 대한 계측 키입니다. APPINSIGHTS_INSTRUMENTATIONKEY와 APPLICATIONINSIGHTS_CONNECTION_STRING을 같이 사용하지 마세요. 가능하면 APPLICATIONINSIGHTS_CONNECTION_STRING을 사용합니다. Application Insights가 독립 클라우드에서 실행되는 경우 APPLICATIONINSIGHTS_CONNECTION_STRING을 사용해야 합니다. 자세한 내용은 Azure Functions에 대한 모니터링을 구성하는 방법을 참조하세요.

키	샘플 값
APPINSIGHTS_INSTRUMENTATIONKEY	55555555-af77-484b-9032-64f83bb83bb

APPINSIGHTS_INSTRUMENTATIONKEY와 APPLICATIONINSIGHTS_CONNECTION_STRING을 같이 사용하지 마세요. 를 APPLICATIONINSIGHTS_CONNECTION_STRING 사용하는 것이 좋습니다.

참고

2025년 3월 31일에 계측 키 수집에 대한 지원이 종료됩니다. 계측 키 수집은 계속 작동하지만 더 이상 기능에 대한 업데이트 또는 지원을 제공하지 않습니다. 연결 문자열로 전환하여 새로운 기능을 활용합니다.

APPLICATIONINSIGHTS_CONNECTION_STRING

Application Insights에 대한 연결 문자열입니다. APPINSIGHTS_INSTRUMENTATIONKEY와 APPLICATIONINSIGHTS_CONNECTION_STRING을 같이 사용하지 마세요. 의 사용 APPLICATIONINSIGHTS_CONNECTION_STRING 은 모든 경우에 권장되지만 다음 경우에 필요합니다.

• 함수 앱에 연결 문자열을 사용하여 지원되는 추가된 사용자 지정이 필요한 경우
• Application Insights 인스턴스가 소버린 클라우드에서 실행되며 사용자 지정 엔드포인트가 필요한 경우

자세한 내용은 연결 문자열을 참조하세요.

키	샘플 값
APPLICATIONINSIGHTS_CONNECTION_STRING	InstrumentationKey=...

AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL

기본적으로 함수 프록시는 바로 가기를 사용하여 프록시에서 동일한 함수 앱의 함수로 API 호출을 직접 보냅니다. 이 바로 가기는 새 HTTP 요청을 만드는 대신 사용됩니다. 이 설정을 사용하면 바로 가기 동작을 사용하지 않도록 설정할 수 있습니다.

키	값	Description
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL	true	로컬 함수 앱에서 함수를 가리키는 백 엔드 URL을 사용하는 호출은 해당 함수로 직접 전달되지 않습니다. 대신, 요청은 함수 앱에 대한 HTTP 프런트 엔드로 다시 전달됩니다.
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL	false	로컬 함수 앱에서 함수를 가리키는 백 엔드 URL을 사용하는 호출은 해당 함수로 직접 전달됩니다. 기본값은 false입니다.

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES

이 설정은 문자 %2F 가 백 엔드 URL에 삽입될 때 경로 매개 변수에서 슬래시로 디코딩되는지 여부를 제어합니다.

키	값	Description
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES	true	인코딩된 슬래시를 사용하는 경로 매개 변수는 디코딩됩니다.
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES	false	모든 경로 매개 변수는 기본 동작인 변경되지 않은 상태로 전달됩니다.

예를 들어 myfunction.com 도메인의 함수 앱에 대한 proxies.json 파일을 살펴보겠습니다.

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

AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES가 true로 설정되면 URL은 example.com/api%2ftest를 example.com/api/test로 확인합니다. 기본적으로 URL은 변경되지 않고 example.com/test%2fapi 그대로 유지됩니다. 자세한 내용은 함수 프록시를 참조하세요.

AZURE_FUNCTIONS_ENVIRONMENT

버전 2.x 이상 버전의 함수 런타임에서는 런타임 환경을 기준으로 앱 동작을 구성합니다. 초기화하는 동안 이 값을 읽고 임의의 값으로 설정할 수 있습니다. 런타임에는 DevelopmentStaging 및 Production 값만 허용됩니다. Azure에서 실행되는 경우 이 애플리케이션 설정이 표시되지 않으면 환경이 Production으로 간주됩니다. Azure의 런타임 환경을 Production 이외의 항목으로 변경해야 하는 경우 ASPNETCORE_ENVIRONMENT 대신 이 설정을 사용합니다. Azure Functions Core Tools는 로컬 컴퓨터에서 실행할 때 로 Development 설정 AZURE_FUNCTIONS_ENVIRONMENT 되며 이 설정은 local.settings.json 파일에서 재정의할 수 없습니다. 자세히 알아보려면 환경 기반 시작 클래스 및 메서드를 참조하세요.

AzureFunctionsJobHost__*

버전 2.x 이상 버전의 Functions 런타임에서는 애플리케이션 설정이 현재 환경의 host.json 설정을 재정의할 수 있습니다. 이러한 재정의는 AzureFunctionsJobHost__path__to__setting이라는 애플리케이션 설정으로 표현됩니다. 자세한 내용은 host.json 값 재정의를 참조하세요.

AzureFunctionsWebHost__hostid

고유한 ID여야 하는 지정된 함수 앱의 호스트 ID를 설정합니다. 이 설정은 앱에 대해 자동으로 생성된 호스트 ID 값을 재정의합니다. 동일한 스토리지 계정을 공유하는 함수 앱 간의 호스트 ID 충돌을 방지해야 하는 경우에만 이 설정을 사용합니다.

호스트 ID는 다음 요구 사항을 충족해야 합니다.

• 1~32자 사이여야 합니다.
• 소문자, 숫자 및 대시만 포함
• 대시로 시작하거나 끝내지 않음
• 연속 대시를 포함하지 않음

ID를 생성하는 쉬운 방법은 GUID를 가져와서 대시를 제거하고 GUID 1835D7B5-5C98-4790-815D-072CC94C6F71을 값 1835d7b55c984790815d072cc94c6f71로 변환하는 것과 같이 소문자로 만드는 것입니다.

키	샘플 값
AzureFunctionsWebHost__hostid	myuniquefunctionappname123456789

자세한 내용은 호스트 ID 고려 사항을 참조하세요.

AzureWebJobsDashboard

로그를 저장하고 포털의 모니터 탭에 표시하기 위한 선택적인 스토리지 계정 연결 문자열입니다. 이 설정은 Azure Functions 런타임의 버전 1.x를 대상으로 하는 앱에만 유효합니다. 스토리지 계정은 Blob, 큐 및 테이블을 지원하는 범용 계정이어야 합니다. 자세한 내용은 스토리지 계정 요구 사항을 참조하세요.

키	샘플 값
AzureWebJobsDashboard	DefaultEndpointsProtocol=https;AccountName=...

참고

성능 및 환경을 향상시키기 위해 런타임 2.x 이상 버전에서는 모니터링을 위해 AzureWebJobsDashboard 대신 APPINSIGHTS_INSTRUMENTATIONKEY 및 App Insights를 사용합니다.

AzureWebJobsDisableHomepage

값은 true 함수 앱의 루트 URL에 대해 표시되는 기본 방문 페이지를 사용하지 않도록 설정합니다. 기본값은 false입니다.

키	샘플 값
AzureWebJobsDisableHomepage	true

이 앱 설정이 생략되거나 false로 설정되면 URL <functionappname>.azurewebsites.net에 대한 응답으로 다음 예와 유사한 페이지가 표시됩니다.

AzureWebJobsDotNetReleaseCompilation

true는 .NET 코드를 컴파일할 때 릴리스 모드 사용을 의미합니다. false는 디버그 모드 사용을 의미합니다. 기본값은 true입니다.

키	샘플 값
AzureWebJobsDotNetReleaseCompilation	true

AzureWebJobsFeatureFlags

사용하도록 설정할 쉼표로 구분된 베타 기능 목록입니다. 이러한 플래그에서 사용하도록 설정된 베타 기능은 프로덕션 준비가 되지 않았지만 라이브로 전환하기 전에 실험용으로 사용할 수 있습니다.

키	샘플 값
AzureWebJobsFeatureFlags	feature1,feature2,EnableProxies

이 목록에 를 추가하여 EnableProxies Azure API Management 마이그레이션을 계획하는 동안 Functions 런타임 버전 4.x에서 프록시를 다시 사용하도록 설정합니다. 자세한 내용은 Functions v4.x에서 프록시 다시 사용을 참조하세요.

AzureWebJobsKubernetesSecretName

키를 저장하는 데 사용되는 Kubernetes 비밀 리소스를 나타냅니다. Kubernetes에서 실행되는 경우에만 지원됩니다. 이 설정을 사용하려면 를 로 설정 AzureWebJobsSecretStorageType 해야 합니다 kubernetes. AzureWebJobsKubernetesSecretName이 설정되지 않은 경우, 리포지토리는 읽기 전용으로 간주됩니다. 이 경우, 배포 전에 값이 생성되어야 합니다. Azure Functions Core Tools는 Kubernetes에 배포할 때 값을 자동으로 생성합니다.

키	샘플 값
AzureWebJobsKubernetesSecretName	<SECRETS_RESOURCE>

자세한 내용은 비밀 리포지토리를 참조하세요.

AzureWebJobsSecretStorageKeyVaultClientId

키가 저장된 자격 증명 모음에 액세스하는 데 사용되는 사용자가 할당한 관리 ID 또는 앱 등록의 클라이언트 ID입니다. 이 설정을 사용하려면 를 로 설정 AzureWebJobsSecretStorageType 해야 합니다 keyvault. Functions 런타임 버전 4.x 이상에서 지원됩니다.

키	샘플 값
AzureWebJobsSecretStorageKeyVaultClientId	<CLIENT_ID>

자세한 내용은 비밀 리포지토리를 참조하세요.

AzureWebJobsSecretStorageKeyVaultClientSecret

키가 저장된 자격 증명 모음에 액세스하는 데 사용되는 사용자가 할당한 관리 ID 또는 앱 등록의 클라이언트 ID에 대한 비밀입니다. 이 설정을 사용하려면 를 로 설정 AzureWebJobsSecretStorageType 해야 합니다 keyvault. Functions 런타임 버전 4.x 이상에서 지원됩니다.

키	샘플 값
AzureWebJobsSecretStorageKeyVaultClientSecret	<CLIENT_SECRET>

자세한 내용은 비밀 리포지토리를 참조하세요.

AzureWebJobsSecretStorageKeyVaultName

키를 저장하는 데 사용되는 키 자격 증명 모음 인스턴스의 이름입니다. 이 설정은 Functions 런타임 버전 3.x에서만 지원됩니다. 버전 4.x의 경우 AzureWebJobsSecretStorageKeyVaultUri를 대신 사용합니다. 이 설정을 사용하려면 를 로 설정 AzureWebJobsSecretStorageType 해야 합니다 keyvault.

자격 증명 모음에는 반드시 호스팅 리소스의 시스템 할당 관리 ID에 해당하는 액세스 정책이 있어야 합니다. 액세스 정책은 ID에 Get,Set, List, Delete의 비밀 권한을 부여하도록 합니다.
함수가 로컬로 실행되면 개발자 ID가 사용되고 설정은 local.settings.json 파일에 있어야 합니다.

키	샘플 값
AzureWebJobsSecretStorageKeyVaultName	<VAULT_NAME>

자세한 내용은 비밀 리포지토리를 참조하세요.

AzureWebJobsSecretStorageKeyVaultTenantId

키가 저장된 자격 증명 모음에 액세스하는 데 사용되는 앱 등록의 테넌트 ID입니다. 이 설정을 사용하려면 를 로 설정 AzureWebJobsSecretStorageType 해야 합니다 keyvault. Functions 런타임 버전 4.x 이상에서 지원됩니다. 자세한 내용은 비밀 리포지토리를 참조하세요.

키	샘플 값
AzureWebJobsSecretStorageKeyVaultTenantId	<TENANT_ID>

AzureWebJobsSecretStorageKeyVaultUri

키를 저장하는 데 사용되는 키 자격 증명 모음 인스턴스의 URI입니다. Functions 런타임 버전 4.x 이상에서 지원됩니다. 키 자격 증명 모음 인스턴스를 키 스토리지에 사용하는 데 권장되는 설정입니다. 이 설정을 사용하려면 를 로 설정 AzureWebJobsSecretStorageType 해야 합니다 keyvault.

AzureWebJobsSecretStorageKeyVaultUri 값은 https://를 포함하여 Key Vault 개요 탭에 표시된 자격 증명 모음 URI의 전체 값이어야 합니다.

자격 증명 모음에는 반드시 호스팅 리소스의 시스템 할당 관리 ID에 해당하는 액세스 정책이 있어야 합니다. 액세스 정책은 ID에 Get,Set, List, Delete의 비밀 권한을 부여하도록 합니다.
함수가 로컬로 실행되면 개발자 ID가 사용되고 설정은 local.settings.json 파일에 있어야 합니다.

키	샘플 값
AzureWebJobsSecretStorageKeyVaultUri	https://<VAULT_NAME>.vault.azure.net

자세한 내용은 Azure Functions용 Key Vault 참조 사용을 참조하세요.

AzureWebJobsSecretStorageSas

키 스토리지에 사용되는 두 번째 스토리지 계정에 대한 Blob Storage SAS URL입니다. 기본적으로 Functions는 AzureWebJobsStorage에 설정된 계정을 사용합니다. 이 비밀 스토리지 옵션을 사용하는 경우 AzureWebJobsSecretStorageType이 명시적으로 설정되어 있지 않거나 blob으로 설정되어 있는지 확인합니다. 자세한 내용은 비밀 리포지토리를 참조하세요.

키	샘플 값
AzureWebJobsSecretStorageSas	<BLOB_SAS_URL>

AzureWebJobsSecretStorageType

키 스토리지에 사용할 리포지토리 또는 공급자를 지정합니다. 키는 함수 앱에 고유한 비밀을 사용하여 저장되기 전에 항상 암호화됩니다.

키	값	Description
AzureWebJobsSecretStorageType	blob	키는 AzureWebJobsStorage 설정에서 제공하는 계정의 Blob Storage 컨테이너에 저장됩니다. Blob Storage는 설정되지 않은 경우 AzureWebJobsSecretStorageType 기본 동작입니다. 다른 스토리지 계정을 지정하려면 AzureWebJobsSecretStorageSas 설정을 사용하여 두 번째 스토리지 계정의 SAS URL을 나타냅니다.
AzureWebJobsSecretStorageType	files	키는 파일 시스템에서 유지됩니다. 이는 Functions v1.x의 기본 동작입니다.
AzureWebJobsSecretStorageType	keyvault	키는 AzureWebJobsSecretStorageKeyVaultName에서 설정한 키 자격 증명 모음 인스턴스에 저장됩니다.
AzureWebJobsSecretStorageType	kubernetes	Kubernetes에서 함수 런타임을 실행하는 경우에만 지원됩니다. AzureWebJobsKubernetesSecretName이 설정되지 않은 경우, 리포지토리는 읽기 전용으로 간주됩니다. 이 경우, 배포 전에 값이 생성되어야 합니다. Azure Functions Core Tools는 Kubernetes에 배포할 때 값을 자동으로 생성합니다.

자세한 내용은 비밀 리포지토리를 참조하세요.

AzureWebJobsStorage

Azure Functions 런타임은 일반 작업을 위해 이 스토리지 계정 연결 문자열을 사용합니다. 이 스토리지 계정은 키 관리, 타이머 트리거 관리 및 Event Hubs 검사점 등에 사용됩니다. 스토리지 계정은 Blob, 큐 및 테이블을 지원하는 범용 계정이어야 합니다. 스토리지 계정 및 스토리지 계정 요구 사항을 참조하세요.

키	샘플 값
AzureWebJobsStorage	DefaultEndpointsProtocol=https;AccountName=...

AzureWebJobs_TypeScriptPath

TypeScript에 사용되는 컴파일러의 경로입니다. 필요한 경우 기본값을 재정의할 수 있습니다.

키	샘플 값
AzureWebJobs_TypeScriptPath	%HOME%\typescript

DOCKER_SHM_SIZE

Python 작업자에서 공유 메모리를 사용하는 경우 공유 메모리 크기(바이트)를 설정합니다. 자세한 내용은 공유 메모리를 참조하세요.

키	샘플 값
DOCKER_SHM_SIZE	268435456

위의 값은 256MB 이하의 공유 메모리 크기를 설정합니다.

FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED을 1로 설정해야 합니다.

ENABLE_ORYX_BUILD

배포 중에 Oryx 빌드 시스템이 사용되는지 여부를 나타냅니다. ENABLE_ORYX_BUILD 는 Linux에 true 원격 빌드 배포를 수행할 때 로 설정해야 합니다. 자세한 내용은 Linux의 원격 빌드를 참조하세요.

키	샘플 값
ENABLE_ORYX_BUILD	true

FUNCTION_APP_EDIT_MODE

Azure Portal에서 편집할 수 있는지 여부를 지정합니다. 유효한 값은 readwrite 및 readonly입니다.

키	샘플 값
FUNCTION_APP_EDIT_MODE	readonly

FUNCTIONS_EXTENSION_VERSION

이 함수 앱을 호스트하는 Functions 런타임의 버전입니다. 주 버전이 있는 타일(~)은 해당 주 버전의 최신 버전(예: ~3)을 사용한다는 의미입니다. 동일한 주 버전에 대한 새 버전을 사용할 수 있는 경우 함수 앱에 자동으로 설치됩니다. 앱을 특정 버전에 고정하려면 전체 버전 번호(예 3.0.12345: )를 사용합니다. 기본값은 ~3입니다. 값이 ~1이면 앱을 런타임의 버전 1.x로 고정합니다. 자세한 내용은 Azure Functions 런타임 버전 개요를 참조하세요. ~4 값은 앱이 .NET 6.0을 지원하는 런타임 버전 4.x에서 실행됨을 의미합니다.

키	샘플 값
FUNCTIONS_EXTENSION_VERSION	~4

다음과 같은 주요 런타임 버전 값이 지원됩니다.

값	런타임 대상	의견
~4	4.x	권장
~3	3.x	2022년 12월 13일에 지원 종료
~2	2.x	더 이상 지원되지 않음
~1	1.x	지원 여부

FUNCTIONS_V2_COMPATIBILITY_MODE

이 설정을 사용하여 함수 앱이 버전 3.x 런타임의 버전 2.x 호환 모드에서 실행되도록 할 수 있습니다. 함수 앱을 런타임의 버전 2.x에서 3.x로 업그레이드한 후 문제가 발생할 때만 이 설정을 사용합니다.

중요

이 설정은 앱이 버전 3.x에서 올바르게 실행되도록 업데이트하는 동안 단기 해결 방법으로만 사용됩니다. 이 설정은 2.x 런타임이 지원되기만 하면 지원됩니다. 이 설정을 사용하지 않고 앱이 버전 3.x에서 실행되지 않도록 하는 문제가 발생하는 경우 문제를 보고하세요.

FUNCTIONS_EXTENSION_VERSION~3로 설정해야 합니다.

키	샘플 값
FUNCTIONS_V2_COMPATIBILITY_MODE	true

FUNCTIONS_REQUEST_BODY_SIZE_LIMIT

HTTP 엔드포인트로 전송되는 요청의 본문 크기에 대한 기본 제한을 재정의합니다. 값은 바이트로 지정되며 기본 최대 요청 크기는 104857600 바이트입니다.

키	샘플 값
FUNCTIONS_REQUEST_BODY_SIZE_LIMIT	250000000

FUNCTIONS_WORKER_PROCESS_COUNT

기본값 1을 사용하여 언어 작업자 프로세스의 최대 수를 지정합니다. 허용된 최대 값은 10입니다. 함수 호출은 언어 작업자 프로세스 간에 균등하게 분산됩니다. 언어 작업자 프로세스는 FUNCTIONS_WORKER_PROCESS_COUNT에서 설정한 수에 도달할 때까지 10초마다 생성됩니다. 여러 언어 작업자 프로세스를 사용하는 것은 크기 조정과 다릅니다. 워크로드에 CPU 바인딩 및 I/O 바인딩 호출이 혼합되어 있는 경우 이 설정을 사용하는 것이 좋습니다. 이 설정은 프로세스(dotnet)에서 실행되는 .NET을 제외한 모든 언어 런타임에 적용됩니다.

키	샘플 값
FUNCTIONS_WORKER_PROCESS_COUNT	2

FUNCTIONS_WORKER_RUNTIME

함수 앱에 로드할 언어 작업자 런타임입니다. 이것은 애플리케이션(예: dotnet)에 사용되는 언어에 해당합니다. Azure Functions 런타임의 버전 2.x부터 지정된 함수 앱은 단일 언어만 지원할 수 있습니다.

키	샘플 값
FUNCTIONS_WORKER_RUNTIME	node

유효한 값은

값	언어
dotnet	C#(클래스 라이브러리) C#(스크립트)
dotnet-isolated	C#(격리된 작업자 프로세스)
java	Java
node	JavaScript TypeScript
powershell	PowerShell
python	Python

FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED

이 설정을 사용하면 Python 작업자에서 공유 메모리를 사용하여 처리량을 향상시킬 수 있습니다. Python 함수 앱에서 메모리 병목 상태에 도달할 때 공유 메모리를 사용하도록 설정합니다.

키	샘플 값
FUNCTIONS_WORKER_SHARED_MEMORY_DATA_TRANSFER_ENABLED	1

이 설정이 사용하도록 설정되면 DOCKER_SHM_SIZE 설정을 사용하여 공유 메모리 크기를 설정할 수 있습니다. 자세한 내용은 공유 메모리를 참조하세요.

JAVA_OPTS

프리미엄 계획 또는 전용 계획에서 실행할 때 Java 함수를 실행하는 데 사용되는 JVM(Java 가상 머신)을 사용자 지정하는 데 사용됩니다. 소비 계획에서 실행하는 경우 대신 을 사용합니다 languageWorkers__java__arguments. 자세한 내용은 JVM 사용자 지정을 참조하세요.

languageWorkers__java__arguments

소비 계획에서 실행할 때 Java 함수를 실행하는 데 사용되는 JVM(Java 가상 머신)을 사용자 지정하는 데 사용됩니다. 이 설정은 소비 계획에서 실행되는 Java 함수의 콜드 시작 시간을 증가합니다. 프리미엄 또는 전용 플랜의 경우 대신 을 사용합니다 JAVA_OPTS. 자세한 내용은 JVM 사용자 지정을 참조하세요.

MDMaxBackgroundUpgradePeriod

PowerShell 함수 앱의 관리되는 종속성 백그라운드 업데이트 기간을 제어하며, 기본값은 7.00:00:00(매주)입니다.

각 PowerShell 작업자 프로세스는 프로세스 시작 시와 그 이후 MDMaxBackgroundUpgradePeriod마다 PowerShell 갤러리에서 모듈 업그레이드 확인을 시작합니다. PowerShell 갤러리에서 새 모듈 버전을 사용할 수 있는 경우 해당 버전은 파일 시스템에 설치되며 PowerShell 작업자에게 제공됩니다. 이 값을 줄이면 함수 앱에서 최신 모듈 버전을 더 빨리 가져올 수 있지만, 앱 리소스 사용량(네트워크 I/O, CPU, 스토리지)도 늘어납니다. 이 값을 늘이면 앱의 리소스 사용량이 줄어들지만, 앱에 새 모듈 버전을 전달하는 작업이 지연될 수도 있습니다.

키	샘플 값
MDMaxBackgroundUpgradePeriod	7.00:00:00

자세한 내용은 종속성 관리를 참조하세요.

MDNewSnapshotCheckPeriod

각 PowerShell 작업자가 관리되는 종속성 업그레이드의 설치 여부를 확인하는 빈도를 지정합니다. 기본 빈도는 01:00:00(매시간)입니다.

새 모듈 버전이 파일 시스템에 설치된 후에는 모든 PowerShell 작업자 프로세스를 다시 시작해야 합니다. PowerShell 작업자를 다시 시작하면 현재 함수 실행을 중단할 수 있으므로 앱 사용 가능성이 영향을 받습니다. 모든 PowerShell 작업자 프로세스가 다시 시작될 때까지 함수 호출은 이전 버전 또는 새 모듈 버전을 사용할 수 있습니다. 모든 PowerShell 작업자를 다시 시작하는 작업이 MDNewSnapshotCheckPeriod 내에 완료됩니다.

모든 MDNewSnapshotCheckPeriod 내에서 PowerShell 작업자가 관리되는 종속성 업그레이드의 설치 여부를 확인합니다. 업그레이드가 설치되면 다시 시작됩니다. 이 값을 늘리면 다시 시작으로 인한 중단 빈도가 줄어듭니다. 그러나 이 값을 늘리면 함수 호출에서 이전 또는 새 모듈 버전을 임의로 사용할 수 있는 시간도 늘어날 수 있습니다.

키	샘플 값
MDNewSnapshotCheckPeriod	01:00:00

자세한 내용은 종속성 관리를 참조하세요.

MDMinBackgroundUpgradePeriod

이전에 관리되는 종속성 업그레이드 확인 후 다른 업그레이드 확인이 시작되기 전의 기간이며, 기본값은 1.00:00:00(매일)입니다.

잦은 작업자 재시작을 과도하게 모듈 업그레이드하지 않기 위해 작업자가 마지막 MDMinBackgroundUpgradePeriod에 체크 인을 이미 시작한 경우에는 모듈 업그레이드를 확인하지 않습니다.

키	샘플 값
MDMinBackgroundUpgradePeriod	1.00:00:00

자세한 내용은 종속성 관리를 참조하세요.

PIP_INDEX_URL

이 설정을 사용하면 기본적으로 https://pypi.org/simple인 Python 패키지 인덱스의 기준 URL을 재정의할 수 있습니다. 사용자 지정 종속성을 사용하여 원격 빌드를 실행해야 하는 경우 이 설정을 사용합니다. 이러한 사용자 지정 종속성은 PEP 503(단순 리포지토리 API)을 준수하는 패키지 인덱스 리포지토리 또는 동일한 형식을 따르는 로컬 디렉터리에 있을 수 있습니다.

키	샘플 값
PIP_INDEX_URL	http://my.custom.package.repo/simple

자세한 내용은 --index-url의 경우 pip 설명서 및 Python 개발자 참조에서 사용자 지정 종속성 사용을 참조하세요.

PIP_EXTRA_INDEX_URL

이 설정의 값은 --index-url 외에 사용할 Python 앱용 사용자 지정 패키지에 대한 추가 인덱스 URL을 나타냅니다. 추가 패키지 인덱스에 있는 사용자 지정 종속성을 사용하여 원격 빌드를 실행해야 하는 경우 이 설정을 사용합니다. 와 동일한 규칙을 --index-url따라야 합니다.

키	샘플 값
PIP_EXTRA_INDEX_URL	http://my.custom.package.repo/simple

자세한 내용은 --extra-index-url의 경우 pip 설명서 및 Python 개발자 참조에서 사용자 지정 종속 항목을 참조하세요.

PYTHON_ISOLATE_WORKER_DEPENDENCIES

구성은 Python 함수 앱에만 적용됩니다. 모듈 로드 순서에 대한 우선 순위를 정의합니다. 기본적으로 이 값은 0로 설정되어 있습니다.

Key	값	Description
PYTHON_ISOLATE_WORKER_DEPENDENCIES	0	기본 동작인 내부 Python 작업자의 종속성에서 Python 라이브러리 로드의 우선 순위를 지정합니다. requirements.txt에 정의된 타사 라이브러리는 섀도 처리될 수 있습니다.
PYTHON_ISOLATE_WORKER_DEPENDENCIES	1	requirements.txt에 정의된 애플리케이션의 패키지에서 Python 라이브러리 로드 우선 순위를 지정합니다. 이렇게 하면 라이브러리가 내부 Python 작업자의 라이브러리와 충돌하지 않습니다.

PYTHON_ENABLE_DEBUG_LOGGING

Python 함수 앱에서 디버그 수준 로깅을 사용하도록 설정합니다. 1 값은 디버그 수준 로깅을 사용하도록 설정합니다. 이 설정을 사용하지 않거나 값이 0인 경우 정보 및 상위 수준 로그만 Python 작업자에서 Functions 호스트로 보냅니다. Python 함수 실행을 디버그하거나 추적하는 경우 이 설정을 사용합니다.

Python 함수를 디버그하는 경우 필요에 따라 host.json 파일에서 디버그 또는 추적 로깅 수준도 설정해야 합니다. 자세한 내용은 Azure Functions에 대한 모니터링을 구성하는 방법을 참조하세요.

PYTHON_ENABLE_WORKER_EXTENSIONS

구성은 Python 함수 앱에만 적용됩니다. 이 구성을 1로 설정하면 requirements.txt에 정의된 Python 작업자 확장에서 작업자를 로드할 수 있습니다. 이를 통해 함수 앱은 타사 패키지에서 제공하는 새 기능에 액세스할 수 있습니다. 또한 앱에서 함수 로드 및 호출 동작을 변경할 수 있습니다. 선택한 확장이 사용할 위험이 있으므로 신뢰할 수 있는지 확인합니다. Azure Functions는 확장에 대한 명시적 보증을 제공하지 않습니다. 확장을 사용하는 방법은 확장의 수동 페이지 또는 추가 정보 문서를 참조하세요. 기본적으로 이 값은 로 0설정합니다.

키	값	설명
PYTHON_ENABLE_WORKER_EXTENSIONS	0	Python 작업자 확장을 사용하지 않도록 설정합니다.
PYTHON_ENABLE_WORKER_EXTENSIONS	1	Python 작업자가 requirements.txt에서 확장을 로드하도록 허용합니다.

PYTHON_THREADPOOL_THREAD_COUNT

Python 언어 작업자에서 함수 호출을 실행하는 데 사용하는 최대 스레드 수를 지정합니다. Python 버전 3.8 이하의 경우 기본값은 1입니다. Python 버전 3.9 이상의 경우 이 값은 None으로 설정됩니다. 이 설정은 실행 중에 설정되는 스레드 수를 보장하지 않습니다. 이 설정은 Python이 스레드 수를 지정된 값으로 확장할 수 있도록 합니다. 이 설정은 Python 함수 앱에만 적용됩니다. 또한 이 설정은 코루틴에는 적용되지 않지만 동기 함수 호출에 적용됩니다.

키	샘플 값	최댓값
PYTHON_THREADPOOL_THREAD_COUNT	2	32

SCALE_CONTROLLER_LOGGING_ENABLED

이 설정은 현재 미리 보기로 있습니다.

이 설정은 Azure Functions 스케일링 컨트롤러의 로깅을 제어합니다. 자세한 내용은 스케일링 컨트롤러 로그를 참조하세요.

키	샘플 값
SCALE_CONTROLLER_LOGGING_ENABLED	AppInsights:Verbose

이 키의 값은 다음과 같이 정의된 <DESTINATION>:<VERBOSITY> 형식으로 제공됩니다.

속성	Description
<DESTINATION>	로그가 전송되는 대상입니다. 유효한 값은 AppInsights 및 Blob입니다. AppInsights를 사용할 때 함수 앱에서 Application Insights가 사용하도록 설정되어 있는지 확인합니다. 대상을 Blob로 설정하면 AzureWebJobsStorage 애플리케이션 설정에 설정된 기본 스토리지 계정에서 azure-functions-scale-controller라는 Blob 컨테이너에 로그가 생성됩니다.
<VERBOSITY>	로깅 수준을 지정합니다. 지원되는 값은 None, Warning 및 Verbose입니다. Verbose로 설정되면 크기 조정 컨트롤러는 모든 작업자 수 변경의 이유 및 해당 결정을 촉발한 트리거에 대한 정보를 기록합니다. 자세한 로그에는 크기 조정 컨트롤러를 실행하기 전후에 트리거에서 사용한 트리거 경고 및 해시가 포함됩니다.

팁

크기 조정 컨트롤러 로깅을 사용하면 함수 앱 모니터링 비용에 영향을 줍니다. 크기 조정 컨트롤러의 동작을 이해하는 데 충분한 데이터를 수집할 때까지는 로깅을 사용하는 것이 좋습니다.

SCM_DO_BUILD_DURING_DEPLOYMENT

배포 중에 원격 빌드 동작을 제어합니다. 가 로 true설정되면 SCM_DO_BUILD_DURING_DEPLOYMENT 프로젝트는 배포 중에 원격으로 빌드됩니다.

키	샘플 값
SCM_DO_BUILD_DURING_DEPLOYMENT	true

SCM_LOGSTREAM_TIMEOUT

스트리밍 로그에 연결된 경우 시간 초과(초)를 제어합니다. 기본값은 7200(2시간)입니다.

키	샘플 값
SCM_LOGSTREAM_TIMEOUT	1800

위의 샘플 값 1800은 30분의 시간 초과를 설정합니다. 자세한 내용은 스트리밍 로그 사용을 참조하세요.

WEBSITE_CONTENTAZUREFILECONNECTIONSTRING

이벤트 기반 스케일링 플랜에 함수 앱 코드와 구성이 저장되는 스토리지 계정에 대한 연결 문자열입니다. 자세한 내용은 함수 앱 만들기를 참조하세요.

키	샘플 값
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING	DefaultEndpointsProtocol=https;AccountName=...

이 설정은 Windows 및 Linux 모두에서 사용 및 프리미엄 플랜 앱에 필요합니다. Functions에 의해 동적으로 크기 조정되지 않는 전용 플랜 앱에는 필요하지 않습니다.

이 설정을 변경하거나 제거하면 함수 앱이 시작되지 않을 수 있습니다. 자세히 알아보려면 이 문제 해결 문서를 참조하세요.

WEBSITE_CONTENTOVERVNET

1 값을 사용하면 스토리지 계정이 가상 네트워크로 제한된 경우 함수 앱을 스케일링할 수 있습니다. 스토리지 계정을 가상 네트워크로 제한할 때 이 설정을 사용하도록 설정해야 합니다. 자세히 알아보려면 가상 네트워크로 스토리지 계정 제한을 참조하세요.

키	샘플 값
WEBSITE_CONTENTOVERVNET	1

프리미엄 및 전용(App Service) 플랜(표준 이상)에서 지원됩니다. 소비 계획에서 실행할 때는 지원되지 않습니다.

WEBSITE_CONTENTSHARE

이벤트 기반 스케일링 플랜의 함수 앱 코드와 구성에 대한 파일 경로입니다. Used with WEBSITE_CONTENTAZUREFILECONNECTIONSTRING. 기본값은 함수 앱 이름으로 시작하는 런타임에서 생성된 고유한 문자열입니다. 함수 앱 만들기를 참조하세요.

키	샘플 값
WEBSITE_CONTENTSHARE	functionapp091999e2

이 설정은 Windows 및 Linux 모두에서 사용 및 프리미엄 플랜 앱에 필요합니다. Functions에 의해 동적으로 크기 조정되지 않는 전용 플랜 앱에는 필요하지 않습니다.

이 설정을 변경하거나 제거하면 함수 앱이 시작되지 않을 수 있습니다. 자세히 알아보려면 이 문제 해결 문서를 참조하세요.

다음 고려 사항은 배포 중에 ARM(Azure Resource Manager) 템플릿을 사용하여 함수 앱을 만들 때 적용됩니다.

• 주 함수 앱 또는 슬롯의 앱에 대한 WEBSITE_CONTENTSHARE 값을 설정하지 않으면 고유한 공유 값이 생성됩니다. ARM 템플릿 배포에 권장되는 방법은 설정 WEBSITE_CONTENTSHARE 안 됨입니다.
• 가상 네트워크에서 보안 스토리지 계정을 사용하는 경우와 같이 WEBSITE_CONTENTSHARE 값을 미리 정의된 공유로 설정해야 하는 시나리오가 있습니다. 이 경우 주 함수 앱과 각 배포 슬롯에 대한 앱에 고유한 공유 이름을 설정해야 합니다.
• WEBSITE_CONTENTSHARE를 슬롯 설정으로 만들지 마세요.
• WEBSITE_CONTENTSHARE를 지정할 때 값은 공유 이름에 대해 이 지침을 따라야 합니다.

자세히 알아보려면 함수 앱에 대한 리소스 배포 자동화를 참조하세요.

WEBSITE_DNS_SERVER

IP 주소를 확인할 때 앱에서 사용하는 DNS 서버를 설정합니다. 이 설정은 Azure DNS 프라이빗 영역 및 프라이빗 엔드포인트 같은 특정 네트워킹 기능을 사용할 때 필요합니다.

키	샘플 값
WEBSITE_DNS_SERVER	168.63.129.16

WEBSITE_ENABLE_BROTLI_ENCODING

Brotli 인코딩이 기본 gzip 압축 대신 압축에 사용되는지 여부를 제어합니다. WEBSITE_ENABLE_BROTLI_ENCODING이 1로 설정되면 Brotli 인코딩이 사용되고, 그렇지 않으면 gzip 인코딩이 사용됩니다.

WEBSITE_FUNCTIONS_ARMCACHE_ENABLED

ARM(Azure Resource Manager) 템플릿을 사용하여 함수 앱을 배포할 때 캐싱을 사용하지 않도록 설정합니다.

키	샘플 값
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED	0

WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT

앱이 스케일링될 수 있는 최대 인스턴스 수입니다. 기본값은 무제한입니다.

중요

이 설정은 미리 보기로 제공됩니다. app property for function max scale out이 추가되었으며, 스케일링을 제한하는 권장 방법입니다.

키	샘플 값
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT	5

WEBSITE_NODE_DEFAULT_VERSION

Windows만 해당됩니다. Windows에서 함수 앱을 실행할 때 사용할 Node.js 버전을 설정합니다. 물결표(~)를 사용하여 런타임에서 대상 주 버전의 사용 가능한 최신 버전을 사용하도록 해야 합니다. 예를 들어 로 설정 ~18하면 최신 버전의 Node.js 18이 사용됩니다. 물결표를 사용하여 주 버전을 대상으로 지정하면 부 버전을 수동으로 업데이트할 필요가 없습니다.

키	샘플 값
WEBSITE_NODE_DEFAULT_VERSION	~18

WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS

Premium Functions 에서 슬롯 교환 을 수행할 때 함수 앱과 연결된 스토리지 계정이 네트워크 제한인 경우 교환에 실패할 수 있습니다. 이는 Functions 및 App Service 공유하는 레거시 애플리케이션 로깅 기능 때문입니다. 이 설정은 레거시 로깅 기능을 재정의하고 교환을 허용합니다. 0 프로덕션 슬롯에서 를 로 설정하고 배포 슬롯 설정(고정이라고도 함)으로 표시하거나 모든 슬롯에 를 추가하여 모든 버전 설정도 교환되도록 합니다.

키	샘플 값
WEBSITE_OVERRIDE_STICKY_DIAGNOSTICS_SETTINGS	0

WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS

기본적으로 함수 앱의 버전 설정은 각 슬롯에 따라 다릅니다. 이 설정은 배포 슬롯을 사용하여 함수를 업그레이드할 때 사용됩니다. 이렇게 하면 교환 후 버전 변경으로 인한 예기치 않은 동작이 방지됩니다. 프로덕션 및 슬롯에서 0으로 설정하여 모든 버전 설정도 교환되도록 합니다. 자세한 내용은 슬롯을 사용하여 업그레이드를 참조하세요.

키	샘플 값
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS	0

WEBSITE_RUN_FROM_PACKAGE

탑재된 패키지 파일에서 함수 앱을 실행하도록 설정합니다.

키	샘플 값
WEBSITE_RUN_FROM_PACKAGE	1

유효한 값은 배포 패키지 파일의 위치를 확인하는 URL이거나 1입니다. 1로 설정하면 패키지는 d:\home\data\SitePackages 폴더에 있어야 합니다. zip 배포를 WEBSITE_RUN_FROM_PACKAGE 사용하도록 설정하면 패키지가 이 위치에 자동으로 업로드됩니다. 미리 보기에서 이 설정은 WEBSITE_RUN_FROM_ZIP으로 명명되었습니다. 자세한 내용은 패키지 파일에서 Functions 실행을 참조하세요.

WEBSITE_SKIP_CONTENTSHARE_VALIDATION

WEBSITE_CONTENTAZUREFILECONNECTIONSTRING 및 WEBSITE_CONTENTSHARE 설정에는 앱을 제대로 시작할 수 있도록 추가 유효성 검사가 있습니다. 네트워킹 제약 조건 또는 기타 제한 요인으로 인해 함수 앱이 다운스트림 스토리지 계정 또는 Key Vault 제대로 호출할 수 없는 경우 애플리케이션 설정 만들기가 실패합니다. WEBSITE_SKIP_CONTENTSHARE_VALIDATION이 1로 설정되면 유효성 검사를 건너뜁니다. 그렇지 않으면 값이 기본적으로 0으로 설정되고 유효성 검사가 수행됩니다.

키	샘플 값
WEBSITE_SKIP_CONTENTSHARE_VALIDATION	1

유효성 검사를 건너뛰고 연결 문자열 또는 콘텐츠 공유가 유효하지 않으면 앱이 제대로 시작할 수 없습니다. 이 경우 함수는 HTTP 500 오류를 반환합니다. 자세한 내용은 오류 문제 해결: "Azure Functions 런타임에 연결할 수 없음"을 참조하세요.

WEBSITE_SLOT_NAME

읽기 전용입니다. 현재 배포 슬롯의 이름. 프로덕션 슬롯의 이름은 Production입니다.

키	샘플 값
WEBSITE_SLOT_NAME	Production

WEBSITE_TIME_ZONE

함수 앱에 대한 표준 시간대를 설정할 수 있습니다.

키	OS	샘플 값
WEBSITE_TIME_ZONE	Windows	Eastern Standard Time
WEBSITE_TIME_ZONE	Linux	America/New_York

CRON 식과 함께 사용하는 기본 표준 시간대는 UTC(협정 세계시)입니다. 다른 표준 시간대를 기반으로 하는 CRON 식을 사용하려면 WEBSITE_TIME_ZONE이라는 함수 앱에 대한 앱 설정을 만듭니다.

이 설정의 값은 함수 앱이 실행되는 운영 체제 및 플랜에 따라 다릅니다.

운영 체제	계획	값
Windows	모두	Windows 명령 tzutil.exe /L에서 제공하는 각 쌍의 두 번째 줄에 지정된 원하는 표준 시간대의 이름으로 값을 설정합니다.
Linux	Premium 전용	tz database에 나온 것과 같이 원하는 표준 시간대의 이름으로 값을 설정합니다.

참고

WEBSITE_TIME_ZONE는 Linux 사용 플랜에서 현재 지원되지 않습니다.

예를 들어 미국 동부 표준시(Eastern Standard Time(Windows) 또는 America/New_York(Linux)로 표시)는 현재 표준 시간 동안 UTC-05:00를 사용하고 일광 절약 시간 동안에는 UTC-04:00를 사용합니다. 매일 오전 10시(미국 동부 표준시)에 타이머 트리거를 두려면 WEBSITE_TIME_ZONE이라는 함수 앱에 대한 앱 설정을 만들고, 값을 Eastern Standard Time(Windows) 또는 America/New_York(Linux)로 설정하고, 다음 NCRONTAB 식을 사용합니다.

"0 0 10 * * *"

WEBSITE_TIME_ZONE을 사용하는 경우 일광 절약 시간 및 표준 시간의 변경을 포함하여 특정 시간대의 시간 변경에 따라 조정됩니다.

WEBSITE_USE_PLACEHOLDER

소비 계획에서 실행할 때 특정 콜드 시작 최적화를 사용할지 여부를 나타냅니다. 0 소비 계획에서 콜드 스타트 최적화를 사용하지 않도록 설정하려면 로 설정합니다.

키	샘플 값
WEBSITE_USE_PLACEHOLDER	1

WEBSITE_VNET_ROUTE_ALL

중요

WEBSITE_VNET_ROUTE_ALL vnetRouteAllEnabled 사이트 설정으로 대체된 레거시 앱 설정입니다.

앱의 모든 아웃바운드 트래픽이 가상 네트워크를 통해 라우팅되도록 할지 여부를 나타냅니다. 설정 값 1은 모든 트래픽이 가상 네트워크를 통해 라우팅되고 있음을 나타냅니다. 지역 가상 네트워크 통합 기능을 사용하는 경우 이 설정이 필요합니다. 또한 가상 네트워크 NAT 게이트웨이가 고정 아웃바운드 IP 주소를 정의하는 데 사용되는 경우에도 사용됩니다.

키	샘플 값
WEBSITE_VNET_ROUTE_ALL	1

App Service 사이트 설정

일부 구성은 언어 버전과 같은 사이트 설정으로 App Service 수준에서 유지 관리되어야 합니다. 이러한 설정은 포털에서, REST API를 사용하거나, Azure CLI 또는 Azure PowerShell 사용하여 관리됩니다. 다음은 런타임 언어, OS 및 버전에 따라 필요할 수 있는 사이트 설정입니다.

linuxFxVersion

Linux에서 실행되는 함수 앱의 경우 linuxFxVersion은 언어별 작업자 프로세스의 언어 및 버전을 나타냅니다. 이 정보는 FUNCTIONS_EXTENSION_VERSION과 함께 함수 앱을 실행하기 위해 설치된 특정 Linux 컨테이너 이미지를 결정하는 데 사용됩니다. 이 설정은 미리 정의된 값 또는 사용자 지정 이미지 URI로 설정할 수 있습니다.

이 값은 Linux 함수 앱을 만들 때 설정됩니다. ARM 템플릿 및 Bicep 배포와 특정 업그레이드 시나리오에 대해 설정해야 할 수 있습니다.

유효한 linuxFxVersion 값

다음 Azure CLI 명령을 사용하여 지원되는 Functions 런타임 버전별로 현재 linuxFxVersion 값의 테이블을 볼 수 있습니다.

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

이전 명령을 사용하려면 Azure CLI 버전 2.40으로 업그레이드해야 합니다.

사용자 지정 이미지

함수 앱에 대한 고유한 사용자 지정 Linux 컨테이너를 만들고 유지 관리할 때 다음 예와 같이 linuxFxVersion 값도 DOCKER|<IMAGE_URI> 형식입니다.

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

자세한 내용은 사용자 지정 컨테이너를 사용하여 Linux에서 함수 만들기를 참조하세요.

중요

사용자 지정 컨테이너를 사용하는 경우 컨테이너의 기본 이미지를 지원되는 최신 기본 이미지로 업데이트해야 합니다. Azure Functions에 대해 지원되는 기본 이미지는 언어별로 다르며 언어별로 Azure Functions 기본 이미지 리포지토리에서 찾을 수 있습니다.

• C# 진행 중.
• C# 격리 작업자 프로세스
• Java
• JavaScript/TypeScript
• PowerShell
• Python

Functions 팀은 이러한 기본 이미지에 대한 월별 업데이트를 게시하기 위해 최선을 다하고 있습니다. 정기 업데이트에는 Functions 런타임 및 언어 모두에 대한 최신 부 버전 업데이트 및 보안 수정 사항이 포함됩니다. 사용자 지정 컨테이너의 경우 Dockerfile에서 기본 이미지를 정기적으로 업데이트하고 사용자 지정 컨테이너의 업데이트된 버전을 다시 빌드 및 재배포해야 합니다.

netFrameworkVersion

C# 함수용 .NET의 특정 버전을 설정합니다. 자세한 내용은 Azure에서 함수 앱 업그레이드를 참조하세요.

powerShellVersion

함수가 실행되는 특정 버전의 PowerShell을 설정합니다. 자세한 내용은 PowerShell 버전 변경을 참조하세요.

로컬에서 실행하는 경우 대신 local.settings.json 파일의 FUNCTIONS_WORKER_RUNTIME_VERSION 설정을 사용합니다.

vnetrouteallenabled

앱의 모든 아웃바운드 트래픽이 가상 네트워크를 통해 라우팅되도록 할지 여부를 나타냅니다. 설정 값 1은 모든 트래픽이 가상 네트워크를 통해 라우팅되고 있음을 나타냅니다. 지역 가상 네트워크 통합 기능을 사용하는 경우 이 설정이 필요합니다. 또한 가상 네트워크 NAT 게이트웨이가 고정 아웃바운드 IP 주소를 정의하는 데 사용되는 경우에도 사용됩니다. 자세한 내용은 애플리케이션 라우팅 구성을 참조하세요.

이 사이트 설정은 레거시 WEBSITE_VNET_ROUTE_ALL 설정을 대체합니다.

다음 단계

앱 설정 업데이트 방법 알아보기

host.json 파일의 구성 설정 보기

App Service 앱에 대한 다른 앱 설정 보기