Variables de entorno y configuración de la aplicación en Azure App Service

Nota

A partir del 1 de junio de 2024, las aplicaciones de App Service recién creadas pueden generar un nombre de host predeterminado único que use la convención de nomenclatura <app-name>-<random-hash>.<region>.azurewebsites.net. Por ejemplo: myapp-ds27dh7271aah175.westus-01.azurewebsites.net. Los nombres de aplicación existentes permanecen sin cambios.

Para más información, consulte la entrada de blog sobre la creación de una aplicación web con un nombre de host predeterminado único.

En Azure App Service, ciertas configuraciones están disponibles para la implementación o el entorno de ejecución como variables de entorno. Puede personalizar algunas de estas opciones de configuración al establecerlas manualmente como configuración de la aplicación. Esta referencia muestra las variables que puede usar o personalizar.

Entorno de la aplicación

Las siguientes variables de entorno están relacionadas con el entorno de la aplicación en general.

Nombre del valor	Descripción
WEBSITE_SITE_NAME	Solo lectura. Nombre de la aplicación.
WEBSITE_RESOURCE_GROUP	Solo lectura. Nombre del grupo de recursos de Azure que contiene el recurso de la aplicación.
WEBSITE_OWNER_NAME	Solo lectura. Contiene el identificador de suscripción de Azure que posee la aplicación, el grupo de recursos y el espacio web.
REGION_NAME	Solo lectura. Nombre de la región de la aplicación.
WEBSITE_PLATFORM_VERSION	Solo lectura. Versión de la plataforma de App Service.
HOME	Solo lectura. Ruta de acceso al directorio principal (por ejemplo, D:\home para Windows).
SERVER_PORT	Solo lectura. Puerto al que debe escuchar la aplicación.
WEBSITE_WARMUP_PATH	Ruta de acceso relativa al ping para preparar la aplicación, empezando por una barra diagonal. El valor predeterminado es /robots933456.txt. Cada vez que la plataforma inicia un contenedor, el orquestador realiza solicitudes repetidas en este punto de conexión. La plataforma considera cualquier respuesta de este punto de conexión como una indicación de que el contenedor está listo. Cuando la plataforma considera que el contenedor está listo, comienza a reenviar el tráfico orgánico al contenedor recién iniciado. A menos que WEBSITE_WARMUP_STATUSES esté configurado, la plataforma considera cualquier respuesta del contenedor en este punto de conexión (incluso códigos de error como 404 o 502) como indicación de que el contenedor está listo. Esta configuración de la aplicación no cambia la ruta de acceso que usa Always On.
WEBSITE_WARMUP_STATUSES	Lista delimitada por comas de códigos de estado HTTP que se consideran correctos cuando la plataforma hace pings de preparación en un contenedor recién iniciado. Se usa con WEBSITE_WARMUP_PATH. De forma predeterminada, cualquier código de estado se considera una indicación de que el contenedor está listo para el tráfico orgánico. Puede usar esta aplicación para requerir una respuesta específica antes de que el tráfico orgánico se enrute al contenedor. Un ejemplo es 200,202. Si hace pings en la ruta de preparación configurada de la aplicación, recibirá una respuesta con un código de estado 200 o 202, el tráfico orgánico se enruta al contenedor. Si se recibe un código de estado que no está en la lista (por ejemplo, 502), la plataforma sigue haciendo pings hasta que se reciba un 200 o 202, o hasta que se alcance el límite de tiempo de espera de inicio del contenedor. (Consulte WEBSITES_CONTAINER_START_TIME_LIMIT más adelante en esta tabla). Si el contenedor no responde con un código de estado HTTP que se encuentra en la lista, la plataforma producirá un error en el intento de inicio y reintentos, lo que genera errores 503.
WEBSITE_COMPUTE_MODE	Solo lectura. Especifica si la aplicación se ejecuta en máquinas virtuales (Dedicated) dedicadas (Shared) o compartidas (VM).
WEBSITE_SKU	Solo lectura. Plan de tarifa de la aplicación. Los valores posibles son Free, Shared, Basic y Standard.
SITE_BITNESS	Solo lectura. Muestra si la aplicación es de 32 bits (x86) o de 64 bits (AMD64).
WEBSITE_HOSTNAME	Solo lectura. Nombre de host principal de la aplicación. Esta configuración no tiene en cuenta los nombres de host personalizados.
WEBSITE_VOLUME_TYPE	Solo lectura. Muestra el tipo de volumen de almacenamiento actualmente en uso.
WEBSITE_NPM_DEFAULT_VERSION	Versión predeterminada de npm que usa la aplicación.
WEBSOCKET_CONCURRENT_REQUEST_LIMIT	Solo lectura. Límite de solicitudes simultáneas de WebSocket. Para el nivel Standard y versiones posteriores, el valor es -1, pero todavía hay un límite por máquina virtual en función del tamaño de la máquina virtual. Consulte Límites numéricos de máquinas virtuales cruzadas.
WEBSITE_PRIVATE_EXTENSIONS	Establézcalo en 0 para deshabilitar el uso de extensiones de sitio privadas.
WEBSITE_TIME_ZONE	De manera predeterminada, la zona horaria de la aplicación siempre es UTC. Puede cambiarla a cualquiera de los valores válidos que se enumeran en las Zonas horarias predeterminadas. Si no se reconoce el valor especificado, la aplicación usa UTC. Ejemplo: Atlantic Standard Time
WEBSITE_ADD_SITENAME_BINDINGS_IN_APPHOST_CONFIG	Después de los intercambios de ranura, la aplicación puede experimentar reinicios inesperados. El motivo es que después de un intercambio, la configuración de enlace de nombre de host deja de estar sincronizada, que por sí misma no provoca reinicios. Sin embargo, determinados eventos de almacenamiento subyacentes (como las conmutaciones por error del volumen de almacenamiento) pueden detectar estas discrepancias y forzar el reinicio de todos los procesos de trabajo. Para minimizar estos tipos de reinicios, establezca el valor de configuración 1 de la aplicación en todas las ranuras. (El valor predeterminado es 0). Pero no establezca este valor si ejecuta una aplicación de Windows Communication Foundation. Para obtener más información, consulte Solucionar problemas de intercambio.
WEBSITE_PROACTIVE_AUTOHEAL_ENABLED	De forma predeterminada, una instancia de máquina virtual se corrige de forma proactiva cuando usa más del 90 % de la memoria asignada durante más de 30 segundos, o cuando el 80 % de las solicitudes totales de los últimos dos minutos tardan más de 200 segundos. Si una instancia de máquina virtual desencadena una de estas reglas, el proceso de recuperación es un reinicio superpuesto de la instancia. Establézcalo en false para deshabilitar este comportamiento de recuperación. El valor predeterminado es true. Para obtener más información, consulte la publicación del blog Presentación de Proactive Auto Heal.
WEBSITE_PROACTIVE_CRASHMONITORING_ENABLED	Cada vez que el proceso de w3wp.exe en una instancia de máquina virtual de la aplicación se bloquea debido a una excepción no controlada durante más de tres veces en 24 horas, un proceso del depurador se asocia al proceso de trabajo principal en esa instancia. El proceso del depurador recopila un volcado de memoria cuando el proceso de trabajo se bloquea de nuevo. A continuación, se analiza este volcado de memoria y la pila de llamadas del subproceso que provocó el bloqueo se registra en los registros de App Service. Establézcalo en false para deshabilitar este comportamiento de supervisión automático. El valor predeterminado es true. Para obtener más información, consulte la publicación del blog Supervisión proactiva de fallos en Azure App Service.
WEBSITE_DAAS_STORAGE_SASURI	Durante la supervisión de los bloqueos (proactiva o manual), los volcados de memoria se eliminan de manera predeterminada. Para guardar los volcados de memoria en un contenedor de blobs de almacenamiento, especifique el URI de firma de acceso compartido (SAS).
WEBSITE_CRASHMONITORING_ENABLED	Establézcalo en true para habilitar supervisión de bloqueos manualmente. También debe establecer WEBSITE_DAAS_STORAGE_SASURI y WEBSITE_CRASHMONITORING_SETTINGS. El valor predeterminado es false. Esta configuración no tiene ningún efecto si está habilitada la depuración remota. Además, si esta configuración se establece en true, se deshabilita la supervisión proactiva de bloqueos.
WEBSITE_CRASHMONITORING_SETTINGS	JSON con el formato siguiente:{"StartTimeUtc": "2020-02-10T08:21","MaxHours": "<elapsed-hours-from-StartTimeUtc>","MaxDumpCount": "<max-number-of-crash-dumps>"}. Necesario para configurar la supervisión de bloqueos si se especifica WEBSITE_CRASHMONITORING_ENABLED. Para registrar la pila de llamadas sin guardar el volcado de memoria en la cuenta de almacenamiento, agregue ,"UseStorageAccount":"false" en el JSON.
REMOTEDEBUGGINGVERSION	Versión de depuración remota.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING	De manera predeterminada, App Service crea un almacenamiento compartido durante la creación de la aplicación. Para usar una cuenta de almacenamiento personalizada en su lugar, se debe establecer en la cadena de conexión de la cuenta de almacenamiento. Para las funciones, consulte Referencia de configuración de aplicaciones para Azure Functions. Ejemplo: DefaultEndpointsProtocol=https;AccountName=<name>;AccountKey=<key>
WEBSITE_CONTENTSHARE	Cuando se especifica una cuenta de almacenamiento personalizada con WEBSITE_CONTENTAZUREFILECONNECTIONSTRING, App Service crea un recurso compartido de archivos en esa cuenta de almacenamiento para la aplicación. Para usar un nombre personalizado, establezca esta variable en el nombre que desee. Si no existe un recurso compartido de archivos con el nombre especificado, App Service lo crea automáticamente. Ejemplo: myapp123
WEBSITE_SCM_ALWAYS_ON_ENABLED	Solo lectura. Muestra si Always On está habilitado (1) o no (0).
WEBSITE_SCM_SEPARATE_STATUS	Solo lectura. Muestra si la aplicación de Kudu se ejecuta en un proceso independiente (1) o no (0).
WEBSITE_DNS_ATTEMPTS	Número de veces que se va a probar la resolución de nombres.
WEBSITE_DNS_TIMEOUT	Número de segundos que se van a esperar a la resolución de nombres.
WEBSITES_CONTAINER_START_TIME_LIMIT	Cantidad de tiempo (en segundos) que la plataforma espera a que un contenedor esté listo al iniciarse. Esta configuración se aplica a aplicaciones basadas en código y basadas en contenedores en App Service para Linux. El valor predeterminado es 230. Cuando se inicia un contenedor, los ping repetidos se realizan en el contenedor para medir su preparación para atender el tráfico orgánico. (Consulte WEBSITE_WARMUP_PATH y WEBSITE_WARMUP_STATUSES). Estos pings se realizan continuamente hasta que se recibe una respuesta correcta o se alcanza el límite de tiempo de inicio. Si el contenedor no se considera listo dentro del tiempo de espera configurado, la plataforma produce un error en el intento de inicio y los reintentos, lo que produce errores 503. En el caso de los contenedores de App Service para Windows, el límite de tiempo de inicio predeterminado es 10 mins. Puede cambiar el límite de hora de inicio especificando un intervalo de tiempo. Por ejemplo, 00:05:00 indica 5 minutos.

