Partilhar via


Variáveis de ambiente e configurações de aplicativo no Serviço de Aplicativo do Azure

No Serviço de Aplicativo do Azure, determinadas configurações estão disponíveis para o ambiente de implantação ou tempo de execução como variáveis de ambiente. Você pode personalizar algumas dessas configurações ao defini-las manualmente como configurações do aplicativo. Esta referência mostra as variáveis que você pode usar ou personalizar.

Ambiente da aplicação

As variáveis de ambiente a seguir estão relacionadas ao ambiente do aplicativo em geral.

Nome da configuração Descrição
WEBSITE_SITE_NAME Somente leitura. Nome do aplicativo.
WEBSITE_RESOURCE_GROUP Somente leitura. Nome do grupo de recursos do Azure que contém o recurso do aplicativo.
WEBSITE_OWNER_NAME Somente leitura. Contém a ID de assinatura do Azure que possui o aplicativo, o grupo de recursos e o espaço web.
REGION_NAME Somente leitura. Nome da região do aplicativo.
WEBSITE_PLATFORM_VERSION Somente leitura. Versão da plataforma do Serviço de Aplicações.
HOME Somente leitura. Caminho para o diretório base (por exemplo, D:\home para Windows).
SERVER_PORT Somente leitura. Porta que o aplicativo deve ouvir.
WEBSITE_WARMUP_PATH Caminho relativo para ping para aquecer o aplicativo, começando com uma barra. A predefinição é /robots933456.txt.

Sempre que a plataforma inicia um contentor, o orquestrador faz solicitações repetidas ao endpoint. A plataforma considera qualquer resposta desse endpoint como uma indicação de que o contêiner está pronto. Quando a plataforma considera que o contêiner está pronto, ela começa a encaminhar o tráfego orgânico para o contêiner recém-iniciado. A menos que WEBSITE_WARMUP_STATUSES esteja configurada, a plataforma considera qualquer resposta do contêiner neste ponto de extremidade (até mesmo códigos de erro como 404 ou 502) como uma indicação de que o contêiner está pronto.

Esta configuração do aplicativo não altera o caminho que o Always On usa.
WEBSITE_WARMUP_STATUSES Lista delimitada por vírgulas de códigos de status HTTP que são considerados bem-sucedidos quando a plataforma faz pings de aquecimento em um contêiner recém-iniciado. Usado com WEBSITE_WARMUP_PATH.

Por padrão, qualquer código de status é considerado uma indicação de que o contêiner está pronto para o tráfego orgânico. Você pode usar este aplicativo para exigir uma resposta específica antes que o tráfego orgânico seja roteado para o contêiner.

Um exemplo é 200,202. Se os pings no caminho de aquecimento configurado da aplicação receberem uma resposta com um código de estado 200 ou 202, o tráfego orgânico será encaminhado para o contentor. Se um código de status que não está na lista for recebido (como 502), a plataforma continuará a fazer pings até que um 200 ou 202 seja recebido ou até que o limite de tempo limite de inicialização do contêiner seja atingido. (Ver WEBSITES_CONTAINER_START_TIME_LIMIT mais adiante nesta tabela.)

Se o contêiner não responder com um código de status HTTP que está na lista, a plataforma acabará por falhar na tentativa de inicialização e repetir, o que resulta em erros 503.
WEBSITE_COMPUTE_MODE Somente leitura. Especifica se o aplicativo é executado em máquinas virtuais (VMs) dedicadas (Dedicated) ou compartilhadas (Shared).
WEBSITE_SKU Somente leitura. Nível de preço do aplicativo. Os valores possíveis são Free, Shared, Basic, e Standard.
SITE_BITNESS Somente leitura. Mostra se o aplicativo é de 32 bits (x86) ou 64 bits (AMD64).
WEBSITE_HOSTNAME Somente leitura. Nome de host principal para o aplicativo. Essa configuração não leva em conta nomes de host personalizados.
WEBSITE_VOLUME_TYPE Somente leitura. Mostra o tipo de volume de armazenamento atualmente em uso.
WEBSITE_NPM_DEFAULT_VERSION Versão padrão do npm que o aplicativo está usando.
WEBSOCKET_CONCURRENT_REQUEST_LIMIT Somente leitura. Limite para solicitações WebSocket simultâneas. Para a Standard camada e superior, o valor é -1, mas ainda há um limite por VM com base no tamanho da VM. Consulte Limites numéricos de VM cruzada.
WEBSITE_PRIVATE_EXTENSIONS Defina como 0 para desativar o uso de extensões de site privado.
WEBSITE_TIME_ZONE Por padrão, o fuso horário do aplicativo é sempre UTC. Você pode alterá-lo para qualquer um dos valores válidos listados em Fusos horários padrão. Se o valor especificado não for reconhecido, o aplicativo usará UTC.

Exemplo: Atlantic Standard Time
WEBSITE_ADD_SITENAME_BINDINGS_IN_APPHOST_CONFIG Após trocas de slots, o aplicativo pode ter reinicializações inesperadas. O motivo é que, após uma troca, a configuração de vinculação de nome de host fica fora de sincronia, o que por si só não causa reinicializações. No entanto, certos eventos de armazenamento subjacentes (como failovers de volume de armazenamento) podem detetar essas discrepâncias e forçar todos os processos operacionais a reiniciar.

Para minimizar esses tipos de reinicializações, defina o valor da configuração do aplicativo como 1 em todos os slots. (O padrão é 0.) Mas não defina esse valor se estiver executando um aplicativo do Windows Communication Foundation. Para obter mais informações, consulte Solucionar problemas de trocas.
WEBSITE_PROACTIVE_AUTOHEAL_ENABLED Por padrão, uma instância de VM é corrigida proativamente quando usa mais de 90% de memória alocada por mais de 30 segundos ou quando 80% do total de solicitações nos últimos dois minutos levam mais de 200 segundos. Se uma instância de VM acionar uma dessas regras, o processo de recuperação será uma reinicialização sobreposta da instância.

Defina como false para desativar esse comportamento de recuperação. A predefinição é true.

Para obter mais informações, consulte a postagem do blog Introducing Proactive Auto Heal .
WEBSITE_PROACTIVE_CRASHMONITORING_ENABLED Sempre que o processo de w3wp.exe em uma instância de VM do seu aplicativo falhar devido a uma exceção não tratada por mais de três vezes em 24 horas, um processo de depurador será anexado ao processo de trabalho principal nessa instância. O processo do depurador recolhe um despejo de memória quando o processo de trabalho falha novamente. Esse despejo de memória é então analisado e a pilha de chamadas do thread que causou a falha é registrada nos logs do Serviço de Aplicativo.

Defina como false para desativar esse comportamento de monitoramento automático. A predefinição é true.

Para obter mais informações, consulte a postagem do blog Monitoramento proativo de falhas no Serviço de Aplicativo do Azure .
WEBSITE_DAAS_STORAGE_SASURI Durante o monitoramento de falhas (proativo ou manual), os despejos de memória são excluídos por padrão. Para salvar os despejos de memória em um contêiner de blob de armazenamento, especifique o URI da assinatura de acesso compartilhado (SAS).
WEBSITE_CRASHMONITORING_ENABLED Defina como true para ativar o monitoramento de falhas manualmente. Você também deve definir WEBSITE_DAAS_STORAGE_SASURI e WEBSITE_CRASHMONITORING_SETTINGS. A predefinição é false.

