Partilhar via

Variáveis de ambiente e definições de aplicação no Serviço de Aplicações do Azure

Em Serviço de Aplicações do Azure, certas definições estão disponíveis para o ambiente de implementação ou 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 da aplicação.
WEBSITE_OWNER_NAME Somente leitura. Contém o ID de subscrição do Azure que detém a aplicação, 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 home (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_DEFAULT_HOSTNAME Somente leitura. O nome padrão do host da aplicação. Isto pode ser no formato <sitename>.azurewebsites.net original ou no nome <sitename>-<randomhash>.<region>.azurewebsites.netde host único . Esta definição é pegajosa e não pode ser trocada.
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. Ver Cruzar Limites Numéricos de VM.
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 definas este valor se estiveres a correr uma aplicação 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 mais informações, consulte o artigo do blogue Proactive Crash Monitoring in Serviço de Aplicações 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 para para ativar manualmente crash. 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 esta definição estiver definida para , fica desativada.
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 configurar a monitorização crash se for especificado WEBSITE_CRASHMONITORING_ENABLED. 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, defina para a cadeia de ligação da sua conta de armazenamento. Para funções, consulte a referência de definições App para Funções do Azure.

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_BYOS_BLOB_DIRECT_IO Definido para false por padrão. Se ativado, todas as transações irão consultar diretamente o armazenamento remoto e o cache será contornado. Esta configuração é aplicada ao nível da aplicação e, portanto, afeta todas as partilhas de blob montadas pela aplicação.

Só é relevante quando se usa Armazenamento de Blobs do Azure montado personalizado. Aplicável apenas a contentores Linux (não aplicável ao Windows).
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. Para Linux, o limite de tempo de arranque deve ser entre um mínimo de 10 segundos e um máximo de 1800 segundos.

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 Serviços de Aplicações para Windows contentores, o limite de tempo de início predefinido é 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. O intervalo de tempo para Windows Contentores deve ser entre um mínimo de 00:01:00 - 1 minuto, e um máximo de 00:15:00 - 15 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. É injetado numa aplicação .NET como uma definição da aplicação.
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_ SQL Server cadeia de ligação na configuração da aplicação. É injetado numa aplicação .NET como uma cadeia de ligação.
SQLAZURECONNSTR_ Base de Dados SQL do Azure cadeia de ligação na configuração da aplicação. É injetado numa aplicação .NET como uma cadeia de ligação.
POSTGRESQLCONNSTR_ PostgreSQL cadeia de ligação na configuração da aplicação. É injetado numa aplicação .NET como uma cadeia de ligação.
CUSTOMCONNSTR_ cadeia de ligação personalizada na configuração da app. É injetado numa aplicação .NET como uma cadeia de ligação.
MYSQLCONNSTR_ String de cadeia de ligação de base de dados MySQL na configuração da aplicação. É injetado numa aplicação .NET como uma cadeia de ligação.
AZUREFILESSTORAGE_ String de ligação para uma partilha personalizada para um contentor personalizado no Ficheiros do Azure.
AZUREBLOBSTORAGE_ String de ligação a uma conta de armazenamento personalizada para um contentor personalizado no Armazenamento de Blobs do Azure.
NOTIFICATIONHUBCONNSTR_ Cadeia de ligação a um notification hub no Hubs de Notificação do Microsoft Azure.
SERVICEBUSCONNSTR_ String de ligação para uma instância do Azure Service Bus.
EVENTHUBCONNSTR_ String de ligação a um event hub no Hubs de Eventos do Azure.
DOCDBCONNSTR_ String de ligação a uma base de dados no Azure Cosmos DB.
REDISCACHECONNSTR_ String de ligação para uma cache no Cache do Azure 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 deployment local Git ou cloud Git (como GitHub), defina para o branch em Azure onde pretende implementar. 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 mais informações, consulte Execute a sua aplicação em Serviço de Aplicações do Azure diretamente a partir 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 implementar em aplicações Linux usando Visual Studio (Web Deploy/MSDeploy), defina-o para 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 implementar com um template de Azure Resource Manager (template ARM), para evitar condições de corrida com chamadas de Resource Manager subsequentes.
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 aplicações Windows, a app Kudu está sempre pré-carregada.

Automação de construção

A configuração de compilação Kudu aplica-se a aplicações nativas do Windows e é usada para controlar o comportamento de implementaçõ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, existe também um timeout geral para pedidos de inatividade 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 ASP.NET automação de compilação (como durante a implementação do Git), defina esta variável para 1 para carregar um perfil de utilizador 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 .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 aplicações Windows nativas ou aplicações Windows containerizadas, esta variável é injetada num ambiente ou contentor de aplicação para permitir rotinas criptográficas ASP.NET. (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 aplicações Windows nativas ou aplicações Windows containerizadas, esta variável é injetada no ambiente ou contentor da aplicação para permitir rotinas criptográficas ASP.NET. (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 aplicações Windows nativas ou aplicações Windows containerizadas, esta variável é injetada no ambiente ou contentor da aplicação para permitir rotinas criptográficas ASP.NET. (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 aplicações Windows nativas ou aplicações Windows containerizadas, esta variável é injetada no ambiente ou contentor da aplicação para permitir rotinas criptográficas ASP.NET. (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_LOCALE_CODE Somente implantação en_US Não aplicável Código de localização do WordPress para a linguagem do site.

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 predefinido para o App Service é 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 mais informações, consulte Utilize um certificado TLS/SSL no seu código em Serviço de Aplicações 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 num contentor do Windows para os certificados intermédios carregados.
WEBSITE_ROOT_CERTS_PATH Somente leitura. Caminho num contentor do Windows para os certificados raiz carregados.

Blocos de implementação

Para mais informações sobre slots de implementação, veja Configurar ambientes de staging em Serviço de Aplicações 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 estiver a usar uma aplicação do Windows Communication Foundation, não defina esta variável.

Personalizar contentores

Para mais informações sobre contentores personalizados, veja Execute um contentor personalizado em 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 Windows contentores, defina para true para permitir que o diretório c:\home seja partilhado entre instâncias escalonadas. O padrão é true para Windows contentores.
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 Azure Container Registry 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 defeito, um contentor do Windows corre com todos os núcleos disponíveis para o escalão de preços 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 defeito, todos os contentores do Windows implementados no App Service têm um limite de memória configurado, dependendo do nível do plano do App Service. 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 defeito, as aplicações podem escalar entre carimbos 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 registo do servidor web para aplicações nativas de Windows está ativado (1) ou não (0).
WEBSITE_HTTPLOGGING_RETENTION_DAYS Período de retenção (em dias) dos registos do servidor web, se os registos do servidor web estiverem ativados para uma aplicação nativa de Windows ou Linux.

Exemplo: 10
WEBSITE_HTTPLOGGING_CONTAINER_URL URL SAS do contentor de armazenamento blob para armazenar registos do servidor web para aplicações nativas do Windows, se os registos do servidor web estiverem ativados. 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 contentor de armazenamento blob para armazenar registos de aplicações nativas para aplicações Windows, se os registos de aplicação estiverem ativados.
APPSERVICEAPPLOGS_TRACE_LEVEL Nível mínimo de log a enviar para 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 aplicações Windows nativas, defina para TRUE para desligar entradas de registo IIS para pedidos bem-sucedidos devolvidos dentro de 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 aplicações Windows e para aplicações Linux criadas 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.

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 estiver a montar uma partilha de ficheiros Azure no App Service e a conta de armazenamento estiver restrita a uma rede virtual, ative esta definição com o valor de 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 para true, desativa a atribuição da identidade principal do thread em aplicações web baseadas em ASP.NET (incluindo aplicações 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 definição para a integração legada de Aplicações Móveis para o Serviço de Aplicações 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 este valor pode fazer com que os IDs de utilizador existentes do Azure Mobile Apps mudem. 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 mais informações, veja Personalizar o início e a saída de sessão na autenticação Serviço de Aplicações 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 Aplicações do Azure preenche automaticamente esta variável de ambiente. Essa variável é usada para configurar o módulo de autenticação integrado. O seu valor corresponde à configuração de autenticação V2 (não clássica) para a aplicação atual no Azure Resource Manager. Não se destina a ser configurado explicitamente.
WEBSITE_AUTH_ENABLED Somente leitura. Injetado numa aplicação Windows ou Linux para indicar se a autenticação de Serviços de Aplicações está ativada.
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.
WEBSITE_AUTH_PRM_DEFAULT_WITH_SCOPES Uma lista separada por vírgulas dos escopos necessários para o aplicativo. Quando definida, essa variável configura um documento de metadados de recurso protegido padrão, que declara que os escopos especificados são suportados. Os escopos também são incluídos nos desafios de autenticação retornados pelo aplicativo.

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 a whitelist, um termo que já não Microsoft utiliza. 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 a referência de definições App para Funções do Azure.
AzureWebJobsSecretStorageType Consulte a referência de definições App para Funções do Azure.
FUNCTIONS_EXTENSION_VERSION Consulte a referência de definições App para Funções do Azure.
FUNCTIONS_WORKER_RUNTIME Consulte a referência de definições App para Funções do Azure.
AzureWebJobsStorage Consulte a referência de definições App para Funções do Azure.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING Consulte a referência de definições App para Funções do Azure.
WEBSITE_CONTENTSHARE Consulte a referência de definições App para Funções do Azure.
WEBSITE_CONTENTOVERVNET Consulte a referência de definições App para Funções do Azure.
WEBSITE_ENABLE_BROTLI_ENCODING Consulte a referência de definições App para Funções do Azure.
WEBSITE_USE_PLACEHOLDER Consulte a referência de definições App para Funções do Azure.
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.
  • Last updated on