Azure App Service 환경 변수 및 앱 설정

참고 항목

2024년 6월 1일부터, 새로 만들어진 모든 App Service 앱에는 명명 규칙 <app-name>-<random-hash>.<region>.azurewebsites.net을 사용하여 고유한 기본 호스트 이름을 생성할 수 있는 옵션이 제공됩니다. 기존 앱 이름은 변경되지 않은 상태로 유지됩니다.

예: myapp-ds27dh7271aah175.westus-01.azurewebsites.net

자세한 내용은 App Service 리소스의 고유 기본 호스트 이름을 참조하세요.

Azure App Service에서, 특정 설정은 배포 또는 런타임 환경에서 환경 변수로 사용할 수 있습니다. 이러한 설정 중 일부는 앱 설정으로 수동으로 설정할 때 사용자 지정할 수 있습니다. 이 참조는 사용하거나 사용자 지정할 수 있는 변수를 보여줍니다.

앱 환경

다음 환경 변수는 일반적으로 앱 환경과 관련이 있습니다.

설정 이름	설명	예시
WEBSITE_SITE_NAME	읽기 전용. 앱 이름.
WEBSITE_RESOURCE_GROUP	읽기 전용. 앱 리소스를 포함하는 Azure 리소스 그룹 이름.
WEBSITE_OWNER_NAME	읽기 전용. 앱, 리소스 그룹 및 웹스페이스를 소유하는 Azure 구독 ID를 포함합니다.
REGION_NAME	읽기 전용. 앱의 지역 이름.
WEBSITE_PLATFORM_VERSION	읽기 전용. App Service 플랫폼 로그.
HOME	읽기 전용. 홈 디렉터리 경로(예: Windows용 D:\home).
SERVER_PORT	읽기 전용. 앱이 수신 대기해야 하는 포트.
WEBSITE_WARMUP_PATH	슬래시로 시작하는 앱을 준비하기 위한 ping의 상대 경로. 기본값은 루트 경로를 ping하는 /입니다. 인증되지 않은 클라이언트를 거부하도록 App Service 인증이 설정된 경우에도 인증되지 않은 클라이언트(예: Azure Traffic Manager)에서 특정 경로를 ping할 수 있습니다. (참고: 이 앱 설정은 AlwaysOn에서 사용하는 경로를 변경하지 않습니다.)
WEBSITE_COMPUTE_MODE	읽기 전용. 앱이 전용(Dedicated) 또는 공유(Shared) VM에서 실행되는지 여부를 지정합니다.
WEBSITE_SKU	읽기 전용. 앱의 SKU. 가능한 값은 Free, Shared, Basic 및 Standard입니다.
SITE_BITNESS	읽기 전용. 앱이 32비트(x86) 또는 64비트(AMD64)인지 여부를 표시합니다.
WEBSITE_HOSTNAME	읽기 전용. 앱의 기본 호스트 이름. 사용자 지정 호스트 이름은 여기에서 고려되지 않습니다.
WEBSITE_VOLUME_TYPE	읽기 전용. 현재 사용 중인 스토리지 볼륨 유형을 표시합니다.
WEBSITE_NPM_DEFAULT_VERSION	앱에서 사용하는 기본 npm 버전.
WEBSOCKET_CONCURRENT_REQUEST_LIMIT	읽기 전용. 웹소켓의 동시 요청에 대한 제한. 표준 계층 이상의 경우, 값은 -1이지만 VM 크기에 따라 VM당 제한이 있습니다(VM 간 숫자 제한 참조).
WEBSITE_PRIVATE_EXTENSIONS	프라이빗 사이트 확장을 사용하지 않으려면 0로 설정합니다.
WEBSITE_TIME_ZONE	기본적으로 앱의 표준 시간대는 항상 UTC입니다. 기본 표준 시간대에 나열된 유효한 값으로 변경할 수 있습니다. 지정된 값이 인식되지 않으면 UTC가 사용됩니다.	Atlantic Standard Time
WEBSITE_ADD_SITENAME_BINDINGS_IN_APPHOST_CONFIG	슬롯 교환 후 앱이 예기치 않게 다시 시작될 수 있습니다. 이는 교환 후 호스트 이름 바인딩 구성이 동기화되지 않아 자체적으로 다시 시작되지 않기 때문입니다. 그러나 특정 기본 스토리지 이벤트(예: 스토리지 볼륨 장애 조치(failover))는 이러한 불일치를 감지하여 모든 작업자 프로세스를 강제로 다시 시작할 수 있습니다. 이러한 유형의 다시 시작을 최소화하려면 앱 설정 값을 1모든 슬롯에서(기본값은 0)로 설정합니다. 그러나 WCF(Windows Communication Foundation) 애플리케이션을 실행 중인 경우에는 이 값을 설정하지 마세요. 자세한 내용은 교환 문제 해결을 참조하세요.
WEBSITE_PROACTIVE_AUTOHEAL_ENABLED	기본적으로 VM 인스턴스는 할당된 메모리의 90% 이상을 30초 이상 사용하거나, 마지막 2분 동안 총 요청의 80%가 200초보다 오래 걸리는 경우, 미리 "자동 절전 모드"로 설정됩니다. VM 인스턴스가 이러한 규칙 중 하나를 트리거한 경우 복구 프로세스는 인스턴스의 중복 재시작입니다. 이 복구 동작을 사용하지 않도록 설정하려면 false로 설정합니다. 기본값은 true입니다. 자세한 내용은 사전적 자동 절전 모드를 참조하세요.
WEBSITE_PROACTIVE_CRASHMONITORING_ENABLED	24시간 동안 처리되지 않은 예외로 인해, 앱의 VM 인스턴스에서 w3wp.exe 프로세스가 충돌할 때마다 디버거 프로세스가 해당 인스턴스의 주 작업자 프로세스에 연결되고 작업자 프로세스가 다시 충돌할 때 메모리 덤프를 수집합니다. 그런 다음, 이 메모리 덤프가 분석되고 크래시를 발생시킨 스레드의 호출 스택이 App Service 로그에 기록됩니다. 이 자동 모니터링 동작을 사용하지 않도록 설정하려면 false로 설정합니다. 기본값은 true입니다. 자세한 내용은 사전적 크래시 모니터링을 참조하세요.
WEBSITE_DAAS_STORAGE_SASURI	크래시 모니터링(사전적 또는 수동) 중에는 기본적으로 메모리 덤프가 삭제됩니다. 스토리지 Blob 컨테이너에 메모리 덤프를 저장하려면 SAS URI를 지정합니다.
WEBSITE_CRASHMONITORING_ENABLED	크래시 모니터링을 수동으로 활성화하려면 true로 설정합니다. WEBSITE_DAAS_STORAGE_SASURI과 WEBSITE_CRASHMONITORING_SETTINGS도 설정해야 합니다. 기본값은 false입니다. 원격 디버깅을 사용하는 경우에는 이 설정이 적용되지 않습니다. 또한 이 설정을 true로 설정하면, 사전적 크래시 모니터링을 사용할 수 없습니다.
WEBSITE_CRASHMONITORING_SETTINGS	{"StartTimeUtc": "2020-02-10T08:21","MaxHours": "<elapsed-hours-from-StartTimeUtc>","MaxDumpCount": "<max-number-of-crash-dumps>"} 형식의 JSON. WEBSITE_CRASHMONITORING_ENABLED이 지정된 경우, 크래시 모니터링을 구성해야 합니다. 스토리지 계정에 크래시 덤프를 저장하지 않고 호출 스택만 기록하려면 JSON에 ,"UseStorageAccount":"false"을 추가합니다.
REMOTEDEBUGGINGVERSION	원격 디버깅 버전.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING	기본적으로 앱을 만들 때 App Service 가 공유 스토리지를 생성합니다. 사용자 지정 스토리지 계정을 대신 사용하려면, 스토리지 계정의 연결 문자열을 설정합니다. 함수의 경우, Functions에 대한 앱 설정 참조를 참조하세요.	DefaultEndpointsProtocol=https;AccountName=<name>;AccountKey=<key>
WEBSITE_CONTENTSHARE	WEBSITE_CONTENTAZUREFILECONNECTIONSTRING을 사용하여 사용자 지정 스토리지 계정을 지정하는 경우, App Service가 앱에 대한 해당 스토리지 계정에 파일 공유를 생성합니다. 사용자 지정 이름을 사용하려면 이 변수를 원하는 이름으로 설정합니다. 지정된 이름의 파일 공유가 없으면 App Service가 파일 공유를 생성합니다.	myapp123
WEBSITE_SCM_ALWAYS_ON_ENABLED	읽기 전용. Always On이 사용(1)인지 아닌지(0) 여부를 표시합니다.
WEBSITE_SCM_SEPARATE_STATUS	읽기 전용. Kudu 앱이 별도의 프로세스에서 실행되고 있는지(1) 아닌지(0) 여부를 표시합니다.
WEBSITE_DNS_ATTEMPTS	이름 확인을 시도하는 횟수입니다.
WEBSITE_DNS_TIMEOUT	이름 확인을 기다리는 시간(초)