Prefijos de variable

En la tabla siguiente, se muestran los prefijos de variables de entorno que utiliza App Service para varios propósitos.

Nombre del valor	Descripción
APPSETTING_	Indica que el cliente establece una variable como una configuración de aplicación en la configuración de la aplicación. Se inserta en una aplicación .NET como una configuración de la aplicación.
MAINSITE_	Indica que una variable es específica de la propia aplicación.
SCMSITE_	Indica que una variable es específica de la aplicación Kudu.
SQLCONNSTR_	Cadena de conexión de SQL Server en la configuración de la aplicación. Se inserta en una aplicación .NET como una cadena de conexión.
SQLAZURECONNSTR_	Cadena de conexión de Azure SQL Database en la configuración de la aplicación. Se inserta en una aplicación .NET como una cadena de conexión.
POSTGRESQLCONNSTR_	Cadena de conexión de PostgreSQL en la configuración de la aplicación. Se inserta en una aplicación .NET como una cadena de conexión.
CUSTOMCONNSTR_	Cadena de conexión personalizada en la configuración de la aplicación. Se inserta en una aplicación .NET como una cadena de conexión.
MYSQLCONNSTR_	Cadena de conexión de base de datos MySQL en la configuración de la aplicación. Se inserta en una aplicación .NET como una cadena de conexión.
AZUREFILESSTORAGE_	Cadena de conexión a un recurso compartido personalizado para un contenedor personalizado en Azure Files.
AZUREBLOBSTORAGE_	Cadena de conexión a una cuenta de almacenamiento personalizada para un contenedor personalizado en Azure Blob Storage.
NOTIFICATIONHUBCONNSTR_	Cadena de conexión a un centro de notificaciones en Azure Notification Hubs.
SERVICEBUSCONNSTR_	Cadena de conexión a una instancia de Azure Service Bus.
EVENTHUBCONNSTR_	Cadena de conexión a un centro de eventos en Azure Event Hubs.
DOCDBCONNSTR_	Cadena de conexión a una base de datos de Azure Cosmos DB.
REDISCACHECONNSTR_	Cadena de conexión a una caché en Azure Cache for Redis.
FILESHARESTORAGE_	Cadena de conexión a un recurso compartido de archivos personalizado.

Implementación

Las siguientes variables de entorno están relacionadas con la implementación de aplicaciones. Para ver las variables relacionadas con la automatización de compilaciones de App Service, consulte Automatización de compilaciones más adelante en este artículo.

Nombre del valor	Descripción
DEPLOYMENT_BRANCH	Para una implementación de Git local o Git en la nube (como GitHub), establezca el valor en la rama de Azure en la que quiere realizar la implementación. De forma predeterminada, es master.
WEBSITE_RUN_FROM_PACKAGE	Establézcalo en 1 para ejecutar la aplicación desde un paquete ZIP local o establezca en una dirección URL externa para ejecutar la aplicación desde un paquete ZIP remoto. Para obtener más información, consulte Ejecute su aplicación en Azure App Service directamente desde un paquete ZIP.
WEBSITE_USE_ZIP	En desuso. Mediante WEBSITE_RUN_FROM_PACKAGE.
WEBSITE_RUN_FROM_ZIP	En desuso. Mediante WEBSITE_RUN_FROM_PACKAGE.
SCM_MAX_ZIP_PACKAGE_COUNT	La aplicación mantiene cinco de los archivos ZIP más recientes implementados a través de la implementación ZIP. Puede mantener más o menos cambiando la configuración de la aplicación a un número diferente.
WEBSITE_WEBDEPLOY_USE_SCM	Establezca en false para que la Herramienta de implementación web deje de usar el motor de implementación de Kudu. El valor predeterminado es true. Para implementar en aplicaciones Linux mediante Visual Studio (Web Deploy/MSDeploy), establézcalo en false.
MSDEPLOY_RENAME_LOCKED_FILES	Establezca el valor en 1 para intentar cambiar el nombre de los archivos DLL si no se pueden copiar durante una implementación de la Herramienta de implementación web. Esta configuración no es aplicable si WEBSITE_WEBDEPLOY_USE_SCM está establecido en false.
WEBSITE_DISABLE_SCM_SEPARATION	De manera predeterminada, la aplicación principal y la aplicación de Kudu se ejecutan en distintos espacios aislados. Al detener la aplicación, la aplicación Kudu todavía se está ejecutando y puede seguir usando la implementación de Git y MSDeploy. Cada aplicación tiene sus propios archivos locales. Desactivar esta separación (establecer en true) es un modo heredado que ya no es totalmente compatible.
WEBSITE_ENABLE_SYNC_UPDATE_SITE	Establezca el valor en 1 para garantizar que las llamadas a la API de REST para actualizar site y siteconfig se aplican completamente a todas las instancias antes de devolver. El valor predeterminado es 1 si va a implementar con una plantilla de Azure Resource Manager (plantilla de ARM) para evitar condiciones de carrera con llamadas posteriores de Resource Manager.
WEBSITE_START_SCM_ON_SITE_CREATION	En una implementación de plantilla de ARM, establezca el valor en 1 en la plantilla de ARM para iniciar previamente la aplicación de Kudu como parte de la creación de la aplicación.
WEBSITE_START_SCM_WITH_PRELOAD	En el caso de las aplicaciones Linux, establezca el valor en true para forzar la carga previa de la aplicación de Kudu cuando Always On esté habilitado; para ello, haga ping a su dirección URL. El valor predeterminado es false. Para aplicaciones Windows, la aplicación de Kudu siempre se carga previamente.

Automatización de compilaciones

Kudu (Windows)

La configuración de compilación de Kudu se aplica a las aplicaciones Windows nativas y se usa para controlar el comportamiento de las implementaciones basadas en Git (o basadas en ZIP).

