Variáveis de ambiente e configurações de aplicativo no Serviço de Aplicativo do Azure
Nota
A partir de 1º de junho de 2024, todos os aplicativos do Serviço de Aplicativo recém-criados terão a opção de gerar um nome de host padrão exclusivo usando a convenção <app-name>-<random-hash>.<region>.azurewebsites.net
de nomenclatura. Os nomes de aplicativos existentes permanecerão inalterados.
Exemplo: myapp-ds27dh7271aah175.westus-01.azurewebsites.net
Para obter mais detalhes, consulte Nome de host padrão exclusivo para recurso do Serviço de Aplicativo.
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. Algumas dessas configurações podem ser personalizadas quando você as define 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 definição | Description | Exemplo |
---|---|---|
WEBSITE_SITE_NAME |
Só de Leitura. Nome da aplicação. | |
WEBSITE_RESOURCE_GROUP |
Só de Leitura. Nome do grupo de recursos do Azure que contém o recurso do aplicativo. | |
WEBSITE_OWNER_NAME |
Só de Leitura. Contém a ID de assinatura do Azure que possui o aplicativo, o grupo de recursos e o espaço web. | |
REGION_NAME |
Só de Leitura. Nome da região do aplicativo. | |
WEBSITE_PLATFORM_VERSION |
Só de Leitura. Versão da plataforma do Serviço de Aplicativo. | |
HOME |
Só de Leitura. Caminho para o diretório base (por exemplo, D:\home para Windows). |
|
SERVER_PORT |
Só de Leitura. A porta que o aplicativo deve ouvir. | |
WEBSITE_WARMUP_PATH |
Um caminho relativo para o ping para aquecer o aplicativo, começando com uma barra. O padrão é / , que executa ping no caminho raiz. O caminho específico pode ser executado por ping por um cliente não autenticado, como o Gerenciador de Tráfego do Azure, mesmo que a autenticação do Serviço de Aplicativo esteja definida para rejeitar clientes não autenticados. (NOTA: Esta configuração do aplicativo não altera o caminho usado pelo AlwaysOn.) |
|
WEBSITE_COMPUTE_MODE |
Só de Leitura. Especifica se o aplicativo é executado em VM/s dedicadas (Dedicated ) ou compartilhadas (Shared ). |
|
WEBSITE_SKU |
Só de Leitura. SKU do aplicativo. Os valores possíveis são Free , Shared , Basic , e Standard . |
|
SITE_BITNESS |
Só de Leitura. Mostra se o aplicativo é de 32 bits (x86 ) ou 64 bits (AMD64 ). |
|
WEBSITE_HOSTNAME |
Só de Leitura. Nome de host principal do aplicativo. Nomes de host personalizados não são contabilizados aqui. | |
WEBSITE_VOLUME_TYPE |
Só de 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 |
Só de Leitura. Limite para solicitações simultâneas do websocket. Para a camada Standard e superior, o valor é -1 , mas ainda há um limite por VM com base no tamanho da VM (consulte Limites numéricos entre VMs). |
|
WEBSITE_PRIVATE_EXTENSIONS |
Defina para 0 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 Fuso horário padrão. Se o valor especificado não for reconhecido, o UTC será usado. | Atlantic Standard Time |
WEBSITE_ADD_SITENAME_BINDINGS_IN_APPHOST_CONFIG |
Após trocas de slots, o aplicativo pode sofrer reinicializações inesperadas. Isso ocorre porque 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, determinados eventos de armazenamento subjacentes (como failovers de volume de armazenamento) podem detetar essas discrepâncias e forçar todos os processos de trabalho 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 ). No entanto, não defina esse valor se você estiver executando um aplicativo do Windows Communication Foundation (WCF). Para obter mais informações, consulte Solucionar problemas de trocas |
|
WEBSITE_PROACTIVE_AUTOHEAL_ENABLED |
Por padrão, uma instância de VM é proativamente "recuperada automaticamente" quando está usando mais de 90% da memória alocada por mais de 30 segundos ou quando 80% do total de solicitações nos últimos dois minutos leva mais de 200 segundos. Se uma instância de VM tiver acionado 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 Auto Heal proativo. |
|
WEBSITE_PROACTIVE_CRASHMONITORING_ENABLED |
Sempre que o processo de w3wp.exe em uma instância de VM do seu aplicativo falha devido a uma exceção não tratada por mais de três vezes em 24 horas, um processo de depurador é anexado ao processo de trabalho principal nessa instância e coleta 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 Monitoramento proativo de falhas. |
|
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 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 |
Um 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 registrar apenas a pilha de chamadas sem salvar o despejo de memória na conta de armazenamento, adicione ,"UseStorageAccount":"false" o 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 como a cadeia de conexão da sua conta de armazenamento. Para funções, consulte Referência de configurações do aplicativo para Funções. | DefaultEndpointsProtocol=https;AccountName=<name>;AccountKey=<key> |
WEBSITE_CONTENTSHARE |
Quando você usa especificar uma conta de armazenamento personalizada com WEBSITE_CONTENTAZUREFILECONNECTIONSTRING o , o Serviço de Aplicativo cria um compartilhamento de arquivos nessa conta de armazenamento para seu aplicativo. 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ê. |
myapp123 |
WEBSITE_SCM_ALWAYS_ON_ENABLED |
Só de Leitura. Mostra se o Always On está ativado (1 ) ou não (0 ). |
|
WEBSITE_SCM_SEPARATE_STATUS |
Só de 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 resolver o nome. | |
WEBSITE_DNS_TIMEOUT |
Número de segundos a aguardar pela resolução do nome |
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 definição | Description |
---|---|
APPSETTING_ |
Significa que uma variável é definida pelo cliente 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_ |
Significa uma 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_ |
Significa uma 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_ |
Significa uma cadeia de conexão PostgreSQL na configuração do aplicativo. Ele é injetado em um aplicativo .NET como uma cadeia de conexão. |
CUSTOMCONNSTR_ |
Significa uma cadeia de conexão personalizada na configuração do aplicativo. Ele é injetado em um aplicativo .NET como uma cadeia de conexão. |
MYSQLCONNSTR_ |
Significa uma 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_ |
Uma cadeia de conexão para um compartilhamento personalizado para um contêiner personalizado nos Arquivos do Azure. |
AZUREBLOBSTORAGE_ |
Uma cadeia de conexão para uma conta de armazenamento personalizada para um contêiner personalizado no Armazenamento de Blob do Azure. |
NOTIFICATIONHUBCONNSTR_ |
Significa uma cadeia de conexão para um hub de notificação nos Hubs de Notificação do Azure. |
SERVICEBUSCONNSTR_ |
Significa uma cadeia de conexão para uma instância do Barramento de Serviço do Azure. |
EVENTHUBCONNSTR_ |
Significa uma cadeia de conexão para um hub de eventos nos Hubs de Eventos do Azure. |
DOCDBCONNSTR_ |
Significa uma cadeia de conexão para um banco de dados no Azure Cosmos DB. |
REDISCACHECONNSTR_ |
Significa uma cadeia de conexão para um cache no Cache do Azure para Redis. |
FILESHARESTORAGE_ |
Significa uma cadeia de conexão para um compartilhamento de arquivos personalizado. |
Implementaçã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.
Nome da definição | Description |
---|---|
DEPLOYMENT_BRANCH |
Para implantação local do Git ou do Git na nuvem (como o GitHub), defina como a ramificação no Azure na qual você deseja implantar. Por padrão, é master . |
WEBSITE_RUN_FROM_PACKAGE |
Defina para 1 executar o aplicativo a partir de um pacote ZIP local ou defina como a URL de uma URL externa para executar o aplicativo 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. WEBSITE_RUN_FROM_PACKAGE Utilize. |
WEBSITE_RUN_FROM_ZIP |
Preterido. WEBSITE_RUN_FROM_PACKAGE Utilize. |
SCM_MAX_ZIP_PACKAGE_COUNT |
Seu aplicativo mantém 5 dos arquivos zip mais recentes implantados usando zip deploy. Você pode manter mais ou menos definindo a configuração do aplicativo para um número diferente. |
WEBSITE_WEBDEPLOY_USE_SCM |
Defina como false para WebDeploy para parar de usar o mecanismo de implantação do Kudu. A predefinição é true . Para implantar em aplicativos Linux usando o Visual Studio (WebDeploy/MSDeploy), defina-o como false . |
MSDEPLOY_RENAME_LOCKED_FILES |
Defina como 1 para tentar renomear DLLs se elas não puderem ser copiadas durante uma implantação do WebDeploy. 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 o Git deploy 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 implantar com um modelo ARM, para evitar condições de corrida com chamadas ARM subsequentes. |
WEBSITE_START_SCM_ON_SITE_CREATION |
Em uma implantação de modelo ARM, defina como 1 no modelo ARM para pré-iniciar o aplicativo Kudu como parte da criação do aplicativo. |
WEBSITE_START_SCM_WITH_PRELOAD |
Para aplicativos Linux, defina para true forçar o pré-carregamento do aplicativo Kudu quando o Always On estiver ativado executando ping em 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 definição | Description | Exemplo |
---|---|---|
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. | Para fazer uma construção limpa: -t:Clean;Compile |
SCM_SCRIPT_GENERATOR_ARGS |
Kudu usa o azure site deploymentscript comando descrito aqui 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. |
Para tratar seu repositório como arquivos de conteúdo simples: --basic -p <folder-to-deploy> |
SCM_TRACE_LEVEL |
Nível de rastreamento de compilação. A predefinição é 1 . Defina para valores mais altos, até 4, para mais rastreamento. |
4 |
SCM_COMMAND_IDLE_TIMEOUT |
Tempo limite em segundos para cada comando que o processo de compilação inicia para aguardar antes sem produzir qualquer saída. Depois disso, o comando é considerado ocioso e morto. 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 ainda continuará executando o 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 para 0 usar 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 implantação do Git), defina essa variável para 1 carregar um perfil de usuário completo no ambiente de compilação. Esta definição só é aplicável quando WEBSITE_COMPUTE_MODE é Dedicated . |
|
WEBSITE_SCM_IDLE_TIMEOUT_IN_MINUTES |
Tempo limite em minutos para o site SCM (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 no Git deploy, 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. Configurações adicionais estão disponíveis durante a automação de compilação no momento da implantação.
Nome da definição | Description |
---|---|
PORT |
Só de Leitura. Para aplicativos Linux, porta que o tempo de execução do .NET escuta no contêiner. |
WEBSITE_ROLE_INSTANCE_ID |
Só de Leitura. ID da instância atual. |
HOME |
Só de Leitura. Diretório que aponta para armazenamento compartilhado (/home ). |
DUMP_DIR |
Só de Leitura. Diretório para os despejos de memória (/home/logs/dumps ). |
APP_SVC_RUN_FROM_COPY |
Apenas aplicações Linux. Por padrão, o aplicativo é executado a partir de /home/site/wwwroot , um diretório compartilhado para todas as instâncias dimensionadas. 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 em contêineres do Windows, essa variável é injetada no ambiente ou contêiner do aplicativo para habilitar rotinas criptográficas ASP.NET (consulte machineKey Element. Para substituir o valor padrão decryption , configure-o como uma configuração de aplicativo do Serviço de Aplicativo ou defina-o machineKey diretamente no elemento do arquivo Web.config . |
MACHINEKEY_DecryptionKey |
Para aplicativos nativos do Windows ou aplicativos em contêineres do Windows, essa variável é injetada no ambiente ou contêiner do aplicativo para habilitar rotinas criptográficas ASP.NET (consulte machineKey Element. Para substituir o valor gerado decryptionKey automaticamente, configure-o como uma configuração de aplicativo do Serviço de Aplicativo ou defina-o diretamente no machineKey elemento do arquivo Web.config . |
MACHINEKEY_Validation |
Para aplicativos nativos do Windows ou aplicativos em contêineres do Windows, essa variável é injetada no ambiente ou contêiner do aplicativo para habilitar rotinas criptográficas ASP.NET (consulte machineKey Element. Para substituir o valor padrão validation , configure-o como uma configuração de aplicativo do Serviço de Aplicativo ou defina-o machineKey diretamente no elemento do arquivo Web.config . |
MACHINEKEY_ValidationKey |
Para aplicativos nativos do Windows ou aplicativos em contêineres do Windows, essa variável é injetada no ambiente ou contêiner do aplicativo para habilitar rotinas criptográficas ASP.NET (consulte machineKey Element. Para substituir o valor gerado validationKey automaticamente, configure-o como uma configuração de aplicativo do Serviço de Aplicativo ou defina-o diretamente no machineKey elemento do arquivo Web.config . |
WordPress
Configuração do aplicativo | Âmbito | Value | Máx | Description |
---|---|---|---|---|
WEBSITES_ENABLE_APP_SERVICE_STORAGE |
Aplicação Web | verdadeiro | - | Quando definido como TRUE, o conteúdo do arquivo é preservado durante as reinicializações. |
WP_MEMORY_LIMIT |
WordPress | 128 milhões | 512 milhões | Frontend ou limite geral de memória PHP wordpress (por script). Não pode ser mais do que PHP_MEMORY_LIMIT |
WP_MAX_MEMORY_LIMIT |
WordPress | 256 milhões | 512 milhões | Limite de memória PHP do painel de administração (por script). Geralmente, os scripts de painel de administração/back-end consomem muita memória em comparação com os scripts de frontend. Não pode ser mais do que PHP_MEMORY_LIMIT. |
PHP_MEMORY_LIMIT |
PHP | 512 milhões | 512 milhões | Limites de memória para script PHP geral. Só pode ser diminuída. |
FILE_UPLOADS |
PHP | Ativado | - | Pode ser On ou Off. Observe que os valores diferenciam maiúsculas de minúsculas. Habilita ou desabilita o upload de arquivos. |
UPLOAD_MAX_FILESIZE |
PHP | 50 M. | Limite máximo de tamanho de upload de arquivo de 256M. Pode ser aumentado até 256M. | |
POST_MAX_SIZE |
PHP | 128 milhões | 256 milhões | 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. Por favor, quebre os scripts se estiver demorando mais de 120 segundos. Adicionado para evitar que scripts ruins atrasem o sistema. |
MAX_INPUT_TIME |
PHP | 120 | 120 | Limite máximo de tempo para analisar as solicitações de entrada. Só pode ser diminuído. |
MAX_INPUT_VARS |
PHP | 10000 | 10000 | - |
DATABASE_HOST |
Base de Dados | - | - | Host de banco de dados usado para se conectar ao WordPress. |
DATABASE_NAME |
Base de Dados | - | - | Nome do banco de dados usado para se conectar ao WordPress. |
DATABASE_USERNAME |
Base de Dados | - | - | Nome de usuário do banco de dados usado para se conectar ao WordPress. |
DATABASE_PASSWORD |
Base de Dados | - | - | 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 | - | - | E-mail de administrador do WordPress. |
WORDPRESS_ADMIN_PASSWORD |
Somente implantação | - | - | Senha de administrador do WordPress. Isso é 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 | - | - | Nome de usuário do administrador do WordPress |
WORDPRESS_ADMIN_LOCALE_CODE |
Somente implantação | - | - | Nome de usuário do banco de dados usado para se conectar ao WordPress. |
Domínio e DNS
Nome da definição | Description | Exemplo |
---|---|---|
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 VNet ou está em um ambiente de Serviço de Aplicativo, ele herda a configuração do servidor DNS da VNet por padrão. |
10.0.0.1 |
WEBSITE_DNS_ALT_SERVER |
Endereço IP do servidor DNS de fallback para conexõ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 serão liberadas & além do cache existente a ser liberado 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 definição | Description |
---|---|
WEBSITE_LOAD_CERTIFICATES |
Valores de impressão digital separados por vírgulas para o certificado que você deseja carregar em seu código ou * 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 |
Só de Leitura. Caminho em um contêiner do Windows para os certificados privados carregados. |
WEBSITE_PUBLIC_CERTS_PATH |
Só de Leitura. Caminho em um contêiner do Windows para os certificados públicos carregados. |
WEBSITE_INTERMEDIATE_CERTS_PATH |
Só de Leitura. Caminho em um contêiner do Windows para os certificados intermediários carregados. |
WEBSITE_ROOT_CERTS_PATH |
Só de Leitura. Caminho em um contêiner do Windows para os certificados 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 definição | Description | Exemplo |
---|---|---|
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS |
Por padrão, as versões para extensões de site são específicas para cada slot. Isso evita um 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 sejam trocadas, 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 essa configuração como false ou 0 para todos os slots de implantação para torná-los permutáveis. Não há controle de grão fino para tipos de configuração específicos. |
|
WEBSITE_SWAP_WARMUP_PING_PATH |
Caminho para ping para aquecer o slot de destino em uma troca, começando com uma barra. O padrão é / , que executa ping no caminho raiz sobre HTTP. |
/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. | 200,202 |
WEBSITE_SLOT_NUMBER_OF_TIMEOUTS_BEFORE_RESTART |
Durante uma troca de slot, o número máximo de tempos limite após o qual forçamos a reinicialização do site em uma instância de VM específica. 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 seu aplicativo acionar uma reinicialização porque applicationHost.config é atualizado com os nomes de host trocados dos slots, defina essa variável como true para evitar uma reinicialização desse tipo. Se você estiver executando um aplicativo WCF (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 definição | Description | Exemplo |
---|---|---|
WEBSITES_ENABLE_APP_SERVICE_STORAGE |
Para contêineres personalizados do Linux: definido para true permitir que o /home diretório seja compartilhado entre instâncias dimensionadas. O padrão é false para contêineres personalizados do Linux.Para contêineres do Windows: definido para true permitir que o c:\home diretório seja compartilhado entre instâncias dimensionadas. O padrão é true para contêineres do Windows. |
|
WEBSITES_CONTAINER_START_TIME_LIMIT |
Quantidade de tempo, em segundos, para aguardar que o contêiner conclua a inicialização antes de reiniciar o contêiner. A predefinição é 230 . Você pode aumentá-lo até o máximo de 1800 . |
|
WEBSITES_CONTAINER_STOP_TIME_LIMIT |
Quantidade de tempo em segundos para esperar que o recipiente termine normalmente. A predefinição é 5 . Pode aumentar até um máximo de 120 |
|
DOCKER_REGISTRY_SERVER_URL |
URL do servidor de registro, ao executar um contêiner personalizado no Serviço de Aplicativo. Por segurança, essa variável não é passada para o contêiner. | 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 extraia de um registro dentro de uma Rede Virtual ou localmente. Seu aplicativo precisará estar conectado a uma Rede Virtual usando o recurso de integração VNet. Essa configuração também é necessária para o Registro de Contêiner do Azure com Ponto de Extremidade Privado. | |
WEBSITES_WEB_CONTAINER_NAME |
Em um aplicativo Docker Compose, apenas um dos contêineres pode ser acessível pela Internet. Defina como o nome do contêiner definido no arquivo de configuração para substituir a seleção de contêiner padrão. Por padrão, o contêiner acessível pela Internet é o primeiro contêiner a definir a porta 80 ou 8080 ou, quando nenhum contêiner é encontrado, 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 o limite de 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 do Azure têm um limite de memória configurado dependendo da SKU do Plano do Serviço de Aplicativo. Defina para o limite de memória desejado em MB. 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. |
Dimensionamento
Nome da definição | Description |
---|---|
WEBSITE_INSTANCE_ID |
Só de Leitura. ID exclusiva da instância de VM atual, quando o aplicativo é expandido para várias instâncias. |
WEBSITE_IIS_SITE_NAME |
Preterido. WEBSITE_INSTANCE_ID Utilize. |
WEBSITE_DISABLE_OVERLAPPED_RECYCLING |
A reciclagem sobreposta faz com 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, os aplicativos podem ser dimensionados entre carimbos se usarem Arquivos do Azure ou um contêiner do Docker. Defina como 1 ou true para desativar o dimensionamento de carimbo cruzado dentro da região do aplicativo. A predefinição é 0 . Contêineres personalizados do Docker que são definidos WEBSITES_ENABLE_APP_SERVICE_STORAGE ou true 1 não podem dimensionar carimbos cruzados porque seu conteúdo não está completamente encapsulado no contêiner do Docker. |
Registo
Nome da definição | Description | Exemplo |
---|---|---|
WEBSITE_HTTPLOGGING_ENABLED |
Só de 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 de logs do servidor Web, se os logs do servidor Web estiverem habilitados para um aplicativo nativo do Windows ou Linux. | 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 estiverem definidos, 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 de logs de aplicativos para aplicativos nativos do Windows, se os logs de aplicativos estiverem habilitados. | 10 |
DIAGNOSTICS_AZUREBLOBCONTAINERSASURL |
URL SAS do contêiner de armazenamento de blob para armazenar logs de aplicativos nativos do Windows, se os logs de aplicativos estiverem habilitados. | |
APPSERVICEAPPLOGS_TRACE_LEVEL |
Nível mínimo de log a ser enviado ao Log Analytics para o tipo de log AppServiceAppLogs . | |
DIAGNOSTICS_LASTRESORTFILE |
O nome do arquivo a ser criado, ou um 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 |
A pasta de log, relativa à raiz do aplicativo (D:\home\site\wwwroot ou /home/site/wwwroot ). |
..\..\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 para 0 desativá-lo. |
|
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 fazer benchmarking de desempenho removendo o registro estendido. |
Contadores de desempenho
A seguir estão variáveis de ambiente 'falsas' que não existem se você enumerá-las, mas retornam seu valor se você procurá-las individualmente. O valor é dinâmico e pode mudar a cada pesquisa.
Nome da definição | Description |
---|---|
WEBSITE_COUNTERS_ASPNET |
Um objeto JSON que contém os contadores de perf ASP.NET. |
WEBSITE_COUNTERS_APP |
Um objeto JSON contendo contadores de área restrita. |
WEBSITE_COUNTERS_CLR |
Um objeto JSON contendo contadores CLR. |
WEBSITE_COUNTERS_ALL |
Um objeto JSON contendo a combinação das outras três variáveis. |
Colocação em cache
Nome da definição | Description |
---|---|
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.- OnStorageIndisponibilidade - Disabled : Desativado para o aplicativo. |
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 MB. O padrão é 1000 (1 GB). |
WEBSITE_LOCALCACHE_READY |
Sinalizador somente leitura indicando se o aplicativo usa cache local. |
WEBSITE_DYNAMIC_CACHE |
Devido à natureza compartilhada 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 (a mesma %SYSTEMDRIVE%\local cota é aplicada). 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 o 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 as implantações não sejam bloqueadas por arquivos bloqueados. |
Rede
As variáveis de ambiente a seguir estão relacionadas a conexões híbridas e integração VNET.
Nome da definição | Description |
---|---|
WEBSITE_RELAYS |
Só de 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 |
Só de Leitura. Usado em tempo de execução para fazer as pesquisas e reescrever conexões apropriadamente. |
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 para 1 rotear todo o tráfego de saída para sua rede virtual e estar sujeito aos mesmos NSGs e UDRs. A configuração permite que você acesse pontos de extremidade não RFC1918 por meio de sua rede virtual, proteja todo o tráfego de saída que sai do seu aplicativo e force todo o tráfego de saída para um dispositivo de rede de sua escolha. |
WEBSITE_PRIVATE_IP |
Só de Leitura. Endereço IP associado ao aplicativo quando integrado a uma rede virtual. Para Integração de VNet Regional, o valor é um IP do intervalo de endereços da sub-rede delegada e, para Integração de VNet necessária pelo gateway, o valor é um IP do intervalo de endereços do pool de endereços ponto a site configurado no Gateway de Rede Virtual. Esse IP é usado pelo aplicativo para se conectar aos recursos por meio da rede virtual. Além disso, ele pode mudar dentro do intervalo de endereços descrito. |
WEBSITE_PRIVATE_PORTS |
Só de Leitura. Na integração VNet, mostra quais portas são utilizáveis pelo aplicativo 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 VNET, certifique-se de habilitar essa configuração com um 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 definição | Description |
---|---|
WEBSITE_KEYVAULT_REFERENCES |
Só de Leitura. Contém informações (incluindo status) para todas as referências do Cofre da Chave 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 da Chave, o aplicativo não poderá resolver a referência do cofre da chave na criação ou atualização do aplicativo se uma das seguintes condições for verdadeira: - O aplicativo acessa o cofre de chaves com uma identidade atribuída pelo sistema. - O aplicativo acessa o cofre de chaves com 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 |
Este env var pode ser definido como 1 pelos usuários para garantir que um certificado do qual um processo de trabalho depende não seja excluído até que ele saia. |
CORS
As variáveis de ambiente a seguir estão relacionadas à configuração do CORS (Cross-Origin Resource Sharing).
Nome da definição | Description |
---|---|
WEBSITE_CORS_ALLOWED_ORIGINS |
Só de Leitura. Mostra as origens permitidas para CORS. |
WEBSITE_CORS_SUPPORT_CREDENTIALS |
Só de Leitura. Mostra se a configuração do cabeçalho como true está habilitada Access-Control-Allow-Credentials (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 definição | Description |
---|---|
WEBSITE_AUTH_DISABLE_IDENTITY_FLOW |
Quando definido como true , desabilita a atribuição da identidade principal do thread no ASP. Aplicações Web baseadas em NET (incluindo aplicações de função v1). Isso foi projetado para permitir que os desenvolvedores protejam o acesso ao site com auth, mas ainda assim façam com que ele use um mecanismo de login 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 do Azure herdada para o Serviço de Aplicativo do Azure. Definir isso para true resolver um problema em que o SID (ID de segurança) gerado para usuários autenticados pode mudar se o usuário alterar suas informações de perfil. A alteração desse valor pode resultar na alteração das IDs de usuário existentes dos Aplicativos Móveis do Azure. 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 logins controlados pelo navegador. Se um início de sessão não for concluído no tempo especificado, o fluxo 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 estiver usando o esquema de configuração de autenticação V2, você deverá usar o valor de login.nonce.nonceExpirationInterval configuração. |
WEBSITE_AUTH_PRESERVE_URL_FRAGMENT |
Quando definido como true e os usuários selecionam links de aplicativos que contêm fragmentos de URL, o processo de entrada garantirá que a parte do fragmento de URL do URL não se perca no processo de redirecionamento de login. Para obter mais informações, consulte Personalizar entrada e saída 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 de declarações herdadas de nomes curtos a longos na API, portanto /.auth/me , determinados mapeamentos são excluídos (por exemplo, "funções"). Para obter a versão mais moderna dos mapeamentos de declarações, defina essa variável como False . No exemplo "roles", ele seria mapeado para o nome da 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 , 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 estiver usando o esquema de configuração de autenticação V2, você deverá usar o valor de identityProviders.azureActiveDirectory.login.disableWwwAuthenticate configuração. |
WEBSITE_AUTH_STATE_DIRECTORY |
Um 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 estiver usando o esquema de configuração de autenticação V2, você deverá usar o valor de login.tokenStore.fileSystem.directory configuração. |
WEBSITE_AUTH_TOKEN_CONTAINER_SASURL |
Uma 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 falharão e os usuários finais precisarão entrar novamente. Esta definição de aplicação destina-se a ser utilizada com a experiência de configuração V1 (clássica). Se estiver usando o esquema de configuração de autenticação V2, você deverá usar o valor de login.tokenStore.tokenRefreshExtensionHours configuração. |
WEBSITE_AUTH_TRACE_LEVEL |
Controla a detalhamento dos rastreamentos de autenticação gravados no log do aplicativo. 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 como false exceto ao depurar temporariamente 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 estiver usando o esquema de configuração de autenticação V2, você deverá usar o valor de login.nonce.validateNonce configuração. |
WEBSITE_AUTH_V2_CONFIG_JSON |
Essa variável de ambiente é preenchida automaticamente pela plataforma do Serviço de Aplicativo do Azure e é usada para configurar o módulo de autenticação integrado. O valor dessa variável de ambiente corresponde à configuração de autenticação V2 (não clássica) para o aplicativo atual no Gerenciador de Recursos do Azure. Não se destina a ser configurado explicitamente. |
WEBSITE_AUTH_ENABLED |
Só de 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, defina como uma chave desejada. Isso é recomendado se você quiser compartilhar tokens ou sessões em vários aplicativos. Se especificado, ele substitui a MACHINEKEY_DecryptionKey configuração. |
WEBSITE_AUTH_SIGNING_KEY |
Por padrão, a chave gerada automaticamente é usada como a chave de assinatura. Para substituir, defina como uma chave desejada. Isso é recomendado se você quiser compartilhar tokens ou sessões em vários aplicativos. Se especificado, ele substitui a MACHINEKEY_ValidationKey configuração. |
Identidade gerida
As variáveis de ambiente a seguir estão relacionadas a identidades gerenciadas.
Nome da definição | Description |
---|---|
IDENTITY_ENDPOINT |
Só de Leitura. A URL para recuperar o token para a identidade gerenciada do aplicativo. |
MSI_ENDPOINT |
Preterido. IDENTITY_ENDPOINT Utilize. |
IDENTITY_HEADER |
Só de Leitura. Valor que deve ser adicionado ao X-IDENTITY-HEADER cabeçalho ao fazer uma solicitação HTTP GET para IDENTITY_ENDPOINT . O valor é girado pela plataforma. |
MSI_SECRET |
Preterido. IDENTITY_HEADER Utilize. |
Verificação de estado de funcionamento
As seguintes variáveis de ambiente estão relacionadas com verificações de integridade.
Nome da definição | Description |
---|---|
WEBSITE_HEALTHCHECK_MAXPINGFAILURES |
O número máximo de pings com falha antes de remover a instância. Defina como um valor entre 2 e 100 . Quando você está aumentando ou reduzindo a escala, o Serviço de Aplicativo executa ping no caminho de verificação de integridade para garantir que novas instâncias estejam prontas. Para obter mais informações, consulte Verificação de integridade. |
WEBSITE_HEALTHCHECK_MAXUNHEALTHYWORKERPERCENT |
Para evitar casos saudáveis avassaladores, não mais da metade dos casos serão excluídos. 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 íntegra) continuarão a receber solicitações. No pior cenário, em que todas as instâncias não estejam íntegras, nenhuma será excluída. Para substituir esse comportamento, defina como um valor entre 1 e 100 . Um valor mais alto significa que mais instâncias não íntegras serão removidas. 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 definição | Description |
---|---|
WEBSITE_PUSH_ENABLED |
Só de Leitura. Adicionado quando as notificações push estão ativadas. |
WEBSITE_PUSH_TAG_WHITELIST |
Só de Leitura. Contém as tags no registro de notificação. |
WEBSITE_PUSH_TAGS_REQUIRING_AUTH |
Só de Leitura. Contém uma lista de tags no registro de notificação que requer autenticação do usuário. |
WEBSITE_PUSH_TAGS_DYNAMIC |
Só de Leitura. Contém uma lista de tags no registro de notificação que foram adicionadas automaticamente. |
Nota
Este artigo contém referências a um termo que a Microsoft já não utiliza. Quando o termo for removido do software, iremos removê-lo deste artigo.
Webjobs
As variáveis de ambiente a seguir estão relacionadas a WebJobs.
Nome da definição | Description |
---|---|
WEBJOBS_RESTART_TIME |
Para trabalhos contínuos, atrase em segundos quando o processo de um trabalho cai por qualquer motivo antes de relançá-lo. |
WEBJOBS_IDLE_TIMEOUT |
Para trabalhos acionados, o tempo limite em segundos, após o qual o trabalho é abortado se estiver ocioso, não tem tempo de CPU ou 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 parar 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 como true para enviar a saída de WebJobs acionados para o pipeline de logs do aplicativo (que suporta sistema 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 de trabalho na Web detetar a presença desse arquivo e iniciar o desligamento. Ao usar o SDK WebJobs, essa parte é tratada automaticamente. |
WEBJOBS_PATH |
Só de Leitura. Caminho raiz do trabalho em execução no momento (estará em algum diretório temporário). |
WEBJOBS_NAME |
Só de Leitura. Nome do trabalho atual. |
WEBJOBS_TYPE |
Só de Leitura. Tipo de trabalho atual (triggered ou continuous ). |
WEBJOBS_DATA_PATH |
Só de Leitura. Caminho de metadados do trabalho atual para conter os logs, o histórico e qualquer artefato do trabalho. |
WEBJOBS_RUN_ID |
Só de Leitura. Para trabalhos acionados, ID de execução atual do trabalho. |
Funções
Nome da definição | Description |
---|---|
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED |
Defina como 0 para desativar o cache de funções. |
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT |
Referência das definições de aplicação para as Funções do Azure |
AzureWebJobsSecretStorageType |
Referência das definições de aplicação para as Funções do Azure |
FUNCTIONS_EXTENSION_VERSION |
Referência das definições de aplicação para as Funções do Azure |
FUNCTIONS_WORKER_RUNTIME |
Referência das definições de aplicação para as Funções do Azure |
AzureWebJobsStorage |
Referência das definições de aplicação para as Funções do Azure |
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING |
Referência das definições de aplicação para as Funções do Azure |
WEBSITE_CONTENTSHARE |
Referência das definições de aplicação para as Funções do Azure |
WEBSITE_CONTENTOVERVNET |
Referência das definições de aplicação para as Funções do Azure |
WEBSITE_ENABLE_BROTLI_ENCODING |
Referência das definições de aplicação para as Funções do Azure |
WEBSITE_USE_PLACEHOLDER |
Referência das definições de aplicação para as Funções do Azure |
WEBSITE_PLACEHOLDER_MODE |
Só de Leitura. Mostra se o aplicativo de função está sendo executado em um host de espaço reservado (generalized ) ou em 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. |