변수 접두사

다음 표에서는 App Service가 다양한 용도로 사용하는 환경 변수 접두사를 보여줍니다.

설정 이름	설명
APPSETTING_	고객이 앱 구성에서 앱 설정으로 변수를 설정함을 의미합니다. 앱 설정으로 .NET 앱에 삽입됩니다.
MAINSITE_	변수가 앱 자체와 관련되어 있다는 것을 의미합니다.
SCMSITE_	변수가 Kudu 앱과 관련되어 있다는 것을 의미합니다.
SQLCONNSTR_	앱 구성에서 SQL Server 연결 문자열을 의미합니다. .NET 앱에 연결 문자열로 삽입됩니다.
SQLAZURECONNSTR_	앱 구성에서 Azure SQL Database 연결 문자열을 의미합니다. .NET 앱에 연결 문자열로 삽입됩니다.
POSTGRESQLCONNSTR_	앱 구성에서 PostgreSQL 연결 문자열을 의미합니다. .NET 앱에 연결 문자열로 삽입됩니다.
CUSTOMCONNSTR_	앱 구성에서 사용자 지정 연결 문자열을 의미합니다. .NET 앱에 연결 문자열로 삽입됩니다.
MYSQLCONNSTR_	앱 구성에서 MySQL Database 연결 문자열을 나타냅니다. .NET 앱에 연결 문자열로 삽입됩니다.
AZUREFILESSTORAGE_	Azure Files의 사용자 지정 컨테이너에 대한 사용자 지정 공유에 대한 연결 문자열입니다.
AZUREBLOBSTORAGE_	Azure Blob Storage의 사용자 지정 컨테이너에 대한 사용자 지정 스토리지 계정에 대한 연결 문자열입니다.
NOTIFICATIONHUBCONNSTR_	Azure Notification Hubs의 알림 허브에 대한 연결 문자열을 의미합니다.
SERVICEBUSCONNSTR_	Azure Service Bus의 인스턴스에 대한 연결 문자열을 의미합니다.
EVENTHUBCONNSTR_	Azure Event Hubs의 이벤트 허브에 대한 연결 문자열을 의미합니다.
DOCDBCONNSTR_	Azure Cosmos DB의 데이터베이스에 대한 연결 문자열을 의미합니다.
REDISCACHECONNSTR_	Azure Cache for Redis의 캐시에 대한 연결 문자열을 의미합니다.
FILESHARESTORAGE_	사용자 지정 파일 공유에 대한 연결 문자열을 의미합니다.

배포

다음 환경 변수는 앱 배포와 관련되어 있습니다. App Service 빌드 자동화와 관련된 변수에 대해서는 빌드 자동화를 참조하세요.

설정 이름	설명
DEPLOYMENT_BRANCH	local Git 또는 cloud Git 배포(예: GitHub)의 경우, Azure에서 배포하려는 분기로 설정합니다. 기본적으로 master입니다.
WEBSITE_RUN_FROM_PACKAGE	로컬 ZIP 패키지에서 앱을 실행하려면 1로 설정하고, 원격 ZIP 패키지에서 앱을 실행하려면 외부 URL의 URL로 설정합니다. 자세한 정보는 Azure App Service에서 ZIP 패키지의 앱 직접 실행하기를 참조하세요.
WEBSITE_USE_ZIP	사용되지 않음. WEBSITE_RUN_FROM_PACKAGE을 사용합니다.
WEBSITE_RUN_FROM_ZIP	사용되지 않음. WEBSITE_RUN_FROM_PACKAGE을 사용합니다.
SCM_MAX_ZIP_PACKAGE_COUNT	앱은 zip deploy를 사용하여 배포된 가장 최근의 zip 파일 5개를 유지합니다. 앱 설정을 다른 숫자로 설정하여 더 많거나 적게 유지할 수 있습니다.
WEBSITE_WEBDEPLOY_USE_SCM	Kudu 배포 엔진 사용을 중지하려면 WebDeploy에 대해 false로 설정합니다. 기본값은 true입니다. Visual Studio(WebDeploy/MSDeploy)를 사용하여 Linux 앱에 배포하려면 false로 설정합니다.
MSDEPLOY_RENAME_LOCKED_FILES	WebDeploy 배포 중에 복사할 수 없을 때 DLL의 이름을 바꾸려면 1로 설정합니다. WEBSITE_WEBDEPLOY_USE_SCM이 false로 설정된 경우 이 설정을 적용할 수 없습니다.
WEBSITE_DISABLE_SCM_SEPARATION	기본적으로, 주 앱과 Kudu 앱은 다른 샌드박스에서 실행됩니다. 앱을 중지할 때 Kudu 앱이 계속 실행되고 있으면 Git 배포 및 MSDeploy를 계속 사용할 수 있습니다. 각 앱에는 자체 로컬 파일이 있습니다. 이 분리를 해제(true로 설정)하는 것은 더 이상 완전히 지원되지 않는 레거시 모드입니다.
WEBSITE_ENABLE_SYNC_UPDATE_SITE	1를 설정하여 반환하기 전에 REST API에서 site 및 siteconfig 업데이트를 호출하고 모든 인스턴스에 완전히 적용되도록 합니다. ARM 템플릿을 사용하여 배포하는 경우의 기본값은 1이며, 이는 후속 ARM 호출로 인한 경합 상태를 방지하기 위한 것입니다.
WEBSITE_START_SCM_ON_SITE_CREATION	ARM 템플릿 배포의 ARM 템플릿에서 1로 설정하여 앱 생성의 일부로 Kudu 앱을 미리 시작합니다.
WEBSITE_START_SCM_WITH_PRELOAD	Linux 앱의 경우, URL을 ping하여 Always On를 사용하도록 설정할 때 Kudu 앱을 강제로 미리 로드하려면 true로 설정합니다. 기본값은 false입니다. Windows 앱의 경우 Kudu 앱은 항상 미리 로드됩니다.

빌드 자동화

Kudu(Windows)

Kudu 빌드 구성은 네이티브 Windows 앱에 적용되며, Git 기반 또는 ZIP 기반 배포의 동작을 제어하는 데 사용됩니다.

설정 이름	설명	예시
SCM_BUILD_ARGS	Msbuild 명령줄의 끝에 항목을 추가하여 기본 명령줄의 이전 부분을 재정의합니다.	클린 빌드를 수행하려면 -t:Clean;Compile을 수행합니다.
SCM_SCRIPT_GENERATOR_ARGS	Kudu는 여기에 설명된 azure site deploymentscript 명령을 사용하여 배포 스크립트를 생성합니다. 언어 프레임워크 형식을 자동으로 검색하고 명령에 전달할 매개 변수를 결정합니다. 이 설정은 자동으로 생성된 매개 변수를 재정의합니다.	리포지토리를 일반 콘텐츠 파일로 처리하려면 --basic -p <folder-to-deploy>을 수행합니다.
SCM_TRACE_LEVEL	빌드 추적 수준. 기본값은 1입니다. 더 많은 추적을 위해 높은 값(최대 4)으로 설정합니다.	4
SCM_COMMAND_IDLE_TIMEOUT	빌드 프로세스에서 출력을 생성하지 않고 대기하기 위해 시작하는 각 명령에 대한 제한 시간(초)입니다. 그 후에는 명령이 유휴 상태로 간주되고 종료됩니다. 기본값은 60(1분)입니다. Azure에서 230초 후에 클라이언트의 연결을 끊는 일반적인 유휴 요청 시간 제한도 있습니다. 그러나 이 명령은 여전히 서버 쪽에서 계속 실행됩니다.
SCM_LOGSTREAM_TIMEOUT	로그 스트리밍을 중지하기 전의 비활성 시간 제한(초). 기본값은 1800(30분)입니다.
SCM_SITEEXTENSIONS_FEED_URL	사이트 확장 갤러리의 URL. 기본값은 https://www.nuget.org/api/v2/입니다. 이전 피드의 URL은 http://www.siteextensions.net/api/v2/입니다.
SCM_USE_LIBGIT2SHARP_REPOSITORY	Git 작업에 libgit2sharp 대신 git.exe를 사용하려면 0로 설정합니다.
WEBSITE_LOAD_USER_PROFILE	ASP.NET 빌드 자동화 동안 The specified user does not have a valid profile. 오류가 발생하는 경우(예: Git 배포 중), 이 변수를 1로 설정하여 빌드 환경에서 전체 사용자 프로필을 로드합니다. 이 설정은 WEBSITE_COMPUTE_MODE이 Dedicated인 경우에만 적용할 수 있습니다.
WEBSITE_SCM_IDLE_TIMEOUT_IN_MINUTES	SCM(Kudu) 사이트에 대한 시간 제한(분). 기본값은 20입니다.
SCM_DO_BUILD_DURING_DEPLOYMENT	ZIP 배포를 사용하여, 배포 엔진은 ZIP 파일을 있는 그대로 실행할 준비가 된 것으로 가정하고 빌드 자동화를 실행하지 않습니다. Git 배포와 동일한 빌드 자동화를 사용하도록 설정하려면 true으로 설정합니다.

