Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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. |