Essa configuração não terá efeito se a depuração remota estiver habilitada. Além disso, se essa configuração estiver definida como true, o monitoramento proativo de falhas será desativado.
WEBSITE_CRASHMONITORING_SETTINGS JSON com o seguinte formato:{"StartTimeUtc": "2020-02-10T08:21","MaxHours": "<elapsed-hours-from-StartTimeUtc>","MaxDumpCount": "<max-number-of-crash-dumps>"}. Necessário para configurar o monitoramento de falhas , se WEBSITE_CRASHMONITORING_ENABLED especificado. Para registar a pilha de chamadas sem salvar o despejo de memória na conta de armazenamento, adicione ,"UseStorageAccount":"false" no JSON.
REMOTEDEBUGGINGVERSION Versão de depuração remota.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING Por padrão, o Serviço de Aplicativo cria um armazenamento compartilhado para você na criação do aplicativo. ** Para usar uma conta de armazenamento personalizada, configure a cadeia de conexão da sua conta de armazenamento. Para funções, consulte Referência de configurações de aplicativo para o Azure Functions.

Exemplo: DefaultEndpointsProtocol=https;AccountName=<name>;AccountKey=<key>
WEBSITE_CONTENTSHARE Quando você especifica uma conta de armazenamento personalizada com WEBSITE_CONTENTAZUREFILECONNECTIONSTRING, o Azure App Service cria um compartilhamento de arquivos nessa conta de armazenamento para a sua aplicação. Para usar um nome personalizado, defina essa variável como o nome desejado. Se um compartilhamento de arquivos com o nome especificado não existir, o Serviço de Aplicativo o criará para você.

Exemplo: myapp123
WEBSITE_SCM_ALWAYS_ON_ENABLED Somente leitura. Mostra se o Always On está ativado (1) ou não (0).
WEBSITE_SCM_SEPARATE_STATUS Somente leitura. Mostra se o aplicativo Kudu está sendo executado em um processo separado (1) ou não (0).
WEBSITE_DNS_ATTEMPTS Número de vezes para tentar a resolução de nomes.
WEBSITE_DNS_TIMEOUT Número de segundos para aguardar a resolução do nome.
WEBSITES_CONTAINER_START_TIME_LIMIT Quantidade de tempo (em segundos) que a plataforma aguarda que um contêiner fique pronto na inicialização. Essa configuração se aplica a aplicativos baseados em código e em contêiner no Serviço de Aplicativo para Linux. O valor predefinido é 230.

Quando um contêiner é iniciado, pings repetidos são feitos contra o contêiner para avaliar sua prontidão para atender ao tráfego orgânico. (Ver WEBSITE_WARMUP_PATH e WEBSITE_WARMUP_STATUSES.) Esses pings são feitos continuamente até que uma resposta bem-sucedida seja recebida ou o limite de tempo de início seja atingido. Se o contêiner não for considerado pronto dentro do tempo limite configurado, a plataforma falhará na tentativa de inicialização e nas tentativas, o que resulta em 503 erros.

Para contêineres do Serviço de Aplicativo para Windows, o limite de tempo de início padrão é 10 mins. Você pode alterar o limite de tempo de início especificando um período de tempo. Por exemplo, 00:05:00 indica 5 minutos.

Prefixos variáveis

A tabela a seguir mostra prefixos de variáveis de ambiente que o Serviço de Aplicativo usa para várias finalidades.

Nome da configuração Descrição
APPSETTING_ Significa que o cliente define uma variável como uma configuração de aplicativo na configuração do aplicativo. Ele é injetado em um aplicativo .NET como uma configuração de aplicativo.
MAINSITE_ Significa que uma variável é específica do próprio aplicativo.
SCMSITE_ Significa que uma variável é específica para o aplicativo Kudu.
SQLCONNSTR_ Cadeia de conexão do SQL Server na configuração do aplicativo. Ele é injetado em um aplicativo .NET como uma cadeia de conexão.
SQLAZURECONNSTR_ Cadeia de conexão do Banco de Dados SQL do Azure na configuração do aplicativo. Ele é injetado em um aplicativo .NET como uma cadeia de conexão.
POSTGRESQLCONNSTR_ Cadeia de conexão PostgreSQL na configuração do aplicativo. Ele é injetado em um aplicativo .NET como uma cadeia de conexão.
CUSTOMCONNSTR_ Cadeia de conexão personalizada na configuração do aplicativo. Ele é injetado em um aplicativo .NET como uma cadeia de conexão.
MYSQLCONNSTR_ Cadeia de conexão do banco de dados MySQL na configuração do aplicativo. Ele é injetado em um aplicativo .NET como uma cadeia de conexão.
AZUREFILESSTORAGE_ Cadeia de conexão para um compartilhamento personalizado para um contêiner personalizado nos Arquivos do Azure.
AZUREBLOBSTORAGE_ Cadeia de conexão para uma conta de armazenamento personalizada para um contêiner personalizado no Armazenamento de Blobs do Azure.
NOTIFICATIONHUBCONNSTR_ Cadeia de conexão para um hub de notificação nos Hubs de Notificação do Azure.
SERVICEBUSCONNSTR_ Cadeia de conexão para uma instância do Barramento de Serviço do Azure.
EVENTHUBCONNSTR_ Cadeia de conexão para um hub de eventos nos Hubs de Eventos do Azure.
DOCDBCONNSTR_ Cadeia de conexão para um banco de dados no Azure Cosmos DB.
REDISCACHECONNSTR_ Cadeia de conexão para um cache no Azure Cache para Redis.
FILESHARESTORAGE_ Cadeia de conexão para um compartilhamento de arquivos personalizado.

Implantação

As variáveis de ambiente a seguir estão relacionadas à implantação do aplicativo. Para variáveis relacionadas à automação de compilação do Serviço de Aplicativo, consulte Automação de compilação mais adiante neste artigo.