Nombre del valor	Descripción
SCM_BUILD_ARGS	Agregue elementos al final de la línea de comandos de msbuild, de modo que invalide cualquier parte anterior de la línea de comandos predeterminada. Por ejemplo, para realizar una compilación limpia: -t:Clean;Compile.
SCM_SCRIPT_GENERATOR_ARGS	Kudu usa el azure site deploymentscript comando para generar un script de implementación. Detecta automáticamente el tipo de marco de lenguaje y determina los parámetros que se pasan al comando. Esta configuración invalida los parámetros generados automáticamente. Por ejemplo, para tratar el repositorio como archivos de contenido sin formato: --basic -p <folder-to-deploy>.
SCM_TRACE_LEVEL	Nivel de seguimiento de compilación. El valor predeterminado es 1. Establézcalo en valores superiores, hasta 4, para obtener más seguimiento.
SCM_COMMAND_IDLE_TIMEOUT	Tiempo de espera, en segundos, para cada comando que se ejecuta el proceso de compilación para esperar antes de generar cualquier salida. Después, el comando se considera inactivo y detenido. El valor predeterminado es 60 (un minuto). En Azure, también hay un tiempo de espera de solicitud de inactividad general que desconecta a los clientes después de 230 segundos. Sin embargo, el comando continúa ejecutándose en el lado servidor después de eso.
SCM_LOGSTREAM_TIMEOUT	Tiempo de espera de inactividad, en segundos, antes de detener el streaming de registros. El valor predeterminado es 1800 ( 30 minutos).
SCM_SITEEXTENSIONS_FEED_URL	Dirección URL de la galería de extensiones de sitio. El valor predeterminado es https://www.nuget.org/api/v2/. La dirección URL de la fuente anterior es http://www.siteextensions.net/api/v2/.
SCM_USE_LIBGIT2SHARP_REPOSITORY	Establezca el valor en 0 para usar git.exe en lugar de libgit2sharp para las operaciones de Git.
WEBSITE_LOAD_USER_PROFILE	En caso de recibir el error The specified user does not have a valid profile (El usuario especificado no tiene un perfil válido) durante la automatización de la compilación de ASP.NET (por ejemplo, durante la implementación de Git), establezca esta variable en 1 para cargar un perfil de usuario completo en el entorno de compilación. Esta configuración solo se aplica cuando WEBSITE_COMPUTE_MODE es Dedicated.
WEBSITE_SCM_IDLE_TIMEOUT_IN_MINUTES	Tiempo de espera, en minutos, para el sitio del Administrador de control de código fuente (Kudu). El valor predeterminado es 20.
SCM_DO_BUILD_DURING_DEPLOYMENT	Con la implementación de ZIP, el motor de implementación supone que un archivo ZIP está listo para ejecutarse tal como está y no ejecuta ninguna automatización de compilación. Para habilitar la misma automatización de compilación que en la implementación de Git, establezca en true.

Oryx (Linux)

La configuración de compilación de Oryx se aplica a las aplicaciones Linux y se usa para controlar el comportamiento de las implementaciones basadas en Git (o basadas en ZIP). Consulte Configuración de Oryx.

Opciones específicas del lenguaje

En esta sección, se muestra la configuración en tiempo de ejecución que se puede configurar para cada marco de lenguaje admitido. Hay más opciones de configuración disponibles durante la automatización de la compilación en el momento de la implementación.

.NET

Nombre del valor	Descripción
PORT	Solo lectura. En el caso de las aplicaciones de Linux, el puerto al que escucha el entorno de ejecución de .NET en el contenedor.
WEBSITE_ROLE_INSTANCE_ID	Solo lectura. Identificador de la instancia actual.
HOME	Solo lectura. Directorio que apunta al almacenamiento compartido (/home).
DUMP_DIR	Solo lectura. Directorio para los volcados de memoria (/home/logs/dumps).
APP_SVC_RUN_FROM_COPY	Solo aplicaciones Linux. De manera predeterminada, la aplicación se ejecuta desde /home/site/wwwroot, un directorio compartido para todas las instancias de escalado horizontal. Establezca esta variable en true para copiar la aplicación en un directorio local del contenedor y ejecutarla desde allí. Cuando use esta opción, asegúrese de no codificar de forma rígida ninguna referencia a /home/site/wwwroot. En su lugar, use una ruta de acceso relativa a /home/site/wwwroot.
MACHINEKEY_Decryption	Para las aplicaciones nativas de Windows o las aplicaciones de Windows en contenedores, esta variable se inyecta en un entorno de aplicación o un contenedor para habilitar rutinas criptográficas ASP.NET. (Consulte elemento machineKey). Para invalidar el valor predeterminado de decryption, configúrelo como una configuración de aplicación de App Service o establézcalo directamente en el elemento machineKey del archivo Web.config.
MACHINEKEY_DecryptionKey	Para las aplicaciones nativas de Windows o las aplicaciones de Windows en contenedores, esta variable se inyecta en el entorno de la aplicación o el contenedor para habilitar las rutinas criptográficas ASP.NET. (Consulte elemento machineKey). Para invalidar el valor de decryptionKey generado automáticamente, configúrelo como una configuración de aplicación de App Service o establézcalo directamente en el elemento machineKey del archivo Web.config.
MACHINEKEY_Validation	Para las aplicaciones nativas de Windows o las aplicaciones de Windows en contenedores, esta variable se inyecta en el entorno de la aplicación o el contenedor para habilitar las rutinas criptográficas ASP.NET. (Consulte elemento machineKey). Para invalidar el valor predeterminado de validation, configúrelo como una configuración de aplicación de App Service o establézcalo directamente en el elemento machineKey del archivo Web.config.
MACHINEKEY_ValidationKey	Para las aplicaciones nativas de Windows o las aplicaciones de Windows en contenedores, esta variable se inyecta en el entorno de la aplicación o el contenedor para habilitar las rutinas criptográficas ASP.NET. (Consulte elemento machineKey). Para invalidar el valor de validationKey generado automáticamente, configúrelo como una configuración de aplicación de App Service o establézcalo directamente en el elemento machineKey del archivo Web.config.

Java