Oryx(Linux)

Oryx 빌드 구성은 Linux 앱에 적용되며, Git 기반 또는 ZIP 기반 배포의 동작을 제어하는 데 사용됩니다. Oryx 구성을 참조하세요.

언어별 설정

이 섹션에서는 지원되는 각 언어 프레임워크에 대한 구성 가능한 런타임 설정을 보여줍니다. 배포 시간의 빌드 자동화 중에 추가 설정을 사용할 수 있습니다.

.NET

설정 이름	설명
PORT	읽기 전용. Linux 앱의 경우, .NET 런타임이 컨테이너에서 수신 대기하는 포트.
WEBSITE_ROLE_INSTANCE_ID	읽기 전용. 현재 인스턴스의 ID.
HOME	읽기 전용. 공유 저장소(/home)를 가리키는 디렉터리.
DUMP_DIR	읽기 전용. 크래시 덤프(/home/logs/dumps)의 디렉터리.
APP_SVC_RUN_FROM_COPY	Linux 앱에만 해당합니다. 기본적으로 앱은 모든 확장된 인스턴스에 대한 공유 디렉터리인 /home/site/wwwroot에서 실행됩니다. 컨테이너의 로컬 디렉터리에 앱을 복사하고 실행하려면 이 변수를 true로 설정합니다. 이 옵션을 사용하는 경우, /home/site/wwwroot에 대한 참조를 하드 코딩하지 않도록 합니다. 대신 /home/site/wwwroot에 상대적인 경로를 사용합니다.
MACHINEKEY_Decryption	Windows 네이티브 앱이나 Windows 컨테이너 앱의 경우 이 변수는 ASP.NET 암호화 루틴을 사용하도록 앱 환경이나 컨테이너에 삽입됩니다(machineKey 요소 참조). 기본 decryption 값을 재정의하려면 해당 값을 App Service 앱 설정으로 구성하거나 Web.config 파일의 machineKey 요소에서 직접 해당 값을 설정합니다.
MACHINEKEY_DecryptionKey	Windows 네이티브 앱이나 Windows 컨테이너 앱의 경우 이 변수는 ASP.NET 암호화 루틴을 사용하도록 앱 환경이나 컨테이너에 삽입됩니다(machineKey 요소 참조). 자동으로 생성된 decryptionKey 값을 재정의하려면 해당 값을 App Service 앱 설정으로 구성하거나 Web.config 파일의 machineKey 요소에서 직접 해당 값을 설정합니다.
MACHINEKEY_Validation	Windows 네이티브 앱이나 Windows 컨테이너 앱의 경우 이 변수는 ASP.NET 암호화 루틴을 사용하도록 앱 환경이나 컨테이너에 삽입됩니다(machineKey 요소 참조). 기본 validation 값을 재정의하려면 해당 값을 App Service 앱 설정으로 구성하거나 Web.config 파일의 machineKey 요소에서 직접 해당 값을 설정합니다.
MACHINEKEY_ValidationKey	Windows 네이티브 앱이나 Windows 컨테이너 앱의 경우 이 변수는 ASP.NET 암호화 루틴을 사용하도록 앱 환경이나 컨테이너에 삽입됩니다(machineKey 요소 참조). 자동으로 생성된 validationKey 값을 재정의하려면 해당 값을 App Service 앱 설정으로 구성하거나 Web.config 파일의 machineKey 요소에서 직접 해당 값을 설정합니다.

Java

설정 이름	설명	예시
JAVA_HOME	Java 설치 디렉터리의 경로
JAVA_OPTS	Java SE 앱의 경우, java 명령에 전달하는 환경 변수. 시스템 변수를 포함할 수 있습니다. Tomcat의 경우, CATALINA_OPTS을 사용합니다.	-Dmysysproperty=%DRIVEPATH%
AZURE_JAVA_APP_PATH	환경 변수는 사용자 지정 스크립트에서 사용할 수 있으므로 로컬에 복사된 후에는 app.jar에 대한 위치를 갖습니다.
SKIP_JAVA_KEYSTORE_LOAD	App Service가 인증서를 키 저장소에 자동으로 로드하지 못하도록 하는 값 1
WEBSITE_JAVA_JAR_FILE_NAME	사용할 .jar 파일. 문자열이 .jar로 끝나지 않으면 .jar을 추가합니다. 기본값은 app.jar입니다
WEBSITE_JAVA_WAR_FILE_NAME	사용할 .war 파일. 문자열이 .war로 끝나지 않으면 .war을 추가합니다. 기본값은 app.war입니다
JAVA_ARGS	다른 java 웹 서버에 필요한 java opts. 기본값은 -noverify -Djava.net.preferIPv4Stack=true입니다.
JAVA_WEBSERVER_PORT_ENVIRONMENT_VARIABLES	서버 포트의 Java 웹 프레임 워크에서 사용하는 환경 변수. Spring, Micronaut, Grails, MicroProfile Thorntail, Helidon, Ratpack, and Quarkus 등의 프레임워크가 포함됩니다
JAVA_TMP_DIR	Java 인수에 -Dsite.tempdir로 추가됩니다. 기본값은 TEMP입니다.
WEBSITE_SKIP_LOCAL_COPY	기본적으로 배포된 app.jar는 /home/site/wwwroot에서 로컬 위치로 복사됩니다. 이 동작을 사용하지 않도록 설정하고 /home/site/wwwroot에서 직접 app.jar를 로드하려면, 이 변수를 1 또는 true으로 설정합니다. 로컬 캐시를 사용하는 경우에는 이 설정이 적용되지 않습니다.
TOMCAT_USE_STARTUP_BAT	네이티브 Windows 앱에만 해당합니다. 기본적으로 Tomcat 서버는 startup.bat로 시작됩니다. 대신 catalina.bat을 사용하려면 0 또는 False으로 설정합니다.	%LOCAL_EXPANDED%\tomcat
CATALINA_OPTS	Tomcat apps의 경우, java 명령에 전달하는 환경 변수. 시스템 변수를 포함할 수 있습니다.
CATALINA_BASE	사용자 지정 Tomcat 설치를 사용하려면, 설치 위치로 설정합니다.
WEBSITE_JAVA_MAX_HEAP_MB	Java 최대 힙(MB). 이 설정은 실험판 Tomcat 버전이 사용되는 경우에만 적용됩니다.
WEBSITE_DISABLE_JAVA_HEAP_CONFIGURATION	이 변수를 true 또는 1으로 설정하여 수동으로 WEBSITE_JAVA_MAX_HEAP_MB을 비활성화합니다.
WEBSITE_AUTH_SKIP_PRINCIPAL	기본적으로, 기본 제공 인증을 사용할 때, isSecure, getRemoteAddr, getRemoteHost, getScheme, getServerPort 등의 Tomcat HttpServletRequest 인터페이스가 하이드레이션 됩니다. 사용하지 않도록 설정하려면, 1로 설정합니다.
WEBSITE_SKIP_FILTERS	App Service에 의해 추가된 모든 servlet 필터를 사용하지 않도록 설정하려면 1로 설정합니다.
IGNORE_CATALINA_BASE	기본적으로 App Service는 Tomcat 변수 CATALINA_BASE이 정의되어 있는지 여부를 확인합니다. 그렇지 않으면, %HOME%\tomcat\conf\server.xml이 있는지 조회합니다. 파일이 존재하면, CATALINA_BASE을 %HOME%\tomcat로 설정합니다. 이 동작을 사용하지 않도록 설정하고 CATALINA_BASE을 제거하려면, 이 변수를 1 또는 true으로 설정합니다.
PORT	읽기 전용. Linux 앱의 경우, Java 런타임이 컨테이너에서 수신 대기하는 포트.
WILDFLY_VERSION	읽기 전용. JBoss(Linux) 앱의 경우, WildFly 버전.
TOMCAT_VERSION	읽기 전용. Linux Tomcat 앱의 경우, Tomcat 버전.
JBOSS_HOME	읽기 전용. JBoss(Linux) 앱의 경우, WildFly 설치 경로.
AZURE_JETTY9_CMDLINE	읽기 전용. 네이티브 Windows 앱의 경우, Jetty 9를 시작하기 위한 명령줄 인수.
AZURE_JETTY9_HOME	읽기 전용. 네이티브 Windows 앱의 경우, Jetty 9 설치 경로.
AZURE_JETTY93_CMDLINE	읽기 전용. 네이티브 Windows 앱의 경우, Jetty 9.3을 시작하기 위한 명령줄 인수.
AZURE_JETTY93_HOME	읽기 전용. 네이티브 Windows 앱의 경우, Jetty 9.3 설치 경로.
AZURE_TOMCAT7_CMDLINE	읽기 전용. 네이티브 Windows 앱의 경우, Tomcat 7을 시작하기 위한 명령줄 인수.
AZURE_TOMCAT7_HOME	읽기 전용. 네이티브 Windows 앱의 경우, Tomcat 7 설치 경로.
AZURE_TOMCAT8_CMDLINE	읽기 전용. 네이티브 Windows 앱의 경우, Tomcat 8을 시작하기 위한 명령줄 인수.
AZURE_TOMCAT8_HOME	읽기 전용. 네이티브 Windows 앱의 경우, Tomcat 8 설치 경로.
AZURE_TOMCAT85_CMDLINE	읽기 전용. 네이티브 Windows 앱의 경우, Tomcat 8.5를 시작하기 위한 명령줄 인수.
AZURE_TOMCAT85_HOME	읽기 전용. 네이티브 Windows 앱의 경우, Tomcat 8.5 설치 경로.
AZURE_TOMCAT90_CMDLINE	읽기 전용. 네이티브 Windows 앱의 경우, Tomcat 9를 시작하기 위한 명령줄 인수.
AZURE_TOMCAT90_HOME	읽기 전용. 네이티브 Windows 앱의 경우, Tomcat 9 설치 경로.
AZURE_SITE_HOME	Java 인수에 -Dsite.home로 추가되는 값. 기본값은 HOME의 값입니다.
HTTP_PLATFORM_PORT	Java 인수에 -Dport.http로 추가됩니다. 다른 Java 웹 프레임워크에서 사용하는 SERVER_PORT, MICRONAUT_SERVER_PORT, THORNTAIL_HTTP_PORT, RATPACK_PORT, QUARKUS_HTTP_PORT, PAYARAMICRO_PORT과 같은 환경 변수는 이 값으로 설정됩니다.
AZURE_LOGGING_DIR	Windows 앱의 경우 Java 인수에 -Dsite.logdir로 추가됩니다. 기본값은 %HOME%\LogFiles\입니다. Linux의 기본값은 AZURE_LOGGING_DIR=/home/LogFiles입니다.