Nome da configuração Descrição
DEPLOYMENT_BRANCH Para a implantação do Git local ou do Git na nuvem (como o GitHub), defina a ramificação no Azure para onde pretende implantar. Por padrão, é master.
WEBSITE_RUN_FROM_PACKAGE Defina para 1 executar a aplicação a partir de um pacote ZIP local ou defina uma URL externa para executar a aplicação a partir de um pacote ZIP remoto. Para obter mais informações, consulte Executar seu aplicativo no Serviço de Aplicativo do Azure diretamente de um pacote ZIP.
WEBSITE_USE_ZIP Preterido. Utilize WEBSITE_RUN_FROM_PACKAGE.
WEBSITE_RUN_FROM_ZIP Preterido. Utilize WEBSITE_RUN_FROM_PACKAGE.
SCM_MAX_ZIP_PACKAGE_COUNT Seu aplicativo mantém cinco dos arquivos ZIP mais recentes implantados por meio da implantação ZIP. Você pode manter mais ou menos alterando a configuração do aplicativo para um número diferente.
WEBSITE_WEBDEPLOY_USE_SCM Defina para false no Web Deploy para parar de usar o mecanismo de implantação Kudu. A predefinição é true. Para implantar em aplicativos Linux usando o Visual Studio (Web Deploy/MSDeploy), defina-o como false.
MSDEPLOY_RENAME_LOCKED_FILES Defina como 1 para tentar renomear DLLs caso não possam ser copiadas durante uma implantação com o Web Deploy. Esta definição não é aplicável se WEBSITE_WEBDEPLOY_USE_SCM estiver definida como false.
WEBSITE_DISABLE_SCM_SEPARATION Por padrão, o aplicativo principal e o aplicativo Kudu são executados em diferentes sandboxes. Quando você para o aplicativo, o aplicativo Kudu ainda está em execução e você pode continuar a usar a implantação do Git e o MSDeploy. Cada aplicativo tem seus próprios arquivos locais. Desativar essa separação (configuração como true) é um modo herdado que não é mais totalmente suportado.
WEBSITE_ENABLE_SYNC_UPDATE_SITE Defina para garantir que as chamadas da 1 API REST sejam atualizadas site e siteconfig completamente aplicadas a todas as instâncias antes de retornar. O padrão é 1 se estiveres a efetuar a implementação com um modelo do Azure Resource Manager (modelo ARM), para evitar condições de concorrência com chamadas subsequentes do Resource Manager.
WEBSITE_START_SCM_ON_SITE_CREATION Na implantação de um modelo ARM, defina 1 no modelo ARM para iniciar antecipadamente o aplicativo Kudu como parte da criação do aplicativo.
WEBSITE_START_SCM_WITH_PRELOAD Para aplicações Linux, defina true para forçar o pré-carregamento da aplicação Kudu quando o Always On estiver habilitado, efetuando ping na sua URL. A predefinição é false. Para aplicativos do Windows, o aplicativo Kudu é sempre pré-carregado.

Automação de construção

A configuração de compilação do Kudu se aplica a aplicativos nativos do Windows e é usada para controlar o comportamento de implantações baseadas em Git (ou ZIP).

Nome da configuração Descrição
SCM_BUILD_ARGS Adicione coisas no final da linha de comando msbuild, de modo que substitua quaisquer partes anteriores da linha de comando padrão.

Por exemplo, para fazer uma compilação limpa: -t:Clean;Compile.
SCM_SCRIPT_GENERATOR_ARGS Kudu usa o azure site deploymentscript comando para gerar um script de implementação. Ele deteta automaticamente o tipo de estrutura de linguagem e determina os parâmetros a serem passados para o comando. Essa configuração substitui os parâmetros gerados automaticamente.

Por exemplo, para tratar seu repositório como arquivos de conteúdo simples: --basic -p <folder-to-deploy>.
SCM_TRACE_LEVEL Nível de rastreamento de construção. A predefinição é 1. Defina para valores mais altos, até 4, para mais rastreamento.
SCM_COMMAND_IDLE_TIMEOUT Tempo limite, em segundos, para cada comando que o processo de compilação executa para aguardar antes de produzir qualquer saída. Depois disso, o comando é considerado ocioso e parado. O padrão é 60 (um minuto).

No Azure, também há um tempo limite geral de solicitação ociosa que desconecta os clientes após 230 segundos. No entanto, o comando continua a ser executado no lado do servidor depois disso.
SCM_LOGSTREAM_TIMEOUT Tempo limite de inatividade, em segundos, antes de interromper o streaming de logs. O padrão é 1800 (30 minutos).
SCM_SITEEXTENSIONS_FEED_URL URL da galeria de extensões de site. A predefinição é https://www.nuget.org/api/v2/. O URL do feed antigo é http://www.siteextensions.net/api/v2/.
SCM_USE_LIBGIT2SHARP_REPOSITORY Defina 0 para utilizar git.exe em vez de libgit2sharp para operações Git.
WEBSITE_LOAD_USER_PROFILE No caso do erro The specified user does not have a valid profile durante a automação de compilação do ASP.NET (como durante a implantação com o Git), defina esta variável para 1 de modo a carregar um perfil de usuário completo no ambiente de compilação. Esta definição aplica-se apenas quando WEBSITE_COMPUTE_MODE é Dedicated.
WEBSITE_SCM_IDLE_TIMEOUT_IN_MINUTES Tempo limite, em minutos, para o site do Gerenciador de Controle do Código-Fonte (Kudu). A predefinição é 20.
SCM_DO_BUILD_DURING_DEPLOYMENT Com a implantação ZIP, o mecanismo de implantação assume que um arquivo ZIP está pronto para ser executado como está e não executa nenhuma automação de compilação. Para habilitar a mesma automação de compilação que na implantação do Git, defina como true.

Configurações específicas do idioma

Esta seção mostra as configurações de tempo de execução configuráveis para cada estrutura de linguagem suportada. Mais configurações estão disponíveis durante a automação de compilação no momento da implantação.

Nome da configuração Descrição
PORT Somente leitura. Para aplicações Linux, a porta que o runtime do .NET escuta no contentor.
WEBSITE_ROLE_INSTANCE_ID Somente leitura. ID da instância atual.
HOME Somente leitura. Diretório que aponta para armazenamento compartilhado (/home).
DUMP_DIR Somente leitura. Diretório para os despejos de memória (/home/logs/dumps).
APP_SVC_RUN_FROM_COPY Apenas aplicações Linux. Por predefinição, a aplicação é executada a partir de /home/site/wwwroot, um diretório partilhado para todas as instâncias ampliadas. Defina essa variável como true para copiar o aplicativo para um diretório local em seu contêiner e executá-lo a partir daí. Ao usar essa opção, certifique-se de não codificar nenhuma referência ao /home/site/wwwroot. Em vez disso, use um caminho relativo a /home/site/wwwroot.
MACHINEKEY_Decryption Para aplicativos nativos do Windows ou aplicativos do Windows em contêineres, essa variável é injetada em um ambiente ou contêiner de aplicativo para habilitar ASP.NET rotinas criptográficas. (Consulte machineKey Element.) Para substituir o valor padrão decryption, configure-o como uma definição de aplicação no Serviço de Aplicativo ou defina-o diretamente no elemento machineKey do arquivo Web.config.
MACHINEKEY_DecryptionKey Para aplicativos nativos do Windows ou aplicativos do Windows em contêineres, essa variável é injetada no ambiente ou contêiner do aplicativo para habilitar ASP.NET rotinas criptográficas. (Consulte machineKey Element.) Para substituir o valor gerado automaticamente decryptionKey, configure-o como uma configuração de aplicação do App Service ou defina-o diretamente no elemento do machineKey ficheiro.
MACHINEKEY_Validation Para aplicativos nativos do Windows ou aplicativos do Windows em contêineres, essa variável é injetada no ambiente ou contêiner do aplicativo para habilitar ASP.NET rotinas criptográficas. (Consulte machineKey Element.) Para substituir o valor padrão validation, configure-o como uma definição de aplicação no Serviço de Aplicativo ou defina-o diretamente no elemento machineKey do arquivo Web.config.
MACHINEKEY_ValidationKey Para aplicativos nativos do Windows ou aplicativos do Windows em contêineres, essa variável é injetada no ambiente ou contêiner do aplicativo para habilitar ASP.NET rotinas criptográficas. (Consulte machineKey Element.) Para substituir o valor gerado automaticamente validationKey, configure-o como uma configuração de aplicação do App Service ou defina-o diretamente no elemento do machineKey ficheiro.