Nombre del valor	Descripción
JAVA_HOME	Ruta de acceso del directorio de instalación de Java.
JAVA_OPTS	En el caso de las aplicaciones de Java Standard Edition (SE), las variables de entorno que se van a pasar al comando java. Pueden contener variables del sistema. Para Tomcat, use CATALINA_OPTS. Ejemplo: -Dmysysproperty=%DRIVEPATH%
AZURE_JAVA_APP_PATH	Variable de entorno que los scripts personalizados pueden usar para que tengan una ubicación para app.jar después de copiarlos en una ubicación local.
SKIP_JAVA_KEYSTORE_LOAD	Establezca un valor de 1 para deshabilitar App Service para cargar automáticamente los certificados en el almacén de claves.
WEBSITE_JAVA_JAR_FILE_NAME	Archivo .jar que se va a utilizar. Anexa .jar si la cadena no termina en .jar. Su valor predeterminado es app.jar.
WEBSITE_JAVA_WAR_FILE_NAME	Archivo .war que se va a utilizar. Anexa .war si la cadena no termina en .war. Su valor predeterminado es app.war.
JAVA_ARGS	JAVA_OPTS valor requerido por un servidor web java diferente. Su valor predeterminado es -noverify -Djava.net.preferIPv4Stack=true.
JAVA_WEBSERVER_PORT_ENVIRONMENT_VARIABLES	Variables de entorno usadas por marcos web de Java populares para puertos de servidor. Los marcos incluyen Spring, Micronaut, Grails, Helidon, Ratpack y Quarkus.
JAVA_TMP_DIR	Se ha agregado a los argumentos de Java como -Dsite.tempdir. Su valor predeterminado es TEMP.
WEBSITE_SKIP_LOCAL_COPY	De forma predeterminada, el archivo implementado app.jar se copia de /home/site/wwwroot a una ubicación local. Para deshabilitar este comportamiento y cargar app.jar directamente desde /home/site/wwwroot, establezca esta variable 1 en o true. Esta configuración no tiene ningún efecto si la memoria caché local está habilitada.
TOMCAT_USE_STARTUP_BAT	Solo aplicaciones Windows nativas. De manera predeterminada, el servidor Tomcat se inicia con su archivo startup.bat. Para establecer el servidor de Tomcat para que empiece por usar su archivo catalina.bat en su lugar, establezca el valor 0 en o False. Ejemplo: %LOCAL_EXPANDED%\tomcat
CATALINA_OPTS	En el caso de las aplicaciones de Tomcat, las variables de entorno se pasan en el comando java. Puede contener variables del sistema.
CATALINA_BASE	Para usar una instalación personalizada de Tomcat, establezca el valor en la ubicación de la instalación.
WEBSITE_JAVA_MAX_HEAP_MB	Montón máximo de Java en megabytes. Esta configuración solo es efectiva cuando se usa una versión experimental de Tomcat.
WEBSITE_DISABLE_JAVA_HEAP_CONFIGURATION	Para deshabilitar manualmente WEBSITE_JAVA_MAX_HEAP_MB, establezca esta variable en true o 1.
WEBSITE_AUTH_SKIP_PRINCIPAL	De forma predeterminada, las siguientes interfaces Para deshabilitarlo, establezca el valor en 1.
WEBSITE_AUTH_EXPIRED_SESSION_LOGOFF	Si una aplicación web usa EasyAuth, establézcalo en true o 1 para forzar una redirección a la página de cierre de sesión de EasyAuth si la sesión asociada a una solicitud ha expirado (por ejemplo, para las aplicaciones web que se ejecutan en Tomcat, se define mediante el elemento session-timeout del archivo web.xml).
WEBSITE_SKIP_FILTERS	Para deshabilitar todos los filtros de servlet que agregó App Service, establezca en 1.
IGNORE_CATALINA_BASE	De manera predeterminada, App Service comprueba si la variable CATALINA_BASE de Tomcat está definida. Si no lo está, busca la existencia de %HOME%\tomcat\conf\server.xml. Si existe el archivo, establece CATALINA_BASE en %HOME%\tomcat. Para deshabilitar este comportamiento y quitar CATALINA_BASE, establezca esta variable en 1 o true.
PORT	Solo lectura. En el caso de las aplicaciones de Linux, el puerto al que escucha el entorno de ejecución de Java en el contenedor.
WILDFLY_VERSION	Solo lectura. Para las aplicaciones Linux de JBoss Enterprise Application Platform (EAP), la versión WildFly.
TOMCAT_VERSION	Solo lectura. En el caso de las aplicaciones de Tomcat para Linux, la versión de Tomcat.
JBOSS_HOME	Solo lectura. En el caso de las aplicaciones de JBoss EAP (Linux), la ruta de acceso de la instalación de WildFly.
AZURE_JETTY9_CMDLINE	Solo lectura. Para las aplicaciones nativas de Windows, los argumentos de la línea de comandos para iniciar Jetty 9.
AZURE_JETTY9_HOME	Solo lectura. En el caso de las aplicaciones nativas de Windows, la ruta de acceso a la instalación de Jetty 9.
AZURE_JETTY93_CMDLINE	Solo lectura. Para las aplicaciones nativas de Windows, especifica los argumentos de la línea de comandos para iniciar Jetty 9.3.
AZURE_JETTY93_HOME	Solo lectura. En el caso de las aplicaciones nativas de Windows, la ruta de acceso a la instalación de Jetty 9.3.
AZURE_TOMCAT7_CMDLINE	Solo lectura. Para las aplicaciones nativas de Windows, especifica los argumentos de la línea de comandos para iniciar Tomcat 7.
AZURE_TOMCAT7_HOME	Solo lectura. En el caso de las aplicaciones nativas de Windows, la ruta de acceso a la instalación de Tomcat 7.
AZURE_TOMCAT8_CMDLINE	Solo lectura. Para las aplicaciones nativas de Windows, especifica los argumentos de la línea de comandos para iniciar Tomcat 8.
AZURE_TOMCAT8_HOME	Solo lectura. En el caso de las aplicaciones nativas de Windows, la ruta de acceso a la instalación de Tomcat 8.
AZURE_TOMCAT85_CMDLINE	Solo lectura. Para las aplicaciones nativas de Windows, especifica los argumentos de la línea de comandos para iniciar Tomcat 8.5.
AZURE_TOMCAT85_HOME	Solo lectura. En el caso de las aplicaciones nativas de Windows, la ruta de acceso a la instalación de Tomcat 8.5.
AZURE_TOMCAT90_CMDLINE	Solo lectura. Para las aplicaciones nativas de Windows, especifica los argumentos de la línea de comandos para iniciar Tomcat 9.
AZURE_TOMCAT90_HOME	Solo lectura. En el caso de las aplicaciones nativas de Windows, la ruta de acceso a la instalación de Tomcat 9.
AZURE_SITE_HOME	Valor agregado a los argumentos de Java como -Dsite.home. El valor predeterminado es el valor de HOME.
HTTP_PLATFORM_PORT	Se ha agregado a los argumentos de Java como -Dport.http. Las siguientes variables de entorno utilizadas por diferentes marcos web de Java también se establecen en este valor: SERVER_PORT, MICRONAUT_SERVER_PORT, RATPACK_PORT, QUARKUS_HTTP_PORT, PAYARAMICRO_PORT.
AZURE_LOGGING_DIR	En el caso de las aplicaciones de Windows, se ha agregado a los argumentos de Java como -Dsite.logdir. El valor predeterminado es %HOME%\LogFiles\. El valor predeterminado en Linux es AZURE_LOGGING_DIR=/home/LogFiles.

Node.js

Nombre del valor	Descripción
PORT	Solo lectura. En el caso de las aplicaciones de Linux, el puerto al que escucha la aplicación Node.js en el contenedor.
WEBSITE_ROLE_INSTANCE_ID	Solo lectura. Identificador de la instancia actual.
PM2HOME
WEBSITE_NODE_DEFAULT_VERSION	En el caso de las aplicaciones nativas de Windows, la versión predeterminada del nodo que usa la aplicación. Puede usar cualquiera de las versiones de Node.js admitidas aquí.

Pitón

Nombre del valor	Descripción
APPSVC_VIRTUAL_ENV	Solo lectura.
PORT	Solo lectura. Para las aplicaciones de Linux, el puerto que la aplicación Python escucha en el contenedor.

PHP

Nombre del valor	Descripción
PHP_Extensions	Lista separada por comas de extensiones de PHP. Ejemplo: extension1.dll,extension2.dll,Name1=value1
PHP_ZENDEXTENSIONS	En el caso de las aplicaciones de Linux, establezca en xdebug para usar la versión Xdebug del contenedor PHP.
PHP_VERSION	Solo lectura. Versión de PHP seleccionada.
WEBSITE_PORT	Solo lectura. Puerto al que escucha el servidor Apache en el contenedor.
WEBSITE_ROLE_INSTANCE_ID	Solo lectura. Identificador de la instancia actual.
WEBSITE_PROFILER_ENABLE_TRIGGER	Establezca el valor en TRUE para agregar xdebug.profiler_enable_trigger=1 y xdebug.profiler_enable=0 al archivo predeterminado php.ini.

Rubí

Nombre del valor	Descripción
PORT	Solo lectura. Puerto en el que escucha la aplicación de Rails en el contenedor.
WEBSITE_ROLE_INSTANCE_ID	Solo lectura. Identificador de la instancia actual.
RAILS_IGNORE_SPLASH	De manera predeterminada, se muestra una página de presentación predeterminada cuando no se encuentra ningún archivo Gemfile. Establezca esta variable en cualquier valor para deshabilitar la página de presentación.
BUNDLE_WITHOUT	Para agregar --without opciones a bundle install, establezca la variable en los grupos que desea excluir, separados por un espacio. De manera predeterminada, se instalan todos los gems. Ejemplo: test development
BUNDLE_INSTALL_LOCATION	Directorio para instalar gems. El valor predeterminado es /tmp/bundle.
RUBY_SITE_CONFIG_DIR	Directorio de configuración del sitio. El valor predeterminado es /home/site/config. El contenedor comprueba si hay gems comprimidos en este directorio.
SECRET_KEY_BASE	De manera predeterminada, se genera una base de clave secreta aleatoria. Para usar una base de clave secreta personalizada, establezca esta variable en la base de clave deseada.
RAILS_ENV	Entorno de Rails. El valor predeterminado es production.
GEM_PRISTINE	Establezca esta variable en cualquier valor para ejecutar gem pristine --all.

WordPress