Node.JS

설정 이름	설명
PORT	읽기 전용. Linux 앱의 경우, .Node.js 앱이 컨테이너에서 수신 대기하는 포트.
WEBSITE_ROLE_INSTANCE_ID	읽기 전용. 현재 인스턴스의 ID.
PM2HOME
WEBSITE_NODE_DEFAULT_VERSION	네이티브 Windows 앱의 경우, 앱이 사용하는 기본 노드 버전. 지원되는 Node.js 버전 은 여기에서 사용할 수 있습니다.

Python

설정 이름	설명
APPSVC_VIRTUAL_ENV	읽기 전용.
PORT	읽기 전용. Linux 앱의 경우, Python 앱이 컨테이너에서 수신 대기하는 포트.

PHP

설정 이름	설명	예시
PHP_Extensions	쉼표로 구분된 PHP 확장 목록.	extension1.dll,extension2.dll,Name1=value1
PHP_ZENDEXTENSIONS	Linux 앱의 경우, xdebug로 설정하여 PHP 컨테이너의 XDebug 버전을 사용합니다.
PHP_VERSION	읽기 전용. 선택한 PHP 버전.
WEBSITE_PORT	읽기 전용. Apache 서버가 컨테이너에서 수신 대기하는 포트.
WEBSITE_ROLE_INSTANCE_ID	읽기 전용. 현재 인스턴스의 ID.
WEBSITE_PROFILER_ENABLE_TRIGGER	TRUE로 설정하여 xdebug.profiler_enable_trigger=1와 xdebug.profiler_enable=0을 기본 php.ini로 추가합니다.

Ruby

설정 이름	설명	예시
PORT	읽기 전용. Rails 앱이 컨테이너에서 수신 대기하는 포트.
WEBSITE_ROLE_INSTANCE_ID	읽기 전용. 현재 인스턴스의 ID.
RAILS_IGNORE_SPLASH	기본적으로, Gemfile이 없으면 기본 시작 페이지가 표시됩니다. 시작 페이지를 사용하지 않도록 설정하려면 이 변수를 임의의 값으로 설정합니다.
BUNDLE_WITHOUT	bundle install에 --without 옵션을 추가하려면 제외하려는 그룹에 공백으로 구분하여 변수를 설정합니다. 기본적으로 모든 Gem이 설치됩니다.	test development
BUNDLE_INSTALL_LOCATION	gem을 설치할 디렉터리. 기본값은 /tmp/bundle입니다.
RUBY_SITE_CONFIG_DIR	사이트 구성 디렉터리. 기본값은 /home/site/config입니다. 컨테이너는 이 디렉터리에서 압축된 gem을 확인합니다.
SECRET_KEY_BASE	기본적으로 임의의 비밀 키 베이스가 생성됩니다. 사용자 지정 비밀 키 베이스를 사용하려면 이 변수를 원하는 키 베이스로 설정합니다.
RAILS_ENV	레일 환경. 기본값은 production입니다.
GEM_PRISTINE	gem pristine --all을 실행하려면 이 변수를 임의의 값으로 설정합니다.

WordPress

애플리케이션 설정	범위	값	최대	설명
WEBSITES_ENABLE_APP_SERVICE_STORAGE	웹앱	true	-	TRUE로 설정하면 다시 시작하는 동안 파일 내용이 유지됩니다.
WP_MEMORY_LIMIT	WordPress	128M	512M	프런트 엔드 또는 일반 wordpress PHP 메모리 제한(스크립트당)입니다. PHP_MEMORY_LIMIT를 초과할 수 없습니다.
WP_MAX_MEMORY_LIMIT	WordPress	256M	512M	관리자 대시보드 PHP 메모리 제한(스크립트당)입니다. 일반적으로 관리자 대시보드/백 엔드 스크립트는 프런트 엔드 스크립트에 비해 많은 메모리를 사용합니다. PHP_MEMORY_LIMIT를 초과할 수 없습니다.
PHP_MEMORY_LIMIT	PHP	512M	512M	일반 PHP 스크립트에 대한 메모리 제한입니다. 감소할 수만 있습니다.
FILE_UPLOADS	PHP	설정	-	켜기 또는 끄기 중 하나일 수 있습니다. 이 값은 대/소문자를 구분합니다. 파일 업로드를 사용하거나 사용하지 않도록 설정합니다.
UPLOAD_MAX_FILESIZE	PHP	50M	256M 최대 파일 업로드 크기 제한입니다. 최대 256M까지 늘릴 수 있습니다.
POST_MAX_SIZE	PHP	128M	256M	최대 256M까지 늘릴 수 있습니다. 일반적으로 UPLOAD_MAX_FILESIZE 이상이어야 합니다.
MAX_EXECUTION_TIME	PHP	120	120	감소할 수만 있습니다. 120초 이상 걸리는 경우 스크립트를 분석하세요. 잘못된 스크립트로 인해 시스템 속도가 느려지는 것을 방지하기 위해 추가되었습니다.
MAX_INPUT_TIME	PHP	120	120	입력 요청을 구문 분석하기 위한 최대 시간 제한입니다. 감소할 수만 있습니다.
MAX_INPUT_VARS	PHP	10000	10000	-
DATABASE_HOST	데이터베이스	-	-	WordPress에 연결하는 데 사용되는 데이터베이스 호스트입니다.
DATABASE_NAME	데이터베이스	-	-	WordPress에 연결하는 데 사용되는 데이터베이스 이름입니다.
DATABASE_USERNAME	데이터베이스	-	-	WordPress에 연결하는 데 사용되는 데이터베이스 사용자 이름입니다.
DATABASE_PASSWORD	데이터베이스	-	-	MySQL 데이터베이스에 연결하는 데 사용되는 데이터베이스 암호입니다. MySQL 데이터베이스 암호를 변경하려면 관리자 암호 업데이트를 참조하세요. MySQL 데이터베이스 암호가 변경될 때마다 애플리케이션 설정도 업데이트해야 합니다.
WORDPRESS_ADMIN_EMAIL	배포 전용	-	-	WordPress 관리자 이메일
WORDPRESS_ADMIN_PASSWORD	배포 전용	-	-	WordPress 관리자 암호. 이는 배포 목적으로만 사용됩니다. 이 값을 수정해도 WordPress 설치에는 영향을 미치지 않습니다. WordPress 관리자 암호를 변경하려면 암호 다시 설정을 참조하세요.
WORDPRESS_ADMIN_USER	배포 전용	-	-	WordPress 관리자 사용자 이름
WORDPRESS_ADMIN_LOCALE_CODE	배포 전용	-	-	WordPress에 연결하는 데 사용되는 데이터베이스 사용자 이름입니다.