WordPress

Configuração do aplicativo Âmbito de aplicação Valor Máximo Descrição
WEBSITES_ENABLE_APP_SERVICE_STORAGE Aplicação Web true Não aplicável Quando definido como true, o conteúdo do arquivo é preservado durante as reinicializações.
WP_MEMORY_LIMIT WordPress 128M 512M Limite de memória PHP para o front-end ou geral do WordPress (para cada script). Não pode ser mais do que PHP_MEMORY_LIMIT.
WP_MAX_MEMORY_LIMIT WordPress 256M 512M Limite de memória do PHP no painel de administração (por script). Geralmente, o painel de administração e os scripts back-end consomem muita memória em comparação com os scripts front-end. Não pode ser mais do que PHP_MEMORY_LIMIT.
PHP_MEMORY_LIMIT PHP 512M 512M Limite de memória para scripts PHP gerais. Só pode ser diminuído.
FILE_UPLOADS PHP On Não aplicável Habilita ou desabilita o upload de arquivos. Tanto pode ser On como Off. Note que os valores são sensíveis a maiúsculas.
UPLOAD_MAX_FILESIZE PHP 50M 256M Limite de tamanho para upload de arquivos. Pode ser aumentado até 256M.
POST_MAX_SIZE PHP 128M 256M Pode ser aumentado até 256M. Geralmente deve ser mais do que UPLOAD_MAX_FILESIZE.
MAX_EXECUTION_TIME PHP 120 120 Só pode ser diminuído. Divida os scripts caso demore mais de 120 segundos. Adicionado para evitar que scripts ruins atrasem o sistema.
MAX_INPUT_TIME PHP 120 120 Prazo para analisar pedidos de entrada. Só pode ser diminuído.
MAX_INPUT_VARS PHP 10000 10000 Número máximo de variáveis para solicitações de entrada.
DATABASE_HOST Base de dados Não aplicável Não aplicável Host de banco de dados usado para se conectar ao WordPress.
DATABASE_NAME Base de dados Não aplicável Não aplicável Nome do banco de dados usado para se conectar ao WordPress.
DATABASE_USERNAME Base de dados Não aplicável Não aplicável Nome de usuário do banco de dados usado para se conectar ao WordPress.
DATABASE_PASSWORD Base de dados Não aplicável Não aplicável Senha do banco de dados usada para se conectar ao banco de dados MySQL. Para alterar a senha do banco de dados MySQL, consulte Atualizar senha de administrador. Sempre que a senha do banco de dados MySQL é alterada, as configurações do aplicativo também precisam ser atualizadas.
WORDPRESS_ADMIN_EMAIL Somente implantação Não aplicável Não aplicável E-mail de administrador do WordPress.
WORDPRESS_ADMIN_PASSWORD Somente implantação Não aplicável Não aplicável Senha de administrador do WordPress. Essa configuração é apenas para fins de implantação. Modificar esse valor não tem efeito na instalação do WordPress. Para alterar a senha de administrador do WordPress, consulte Redefinir sua senha.
WORDPRESS_ADMIN_USER Somente implantação Não aplicável Não aplicável Nome de usuário do administrador do WordPress.
WORDPRESS_ADMIN_LOCALE_CODE Somente implantação Não aplicável Não aplicável Nome de usuário do banco de dados usado para se conectar ao WordPress.

Domínio e DNS

Nome da configuração Descrição
WEBSITE_DNS_SERVER Endereço IP do servidor DNS primário para conexões de saída (como para um serviço back-end). O servidor DNS padrão para o Serviço de Aplicativo é o DNS do Azure, cujo endereço IP é 168.63.129.16. Se seu aplicativo usa integração de rede virtual ou está em um ambiente do Serviço de Aplicativo, ele herda a configuração do servidor DNS da rede virtual por padrão.

Exemplo: 10.0.0.1
WEBSITE_DNS_ALT_SERVER Endereço IP do servidor DNS de reserva para ligações de saída. Consulte WEBSITE_DNS_SERVER.
WEBSITE_ENABLE_DNS_CACHE Permite que resoluções DNS bem-sucedidas sejam armazenadas em cache. Por padrão, as entradas de cache DNS expiradas são liberadas (além do cache existente) a cada 4,5 minutos.

TLS/SSL

Para obter mais informações, consulte Usar um certificado TLS/SSL em seu código no Serviço de Aplicativo do Azure.

Nome da configuração Descrição
WEBSITE_LOAD_CERTIFICATES Valores de impressão digital separados por vírgulas para o certificado que você deseja carregar em seu código. Ou use * para permitir que todos os certificados sejam carregados no código. Apenas os certificados adicionados à sua aplicação podem ser carregados.
WEBSITE_PRIVATE_CERTS_PATH Somente leitura. Caminho num contentor do Windows para os certificados privados carregados.
WEBSITE_PUBLIC_CERTS_PATH Somente leitura. Caminho num contentor do Windows para os certificados públicos carregados.
WEBSITE_INTERMEDIATE_CERTS_PATH Somente leitura. Caminho em um contêiner do Windows para os certificados intermediários carregados.
WEBSITE_ROOT_CERTS_PATH Somente leitura. Caminho em um contentor do Windows para os certificados de raiz carregados.

Blocos de implementação

Para obter mais informações sobre slots de implantação, consulte Configurar ambientes de preparo no Serviço de Aplicativo do Azure.

Nome da configuração Descrição
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS Por padrão, as versões para extensões de site são específicas para cada slot. Esse padrão impede o comportamento imprevisto do aplicativo devido à alteração de versões de extensão após uma troca. Se você quiser que as versões de extensão também troquem, defina como 0 em todos os slots.
WEBSITE_OVERRIDE_PRESERVE_DEFAULT_STICKY_SLOT_SETTINGS Designa determinadas configurações como adesivas ou não trocáveis por padrão. A predefinição é true. Defina esse valor como false ou 0 para todos os slots de implantação para torná-los permutáveis. Não há controle refinado para tipos de configuração específicos.
WEBSITE_SWAP_WARMUP_PING_PATH Caminho para realizar ping, a fim de aquecer o slot de destino durante uma troca, iniciando com uma barra. O padrão é /, que envia um ping ao caminho raiz via HTTP.

Exemplo: /statuscheck
WEBSITE_SWAP_WARMUP_PING_STATUSES Códigos de resposta HTTP válidos para a operação de aquecimento durante uma troca. Se o código de status retornado não estiver na lista, as operações de aquecimento e troca serão interrompidas. Por padrão, todos os códigos de resposta são válidos.