Configuración de aplicación	Ámbito	Valor	Máxima	Descripción
WEBSITES_ENABLE_APP_SERVICE_STORAGE	Aplicación web	true	No aplicable	Cuando se establece en true, el contenido del archivo se conserva durante los reinicios.
WP_MEMORY_LIMIT	WordPress	128M	512M	Límite general de memoria PHP de WordPress o front-end (por script). No puede ser más que PHP_MEMORY_LIMIT.
WP_MAX_MEMORY_LIMIT	WordPress	256M	512M	Límite de memoria PHP del panel de administración (por script). Por lo general, el panel de administración y los scripts de back-end toman mucha memoria en comparación con los scripts de front-end. No puede ser más que PHP_MEMORY_LIMIT.
PHP_MEMORY_LIMIT	PHP	512M	512M	Límite de memoria para scripts PHP generales. Solo se puede reducir.
FILE_UPLOADS	PHP	On	No aplicable	Habilita o deshabilita las cargas de archivos. Puede ser On o Off. Tenga en cuenta que los valores distinguen mayúsculas de minúsculas.
UPLOAD_MAX_FILESIZE	PHP	50M	256M	Límite de tamaño para la carga de archivos. Se puede aumentar hasta 256M.
POST_MAX_SIZE	PHP	128M	256M	Se puede aumentar hasta 256M. Por lo general, debe ser mayor que UPLOAD_MAX_FILESIZE.
MAX_EXECUTION_TIME	PHP	120	120	Solo se puede reducir. Desglosar los scripts si tarda más de 120 segundos. Se ha agregado para evitar que los scripts con errores ralenticen el sistema.
MAX_INPUT_TIME	PHP	120	120	Límite de tiempo para analizar las solicitudes de entrada. Solo se puede reducir.
MAX_INPUT_VARS	PHP	10000	10000	Número máximo de variables para las solicitudes de entrada.
DATABASE_HOST	Base de datos	No aplicable	No aplicable	Host de la base de datos que se usa para conectarse a WordPress.
DATABASE_NAME	Base de datos	No aplicable	No aplicable	Nombre de la base de datos que se usa para conectarse a WordPress.
DATABASE_USERNAME	Base de datos	No aplicable	No aplicable	Nombre de usuario de la base de datos que se usa para conectarse a WordPress.
DATABASE_PASSWORD	Base de datos	No aplicable	No aplicable	Contraseña de base de datos usada para conectarse a la base de datos MySQL. Para cambiar la contraseña de base de datos MySQL, consulte Actualizar la contraseña del administrador. Siempre que se cambie la contraseña de la base de datos MySQL, también es necesario actualizar la configuración de la aplicación.
WORDPRESS_ADMIN_EMAIL	Solo implementación	No aplicable	No aplicable	Correo electrónico de administrador de WordPress.
WORDPRESS_ADMIN_PASSWORD	Solo implementación	No aplicable	No aplicable	Contraseña de administrador de WordPress. Esta configuración solo es para fines de implementación. La modificación de este valor no tiene ningún efecto en la instalación de WordPress. Para cambiar la contraseña de administrador de WordPress, consulte Restablezca la contraseña.
WORDPRESS_ADMIN_USER	Solo implementación	No aplicable	No aplicable	Nombre de usuario del administrador de WordPress.
WORDPRESS_ADMIN_LOCALE_CODE	Solo implementación	No aplicable	No aplicable	Nombre de usuario de la base de datos que se usa para conectarse a WordPress.

Dominio y DNS

Nombre del valor	Descripción
WEBSITE_DNS_SERVER	Dirección IP del servidor DNS principal para las conexiones salientes (por ejemplo, a un servicio back-end). El servidor DNS predeterminado de App Service es Azure DNS, cuya dirección IP es 168.63.129.16. Si la aplicación usa la integración de red virtual o está en un entorno de App Service, hereda la configuración del servidor DNS de la red virtual de forma predeterminada. Ejemplo: 10.0.0.1
WEBSITE_DNS_ALT_SERVER	Dirección IP del servidor DNS de reserva para las conexiones salientes. Vea WEBSITE_DNS_SERVER.
WEBSITE_ENABLE_DNS_CACHE	Permite almacenar en caché las resoluciones DNS correctas. De forma predeterminada, las entradas de caché DNS expiradas se vacían (además de la caché existente) cada 4,5 minutos.

TLS/SSL

Para obtener más información, consulte Usar un certificado SSL en el código de Azure App Service.

Nombre del valor	Descripción
WEBSITE_LOAD_CERTIFICATES	Valores de huella digital separados por comas en el certificado que desea cargar en el código. O bien, use * para permitir que todos los certificados se carguen en el código. Solo se pueden cargar los certificados agregados a la aplicación.
WEBSITE_PRIVATE_CERTS_PATH	Solo lectura. Ruta de acceso en un contenedor Windows a los certificados privados cargados.
WEBSITE_PUBLIC_CERTS_PATH	Solo lectura. Ruta de acceso en un contenedor Windows a los certificados públicos cargados.
WEBSITE_INTERMEDIATE_CERTS_PATH	Solo lectura. Ruta de acceso en un contenedor Windows a los certificados intermedios cargados.
WEBSITE_ROOT_CERTS_PATH	Solo lectura. Ruta de acceso en un contenedor Windows a los certificados raíz cargados.

Ranuras de implementación

Para más información sobre las ranuras de implementación, consulte Configuración de entornos de ensayo en Azure App Service.

Nombre del valor	Descripción
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS	De manera predeterminada, las versiones de las extensiones de sitio son específicas de cada ranura. Este valor predeterminado impide el comportamiento de la aplicación imprevisto debido a la modificación de las versiones de extensión después de un intercambio. Si desea que las versiones de extensión también cambien, establezca en 0 en todas las ranuras.
WEBSITE_OVERRIDE_PRESERVE_DEFAULT_STICKY_SLOT_SETTINGS	Designa determinadas opciones como permanentes o no intercambiables de manera predeterminada. El valor predeterminado es true. Establezca este valor false en o 0 para todas las ranuras de implementación para que se puedan intercambiar en su lugar. No hay ningún control específico para tipos de configuración específicos.
WEBSITE_SWAP_WARMUP_PING_PATH	Ruta de acceso para hacer ping para activar la ranura de destino en un intercambio; comienza por una barra diagonal. El valor predeterminado es /, que hace ping a la ruta de acceso raíz sobre HTTP. Ejemplo: /statuscheck
WEBSITE_SWAP_WARMUP_PING_STATUSES	Códigos de respuesta HTTP válidos para la operación de activación durante un intercambio. Si el código de estado devuelto no está en la lista, las operaciones de preparación e intercambio se detienen. Por defecto, todos los códigos de respuesta son válidos. Ejemplo: 200,202
WEBSITE_SLOT_NUMBER_OF_TIMEOUTS_BEFORE_RESTART	Durante un intercambio de ranuras, el número máximo de tiempos de espera antes de un reinicio forzado del sitio en una instancia de máquina virtual específica. El valor predeterminado es 3.
WEBSITE_SLOT_MAX_NUMBER_OF_TIMEOUTS	Durante un intercambio de ranura, número máximo de solicitudes de tiempo de espera para una única dirección URL que se debe realizar antes de desistir. El valor predeterminado es 5.
WEBSITE_SKIP_ALL_BINDINGS_IN_APPHOST_CONFIG	Establezca el valor en true o 1 para omitir todos los enlaces en el archivo applicationHost.config. El valor predeterminado es false. Si la aplicación desencadena un reinicio porque applicationHost.config se actualiza con los nombres de host intercambiados de las ranuras, establezca esta variable en true evitar un reinicio de este tipo. Si ejecuta una aplicación de Windows Communication Foundation, no establezca esta variable.

Contenedores personalizados

Para más información sobre los contenedores personalizados, consulte Ejecución de un contenedor personalizado en Azure.

Nombre del valor	Descripción
WEBSITES_ENABLE_APP_SERVICE_STORAGE	En el caso de los contenedores de Linux, si no se especifica esta configuración de aplicación, el directorio /home se comparte entre instancias escaladas de forma predeterminada. Puede establecerlo en false para deshabilitar el uso compartido. Para contenedores de Windows, establezca el valor en true para permitir que el directorio c:\home se comparta entre instancias escaladas. El valor predeterminado es true para los contenedores de Windows.
WEBSITES_CONTAINER_STOP_TIME_LIMIT	Cantidad de tiempo, en segundos, para esperar a que el contenedor finalice correctamente. El valor predeterminado es 5. Puede aumentar hasta un máximo de 120.
DOCKER_REGISTRY_SERVER_URL	Dirección URL del servidor del registro cuando se ejecuta un contenedor personalizado en App Service. Por motivos de seguridad, no se pasa esta variable al contenedor. Ejemplo: https://<server-name>.azurecr.io
DOCKER_REGISTRY_SERVER_USERNAME	Nombre de usuario para autenticarse en el servidor del registro en DOCKER_REGISTRY_SERVER_URL. Por motivos de seguridad, no se pasa esta variable al contenedor.
DOCKER_REGISTRY_SERVER_PASSWORD	Contraseña para autenticarse en el servidor del registro en DOCKER_REGISTRY_SERVER_URL. Por motivos de seguridad, no se pasa esta variable al contenedor.
DOCKER_ENABLE_CI	Establézcalo en true para habilitar la implementación continua para contenedores personalizados. El valor predeterminado es false para los contenedores personalizados.
WEBSITE_PULL_IMAGE_OVER_VNET	Conéctese y extraiga de un registro dentro de una red virtual o local. La aplicación debe estar conectada a una red virtual a través de la característica de integración de red virtual. Esta configuración también es necesaria para Azure Container Registry con un punto de conexión privado.
WEBSITES_WEB_CONTAINER_NAME	En una aplicación de Docker Compose, solo uno de los contenedores puede ser accesible desde Internet. Establezca el valor en el nombre del contenedor definido en el archivo de configuración para invalidar la selección de contenedor predeterminada. De forma predeterminada, el contenedor accesible para Internet es el primer contenedor para definir el puerto 80 o 8080. Cuando no se encuentra este contenedor, el valor predeterminado es el primer contenedor definido en el archivo de configuración.
WEBSITES_PORT	Para un contenedor personalizado, el número de puerto personalizado del contenedor de App Service al que se van a enrutar las solicitudes. De manera predeterminada, App Service intenta la detección automática de los puertos 80 y 8080. Esta configuración no se inserta en el contenedor como variable de entorno.
WEBSITE_CPU_CORES_LIMIT	De forma predeterminada, un contenedor de Windows se ejecuta con todos los núcleos disponibles del plan de tarifa elegido. Para reducir el número de núcleos, establezca un límite en el número de núcleos deseados. Para obtener más información, consulte Personalizar el número de núcleos de proceso.
WEBSITE_MEMORY_LIMIT_MB	De forma predeterminada, todos los contenedores de Windows implementados en App Service tienen configurado un límite de memoria, en función del nivel del plan de App Service. Establezca en el límite de memoria deseado en megabytes. El total acumulado de esta configuración entre las aplicaciones del mismo plan no debe superar la cantidad que permite el plan de tarifa elegido. Para más información, consulte Personalizar la memoria del contenedor.