도메인 및 DNS

설정 이름	설명	예시
WEBSITE_DNS_SERVER	나가는 연결(예: 백 엔드 서비스)에 대한 기본 DNS 서버의 IP 주소. App Service에 대한 기본 DNS 서버는 IP 주소가 168.63.129.16인 Azure DNS입니다. 앱이 VNet 통합을 사용하거나 App Service environment에 있는 경우, 기본적으로 VNet에서 DNS 서버 구성을 상속합니다.	10.0.0.1
WEBSITE_DNS_ALT_SERVER	나가는 연결에 대한 대체 DNS 서버의 IP 주소. WEBSITE_DNS_SERVER을(를) 참조하세요.
WEBSITE_ENABLE_DNS_CACHE	성공적인 DNS 확인을 캐시할 수 있습니다. 기본적으로 만료된 DNS 캐시 항목은 4.5분마다 플러시되는 기존 캐시와 함께 &로 플러시됩니다.

TLS/SSL

자세한 내용은 Azure App Service의 코드에서 TLS/SSL 인증서 사용을 참조하세요.

설정 이름	설명
WEBSITE_LOAD_CERTIFICATES	코드에서 로드하려는 인증서에 대한 쉼표로 구분된 지문 값 또는 모든 인증서를 코드에 로드할 수 있도록 허용하는 *. 앱에 추가된 인증서만 로드할 수 있습니다.
WEBSITE_PRIVATE_CERTS_PATH	읽기 전용. 로드된 프라이빗 인증서에 대한 Windows 컨테이너의 경로.
WEBSITE_PUBLIC_CERTS_PATH	읽기 전용. 로드된 공용 인증서에 대한 Windows 컨테이너의 경로.
WEBSITE_INTERMEDIATE_CERTS_PATH	읽기 전용. 로드된 중간 인증서에 대한 Windows 컨테이너의 경로.
WEBSITE_ROOT_CERTS_PATH	읽기 전용. 로드된 루트 인증서에 대한 Windows 컨테이너의 경로.

배포 슬롯

자세한 내용은 Azure App Service에서 스테이징 환경 설정을 참조하세요.

설정 이름	설명	예시
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS	기본적으로 사이트 확장의 버전은 각 슬롯에 따라 다릅니다. 이렇게 하면 교환 후 확장 버전 변경으로 인한 예기치 않은 애플리케이션 동작이 방지됩니다. 확장 버전도 교환하려면, 모든 슬롯에서 0로 설정합니다.
WEBSITE_OVERRIDE_PRESERVE_DEFAULT_STICKY_SLOT_SETTINGS	기본적으로 특정 설정을 고정 또는 교환 불가능으로 지정합니다. 기본값은 true입니다. 대신, 모든 배포 슬롯을 교환할 수 있도록 이 설정을 false 또는 0로 설정합니다. 특정 설정 형식에 대한 세분화된 제어는 없습니다.
WEBSITE_SWAP_WARMUP_PING_PATH	슬래시로 시작하는 교환에서 대상 슬롯을 준비하기 위한 ping 경로. 기본값은 HTTP를 통해 루트 경로를 ping하는 /입니다.	/statuscheck
WEBSITE_SWAP_WARMUP_PING_STATUSES	교환 중 준비 작업에 대한 유효한 HTTP 응답 코드. 반환된 상태 코드가 목록에 없는 경우 준비 및 교환 작업이 중지됩니다. 기본적으로 모든 응답 코드는 유효합니다.	200,202
WEBSITE_SLOT_NUMBER_OF_TIMEOUTS_BEFORE_RESTART	슬롯 교환 중 특정 VM 인스턴스에서 사이트를 강제로 다시 시작하는 최대 시간 제한 수. 기본값은 3입니다.
WEBSITE_SLOT_MAX_NUMBER_OF_TIMEOUTS	슬롯 교환 중 포기 전에 만들 단일 URL에 대한 최대 시간 제한 요청 수. 기본값은 5입니다.
WEBSITE_SKIP_ALL_BINDINGS_IN_APPHOST_CONFIG	true또는 1로 설정하여 applicationHost.config의 모든 바인딩을 건너뜁니다. 기본값은 false입니다. applicationHost.config이 슬롯의 교환된 호스트 이름으로 업데이트되기 때문에, 앱이 재시작을 트리거하는 경우, 이 변수를 true로 설정하여 이러한 종류의 재시작을 방지합니다. WCF(Windows Communication Foundation) 앱을 실행 중인 경우 이 변수를 설정하지 마세요.

사용자 지정 컨테이너

사용자 지정 컨테이너에 대한 자세한 내용은 Azure에서 사용자 지정 컨테이너 실행을 참조하세요.

설정 이름	설명	예시
WEBSITES_ENABLE_APP_SERVICE_STORAGE	Linux 사용자 지정 컨테이너의 경우: /home 디렉터리가 크기 조정된 인스턴스 간에 공유되도록 하려면 true로 설정합니다. Linux 사용자 지정 컨테이너의 경우 기본값은 false입니다. Windows 컨테이너의 경우: c:\home 디렉터리가 크기 조정된 인스턴스 간에 공유되도록 하려면 true로 설정합니다. Windows 컨테이너의 경우 기본값은 true입니다.
WEBSITES_CONTAINER_START_TIME_LIMIT	컨테이너를 다시 시작하기 전에 컨테이너가 시작이 완료되기를 기다리는 시간(초). 기본값은 230입니다. 최대 1800까지 늘릴 수 있습니다.
WEBSITES_CONTAINER_STOP_TIME_LIMIT	컨테이너가 정상적으로 종료되기를 기다리는 시간(초)입니다. 기본값은 5입니다. 최대 120까지 늘릴 수 있습니다.
DOCKER_REGISTRY_SERVER_URL	App Service 사용자 지정 컨테이너를 실행할 때 레지스트리 서버의 URL. 보안을 위해 이 변수는 컨테이너에 전달되지 않습니다.	https://<server-name>.azurecr.io
DOCKER_REGISTRY_SERVER_USERNAME	DOCKER_REGISTRY_SERVER_URL에서 레지스트리 서버로 인증할 사용자 이름. 보안을 위해 이 변수는 컨테이너에 전달되지 않습니다.
DOCKER_REGISTRY_SERVER_PASSWORD	DOCKER_REGISTRY_SERVER_URL에서 레지스트리 서버로 인증하는 데 사용할 암호. 보안을 위해 이 변수는 컨테이너에 전달되지 않습니다.
DOCKER_ENABLE_CI	사용자 지정 컨테이너에 대한 지속적인 배포를 사용하도록 설정하려면 true로 설정합니다. 사용자 지정 컨테이너에 대한 기본값은 false입니다.
WEBSITE_PULL_IMAGE_OVER_VNET	Virtual Network 또는 온-프레미스 내의 레지스트리에서 연결하고 끌어옵니다. VNet 통합 기능을 사용하여 앱을 Virtual Network에 연결해야 합니다. 프라이빗 엔드포인트가 있는 Azure Container Registry에도 이 설정이 필요합니다.
WEBSITES_WEB_CONTAINER_NAME	Docker Compose 앱에서는 컨테이너 중 하나만 인터넷에 액세스할 수 있습니다. 기본 컨테이너 선택을 재정의하려면, 구성 파일에 정의된 컨테이너의 이름으로 설정합니다. 기본적으로, 인터넷 액세스 가능 컨테이너는 포트 80 또는 8080을 정의하는 첫 번째 컨테이너이거나, 이러한 컨테이너가 없으면 구성 파일에 정의된 첫 번째 컨테이너입니다.
WEBSITES_PORT	사용자 지정 컨테이너의 경우 App Service가 요청을 라우팅할 컨테이너의 사용자 지정 포트 번호입니다. 기본적으로 App Service는 포트 80 및 8080의 자동 포트 검색을 시도합니다. 이 설정은 환경 변수로 컨테이너에 삽입되지 않습니다.
WEBSITE_CPU_CORES_LIMIT	기본적으로 Windows 컨테이너는 선택한 가격 책정 계층에서 사용할 수 있는 모든 코어를 사용하여 실행됩니다. 컨테이너에서 사용하는 코어 수를 줄이려면, 원하는 코어 제한 수로 설정합니다. 자세한 내용은 컴퓨팅 코어 수 사용자 지정을 참조하세요.
WEBSITE_MEMORY_LIMIT_MB	기본적으로 Azure App Service에 배포된 모든 Windows 컨테이너에는 App Service 계획 SKU에 따라 구성된 메모리 제한이 있습니다. 원하는 메모리 제한(MB)으로 설정합니다. 동일한 플랜의 앱에서 이 설정의 누적 합계는 선택한 가격 책정 계층에서 허용하는 금액을 초과해서는 안됩니다. 자세한 내용은 컨테이너 메모리 사용자 지정을 참조하세요.