Exemplo: 200,202
WEBSITE_SLOT_NUMBER_OF_TIMEOUTS_BEFORE_RESTART Durante uma troca de slot, número máximo de timeouts antes de uma reinicialização forçada do site numa instância específica de VM. A predefinição é 3.
WEBSITE_SLOT_MAX_NUMBER_OF_TIMEOUTS Durante uma troca de slot, número máximo de solicitações de tempo limite para um único URL a serem feitas antes de desistir. A predefinição é 5.
WEBSITE_SKIP_ALL_BINDINGS_IN_APPHOST_CONFIG Defina como true ou 1 ignore todas as ligações em applicationHost.config. A predefinição é false. Se a sua aplicação acionar uma reinicialização porque applicationHost.config é atualizado com os nomes de host trocados dos slots, defina esta variável para true para evitar uma reinicialização desse tipo. Se você estiver executando um aplicativo do Windows Communication Foundation, não defina essa variável.

Personalizar contentores

Para obter mais informações sobre contêineres personalizados, consulte Executar um contêiner personalizado no Azure.

Nome da configuração Descrição
WEBSITES_ENABLE_APP_SERVICE_STORAGE Para contêineres Linux, se essa configuração de aplicativo não for especificada, o /home diretório será compartilhado entre instâncias dimensionadas por padrão. Você pode configurá-lo para false desativar o compartilhamento.

Para contêineres do Windows, definir o valor para true para permitir que o diretório c:\home seja compartilhado entre instâncias escalonadas. O padrão é true para contêineres do Windows.
WEBSITES_CONTAINER_STOP_TIME_LIMIT Quantidade de tempo, em segundos, para esperar que o recipiente termine normalmente. A predefinição é 5. Você pode aumentar até um máximo de 120.
DOCKER_REGISTRY_SERVER_URL URL do servidor de registo quando estiver a executar um contentor personalizado no Serviço de Aplicação. Por segurança, essa variável não é passada para o contêiner.

Exemplo: https://<server-name>.azurecr.io
DOCKER_REGISTRY_SERVER_USERNAME Nome de usuário para autenticar com o servidor de registro em DOCKER_REGISTRY_SERVER_URL. Por segurança, essa variável não é passada para o contêiner.
DOCKER_REGISTRY_SERVER_PASSWORD Senha para autenticar com o servidor de registro em DOCKER_REGISTRY_SERVER_URL. Por segurança, essa variável não é passada para o contêiner.
DOCKER_ENABLE_CI Defina como true para habilitar a implantação contínua para contêineres personalizados. O padrão é false para contêineres personalizados.
WEBSITE_PULL_IMAGE_OVER_VNET Conecte-se e aceda a um registo dentro de uma rede de área virtual ou nas instalações. Seu aplicativo precisa estar conectado a uma rede virtual por meio do recurso de integração de rede virtual. Esta configuração também é necessária para o Registo de Contêiner do Azure com um endpoint privado.
WEBSITES_WEB_CONTAINER_NAME Em um aplicativo Docker Compose, apenas um dos contêineres pode ser acessível pela Internet. Defina para o nome do contentor definido no ficheiro de configuração para substituir a seleção de contentor padrão. Por padrão, o contêiner acessível pela Internet é o primeiro contêiner a definir a porta 80 ou 8080. Quando nenhum contêiner é encontrado, o padrão é o primeiro contêiner definido no arquivo de configuração.
WEBSITES_PORT Para um contêiner personalizado, o número da porta personalizada no contêiner para o qual o Serviço de Aplicativo encaminha solicitações. Por padrão, o Serviço de Aplicativo tenta a deteção automática de portas das portas 80 e 8080. Essa configuração não é injetada no contêiner como uma variável de ambiente.
WEBSITE_CPU_CORES_LIMIT Por padrão, um contêiner do Windows é executado com todos os núcleos disponíveis para o nível de preço escolhido. Para reduzir o número de núcleos, defina um limite para o número de núcleos desejados. Para obter mais informações, consulte Personalizar o número de núcleos de computação.
WEBSITE_MEMORY_LIMIT_MB Por padrão, todos os contêineres do Windows implantados no Serviço de Aplicativo têm um limite de memória configurado, dependendo da camada do plano do Serviço de Aplicativo. Defina para o limite de memória desejado em megabytes. O total acumulado dessa configuração entre aplicativos no mesmo plano não deve exceder o valor permitido pelo nível de preço escolhido. Para obter mais informações, consulte Personalizar memória de contêiner.

Escalonamento

Nome da configuração Descrição
WEBSITE_INSTANCE_ID Somente leitura. ID exclusiva da instância de VM atual, quando o aplicativo é expandido para várias instâncias.
WEBSITE_IIS_SITE_NAME Preterido. Utilize WEBSITE_INSTANCE_ID.
WEBSITE_DISABLE_OVERLAPPED_RECYCLING A reciclagem sobreposta garante que, antes que a instância de VM atual de um aplicativo seja encerrada, uma nova instância de VM seja iniciada. Em alguns casos, pode causar problemas de bloqueio de ficheiros. Você pode tentar desativá-lo definindo como 1.
WEBSITE_DISABLE_CROSS_STAMP_SCALE Por padrão, as aplicações podem ser escalonadas entre servidores se usarem Ficheiros do Azure ou um contentor Docker. Defina-o como 1 ou true para desativar o escalonamento cruzado na região do aplicativo. A predefinição é 0. Contêineres personalizados do Docker que configuram WEBSITES_ENABLE_APP_SERVICE_STORAGE para true ou 1 não podem escalar entre carimbos porque seu conteúdo não está completamente encapsulado no contêiner Docker.

Exploração Florestal

Nome da configuração Descrição
WEBSITE_HTTPLOGGING_ENABLED Somente leitura. Mostra se o log do servidor Web para aplicativos nativos do Windows está habilitado (1) ou não (0).
WEBSITE_HTTPLOGGING_RETENTION_DAYS Período de retenção (em dias) dos logs do servidor Web, se os logs do servidor Web estiverem habilitados para um aplicativo nativo do Windows ou Linux.

Exemplo: 10
WEBSITE_HTTPLOGGING_CONTAINER_URL URL SAS do contêiner de armazenamento de blob para armazenar logs do servidor Web para aplicativos nativos do Windows, se os logs do servidor Web estiverem habilitados. Se não estiver definido, os logs do servidor Web serão armazenados no sistema de arquivos do aplicativo (armazenamento compartilhado padrão).
DIAGNOSTICS_AZUREBLOBRETENTIONINDAYS Período de retenção (em dias) dos registos de aplicações para aplicações nativas do Windows, se os registos de aplicações estiverem ativados.

Exemplo: 10
DIAGNOSTICS_AZUREBLOBCONTAINERSASURL URL SAS do contêiner de armazenamento de BLOB para armazenar registos de aplicações nativas do Windows, caso os registos de aplicações estejam ativados.
APPSERVICEAPPLOGS_TRACE_LEVEL Nível mínimo de log a ser enviado ao Log Analytics para o tipo de log AppServiceAppLogs .
DIAGNOSTICS_LASTRESORTFILE Nome do arquivo a ser criado, ou caminho relativo para o diretório de log, para registrar erros internos para solucionar problemas do ouvinte. A predefinição é logging-errors.txt.
DIAGNOSTICS_LOGGINGSETTINGSFILE Caminho para o arquivo de configurações de log, relativo a D:\home ou /home. A predefinição é site\diagnostics\settings.json.
DIAGNOSTICS_TEXTTRACELOGDIRECTORY Pasta de log, relativa à raiz do aplicativo (D:\home\site\wwwroot ou /home/site/wwwroot).