Escalado

Nombre del valor	Descripción
WEBSITE_INSTANCE_ID	Solo lectura. Identificador único de la instancia de máquina virtual actual cuando la aplicación se escala horizontalmente a varias instancias.
WEBSITE_IIS_SITE_NAME	En desuso. Mediante WEBSITE_INSTANCE_ID.
WEBSITE_DISABLE_OVERLAPPED_RECYCLING	El reciclaje superpuesto garantiza que antes de que se apague la instancia de máquina virtual actual de una aplicación, se inicia una nueva instancia de máquina virtual. En algunos casos, puede provocar problemas de bloqueo de archivos. Puede probar a desactivarlo; para ello, establezca el valor en 1.
WEBSITE_DISABLE_CROSS_STAMP_SCALE	De manera predeterminada, las aplicaciones pueden escalar entre stamps si usan Azure Files o un contenedor de Docker. Establezca el valor en 1 o true para deshabilitar el escalado entre unidades de escalado dentro de la región de la aplicación. El valor predeterminado es 0. Los contenedores de Docker personalizados que establecen WEBSITES_ENABLE_APP_SERVICE_STORAGE en true o 1 no se pueden escalar entre unidades de escalado porque su contenido no está completamente encapsulado en el contenedor de Docker.

Registro

Nombre del valor	Descripción
WEBSITE_HTTPLOGGING_ENABLED	Solo lectura. Muestra si el registro del servidor web para aplicaciones nativas de Windows está habilitado (1) o no (0).
WEBSITE_HTTPLOGGING_RETENTION_DAYS	Período de retención (en días) de registros de servidor web, si los registros de servidor web están habilitados para una aplicación nativa de Windows o Linux. Ejemplo: 10
WEBSITE_HTTPLOGGING_CONTAINER_URL	Dirección URL de SAS del contenedor de Blob Storage para almacenar registros de servidor web para aplicaciones nativas de Windows, si los registros del servidor web están habilitados. Si no se establece, los registros del servidor web se almacenan en el sistema de archivos de la aplicación (almacenamiento compartido predeterminado).
DIAGNOSTICS_AZUREBLOBRETENTIONINDAYS	Período de retención (en días) de registros de aplicaciones para aplicaciones nativas de Windows, si los registros de aplicaciones están habilitados. Ejemplo: 10
DIAGNOSTICS_AZUREBLOBCONTAINERSASURL	Dirección URL de SAS del contenedor de Blob Storage para almacenar registros de aplicaciones para aplicaciones nativas de Windows, si los registros de aplicaciones están habilitados.
APPSERVICEAPPLOGS_TRACE_LEVEL	Nivel mínimo de registro que se va a enviar a Log Analytics para el tipo de registro AppServiceAppLogs.
DIAGNOSTICS_LASTRESORTFILE	Nombre de archivo para crear, o ruta de acceso relativa al directorio de registro, para registrar errores internos para solucionar problemas del agente de escucha. El valor predeterminado es logging-errors.txt.
DIAGNOSTICS_LOGGINGSETTINGSFILE	Ruta de acceso al archivo de configuración de registro, relativa a D:\home o /home. El valor predeterminado es site\diagnostics\settings.json.
DIAGNOSTICS_TEXTTRACELOGDIRECTORY	Carpeta de registro, relativa a la raíz de la aplicación (D:\home\site\wwwroot o /home/site/wwwroot). Ejemplo: ..\..\LogFiles\Application
DIAGNOSTICS_TEXTTRACEMAXLOGFILESIZEBYTES	Tamaño máximo del archivo de registro en bytes. El valor predeterminado es 131072 (128 KB).
DIAGNOSTICS_TEXTTRACEMAXLOGFOLDERSIZEBYTES	Tamaño máximo de la carpeta de registro en bytes. El valor predeterminado es 1048576 (1 MB).
DIAGNOSTICS_TEXTTRACEMAXNUMLOGFILES	Número máximo de archivos de registro que se van a conservar. El valor predeterminado es 20.
DIAGNOSTICS_TEXTTRACETURNOFFPERIOD	Tiempo de espera, en milisegundos, para mantener habilitado el registro de aplicaciones. El valor predeterminado es 43200000 (12 horas).
WEBSITE_LOG_BUFFERING	El almacenamiento en búfer del registro está habilitado de manera predeterminada. Para deshabilitarlo, establezca el valor en 0.
WEBSITE_ENABLE_PERF_MODE	Para aplicaciones Windows nativas, establezca el valor en TRUE para desactivar las entradas del registro de IIS para las solicitudes correctas devueltas en un plazo de 10 segundos. Se trata de una manera rápida de establecer un punto de referencia de rendimiento mediante la eliminación del registro extendido.

Contadores de rendimiento

A continuación se muestran variables de entorno "falsas" que no existen si las enumera, pero devuelven su valor si las busca individualmente. El valor es dinámico y puede cambiar en cada búsqueda.

Nombre del valor	Descripción
WEBSITE_COUNTERS_ASPNET	Objeto JSON que contiene contadores de rendimiento ASP.NET.
WEBSITE_COUNTERS_APP	Objeto JSON que contiene contadores de espacio aislado.
WEBSITE_COUNTERS_CLR	Objeto JSON que contiene contadores de Common Language Runtime.
WEBSITE_COUNTERS_ALL	Objeto JSON que contiene la combinación de las otras tres variables.

Almacenamiento en caché

Nombre del valor	Descripción
WEBSITE_LOCAL_CACHE_OPTION	Determina si la memoria caché local está habilitada. Las opciones disponibles son la siguientes: - Default: hereda la configuración global de nivel de sello. - Always: habilitar para la aplicación. - OnStorageUnavailability - Disabled: deshabilitar para la aplicación.
WEBSITE_LOCAL_CACHE_READWRITE_OPTION	Opciones de lectura y escritura de la caché local. Las opciones disponibles son la siguientes: - ReadOnly: la memoria caché es de solo lectura. - WriteButDiscardChanges: permite escrituras en la memoria caché local, pero descarta los cambios realizados localmente.
WEBSITE_LOCAL_CACHE_SIZEINMB	Tamaño de la caché local en megabytes. El valor predeterminado es 1000 (1 GB).
WEBSITE_LOCALCACHE_READY	Marca de solo lectura que indica si la aplicación usa la caché local.
WEBSITE_DYNAMIC_CACHE	Debido a la naturaleza del recurso compartido de archivos de red para permitir el acceso a varias instancias, la caché dinámica mejora el rendimiento almacenando en caché los archivos a los que se accede recientemente localmente en una instancia. La memoria caché se invalida cuando se modifica el archivo. La ubicación de la caché es %SYSTEMDRIVE%\local\DynamicCache. (Se aplica la misma cuota %SYSTEMDRIVE%\local). Para habilitar el almacenamiento en caché de contenido completo, establezca en 1, que incluye el contenido del archivo y los metadatos de directorio o archivo (marcas de tiempo, tamaño, contenido del directorio). Para conservar el uso del disco local, establezca en 2 para almacenar en caché solo los metadatos de directorio o archivo (marcas de tiempo, tamaño y contenido del directorio). Para desactivar el almacenamiento en caché, establezca el valor en 0. Tanto en el caso de las aplicaciones de Windows, como en el de las aplicaciones de Linux creadas con la plantilla de WordPress, el valor predeterminado es 1. En las restantes aplicaciones de Linux, el valor predeterminado es 0.
WEBSITE_READONLY_APP	Al usar una caché dinámica, puede deshabilitar el acceso de escritura a la raíz de la aplicación (D:\home\site\wwwroot o /home/site/wwwroot) estableciendo esta variable en 1. Excepto para el directorio App_Data, no se permiten bloqueos exclusivos para que los archivos bloqueados no bloqueen las implementaciones.