확장

설정 이름	설명
WEBSITE_INSTANCE_ID	읽기 전용. 앱이 여러 인스턴스로 확장되는 경우, 현재 VM 인스턴스의 고유 ID.
WEBSITE_IIS_SITE_NAME	사용되지 않음. WEBSITE_INSTANCE_ID을 사용합니다.
WEBSITE_DISABLE_OVERLAPPED_RECYCLING	반복 재활용을 사용하면 앱의 현재 VM 인스턴스가 종료되기 전에 새 VM 인스턴스가 시작됩니다. 경우에 따라 파일 잠금 문제가 발생할 수 있습니다. 1로 설정하여 해제해 볼 수 있습니다.
WEBSITE_DISABLE_CROSS_STAMP_SCALE	기본적으로, 앱은 Azure Files 또는 Docker 컨테이너를 사용하는 경우에 스탬프를 스케일링할 수 있습니다. 1또는 true로 설정하여 앱의 지역 내에서 스탬프 간 스케일링을 사용하지 않도록 설정합니다. 기본값은 0입니다. WEBSITES_ENABLE_APP_SERVICE_STORAGE를 true 또는 1로 설정하는 사용자 지정 Docker 컨테이너는 콘텐츠가 Docker 컨테이너에 완전히 캡슐화되지 않았기 때문에 교차 스탬프의 크기를 조정할 수 없습니다.

로깅

설정 이름	설명	예시
WEBSITE_HTTPLOGGING_ENABLED	읽기 전용. Windows 네이티브 앱에 대한 웹 서버 로깅을 사용할지(1) 말지(0) 여부를 표시합니다.
WEBSITE_HTTPLOGGING_RETENTION_DAYS	웹 서버 로그가 Windows 네이티브 또는 Linux 앱에 대해 사용하도록 설정된 경우 웹 서버 로그의 보존 기간(일)입니다.	10
WEBSITE_HTTPLOGGING_CONTAINER_URL	웹 서버 로그를 사용하는 경우, Windows 네이티브 앱에 대한 웹 서버 로그를 저장할 Blob Storage 컨테이너의 SAS URL. 설정하지 않으면 웹 서버 로그가 앱의 파일 시스템(기본 공유 스토리지)에 저장됩니다.
DIAGNOSTICS_AZUREBLOBRETENTIONINDAYS	애플리케이션 로그를 사용하는 경우, Windows 네이티브 앱에 대한 애플리케이션 로그의 보존 기간(일).	10
DIAGNOSTICS_AZUREBLOBCONTAINERSASURL	애플리케이션 로그를 사용하는 경우, Windows 네이티브 앱에 대한 애플리케이션 로그를 저장할 Blob Storage 컨테이너의 SAS URL.
APPSERVICEAPPLOGS_TRACE_LEVEL	AppServiceAppLogs 로그 유형에 대한 Log Analytics로 발송할 최소 로그 수준.
DIAGNOSTICS_LASTRESORTFILE	생성할 파일 이름 또는 수신기 문제 해결을 위한 내부 오류를 기록하기 위한 로그 디렉터리에 대한 상대 경로. 기본값은 logging-errors.txt입니다.
DIAGNOSTICS_LOGGINGSETTINGSFILE	D:\home 또는 /home에 상대적인 로그 설정 파일의 경로. 기본값은 site\diagnostics\settings.json입니다.
DIAGNOSTICS_TEXTTRACELOGDIRECTORY	앱 루트(D:\home\site\wwwroot 또는 /home/site/wwwroot)를 기준으로 하는 로그 폴더.	..\..\LogFiles\Application
DIAGNOSTICS_TEXTTRACEMAXLOGFILESIZEBYTES	파일의 최대 크기(바이트). 기본값은 131072(128KB)입니다.
DIAGNOSTICS_TEXTTRACEMAXLOGFOLDERSIZEBYTES	로그 폴더의 최대 크기(바이트). 기본값은 1048576(1MB)입니다.
DIAGNOSTICS_TEXTTRACEMAXNUMLOGFILES	유지할 최대 로그 파일 수. 기본값은 20입니다.
DIAGNOSTICS_TEXTTRACETURNOFFPERIOD	애플리케이션 로깅을 사용하도록 유지하기 위한 시간(밀리초). 기본값은 43200000(12시간)입니다.
WEBSITE_LOG_BUFFERING	기본적으로 로그 버퍼링이 사용됩니다. 0로 설정하여 해제합니다.
WEBSITE_ENABLE_PERF_MODE	네이티브 Windows 앱의 경우, TRUE로 설정하여 10초 이내에 반환된 성공적인 요청에 대한 IIS 로그 항목을 해제합니다. 이는 확장된 로깅을 제거하여 성능 벤치마킹을 수행하는 빠른 방법입니다.

성능 카운터

다음은 열거하는 경우에는 존재하지 않지만 개별적으로 조회하는 경우 해당 값을 반환하는 '가짜' 환경 변수입니다. 값은 동적이며 모든 조회에서 변경할 수 있습니다.

설정 이름	설명
WEBSITE_COUNTERS_ASPNET	ASP.NET 성능 카운터를 포함하는 JSON 개체.
WEBSITE_COUNTERS_APP	샌드박스 카운터를 포함하는 JSON 개체.
WEBSITE_COUNTERS_CLR	CLR 카운터를 포함하는 JSON 개체.
WEBSITE_COUNTERS_ALL	다른 세 변수의 조합을 포함하는 JSON 개체.

캐싱

설정 이름	설명
WEBSITE_LOCAL_CACHE_OPTION	로컬 캐시를 사용할 수 있는지 여부. 사용 가능한 옵션은 다음과 같습니다. - Default: 스탬프 수준 전역 설정을 상속합니다. - Always: 앱에 대해 사용하도록 설정합니다. - OnStorageUnavailability - Disabled: 앱에 대해 사용하지 않도록 설정합니다.
WEBSITE_LOCAL_CACHE_READWRITE_OPTION	로컬 캐시의 읽기-쓰기 옵션. 사용 가능한 옵션은 다음과 같습니다. - ReadOnly: 캐시는 읽기 전용입니다. - WriteButDiscardChanges: 로컬 캐시에 대한 쓰기를 허용하지만 로컬에서 변경한 내용을 무시합니다.
WEBSITE_LOCAL_CACHE_SIZEINMB	로컬 캐시의 크기(MB). 기본값은 1000(1GB)입니다.
WEBSITE_LOCALCACHE_READY	앱이 로컬 캐시를 사용하는지 여부를 나타내는 읽기 전용 플래그.
WEBSITE_DYNAMIC_CACHE	여러 인스턴스에 대한 액세스를 허용하는 네트워크 파일 공유 특성으로 인해, 동적 캐시는 최근에 액세스한 파일을 인스턴스에 로컬로 캐싱하여 성능을 향상시킵니다. 파일이 수정되면 캐시가 무효화됩니다. 캐시 위치는 %SYSTEMDRIVE%\local\DynamicCache입니다(동일한 %SYSTEMDRIVE%\local 할당량 적용). 전체 콘텐츠 캐싱을 사용하도록 설정하려면 파일 콘텐츠와 디렉터리/파일 메타데이터(타임스탬프, 크기, 디렉터리 콘텐츠)를 모두 포함하는 1로 설정합니다. 로컬 디스크 사용을 절약하려면, 2로 설정하여 디렉터리/파일 메타데이터(타임스탬프, 크기, 디렉터리 콘텐츠)만 캐싱합니다. 캐싱을 해제하려면 0로 설정합니다. Windows 앱 및 WordPress 템플릿으로 만들어진 Linux 앱의 경우 기본값은 1입니다. 다른 모든 Linux 앱의 경우 기본값은 0입니다.
WEBSITE_READONLY_APP	동적 캐시를 사용하는 경우, 이 변수를 1로 설정하여 앱 루트(D:\home\site\wwwroot 또는 /home/site/wwwroot)에 대한 쓰기 액세스를 사용하지 않도록 설정할 수 있습니다. App_Data 디렉터리를 제외하고, 배타적 잠금이 허용되지 않으므로 잠긴 파일에 의해 배포가 차단되지 않습니다.

네트워킹

다음 환경 변수는 하이브리드 연결 및 VNET 통합과 관련이 있습니다.