Exemplo: ..\..\LogFiles\Application
DIAGNOSTICS_TEXTTRACEMAXLOGFILESIZEBYTES Tamanho máximo do arquivo de log em bytes. O padrão é 131072 (128 KB).
DIAGNOSTICS_TEXTTRACEMAXLOGFOLDERSIZEBYTES Tamanho máximo da pasta de log em bytes. O padrão é 1048576 (1 MB).
DIAGNOSTICS_TEXTTRACEMAXNUMLOGFILES Número máximo de arquivos de log a serem mantidos. A predefinição é 20.
DIAGNOSTICS_TEXTTRACETURNOFFPERIOD Tempo limite, em milissegundos, para manter o registo de aplicações ativado. O padrão é 43200000 (12 horas).
WEBSITE_LOG_BUFFERING Por padrão, o buffer de log está habilitado. Defina 0 para desativar.
WEBSITE_ENABLE_PERF_MODE Para aplicativos nativos do Windows, defina para TRUE desativar as entradas de log do IIS para solicitações bem-sucedidas retornadas em 10 segundos. Esta é uma maneira rápida de realizar testes de desempenho removendo os logs detalhados.

Contadores de desempenho

A seguir estão variáveis de ambiente "falsas" que não existem se você enumerá-las, mas elas retornam seu valor se você procurá-las individualmente. O valor é dinâmico e pode mudar a cada pesquisa.

Nome da configuração Descrição
WEBSITE_COUNTERS_ASPNET Objeto JSON que contém contadores de desempenho ASP.NET.
WEBSITE_COUNTERS_APP Objeto JSON que contém contadores de sandbox.
WEBSITE_COUNTERS_CLR Objeto JSON que contém contadores do Common Language Runtime.
WEBSITE_COUNTERS_ALL Objeto JSON que contém a combinação das outras três variáveis.

Armazenamento em cache

Nome da configuração Descrição
WEBSITE_LOCAL_CACHE_OPTION Se o cache local está habilitado. As opções disponíveis são:

- Default: Herdar a configuração global no nível do carimbo.
- Always: Ativar para o aplicativo.
- OnStorageUnavailability
- Disabled: Desativar para a aplicação.
WEBSITE_LOCAL_CACHE_READWRITE_OPTION Opções de leitura/gravação do cache local. As opções disponíveis são:

- ReadOnly: O cache é somente leitura.
- WriteButDiscardChanges: Permita gravações no cache local, mas descarte as alterações feitas localmente.
WEBSITE_LOCAL_CACHE_SIZEINMB Tamanho do cache local em megabytes. O padrão é 1000 (1 GB).
WEBSITE_LOCALCACHE_READY Sinalizador somente leitura que indica se o aplicativo está usando o cache local.
WEBSITE_DYNAMIC_CACHE Devido à natureza do compartilhamento de arquivos de rede para permitir o acesso a várias instâncias, o cache dinâmico melhora o desempenho armazenando em cache os arquivos acessados recentemente localmente em uma instância. O cache é invalidado quando o arquivo é modificado. O local do cache é %SYSTEMDRIVE%\local\DynamicCache. (É aplicada a mesma %SYSTEMDRIVE%\local quota.)

Para habilitar o cache de conteúdo completo, defina como 1, que inclui o conteúdo do arquivo e metadados de diretório/arquivo (carimbos de data/hora, tamanho, conteúdo do diretório). Para conservar o uso do disco local, defina como 2 armazenar em cache apenas metadados de diretório/arquivo (carimbos de data/hora, tamanho, conteúdo do diretório). Para desativar o cache, defina como 0.

Para aplicativos do Windows e para aplicativos Linux criados com o modelo WordPress, o padrão é 1. Para todos os outros aplicativos Linux, o padrão é 0.
WEBSITE_READONLY_APP Ao usar um cache dinâmico, você pode desabilitar o acesso de gravação à raiz do aplicativo (D:\home\site\wwwroot ou /home/site/wwwroot) definindo essa variável como 1. Com exceção do App_Data diretório, nenhum bloqueio exclusivo é permitido para que os arquivos bloqueados não bloqueiem implantações.

Ligação em rede

As variáveis de ambiente a seguir estão relacionadas a conexões híbridas e integração de rede virtual.

Nome da configuração Descrição
WEBSITE_RELAYS Somente leitura. Dados necessários para configurar a conexão híbrida, incluindo pontos de extremidade e dados do barramento de serviço.
WEBSITE_REWRITE_TABLE Somente leitura. Usado em tempo de execução para realizar as pesquisas e reescrever conexões adequadamente.
WEBSITE_VNET_ROUTE_ALL Por padrão, se você usar a integração de rede virtual regional, seu aplicativo roteia apenas RFC1918 tráfego para sua rede virtual. Defina como 1 para rotear todo o tráfego de saída para sua rede virtual e estar sujeito aos mesmos grupos de segurança de rede e rotas definidas pelo usuário. A configuração permite aceder a pontos de extremidade não RFC1918 através da sua rede virtual, proteger todo o tráfego de saída do seu aplicativo e forçar o encaminhamento de todo o tráfego de saída para um appliance de rede à sua escolha.
WEBSITE_PRIVATE_IP Somente leitura. Endereço IP associado ao aplicativo integrado a uma rede virtual. Para integração de rede virtual regional, o valor é um IP do intervalo de endereços da sub-rede delegada. Para a integração de rede virtual que exige um gateway, o valor é um IP do intervalo de endereços da gama de endereços ponto-a-site configurada no gateway de rede virtual.

O aplicativo usa esse IP para se conectar aos recursos através da rede virtual. Além disso, ele pode mudar dentro do intervalo de endereços descrito.
WEBSITE_PRIVATE_PORTS Somente leitura. Na integração de rede virtual, mostra quais portas o aplicativo pode usar para se comunicar com outros nós.
WEBSITE_CONTENTOVERVNET Se você estiver montando um compartilhamento de arquivos do Azure no Serviço de Aplicativo e a conta de armazenamento estiver restrita a uma rede virtual, habilite essa configuração com o valor .1

Referências do cofre de chaves

As variáveis de ambiente a seguir estão relacionadas às referências do cofre de chaves.

Nome da configuração Descrição
WEBSITE_KEYVAULT_REFERENCES Somente leitura. Contém informações (incluindo estados) para todas as referências do cofre de chaves que estão atualmente configuradas no aplicativo.
WEBSITE_SKIP_CONTENTSHARE_VALIDATION Se você definir a conexão de armazenamento compartilhado do seu aplicativo (usando WEBSITE_CONTENTAZUREFILECONNECTIONSTRING) como uma referência do cofre de chaves, o aplicativo não poderá resolver a referência do cofre de chaves na criação ou atualização do aplicativo se uma das seguintes condições for verdadeira:

- O aplicativo acessa o cofre de chaves usando uma identidade atribuída pelo sistema.
- O aplicativo acessa o cofre de chaves usando uma identidade atribuída pelo usuário, e o cofre de chaves é bloqueado com uma rede virtual.

Para evitar erros no momento da criação ou atualização, defina essa variável como 1.
WEBSITE_DELAY_CERT_DELETION Definir esta variável de ambiente para 1 garante que um certificado do qual depende um processo de trabalho não seja apagado até que este termine.

CORS

As variáveis de ambiente a seguir estão relacionadas à configuração de compartilhamento de recursos entre origens (CORS).

Nome da configuração Descrição
WEBSITE_CORS_ALLOWED_ORIGINS Somente leitura. Mostra as origens permitidas para CORS.
WEBSITE_CORS_SUPPORT_CREDENTIALS Somente leitura. Mostra se a configuração do cabeçalho Access-Control-Allow-Credentials para true está habilitada (True) ou não (False).

Autenticação e autorização

As variáveis de ambiente a seguir estão relacionadas à autenticação do Serviço de Aplicativo.

Nome da configuração Descrição
WEBSITE_AUTH_DISABLE_IDENTITY_FLOW Quando definido como true, desativa a atribuição da identidade principal do thread em aplicações Web baseadas em ASP.NET (incluindo apps de função v1). Esse recurso permite que os desenvolvedores protejam o acesso ao site com autenticação, mas ainda o façam usar um mecanismo de entrada separado dentro da lógica do aplicativo. A predefinição é false.
WEBSITE_AUTH_HIDE_DEPRECATED_SID true ou false. O valor predefinido é false. Esta é uma configuração para a integração de Aplicativos Móveis herdados para o Serviço de Aplicativo do Azure. Definir o valor para true resolver um problema em que o ID de segurança gerado para usuários autenticados pode mudar se o usuário alterar suas informações de perfil.

Alterar esse valor pode fazer com que as IDs de usuário existentes dos Aplicativos Móveis do Azure sejam alteradas. A maioria dos aplicativos não precisa usar essa configuração.
WEBSITE_AUTH_NONCE_DURATION Um valor de intervalo de tempo no formulário hours:minutes:seconds. O valor padrão é 00:05:00, ou 5 minutos. Essa configuração controla o tempo de vida do nonce criptográfico gerado para todos os inícios de sessão através do navegador. Se um início de sessão não for concluído no tempo especificado, o processo de início de sessão será repetido automaticamente.

Esta definição de aplicação destina-se a ser utilizada com a experiência de configuração V1 (clássica). Se estiveres a usar o esquema de configuração de autenticação V2, deves utilizar o valor da configuração login.nonce.nonceExpirationInterval.
WEBSITE_AUTH_PRESERVE_URL_FRAGMENT Quando definido como true e os utilizadores selecionam ligações de aplicações que contêm partes de fragmento de URL, o processo de início de sessão garante que a parte do fragmento de URL do seu URL não se perca no processo de redirecionamento de início de sessão. Para obter mais informações, consulte Personalizar início e término de sessão na autenticação do Serviço de Aplicativo do Azure.
WEBSITE_AUTH_USE_LEGACY_CLAIMS Para manter a compatibilidade com versões anteriores entre atualizações, o módulo de autenticação usa o mapeamento herdado de declarações de nomes curtos para nomes longos na API /.auth/me, portanto, certos mapeamentos são excluídos (por exemplo, "perfis"). Para obter a versão mais moderna dos mapeamentos de declarações, defina essa variável como False. No exemplo de "funções", ele seria mapeado para o nome de declaração longa http://schemas.microsoft.com/ws/2008/06/identity/claims/role.
WEBSITE_AUTH_DISABLE_WWWAUTHENTICATE true ou false. O valor predefinido é false. Quando definido como true, ele remove o WWW-Authenticate cabeçalho de resposta HTTP das respostas HTTP 401 geradas pelo módulo.

Esta definição de aplicação destina-se a ser utilizada com a experiência de configuração V1 (clássica). Se estiveres a usar o esquema de configuração de autenticação V2, deves utilizar o valor da configuração identityProviders.azureActiveDirectory.login.disableWwwAuthenticate.
WEBSITE_AUTH_STATE_DIRECTORY Caminho de diretório do sistema de arquivos local onde os tokens são armazenados quando o armazenamento de tokens baseado em arquivo está habilitado. O valor predefinido é %HOME%\Data\.auth.

Esta definição de aplicação destina-se a ser utilizada com a experiência de configuração V1 (clássica). Se estiveres a usar o esquema de configuração de autenticação V2, deves utilizar o valor da configuração login.tokenStore.fileSystem.directory.
WEBSITE_AUTH_TOKEN_CONTAINER_SASURL URL de contêiner de blob totalmente qualificada. Instrui o módulo de autenticação a armazenar e carregar todos os tokens criptografados no contêiner de armazenamento de blob especificado em vez de usar o sistema de arquivos local padrão.
WEBSITE_AUTH_TOKEN_REFRESH_HOURS Qualquer número decimal positivo. O valor padrão é 72 (horas). Essa configuração controla a quantidade de tempo após a expiração de um token de sessão que a /.auth/refresh API pode ser usada para atualizá-lo. As tentativas de atualização após esse período falham e os usuários precisam entrar novamente.

Esta definição de aplicação destina-se a ser utilizada com a experiência de configuração V1 (clássica). Se estiveres a usar o esquema de configuração de autenticação V2, deves utilizar o valor da configuração login.tokenStore.tokenRefreshExtensionHours.
WEBSITE_AUTH_TRACE_LEVEL Controla o nível de detalhe dos rastreamentos de autenticação gravados no registo da aplicação. Os valores válidos são Off, Error, Warning, Information, e Verbose. O valor predefinido é Verbose.
WEBSITE_AUTH_VALIDATE_NONCE true ou false. O valor predefinido é true. Esse valor nunca deve ser definido para false, exceto quando estiver temporariamente a depurar falhas de validação de nonce criptográfico que ocorrem durante logins interativos.

Esta definição de aplicação destina-se a ser utilizada com a experiência de configuração V1 (clássica). Se estiveres a usar o esquema de configuração de autenticação V2, deves utilizar o valor da configuração login.nonce.validateNonce.
WEBSITE_AUTH_V2_CONFIG_JSON O Serviço de Aplicativo do Azure preenche automaticamente essa variável de ambiente. Essa variável é usada para configurar o módulo de autenticação integrado. Seu valor corresponde à configuração de autenticação V2 (não clássica) para o aplicativo atual no Azure Resource Manager. Não se destina a ser configurado explicitamente.
WEBSITE_AUTH_ENABLED Somente leitura. Injetado em um aplicativo Windows ou Linux para indicar se a autenticação do Serviço de Aplicativo está habilitada.
WEBSITE_AUTH_ENCRYPTION_KEY Por padrão, a chave gerada automaticamente é usada como a chave de criptografia. Para substituir, configure com a tecla desejada. Recomendamos essa variável de ambiente se você quiser compartilhar tokens ou sessões em vários aplicativos. Se especificares, isso substituirá a configuração MACHINEKEY_DecryptionKey.
WEBSITE_AUTH_SIGNING_KEY Por padrão, a chave gerada automaticamente é usada como a chave de assinatura. Para substituir, configure com a tecla desejada. Recomendamos essa variável de ambiente se você quiser compartilhar tokens ou sessões em vários aplicativos. Se especificares, isso substituirá a configuração MACHINEKEY_ValidationKey.