Redes

Las siguientes variables de entorno están relacionadas con las conexiones híbridas y la integración de red virtual.

Nombre del valor	Descripción
WEBSITE_RELAYS	Solo lectura. Datos necesarios para configurar la conexión híbrida, incluidos los puntos de conexión y los datos de Service Bus.
WEBSITE_REWRITE_TABLE	Solo lectura. Se usa en tiempo de ejecución para realizar las búsquedas y reescribir las conexiones correctamente.
WEBSITE_VNET_ROUTE_ALL	De forma predeterminada, si usa la integración de red virtual regional, la aplicación solo enruta RFC1918 tráfico a la red virtual. Establézcalo en 1 para enrutar todo el tráfico saliente a la red virtual y estar sujeto a los mismos grupos de seguridad de red y rutas definidas por el usuario. La configuración le permite acceder a los puntos de conexión que no son de RFC1918 a través de la red virtual, proteger todo el tráfico saliente que sale de la aplicación y forzar el túnel de todo el tráfico saliente a un dispositivo de red de su elección.
WEBSITE_PRIVATE_IP	Solo lectura. Dirección IP asociada a la aplicación integrada con una red virtual. Para la integración de red virtual regional, el valor es una dirección IP del intervalo de direcciones de la subred delegada. Para la integración de red virtual con requisito de puerta de enlace, el valor es una dirección IP del intervalo de direcciones del grupo de direcciones de punto a sitio configurado en la puerta de enlace de red virtual. La aplicación usa esta dirección IP para conectarse a los recursos a través de la red virtual. Además, puede cambiar dentro del intervalo de direcciones descrito.
WEBSITE_PRIVATE_PORTS	Solo lectura. En la integración de red virtual, muestra qué puertos puede usar la aplicación para comunicarse con otros nodos.
WEBSITE_CONTENTOVERVNET	Si va a montar un recurso compartido de archivos de Azure en App Service y la cuenta de almacenamiento está restringida a una red virtual, habilite esta configuración con un valor de 1.

Referencias del almacén de claves

Las siguientes variables de entorno están relacionadas con las referencias de Key Vault.

Nombre del valor	Descripción
WEBSITE_KEYVAULT_REFERENCES	Solo lectura. Contiene información (incluidos los estados) para todas las referencias del almacén de claves que están configuradas actualmente en la aplicación.
WEBSITE_SKIP_CONTENTSHARE_VALIDATION	Si establece la conexión de almacenamiento compartido de la aplicación (mediante WEBSITE_CONTENTAZUREFILECONNECTIONSTRING) en una referencia de almacén de claves, la aplicación no puede resolver la referencia del almacén de claves en la creación de la aplicación o actualizar si se cumple una de las condiciones siguientes: - La aplicación accede al almacén de claves mediante una identidad asignada por el sistema. - La aplicación accede al almacén de claves mediante una identidad asignada por el usuario y el almacén de claves está bloqueado con una red virtual. Para evitar errores en tiempo de creación o actualización, establezca esta variable en 1.
WEBSITE_DELAY_CERT_DELETION	Establecer esta variable de entorno en 1 garantiza que un certificado del que depende un proceso de trabajo no se elimine hasta que salga.

CORS

Las siguientes variables de entorno están relacionadas con la configuración de uso compartido de recursos entre orígenes (CORS).

Nombre del valor	Descripción
WEBSITE_CORS_ALLOWED_ORIGINS	Solo lectura. Muestra los orígenes permitidos para CORS.
WEBSITE_CORS_SUPPORT_CREDENTIALS	Solo lectura. Muestra si establecer el encabezado Access-Control-Allow-Credentials en true está habilitado (True) o no (False).

Autenticación y autorización

Las siguientes variables de entorno están relacionadas con la autenticación de App Service.

Nombre del valor	Descripción
WEBSITE_AUTH_DISABLE_IDENTITY_FLOW	Cuando se establece en true, deshabilita la asignación de la identidad de entidad de seguridad del subproceso en ASP. Aplicaciones web basadas en NET (incluidas las aplicaciones de funciones v1). Esta funcionalidad permite a los desarrolladores proteger el acceso a su sitio con autenticación, pero todavía tienen que usar un mecanismo de inicio de sesión independiente dentro de la lógica de la aplicación. El valor predeterminado es false.
WEBSITE_AUTH_HIDE_DEPRECATED_SID	true o false. El valor predeterminado es false. Se trata de una configuración para la integración heredada de Mobile Apps para Azure App Service. Al establecer el valor en true se resuelve un problema por el que el identificador de seguridad generado para los usuarios autenticados podría cambiar si el usuario cambia su información de perfil. Cambiar este valor puede hacer que los identificadores de usuario de Azure Mobile Apps existentes cambien. La mayoría de las aplicaciones no necesitan usar esta configuración.
WEBSITE_AUTH_NONCE_DURATION	Valor de intervalo de tiempo con el formato hours:minutes:seconds. El valor predeterminado es 00:05:00 (5 minutos). Esta configuración controla la duración del nonce criptográfico generado para todos los inicios de sesión controlados por el explorador. Si no se puede finalizar un inicio de sesión en el tiempo especificado, el flujo de inicio de sesión se reintenta automáticamente. Esta configuración de aplicación está pensada para su uso con la experiencia de configuración V1 (clásica). Si usa el esquema de configuración de autenticación V2, en su lugar debe usar el valor de configuración login.nonce.nonceExpirationInterval.
WEBSITE_AUTH_PRESERVE_URL_FRAGMENT	Cuando se establece en true y los usuarios seleccionan vínculos de aplicación que contienen fragmentos de dirección URL, el proceso de inicio de sesión garantiza que la parte del fragmento de dirección URL de la dirección URL no se pierda en el proceso de redirección de inicio de sesión. Para más información, consulte Personalizar el inicio y cierre de sesión en la autenticación de Azure App Service.
WEBSITE_AUTH_USE_LEGACY_CLAIMS	Para mantener la compatibilidad con versiones anteriores en las actualizaciones, el módulo de autenticación usa la asignación de notificaciones heredada de nombres cortos a largos en la API de /.auth/me, por lo que se excluyen determinadas asignaciones (por ejemplo, "roles"). Para obtener la versión más moderna de las asignaciones de notificaciones, establezca esta variable en False. En el ejemplo de "roles", se asignaría al nombre largo de la notificación http://schemas.microsoft.com/ws/2008/06/identity/claims/role.
WEBSITE_AUTH_DISABLE_WWWAUTHENTICATE	true o false. El valor predeterminado es false. Cuando se establece en true, quita el WWW-Authenticate encabezado de respuesta HTTP de las respuestas HTTP 401 generadas por el módulo. Esta configuración de aplicación está pensada para su uso con la experiencia de configuración V1 (clásica). Si usa el esquema de configuración de autenticación V2, en su lugar debe usar el valor de configuración identityProviders.azureActiveDirectory.login.disableWwwAuthenticate.
WEBSITE_AUTH_STATE_DIRECTORY	Ruta de acceso de directorio del sistema de archivos local donde se almacenan los tokens cuando está habilitado el almacén de tokens basado en archivos. El valor predeterminado es %HOME%\Data\.auth. Esta configuración de aplicación está pensada para su uso con la experiencia de configuración V1 (clásica). Si usa el esquema de configuración de autenticación V2, en su lugar debe usar el valor de configuración login.tokenStore.fileSystem.directory.
WEBSITE_AUTH_TOKEN_CONTAINER_SASURL	Dirección URL completa del contenedor de blobs. Indica al módulo de autenticación que almacene y cargue todos los tokens cifrados en el contenedor de almacenamiento de blobs especificado en lugar de usar el sistema de archivos local predeterminado.
WEBSITE_AUTH_TOKEN_REFRESH_HOURS	Cualquier número decimal positivo. El valor predeterminado es 72 (horas). Esta configuración controla la cantidad de tiempo después de que expire un token de sesión para que se pueda usar la API de /.auth/refresh para actualizarlo. Los intentos de actualización después de este período producen un error y los usuarios deben iniciar sesión de nuevo. Esta configuración de aplicación está pensada para su uso con la experiencia de configuración V1 (clásica). Si usa el esquema de configuración de autenticación V2, en su lugar debe usar el valor de configuración login.tokenStore.tokenRefreshExtensionHours.
WEBSITE_AUTH_TRACE_LEVEL	Controla el nivel de detalle de los seguimientos de autenticación que se escriben en Application Logging. Los valores válidos son Off, Error, Warning, Information y Verbose. El valor predeterminado es Verbose.
WEBSITE_AUTH_VALIDATE_NONCE	true o false. El valor predeterminado es true. Este valor nunca debe establecerse en false excepto cuando esté depurando temporalmente fallas de validación de nonce criptográfico que ocurren durante inicios de sesión interactivos. Esta configuración de aplicación está pensada para su uso con la experiencia de configuración V1 (clásica). Si usa el esquema de configuración de autenticación V2, en su lugar debe usar el valor de configuración login.nonce.validateNonce.
WEBSITE_AUTH_V2_CONFIG_JSON	Azure App Service rellena automáticamente esta variable de entorno. Esta variable se usa para configurar el módulo de autenticación integrado. Su valor corresponde a la configuración de autenticación V2 (no clásica) de la aplicación actual en Azure Resource Manager. No está pensado para ser configurado de forma explícita.
WEBSITE_AUTH_ENABLED	Solo lectura. Se inserta en una aplicación Windows o Linux para indicar si está habilitada la autenticación de App Service.
WEBSITE_AUTH_ENCRYPTION_KEY	De manera predeterminada, la clave generada automáticamente se usa como clave de cifrado. Para invalidarla, establezca el valor en la clave deseada. Se recomienda esta variable de entorno si desea compartir tokens o sesiones en varias aplicaciones. Si lo especifica, reemplaza la configuración MACHINEKEY_DecryptionKey.
WEBSITE_AUTH_SIGNING_KEY	De manera predeterminada, la clave generada automáticamente se usa como clave de firma. Para invalidarla, establezca el valor en la clave deseada. Se recomienda esta variable de entorno si desea compartir tokens o sesiones en varias aplicaciones. Si lo especifica, reemplaza la configuración MACHINEKEY_ValidationKey.