설정 이름	설명
WEBSITE_RELAYS	읽기 전용. 엔드포인트 및 서비스 버스 데이터를 포함하여 하이브리드 연결을 구성하는 데 필요한 데이터입니다.
WEBSITE_REWRITE_TABLE	읽기 전용. 런타임에 조회를 수행하여 연결을 적절하게 다시 작성하는 데 사용됩니다.
WEBSITE_VNET_ROUTE_ALL	기본적으로 지역 VNet 통합을 사용하는 경우, 앱은 RFC1918 트래픽만 VNet으로 라우팅합니다. 모든 아웃바운드 트래픽을 VNet으로 라우팅하고 동일한 NSG 및 UDR을 적용하려면 1로 설정합니다. 이 설정을 사용하면 VNet을 통해 비 RFC1918 엔드포인트에 액세스하고, 앱에서 나가는 모든 아웃바운드 트래픽을 보호하고, 선택한 네트워크 어플라이언스에 모든 아웃바운드 트래픽을 강제로 터널링할 수 있습니다.
WEBSITE_PRIVATE_IP	읽기 전용. VNet 와 통합될 때 앱과 연결된 IP 주소. 지역 VNet 통합의 경우, 값은 위임된 서브넷의 주소 범위에 속하는 IP이고 VNet 통합이 필요한 게이트웨이의 경우 값은 Virtual Network Gateway에 구성된 지점 및 사이트 간 주소 풀의 주소 범위에 속하는 IP입니다. 이 IP는 앱이 VNet을 통해 리소스에 연결하는 데 사용합니다. 또한 설명된 주소 범위 내에서 변경할 수 있습니다.
WEBSITE_PRIVATE_PORTS	읽기 전용. VNet 통합에서 앱에서 다른 노드와 통신하는 데 사용할 수 있는 포트를 보여줍니다.
WEBSITE_CONTENTOVERVNET	AApp Service에 Azure File Share를 탑재하고 스토리지 계정이 VNET으로 제한되는 경우 1 값으로 이 설정을 사용하도록 설정해야 합니다.

Key Vault 참조

다음 환경 변수는 키 자격 증명 모음 참조와 관련이 있습니다.

설정 이름	설명
WEBSITE_KEYVAULT_REFERENCES	읽기 전용. 앱에서 현재 구성된 모든 Key Vault 참조에 대한 정보(상태 포함)를 포함합니다.
WEBSITE_SKIP_CONTENTSHARE_VALIDATION	앱의 공유 스토리지 연결(WEBSITE_CONTENTAZUREFILECONNECTIONSTRING 사용)을 Key Vault 참조로 설정하면, 앱은 다음 조건 중 하나에 해당하면 앱 생성 시 키 자격 증명 모음 참조를 해결하지 못하거나 업데이트할 수 없습니다. - 앱이 시스템 할당 ID를 통해 키 자격 증명 모음에 액세스합니다. - 앱이 사용자 할당 ID를 통해 키 자격 증명 모음에 액세스하고 키 자격 증명 모음이 VNet으로 잠깁니다. 생성하거나 업데이트할 때 오류를 방지하려면 이 변수를 1로 설정합니다.
WEBSITE_DELAY_CERT_DELETION	작업자 프로세스가 종속된 인증서가 종료될 때까지 삭제되지 않도록 하려면, 사용자가 이 env var을 1로 설정할 수 있습니다.

CORS

다음 환경 변수는 CORS(원본 간 리소스 공유) 구성과 관련이 있습니다.

설정 이름	설명
WEBSITE_CORS_ALLOWED_ORIGINS	읽기 전용. CORS에 허용되는 원본을 표시합니다.
WEBSITE_CORS_SUPPORT_CREDENTIALS	읽기 전용. true에 대한 Access-Control-Allow-Credentials 헤더를 설정했는지(True) 아닌지(False) 여부를 나타냅니다.

인증 및 권한 부여

다음 환경 변수는 App Service 인증과 관련이 있습니다.

설정 이름	설명
WEBSITE_AUTH_DISABLE_IDENTITY_FLOW	true로 설정하면, ASP.NET 기반 웹 애플리케이션(v1 함수 앱 포함)에서 스레드 보안 주체 ID 할당을 사용하지 않도록 설정합니다. 이는 개발자가 인증을 사용하여 사이트에 대한 액세스를 보호할 수 있도록 설계되었지만, 앱 논리 내에서 별도의 로그인 메커니즘을 계속 사용하도록 합니다. 기본값은 false입니다.
WEBSITE_AUTH_HIDE_DEPRECATED_SID	true 또는 false. 기본값은 false입니다. 이는 Azure App Service용 레거시 Azure Mobile Apps 통합을 위한 설정입니다. 이를 true로 설정하면 사용자가 프로필 정보를 변경하는 경우 인증된 사용자에 대해 생성된 SID(보안 ID)가 변경되는 문제가 해결됩니다. 이 값을 변경하면 기존 Azure Mobile Apps 사용자 ID가 변경됩니다. 대부분의 앱은 이 설정을 사용할 필요가 없습니다.
WEBSITE_AUTH_NONCE_DURATION	_hours_:_minutes_:_seconds_ 형식 내의 기간 값. 기본값은 00:05:00(5분)입니다. 이 설정은 모든 브라우저 기반 로그인에 대해 생성된 암호화 nonce의 수명을 제어합니다. 로그인이 지정된 시간 내에 완료되지 않으면 로그인 흐름이 자동으로 다시 시도됩니다. 이 애플리케이션 설정은 V1(classic) 구성 환경에서 사용하기 위한 것입니다. V2 인증 구성 스키마를 사용하는 경우, 대신 login.nonce.nonceExpirationInterval 구성 값을 사용해야 합니다.
WEBSITE_AUTH_PRESERVE_URL_FRAGMENT	true로 설정하고 사용자가 URL 조각이 포함된 앱 링크를 선택하면 로그인 프로세스는 로그인 리디렉션 프로세스에서 URL의 URL 조각 부분이 손실되지 않도록 합니다. 자세한 내용은 Azure App Service 인증에서 로그인 및 로그아웃 사용자 지정을 참조하세요.
WEBSITE_AUTH_USE_LEGACY_CLAIMS	업그레이드 간에 이전 버전과의 호환성을 유지하기 위해, 인증 모듈은 /.auth/me API에서 짧은 이름에서 긴 이름으로의 레거시 클레임 매핑을 사용하므로 특정 매핑(예: "역할")은 제외됩니다. 최신 버전의 클레임 매핑을 얻으려면, 이 변수를 False로 설정합니다. “역할” 예제에서는 긴 클레임 이름인 “http://schemas.microsoft.com/ws/2008/06/identity/claims/role"”에 매핑됩니다.
WEBSITE_AUTH_DISABLE_WWWAUTHENTICATE	true 또는 false. 기본값은 false입니다. true로 설정하면 모듈에서 생성된 HTTP 401 응답에서 WWW-Authenticate HTTP 응답 헤더를 제거합니다. 이 애플리케이션 설정은 V1(classic) 구성 환경에서 사용하기 위한 것입니다. V2 인증 구성 스키마를 사용하는 경우, 대신 identityProviders.azureActiveDirectory.login.disableWwwAuthenticate 구성 값을 사용해야 합니다.
WEBSITE_AUTH_STATE_DIRECTORY	파일 기반 토큰 저장소를 사용할 때 토큰이 저장되는 로컬 파일 시스템 디렉터리 경로. 기본값은 %HOME%\Data\.auth입니다. 이 애플리케이션 설정은 V1(classic) 구성 환경에서 사용하기 위한 것입니다. V2 인증 구성 스키마를 사용하는 경우, 대신 login.tokenStore.fileSystem.directory 구성 값을 사용해야 합니다.
WEBSITE_AUTH_TOKEN_CONTAINER_SASURL	정규화된 Blob 컨테이너 URL. 기본 로컬 파일 시스템을 사용하는 대신, 암호화된 모든 토큰을 저장하고 지정된 Blob Storage 컨테이너에 로드하도록 인증 모듈에 지시합니다.
WEBSITE_AUTH_TOKEN_REFRESH_HOURS	모든 양의 10진수. 기본값은 72(시간)입니다. 이 설정은 세션 토큰이 만료된 후 /.auth/refresh API를 사용하여 새로 고칠 수 있는 시간을 제어합니다. 이 기간 후에 새로 고침 시도가 실패하고 최종 사용자는 다시 로그인해야 합니다. 이 애플리케이션 설정은 V1(classic) 구성 환경에서 사용하기 위한 것입니다. V2 인증 구성 스키마를 사용하는 경우, 대신 login.tokenStore.tokenRefreshExtensionHours 구성 값을 사용해야 합니다.
WEBSITE_AUTH_TRACE_LEVEL	Application Logging에 기록된 인증 추적의 세부 정보를 제어합니다. 유효한 값은 Off, Error, Warning, Information, Verbose입니다. 기본값은 Verbose입니다.
WEBSITE_AUTH_VALIDATE_NONCE	true 또는 false. 기본값은 true입니다. 대화형 로그인 중에 발생하는 암호화 nonce 유효성 검사 오류를 일시적으로 디버깅하는 경우를 제외하고, 이 값을 false로 설정하면 안 됩니다. 이 애플리케이션 설정은 V1(classic) 구성 환경에서 사용하기 위한 것입니다. V2 인증 구성 스키마를 사용하는 경우, 대신 login.nonce.validateNonce 구성 값을 사용해야 합니다.
WEBSITE_AUTH_V2_CONFIG_JSON	이 환경 변수는 Azure App Service 플랫폼에서 자동으로 채워지고 통합 인증 모듈을 구성하는 데 사용됩니다. 이 환경 변수의 값은 Azure Resource Manager의 최신 앱의 V2(non-classic) 인증 구성에 해당합니다. 명백하게 구성하기에 적합하지 않습니다.
WEBSITE_AUTH_ENABLED	읽기 전용. Windows 또는 Linux 앱에 삽입되어 App Service 인증이 사용되는지 여부를 나타냅니다.
WEBSITE_AUTH_ENCRYPTION_KEY	기본적으로, 자동으로 생성된 키는 암호화 키로 사용됩니다. 재정의하려면 원하는 키로 설정합니다. 이는 여러 앱에서 토큰 또는 세션을 공유하려는 경우에 권장됩니다. 지정된 경우 MACHINEKEY_DecryptionKey 설정을 대체합니다.
WEBSITE_AUTH_SIGNING_KEY	기본적으로 자동으로 생성된 키는 서명 키로 사용됩니다. 재정의하려면 원하는 키로 설정합니다. 이는 여러 앱에서 토큰 또는 세션을 공유하려는 경우에 권장됩니다. 지정된 경우 MACHINEKEY_ValidationKey 설정을 대체합니다.