Identidade gerenciada

As variáveis de ambiente a seguir estão relacionadas a identidades gerenciadas.

Nome da configuração Descrição
IDENTITY_ENDPOINT Somente leitura. URL para recuperar o token para a identidade gerenciada do aplicativo.
MSI_ENDPOINT Preterido. Utilize IDENTITY_ENDPOINT.
IDENTITY_HEADER Somente leitura. Valor que deve ser adicionado ao X-IDENTITY-HEADER cabeçalho quando você estiver fazendo uma solicitação HTTP GET para IDENTITY_ENDPOINT. A plataforma altera o valor.
MSI_SECRET Preterido. Utilize IDENTITY_HEADER.

Verificação de saúde

As seguintes variáveis de ambiente estão relacionadas com verificações de integridade.

Nome da configuração Descrição
WEBSITE_HEALTHCHECK_MAXPINGFAILURES Número máximo de pings com falha antes de remover a instância. Defina como um valor entre 2 e 10. Quando você está aumentando ou diminuindo a escala, o Serviço de Aplicativo executa ping no caminho da verificação de integridade para garantir que as novas instâncias estejam prontas. Para obter mais informações, consulte verificação de integridade.
WEBSITE_HEALTHCHECK_MAXUNHEALTHYWORKERPERCENT Para evitar sobrecarregar instâncias saudáveis, não se exclui mais do que metade das instâncias. Por exemplo, se um plano do Serviço de Aplicativo for dimensionado para quatro instâncias e três não estiverem íntegros, no máximo duas serão excluídas. As outras duas instâncias (uma saudável e outra não saudável) continuam a receber solicitações. No pior cenário, em que todas as instâncias não são saudáveis, nenhuma delas é excluída.

Para substituir esse comportamento, defina como um valor entre 1 e 100. Um valor mais alto significa que mais casos não saudáveis são removidos. O padrão é 50 (50%).

Notificações push

As variáveis de ambiente a seguir estão relacionadas ao recurso de notificações por push .

Nome da configuração Descrição
WEBSITE_PUSH_ENABLED Somente leitura. Adicionado quando as notificações push estão ativadas.
WEBSITE_PUSH_TAG_WHITELIST Somente leitura. Contém as tags no registo de notificação.
WEBSITE_PUSH_TAGS_REQUIRING_AUTH Somente leitura. Contém uma lista de tags no registro de notificação que exigem autenticação do usuário.
WEBSITE_PUSH_TAGS_DYNAMIC Somente leitura. Contém uma lista de tags no registro de notificação que foram adicionadas automaticamente.

Observação

A tabela anterior refere-se à lista branca, um termo que a Microsoft não usa mais. Quando o termo é removido do software, nós o removemos deste artigo.

Empregos na Web

As variáveis de ambiente a seguir estão relacionadas a WebJobs.

Nome da configuração Descrição
WEBJOBS_RESTART_TIME Para trabalhos contínuos, atrase em segundos quando o processo de um trabalho fica inativo por qualquer motivo antes de ser reiniciado.
WEBJOBS_IDLE_TIMEOUT Para trabalhos desencadeados, o tempo limite é em segundos. Após esse tempo limite, o trabalho é interrompido se estiver ocioso, não tiver tempo de CPU ou não tiver saída.
WEBJOBS_HISTORY_SIZE Para trabalhos acionados, número máximo de execuções mantidas no diretório de histórico por tarefa. A predefinição é 50.
WEBJOBS_STOPPED Defina como 1 para desativar a execução de qualquer trabalho e interromper todos os trabalhos em execução no momento.
WEBJOBS_DISABLE_SCHEDULE Defina como 1 para desativar todos os acionamentos agendados. Os trabalhos ainda podem ser invocados manualmente.
WEBJOBS_ROOT_PATH Caminho absoluto ou relativo de arquivos WebJob. Para um caminho relativo, o valor é combinado com o caminho raiz padrão (D:/home/site/wwwroot/ ou /home/site/wwwroot/).
WEBJOBS_LOG_TRIGGERED_JOBS_TO_APP_LOGS Defina para true para enviar a saída de WebJobs acionados para o canal de logs de aplicativos (que suporta sistemas de arquivos, blobs e tabelas).
WEBJOBS_SHUTDOWN_FILE Arquivo que o Serviço de Aplicativo cria quando uma solicitação de desligamento é detetada. É responsabilidade do processo WebJob detetar a presença desse arquivo e iniciar o desligamento. Quando você usa o SDK WebJobs, essa parte é manipulada automaticamente.
WEBJOBS_PATH Somente leitura. Caminho raiz do trabalho em execução no momento, em um diretório temporário.
WEBJOBS_NAME Somente leitura. Nome do trabalho atual.
WEBJOBS_TYPE Somente leitura. Tipo de trabalho atual (triggered ou continuous).
WEBJOBS_DATA_PATH Somente leitura. Caminho de metadados para conter os logs, o histórico e os artefatos do trabalho atual.
WEBJOBS_RUN_ID Somente leitura. Para trabalhos acionados, ID atual de execução do trabalho.

Funções

Nome da configuração Descrição
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED Defina como 0 para desativar o cache de funções.
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT Consulte Referência de configurações de aplicativo para o Azure Functions.
AzureWebJobsSecretStorageType Consulte Referência de configurações de aplicativo para o Azure Functions.
FUNCTIONS_EXTENSION_VERSION Consulte Referência de configurações de aplicativo para o Azure Functions.
FUNCTIONS_WORKER_RUNTIME Consulte Referência de configurações de aplicativo para o Azure Functions.
AzureWebJobsStorage Consulte Referência de configurações de aplicativo para o Azure Functions.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING Consulte Referência de configurações de aplicativo para o Azure Functions.
WEBSITE_CONTENTSHARE Consulte Referência de configurações de aplicativo para o Azure Functions.
WEBSITE_CONTENTOVERVNET Consulte Referência de configurações de aplicativo para o Azure Functions.
WEBSITE_ENABLE_BROTLI_ENCODING Consulte Referência de configurações de aplicativo para o Azure Functions.
WEBSITE_USE_PLACEHOLDER Consulte Referência de configurações de aplicativo para o Azure Functions.
WEBSITE_PLACEHOLDER_MODE Somente leitura. Mostra se a aplicação de funções está a ser executada num host de espaço reservado (generalized) ou no seu próprio host (specialized).
WEBSITE_DISABLE_ZIP_CACHE Quando seu aplicativo é executado a partir de um pacote ZIP ( WEBSITE_RUN_FROM_PACKAGE=1), os cinco pacotes ZIP implantados mais recentemente são armazenados em cache no sistema de arquivos do aplicativo (D:\home\data\SitePackages). Defina essa variável como 1 para desabilitar esse cache. Para aplicativos de consumo Linux, o cache do pacote ZIP é desativado por padrão.