Identidad administrada

Las siguientes variables de entorno están relacionadas con las identidades administradas.

Nombre del valor	Descripción
IDENTITY_ENDPOINT	Solo lectura. Dirección URL para recuperar el token de la identidad administrada de la aplicación.
MSI_ENDPOINT	En desuso. Mediante IDENTITY_ENDPOINT.
IDENTITY_HEADER	Solo lectura. Valor que se debe agregar al encabezado X-IDENTITY-HEADER al realizar una solicitud HTTP GET a IDENTITY_ENDPOINT. La plataforma rota el valor.
MSI_SECRET	En desuso. Mediante IDENTITY_HEADER.

Comprobación de estado

Las siguientes variables de entorno están relacionadas con las comprobaciones de estado.

Nombre del valor	Descripción
WEBSITE_HEALTHCHECK_MAXPINGFAILURES	Número máximo de pings con errores antes de quitar la instancia. Establezca un valor entre 2 y 10. Al escalar o reducir verticalmente, App Service hace ping a la ruta de acceso de la comprobación de estado para asegurarse de que las nuevas instancias están listas. Para obtener más información, consulte Comprobación de estado.
WEBSITE_HEALTHCHECK_MAXUNHEALTHYWORKERPERCENT	Para evitar sobrecargar instancias correctas, no se excluyen más de la mitad de las instancias. Por ejemplo, si un plan de App Service se escala a cuatro instancias y tres son incorrectos, se excluyen como máximo dos. Las otras dos instancias (una correcta y otra incorrecta) siguen recibiendo solicitudes. En el peor de los casos en los que todas las instancias son incorrectas, no se excluye ninguna. Para invalidar este comportamiento, establezca un valor entre 1 y 100. Un valor mayor significa que se quitan más instancias incorrectas. El valor predeterminado es 50 (50 %).

Notificaciones de inserción

Las siguientes variables de entorno están relacionadas con la característica de notificaciones de inserción.

Nombre del valor	Descripción
WEBSITE_PUSH_ENABLED	Solo lectura. Se agrega cuando se habilitan las notificaciones de inserción.
WEBSITE_PUSH_TAG_WHITELIST	Solo lectura. Contiene las etiquetas del registro de la notificación.
WEBSITE_PUSH_TAGS_REQUIRING_AUTH	Solo lectura. Contiene una lista de etiquetas en el registro de notificaciones que requieren autenticación de usuario.
WEBSITE_PUSH_TAGS_DYNAMIC	Solo lectura. Contiene una lista de las etiquetas del registro de la notificación que se han agregado automáticamente.

Nota

La tabla anterior hace referencia a la lista blanca, un término que Microsoft ya no usa. Cuando el término se quita del software, lo quitamos de este artículo.

WebJobs

Las siguientes variables de entorno están relacionadas con los WebJobs.

Nombre del valor	Descripción
WEBJOBS_RESTART_TIME	En el caso de los trabajos continuos, retrase en segundos cuando el proceso de un trabajo deje de funcionar por cualquier motivo antes de reiniciarlo.
WEBJOBS_IDLE_TIMEOUT	En el caso de los trabajos desencadenados, tiempo de espera en segundos. Después de este tiempo de espera, el trabajo se detiene si está inactivo, no tiene tiempo de CPU o no tiene ninguna salida.
WEBJOBS_HISTORY_SIZE	Para los trabajos desencadenados, es el número máximo de ejecuciones que se mantienen en el directorio del historial por cada trabajo. El valor predeterminado es 50.
WEBJOBS_STOPPED	Establezca el valor en 1 para deshabilitar la ejecución de cualquier trabajo y detener todos los trabajos que se están ejecutando actualmente.
WEBJOBS_DISABLE_SCHEDULE	Establezca el valor en 1 para desactivar todo el desencadenamiento programado. Los trabajos todavía se pueden invocar manualmente.
WEBJOBS_ROOT_PATH	Ruta de acceso absoluta o relativa de los archivos del WebJob. Para una ruta de acceso relativa, el valor se combina con la ruta de acceso raíz predeterminada (D:/home/site/wwwroot/ o /home/site/wwwroot/).
WEBJOBS_LOG_TRIGGERED_JOBS_TO_APP_LOGS	Establézcalo en true para enviar la salida de WebJobs desencadenados a la canalización de registros de aplicaciones (que admite sistemas de archivos, blobs y tablas).
WEBJOBS_SHUTDOWN_FILE	Archivo creado por App Service cuando se detecta una solicitud de apagado. Es responsabilidad del proceso de WebJob detectar la presencia de este archivo e iniciar el apagado. Cuando se usa el SDK de WebJobs, este elemento se controla automáticamente.
WEBJOBS_PATH	Solo lectura. Ruta de acceso raíz del trabajo que se está ejecutando actualmente, en un directorio temporal.
WEBJOBS_NAME	Solo lectura. Nombre del trabajo actual.
WEBJOBS_TYPE	Solo lectura. Tipo de trabajo actual (triggered o continuous).
WEBJOBS_DATA_PATH	Solo lectura. Ruta de acceso de metadatos para contener los registros, el historial y los artefactos del trabajo actual.
WEBJOBS_RUN_ID	Solo lectura. Para los trabajos desencadenados, es el identificador de ejecución actual del trabajo.

Funciones

Nombre del valor	Descripción
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED	Establezca el valor en 0 para deshabilitar el almacenamiento en caché de las funciones.
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT	Consulte Referencia de configuración de aplicaciones para Azure Functions.
AzureWebJobsSecretStorageType	Consulte Referencia de configuración de aplicaciones para Azure Functions.
FUNCTIONS_EXTENSION_VERSION	Consulte Referencia de configuración de aplicaciones para Azure Functions.
FUNCTIONS_WORKER_RUNTIME	Consulte Referencia de configuración de aplicaciones para Azure Functions.
AzureWebJobsStorage	Consulte Referencia de configuración de aplicaciones para Azure Functions.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING	Consulte Referencia de configuración de aplicaciones para Azure Functions.
WEBSITE_CONTENTSHARE	Consulte Referencia de configuración de aplicaciones para Azure Functions.
WEBSITE_CONTENTOVERVNET	Consulte Referencia de configuración de aplicaciones para Azure Functions.
WEBSITE_ENABLE_BROTLI_ENCODING	Consulte Referencia de configuración de aplicaciones para Azure Functions.
WEBSITE_USE_PLACEHOLDER	Consulte Referencia de configuración de aplicaciones para Azure Functions.
WEBSITE_PLACEHOLDER_MODE	Solo lectura. Muestra si la aplicación de funciones se ejecuta en un host de marcador de posición (generalized) o en su propio host (specialized).
WEBSITE_DISABLE_ZIP_CACHE	Cuando la aplicación se ejecuta desde un paquete ZIP (WEBSITE_RUN_FROM_PACKAGE=1), los cinco paquetes ZIP implementados más recientemente se almacenan en caché en el sistema de archivos de la aplicación (D:\home\data\SitePackages). Establezca esta variable en 1 para deshabilitar está caché. En el caso de las aplicaciones de consumo de Linux, la memoria caché de paquetes ZIP está deshabilitada de manera predeterminada.