관리 ID

다음 환경 변수는 관리 ID와 관련이 있습니다.

설정 이름	설명
IDENTITY_ENDPOINT	읽기 전용. 앱의 관리 ID에 대한 토큰을 검색할 URL.
MSI_ENDPOINT	사용되지 않음. IDENTITY_ENDPOINT을 사용합니다.
IDENTITY_HEADER	읽기 전용. IDENTITY_ENDPOINT에 대한 HTTP GET 요청을 만들 때 X-IDENTITY-HEADER 헤더에 추가해야 하는 값입니다. 플랫폼에서 값을 회전합니다.
MSI_SECRET	사용되지 않음. IDENTITY_HEADER을 사용합니다.

상태 확인

다음 환경 변수는 상태 검사와 관련되어 있습니다.

설정 이름	설명
WEBSITE_HEALTHCHECK_MAXPINGFAILURES	인스턴스를 제거하기 전에 실패한 최대 ping 수. 2과 100 사이의 값을 설정합니다. 스케일 업 또는 스케일 아웃할 때 App Service는 새 인스턴스가 준비되도록 Health check 경로를 ping합니다. 자세한 내용은 상태 검사를 참조하세요.
WEBSITE_HEALTHCHECK_MAXUNHEALTHYWORKERPERCENT	정상 상태의 인스턴스가 너무 많아지는 것을 방지하기 위해 인스턴스 중 절반 이하만 제외됩니다. 예를 들어 App Service 계획이 4개의 인스턴스로 확장되고 3개가 비정상이면 최대 2개가 제외됩니다. 나머지 두 인스턴스(정상 1 및 비정상 1)에서는 계속해서 요청을 받습니다. 모든 인스턴스가 비정상인 최악의 시나리오에서는 인스턴스가 제외되지 않습니다. 이 동작을 재정의하려면 1과 100 사이의 값으로 설정합니다. 값이 높을수록 비정상 인스턴스가 더 많이 제거됩니다. 기본값은 50(50%)입니다.

푸시 알림

다음 환경 변수는 푸시 알림 기능과 관련이 있습니다.

설정 이름	설명
WEBSITE_PUSH_ENABLED	읽기 전용. 푸시 알림이 사용하도록 설정된 경우 추가됩니다.
WEBSITE_PUSH_TAG_WHITELIST	읽기 전용. 알림 등록에 태그를 포함합니다.
WEBSITE_PUSH_TAGS_REQUIRING_AUTH	읽기 전용. 사용자 인증이 필요한 알림 등록의 태그 목록을 포함합니다.
WEBSITE_PUSH_TAGS_DYNAMIC	읽기 전용. 자동으로 추가된 알림 등록의 태그 목록을 포함합니다.

참고 항목

이 문서에는 Microsoft에서 더 이상 사용하지 않는 용어에 대한 참조가 포함되어 있습니다. 소프트웨어에서 용어가 제거되면 이 문서에서 해당 용어가 제거됩니다.

Webjobs

다음 환경 변수는 WebJobs와 관련되어 있습니다.

설정 이름	설명
WEBJOBS_RESTART_TIME	연속 작업의 경우, 작업을 다시 시작하기 전에 어떤 이유로든 작업 프로세스가 중단되면 몇 초 단위로 지연합니다.
WEBJOBS_IDLE_TIMEOUT	트리거된 작업의 경우, 시간 제한(초)으로, 유휴 상태이면 작업이 중단되고 CPU 시간 또는 출력이 없습니다.
WEBJOBS_HISTORY_SIZE	트리거된 작업의 경우, 작업당 기록 디렉터리에 유지되는 최대 실행 수. 기본값은 50입니다.
WEBJOBS_STOPPED	모든 작업 실행을 사용하지 않도록 설정하고 현재 실행 중인 모든 작업을 중지하려면 1로 설정합니다.
WEBJOBS_DISABLE_SCHEDULE	1로 설정하여 예약된 모든 트리거를 해제합니다. 작업은 여전히 수동으로 호출할 수 있습니다.
WEBJOBS_ROOT_PATH	webjob 파일의 절대 또는 상대 경로. 상대 경로의 경우, 값은 기본 루트 경로(D:/home/site/wwwroot/ 또는 /home/site/wwwroot/)와 결합됩니다.
WEBJOBS_LOG_TRIGGERED_JOBS_TO_APP_LOGS	트리거된 WebJobs의 출력을 애플리케이션 로그 파이프라인(파일 시스템, Blob, 테이블 지원)으로 보내려면 true로 설정합니다.
WEBJOBS_SHUTDOWN_FILE	종료 요청이 검색될 때 App Service가 생성하는 파일입니다. 이 파일의 존재를 감지하고 종료를 시작하는 것은 웹 작업 프로세스의 책임입니다. WebJobs SDK를 사용하는 경우, 이 부분은 자동으로 처리됩니다.
WEBJOBS_PATH	읽기 전용. 현재 실행 중인 작업의 루트 경로(일부 임시 디렉터리 아래).
WEBJOBS_NAME	읽기 전용. 현재 작업 이름.
WEBJOBS_TYPE	읽기 전용. 현재 작업 유형(triggered 또는 continuous).
WEBJOBS_DATA_PATH	읽기 전용. 작업의 로그, 기록 아티팩트까지 포함할 현재 작업 메타데이터 경로.
WEBJOBS_RUN_ID	읽기 전용. 트리거된 작업의 경우, 작업의 현재 실행 ID.

함수

설정 이름	설명
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED	함수 캐시를 사용하지 않으려면 0로 설정합니다.
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT	Azure Functions에 대한 앱 설정 참조
AzureWebJobsSecretStorageType	Azure Functions에 대한 앱 설정 참조
FUNCTIONS_EXTENSION_VERSION	Azure Functions에 대한 앱 설정 참조
FUNCTIONS_WORKER_RUNTIME	Azure Functions에 대한 앱 설정 참조
AzureWebJobsStorage	Azure Functions에 대한 앱 설정 참조
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING	Azure Functions에 대한 앱 설정 참조
WEBSITE_CONTENTSHARE	Azure Functions에 대한 앱 설정 참조
WEBSITE_CONTENTOVERVNET	Azure Functions에 대한 앱 설정 참조
WEBSITE_ENABLE_BROTLI_ENCODING	Azure Functions에 대한 앱 설정 참조
WEBSITE_USE_PLACEHOLDER	Azure Functions에 대한 앱 설정 참조
WEBSITE_PLACEHOLDER_MODE	읽기 전용. 함수 앱이 자리 표시자 호스트(generalized) 또는 자체 호스트(specialized)에서 실행되고 있는지 여부를 표시합니다.
WEBSITE_DISABLE_ZIP_CACHE	앱이 ZIP 패키지(WEBSITE_RUN_FROM_PACKAGE=1)에서 실행되면, 가장 최근에 배포된 5개의 ZIP 패키지가 앱의 파일 시스템(D:\home\data\SitePackages)에 캐싱됩니다. 이 캐시를 사용하지 않으려면 이 변수를 1로 설정합니다. Linux 사용 앱의 경우, ZIP 패키지 캐시는 기본적으로 사용하지 않도록 설정됩니다.