Condividi tramite

Variabili di ambiente e impostazioni dell'app in Servizio app di Azure

In Servizio app di Azure, alcune impostazioni sono disponibili per l'ambiente di distribuzione o runtime come variabili di ambiente. È possibile personalizzare alcune di queste impostazioni quando vengono impostate manualmente come impostazioni dell'app. Questo riferimento mostra le variabili che è possibile usare o personalizzare.

Ambiente dell'app

Le variabili di ambiente seguenti sono correlate all'ambiente dell'app in generale.

Nome impostazione Descrizione
WEBSITE_SITE_NAME Di sola lettura. Nome dell'app.
WEBSITE_RESOURCE_GROUP Di sola lettura. Nome del gruppo di risorse di Azure che contiene la risorsa dell'app.
WEBSITE_OWNER_NAME Di sola lettura. Contiene l'ID sottoscrizione di Azure proprietario dell'app, del gruppo di risorse e dello spazio Web.
REGION_NAME Di sola lettura. Nome dell'area dell'app.
WEBSITE_PLATFORM_VERSION Di sola lettura. Versione della piattaforma App Service.
HOME Di sola lettura. Percorso della home directory (ad esempio, D:\home per Windows).
SERVER_PORT Di sola lettura. Porta che l'app deve ascoltare.
WEBSITE_WARMUP_PATH Percorso relativo del ping per riscaldare l'app, a partire da una barra. Il valore predefinito è /robots933456.txt.

Ogni volta che la piattaforma avvia un contenitore, l'agente di orchestrazione effettua richieste ripetute su questo endpoint. La piattaforma considera qualsiasi risposta da questo endpoint come indicazione che il contenitore è pronto. Quando la piattaforma considera che il contenitore sia pronto, inizia a inoltrare traffico organico al contenitore appena avviato. A meno che WEBSITE_WARMUP_STATUSES non sia configurata, la piattaforma considera qualsiasi risposta dal contenitore in questo endpoint (anche codici di errore come 404 o 502) come indicazione che il contenitore è pronto.

Questa impostazione dell'app non modifica il percorso usato da Always On.
WEBSITE_WARMUP_STATUSES Elenco delimitato da virgole di codici di stato HTTP considerati riusciti quando la piattaforma effettua ping di riscaldamento su un contenitore appena avviato. Utilizzato insieme a WEBSITE_WARMUP_PATH,

Per impostazione predefinita, qualsiasi codice di stato è considerato un'indicazione che il contenitore è pronto per il traffico organico. È possibile usare questa app per richiedere una risposta specifica prima che il traffico organico venga instradato al contenitore.

Un esempio è 200,202. Se i ping sul percorso di riscaldamento configurato dell'app ricevono una risposta con un codice di stato 200 o 202, il traffico organico viene instradato al contenitore. Se viene ricevuto un codice di stato che non si trova nell'elenco (ad esempio 502), la piattaforma continua a effettuare ping fino a quando non viene ricevuto un numero 200 o 202 o fino al raggiungimento del limite di timeout di avvio del contenitore. Vedi WEBSITES_CONTAINER_START_TIME_LIMIT più avanti in questa tabella.

Se il contenitore non risponde con un codice di stato HTTP incluso nell'elenco, alla fine la piattaforma non riesce a effettuare il tentativo di avvio e riprova, il che genera errori 503.
WEBSITE_COMPUTE_MODE Di sola lettura. Specifica se l'app viene eseguita in macchine virtuali dedicate (Dedicated) o condiviseShared ().
WEBSITE_SKU Di sola lettura. Piano tariffario dell'app. I valori consentiti sono Free, Shared, Basic e Standard.
SITE_BITNESS Di sola lettura. Indica se l'app è a 32 bit (x86) o a 64 bit (AMD64).
WEBSITE_HOSTNAME Di sola lettura. Nome host primario per l'app. Questa impostazione non tiene conto dei nomi host personalizzati.
WEBSITE_VOLUME_TYPE Di sola lettura. Mostra il tipo di volume di archiviazione attualmente in uso.
WEBSITE_NPM_DEFAULT_VERSION Versione npm predefinita usata dall'app.
WEBSOCKET_CONCURRENT_REQUEST_LIMIT Di sola lettura. Limite per le richieste WebSocket simultanee. Per il Standard livello e superiore, il valore è -1, ma esiste ancora un limite per macchina virtuale in base alle dimensioni della macchina virtuale. Vedere Limiti numerici tra macchine virtuali.
WEBSITE_PRIVATE_EXTENSIONS Impostare su 0 per disabilitare l'uso delle estensioni del sito privato.
WEBSITE_TIME_ZONE Per impostazione predefinita, il fuso orario per l'app è sempre UTC. È possibile modificarlo in uno qualsiasi dei valori validi elencati in Fusi orari predefiniti. Se il valore specificato non viene riconosciuto, l'app usa l'ora UTC.

Esempio: Atlantic Standard Time
WEBSITE_ADD_SITENAME_BINDINGS_IN_APPHOST_CONFIG Dopo gli scambi di slot, l'app potrebbe riscontrare riavvii imprevisti. Il motivo è che dopo uno scambio, la configurazione dell'associazione di nomi host non viene sincronizzata, che da sola non causa riavvii. Tuttavia, alcuni eventi di archiviazione sottostanti, ad esempio i failover del volume di archiviazione, potrebbero rilevare queste discrepanze e forzare il riavvio di tutti i processi di lavoro.

Per ridurre al minimo questi tipi di riavvii, impostare il valore dell'impostazione dell'app su 1 in tutti gli slot. Il valore predefinito è 0.) Ma non impostare questo valore se si esegue un'applicazione Windows Communication Foundation. Per altre informazioni, vedere Risolvere i problemi relativi agli scambi.
WEBSITE_PROACTIVE_AUTOHEAL_ENABLED Per impostazione predefinita, un'istanza di macchina virtuale viene corretta in modo proattivo quando usa più di 90% di memoria allocata per più di 30 secondi o quando 80% delle richieste totali negli ultimi due minuti richiedono più di 200 secondi. Se un'istanza di macchina virtuale attiva una di queste regole, il processo di ripristino è un riavvio sovrapposto dell'istanza.

Impostare su false per disabilitare questo comportamento di ripristino. Il valore predefinito è true.

Per altre informazioni, vedere il post di blog Introduzione al ripristino automatico proattivo .
WEBSITE_PROACTIVE_CRASHMONITORING_ENABLED Ogni volta che il processo w3wp.exe in un'istanza di macchina virtuale dell'app si arresta in modo anomalo a causa di un'eccezione non gestita per più di tre volte in 24 ore, un processo del debugger viene collegato al processo di lavoro principale in tale istanza. Il processo del debugger raccoglie un dump della memoria quando il processo di lavoro si arresta di nuovo in modo anomalo. Questo dump della memoria viene quindi analizzato e lo stack di chiamate del thread che ha causato l'arresto anomalo viene registrato nei log del Servizio app.

Impostare su false per disabilitare questo comportamento di monitoraggio automatico. Il valore predefinito è true.

Per altre informazioni, vedere il post di blog Monitoraggio proattivo degli arresti anomali nel servizio app di Azure.
WEBSITE_DAAS_STORAGE_SASURI Durante il monitoraggio degli arresti improvvisi (proattivo o manuale), i dump della memoria vengono eliminati di default. Per salvare i dump di memoria in un contenitore BLOB di archiviazione, specificare l'URI della firma di accesso condiviso.
WEBSITE_CRASHMONITORING_ENABLED Impostare su true per abilitare manualmente il monitoraggio degli arresti anomali. È inoltre necessario impostare WEBSITE_DAAS_STORAGE_SASURI e WEBSITE_CRASHMONITORING_SETTINGS. Il valore predefinito è false.

Questa impostazione non ha alcun effetto se il debug remoto è abilitato. Inoltre, se questa impostazione è impostata su true, il monitoraggio proattivo degli arresti anomali è disabilitato.
WEBSITE_CRASHMONITORING_SETTINGS JSON con il formato seguente:{"StartTimeUtc": "2020-02-10T08:21","MaxHours": "<elapsed-hours-from-StartTimeUtc>","MaxDumpCount": "<max-number-of-crash-dumps>"}. Obbligatorio per configurare il monitoraggio degli arresti anomali se WEBSITE_CRASHMONITORING_ENABLED è specificato. Per registrare lo stack di chiamate senza salvare il dump di arresto anomalo nell'account di archiviazione, aggiungere ,"UseStorageAccount":"false" nel codice JSON.
REMOTEDEBUGGINGVERSION Versione per il debug remoto.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING Per impostazione predefinita, il Servizio app crea automaticamente una risorsa di archiviazione condivisa al momento della creazione dell'app. Per usare invece un account di archiviazione personalizzato, impostarlo sulla stringa di connessione dell'account di archiviazione. Per le funzioni, vedere Informazioni di riferimento sulle impostazioni dell'app per Funzioni di Azure.

Esempio: DefaultEndpointsProtocol=https;AccountName=<name>;AccountKey=<key>
WEBSITE_CONTENTSHARE Quando si specifica un account di archiviazione personalizzato con WEBSITE_CONTENTAZUREFILECONNECTIONSTRING, il Servizio app crea una condivisione file nell'account di archiviazione per l'app. Per usare un nome personalizzato, impostare questa variabile sul nome desiderato. Se non esiste una condivisione file con il nome specificato, il Servizio app lo crea automaticamente.

Esempio: myapp123
WEBSITE_SCM_ALWAYS_ON_ENABLED Di sola lettura. Indica se Always On è abilitato (1) o meno (0).
WEBSITE_SCM_SEPARATE_STATUS Di sola lettura. Indica se l'app Kudu è in esecuzione in un processo separato (1) o meno (0).
WEBSITE_DNS_ATTEMPTS Numero di tentativi di risoluzione dei nomi.
WEBSITE_DNS_TIMEOUT Numero di secondi di attesa per la risoluzione dei nomi.
WEBSITES_CONTAINER_START_TIME_LIMIT Quantità di tempo (in secondi) che la piattaforma attende che un contenitore diventi pronto all'avvio. Questa impostazione si applica alle app basate su codice e basate su contenitori in servizio app per Linux. Il valore predefinito è 230.

All'avvio di un contenitore, vengono eseguiti ping ripetuti sul contenitore per misurare la conformità per gestire il traffico organico. (Vedere WEBSITE_WARMUP_PATH e WEBSITE_WARMUP_STATUSES.) Questi ping vengono continuamente eseguiti fino a quando non viene ricevuta una risposta corretta o viene raggiunto il limite di tempo di inizio. Se il contenitore non è considerato pronto entro il timeout configurato, la piattaforma fallisce il tentativo di avvio e riprova, causando errori 503.

Per i contenitori del servizio app per Windows, il limite di ora di avvio predefinito è 10 mins. È possibile modificare il limite di ora di inizio specificando un intervallo di tempo. Ad esempio, 00:05:00 indica 5 minuti.

Prefissi di variabili

La tabella seguente illustra i prefissi delle variabili di ambiente usati dal Servizio app per vari scopi.

Nome impostazione Descrizione
APPSETTING_ Indica che il cliente imposta una variabile come impostazione dell'app nella configurazione dell'app. Viene inserito in un'app .NET come impostazione dell'app.
MAINSITE_ Indica che una variabile è specifica dell'app stessa.
SCMSITE_ Indica che una variabile è specifica per l'app Kudu.
SQLCONNSTR_ Stringa di connessione di SQL Server nella configurazione dell'app. Viene inserito in un'app .NET come stringa di connessione.
SQLAZURECONNSTR_ Stringa di connessione del database SQL di Azure nella configurazione dell'app. Viene inserito in un'app .NET come stringa di connessione.
POSTGRESQLCONNSTR_ Stringa di connessione PostgreSQL nella configurazione dell'app. Viene inserito in un'app .NET come stringa di connessione.
CUSTOMCONNSTR_ Stringa di connessione personalizzata nella configurazione dell'app. Viene inserito in un'app .NET come stringa di connessione.
MYSQLCONNSTR_ Stringa di connessione del database MySQL nella configurazione dell'app. Viene inserito in un'app .NET come stringa di connessione.
AZUREFILESSTORAGE_ Stringa di connessione a una condivisione personalizzata per un contenitore personalizzato in File di Azure.
AZUREBLOBSTORAGE_ Stringa di connessione a un account di archiviazione personalizzato per un contenitore personalizzato in Azure Blob Storage.
NOTIFICATIONHUBCONNSTR_ Stringa di connessione a un hub di notifica in Hub di notifica di Azure.
SERVICEBUSCONNSTR_ Stringa di connessione a un'istanza del bus di servizio di Azure.
EVENTHUBCONNSTR_ Stringa di connessione a un hub eventi in Hub eventi di Azure.
DOCDBCONNSTR_ Stringa di connessione a un database in Azure Cosmos DB.
REDISCACHECONNSTR_ Stringa di connessione a una cache in Cache Redis di Azure.
FILESHARESTORAGE_ Stringa di connessione a una condivisione file personalizzata.

Distribuzione

Le variabili di ambiente seguenti sono correlate alla distribuzione delle app. Per le variabili correlate all'automazione della build in App Service, vedere Automazione della build più avanti in questo articolo.

Nome impostazione Descrizione
DEPLOYMENT_BRANCH Per la distribuzione Git locale o git cloud (ad esempio GitHub), impostare sul ramo in Azure in cui si vuole eseguire la distribuzione. L'impostazione predefinita è master.
WEBSITE_RUN_FROM_PACKAGE Impostare su 1 per eseguire l'app da un pacchetto ZIP locale o impostare su un URL esterno per eseguire l'app da un pacchetto ZIP remoto. Per altre informazioni, vedere Eseguire l'app nel Servizio app di Azure direttamente da un pacchetto ZIP.
WEBSITE_USE_ZIP Deprecato. Usa WEBSITE_RUN_FROM_PACKAGE.
WEBSITE_RUN_FROM_ZIP Deprecato. Usa WEBSITE_RUN_FROM_PACKAGE.
SCM_MAX_ZIP_PACKAGE_COUNT L'app mantiene cinque dei file ZIP più recenti distribuiti tramite distribuzione ZIP. È possibile mantenere più o meno modificando l'impostazione dell'app su un numero diverso.
WEBSITE_WEBDEPLOY_USE_SCM Impostare su false per Distribuzione Web per interrompere l'uso del motore di distribuzione Kudu. Il valore predefinito è true. Per eseguire la distribuzione in app Linux usando Visual Studio (Distribuzione Web/MSDeploy), impostarlo su false.
MSDEPLOY_RENAME_LOCKED_FILES Impostare su 1 per tentare di rinominare le DLL se non possono essere copiate durante una distribuzione di Distribuzione Web. Questa impostazione non è applicabile se WEBSITE_WEBDEPLOY_USE_SCM è impostato su false.
WEBSITE_DISABLE_SCM_SEPARATION Per impostazione predefinita, l'app principale e l'app Kudu vengono eseguite in sandbox diverse. Quando si arresta l'app, l'app Kudu è ancora in esecuzione ed è possibile continuare a usare la distribuzione Git e MSDeploy. Ogni app ha i propri file locali. La disattivazione di questa separazione (impostazione su true) è una modalità legacy che non è più completamente supportata.
WEBSITE_ENABLE_SYNC_UPDATE_SITE Impostare su 1 per assicurarsi che le chiamate API REST per l'aggiornamento di site e siteconfig vengano applicate completamente a tutte le istanze prima della restituzione. L'impostazione predefinita è 1 se si esegue la distribuzione con un modello di Azure Resource Manager (modello ARM), per evitare race condition con le successive chiamate di Resource Manager.
WEBSITE_START_SCM_ON_SITE_CREATION In una distribuzione di modelli di Resource Manager, impostare su 1 nel modello di Resource Manager per pre-avviare l'app Kudu come parte della creazione dell'app.
WEBSITE_START_SCM_WITH_PRELOAD Per le app Linux, impostare su true per forzare il precaricamento dell'app Kudu quando Always On è abilitato eseguendo il ping dell'URL. Il valore predefinito è false. Per le app di Windows, l'app Kudu viene sempre precaricata.

Automazione della compilazione

La configurazione della compilazione Kudu si applica alle app di Windows native e viene usata per controllare il comportamento delle distribuzioni basate su Git (o basate su ZIP).

Nome impostazione Descrizione
SCM_BUILD_ARGS Aggiungere elementi alla fine della riga di comando di MSBuild, in modo da eseguire l'override di tutte le parti precedenti della riga di comando predefinita.

Ad esempio, per eseguire una compilazione pulita: -t:Clean;Compile.
SCM_SCRIPT_GENERATOR_ARGS Kudu usa il azure site deploymentscript comando per generare uno script di distribuzione. Rileva automaticamente il tipo di framework del linguaggio e determina i parametri da passare al comando. Questa impostazione esegue l'override dei parametri generati automaticamente.

Ad esempio, per considerare il repository come file di contenuto normale: --basic -p <folder-to-deploy>.
SCM_TRACE_LEVEL Livello di traccia della compilazione. Il valore predefinito è 1. Impostare su valori più elevati, fino a 4, per una maggiore tracciabilità.
SCM_COMMAND_IDLE_TIMEOUT Timeout, in secondi, per ogni comando eseguito dal processo di compilazione prima di produrre un output. Successivamente, il comando viene considerato inattivo e arrestato. Il valore predefinito è 60 (un minuto).

In Azure è disponibile anche un timeout di richiesta inattiva generale che disconnette i client dopo 230 secondi. Tuttavia, il comando continua a essere eseguito sul lato server dopo tale operazione.
SCM_LOGSTREAM_TIMEOUT Timeout dell'inattività, in secondi, prima di arrestare il flusso di log. Il valore predefinito è 1800 (30 minuti).
SCM_SITEEXTENSIONS_FEED_URL URL della raccolta di estensioni del sito. Il valore predefinito è https://www.nuget.org/api/v2/. L'URL del feed precedente è http://www.siteextensions.net/api/v2/.
SCM_USE_LIBGIT2SHARP_REPOSITORY Impostare su 0 per usare git.exe anziché libgit2sharp per le operazioni Git.
WEBSITE_LOAD_USER_PROFILE In caso di errore The specified user does not have a valid profile durante l'automazione della compilazione ASP.NET, ad esempio durante la distribuzione Git, impostare questa variabile su 1 per caricare un profilo utente completo nell'ambiente di compilazione. Questa impostazione si applica solo quando WEBSITE_COMPUTE_MODE è Dedicated.
WEBSITE_SCM_IDLE_TIMEOUT_IN_MINUTES Timeout, espresso in minuti, per il sito di Gestione controllo del codice sorgente (Kudu). Il valore predefinito è 20.
SCM_DO_BUILD_DURING_DEPLOYMENT Con la distribuzione ZIP, il motore di distribuzione presuppone che un file ZIP sia pronto per l'esecuzione così com'è e non esegua alcuna automazione di compilazione. Per abilitare la stessa automazione della compilazione come nella distribuzione Git, impostarla su true.

Impostazioni specifiche della lingua

Questa sezione illustra le impostazioni di runtime configurabili per ogni framework di linguaggio supportato. Sono disponibili altre impostazioni durante l'automazione della compilazione in fase di distribuzione.

Nome impostazione Descrizione
PORT Di sola lettura. Per le app Linux, la porta su cui il runtime .NET è in ascolto nel contenitore.
WEBSITE_ROLE_INSTANCE_ID Di sola lettura. ID dell'istanza corrente.
HOME Di sola lettura. Directory che punta all'archiviazione condivisa (/home).
DUMP_DIR Di sola lettura. Directory per i dump di arresto anomalo del sistema (/home/logs/dumps).
APP_SVC_RUN_FROM_COPY Applicazioni Linux solo. Per impostazione predefinita, l'app viene eseguita da /home/site/wwwroot, una directory condivisa per tutte le istanze con scalabilità orizzontale. Impostare questa variabile su true per copiare l'app in una directory locale nel contenitore ed eseguirla da questa posizione. Quando si utilizza questa opzione, assicurarsi di non inserire direttamente nel codice alcun riferimento a /home/site/wwwroot. Usare invece un percorso relativo a /home/site/wwwroot.
MACHINEKEY_Decryption Per le app di Windows native o le app di Windows in contenitori, questa variabile viene inserita in un ambiente o un contenitore di app per abilitare ASP.NET routine di crittografia. (Vedere elemento machineKey.) Per eseguire l'override del valore predefinito decryption, configurarlo come impostazione dell'app del Servizio app o impostarlo direttamente nell'elemento machineKey del file Web.config.
MACHINEKEY_DecryptionKey Per le app di Windows native o le app di Windows in contenitori, questa variabile viene inserita nell'ambiente o nel contenitore dell'app per abilitare ASP.NET routine di crittografia. (Vedere elemento machineKey.) Per eseguire l'override del valore decryptionKey generato automaticamente, configurarlo come impostazione dell'app del Servizio app o impostarlo direttamente nell'elemento machineKey del file Web.config.
MACHINEKEY_Validation Per le app di Windows native o le app di Windows in contenitori, questa variabile viene inserita nell'ambiente o nel contenitore dell'app per abilitare ASP.NET routine di crittografia. (Vedere elemento machineKey.) Per eseguire l'override del valore predefinito validation, configurarlo come impostazione dell'app del Servizio app o impostarlo direttamente nell'elemento machineKey del file Web.config.
MACHINEKEY_ValidationKey Per le app di Windows native o le app di Windows in contenitori, questa variabile viene inserita nell'ambiente o nel contenitore dell'app per abilitare ASP.NET routine di crittografia. (Vedere elemento machineKey.) Per eseguire l'override del valore validationKey generato automaticamente, configurarlo come impostazione dell'app del Servizio app o impostarlo direttamente nell'elemento machineKey del file Web.config.

WordPress

Impostazione dell'applicazione Ambito Valore Massimo Descrizione
WEBSITES_ENABLE_APP_SERVICE_STORAGE Applicazione Web true Non applicabile Se impostato su true, il contenuto del file viene mantenuto durante i riavvii.
WP_MEMORY_LIMIT WordPress 128M 512M Limite di memoria PHP Front-end o generale WordPress (per script). Non può essere più di PHP_MEMORY_LIMIT.
WP_MAX_MEMORY_LIMIT WordPress 256M 512M Limite di memoria PHP del dashboard di amministrazione (per script). In genere, il dashboard di amministrazione e gli script back-end richiedono molta memoria rispetto agli script front-end. Non può essere più di PHP_MEMORY_LIMIT.
PHP_MEMORY_LIMIT PHP 512M 512M Limite di memoria per gli script PHP generali. Può essere solo ridotto.
FILE_UPLOADS PHP On Non applicabile Abilita o disabilita i caricamenti di file. Può essere On o Off. Si noti che questi valori distinguono tra maiuscole e minuscole.
UPLOAD_MAX_FILESIZE PHP 50M 256M Limite di dimensioni per il caricamento di file. Può essere aumentato fino a 256M.
POST_MAX_SIZE PHP 128M 256M Può essere aumentato fino a 256M. In genere deve essere maggiore di UPLOAD_MAX_FILESIZE.
MAX_EXECUTION_TIME PHP 120 120 Può essere solo ridotto. Suddividere gli script se sono necessari più di 120 secondi. Aggiunta per evitare che gli script errati rallentano il sistema.
MAX_INPUT_TIME PHP 120 120 Limite di tempo per l'analisi delle richieste di input. Può essere solo ridotto.
MAX_INPUT_VARS PHP 10000 10000 Numero massimo di variabili per le richieste di input.
DATABASE_HOST banca dati Non applicabile Non applicabile Host di database utilizzato per connettersi a WordPress.
DATABASE_NAME banca dati Non applicabile Non applicabile Nome del database utilizzato per connettersi a WordPress.
DATABASE_USERNAME banca dati Non applicabile Non applicabile Nome utente del database utilizzato per connettersi a WordPress.
DATABASE_PASSWORD banca dati Non applicabile Non applicabile Password del database usata per connettersi al database MySQL. Per modificare la password del database MySQL, vedere Aggiornare la password amministratore. Ogni volta che viene modificata la password del database MySQL, è necessario aggiornare anche le impostazioni dell'applicazione.
WORDPRESS_ADMIN_EMAIL Solo distribuzione Non applicabile Non applicabile E-mail di amministrazione di WordPress
WORDPRESS_ADMIN_PASSWORD Solo distribuzione Non applicabile Non applicabile Password amministratore di WordPress. Questa impostazione è solo a scopo di distribuzione. La modifica di questo valore non ha alcun effetto sull'installazione di WordPress. Per modificare la password amministratore di WordPress, vedere Reimpostare la password.
WORDPRESS_ADMIN_USER Solo distribuzione Non applicabile Non applicabile Nome utente amministratore WordPress.
WORDPRESS_ADMIN_LOCALE_CODE Solo distribuzione Non applicabile Non applicabile Nome utente del database utilizzato per connettersi a WordPress.

Dominio e DNS

Nome impostazione Descrizione
WEBSITE_DNS_SERVER Indirizzo IP del server DNS primario per le connessioni in uscita, ad esempio per un servizio back-end. Il server DNS predefinito per il Servizio app è DNS di Azure, il cui indirizzo IP è 168.63.129.16. Se l'app usa l'integrazione della rete virtuale o si trova in un ambiente del servizio App, eredita la configurazione del server DNS dalla rete virtuale per impostazione predefinita.

Esempio: 10.0.0.1
WEBSITE_DNS_ALT_SERVER Indirizzo IP del server DNS di fallback per le connessioni in uscita. Vedere WEBSITE_DNS_SERVER.
WEBSITE_ENABLE_DNS_CACHE Consente di memorizzare nella cache le risoluzioni DNS riuscite. Per impostazione predefinita, le voci della cache DNS scadute vengono scaricate (oltre alla cache esistente) ogni 4,5 minuti.

TLS/SSL

Per altre informazioni, vedere l'articolo relativo all'utilizzo di un certificato TLS/SSL nel codice nel Servizio app di Azure.

Nome impostazione Descrizione
WEBSITE_LOAD_CERTIFICATES Valori di identificazione personale delimitati da virgole nel certificato da caricare nel codice. In alternativa, usare * per consentire il caricamento di tutti i certificati nel codice. È possibile caricare solo i certificati aggiunti all'app.
WEBSITE_PRIVATE_CERTS_PATH Di sola lettura. Percorso in un contenitore di Windows per i certificati privati caricati.
WEBSITE_PUBLIC_CERTS_PATH Di sola lettura. Percorso in un contenitore Windows verso i certificati pubblici caricati.
WEBSITE_INTERMEDIATE_CERTS_PATH Di sola lettura. Percorso in un contenitore di Windows per i certificati intermedi caricati.
WEBSITE_ROOT_CERTS_PATH Di sola lettura. Percorso in un contenitore di Windows per i certificati radice caricati.

Slot di distribuzione

Per altre informazioni sull'uso degli slot di distribuzione, vedere Configurare gli ambienti di gestione temporanea nel Servizio app di Azure.

Nome impostazione Descrizione
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS Per impostazione predefinita, le versioni per le estensioni del sito sono specifiche di ogni slot. Questa impostazione predefinita impedisce il comportamento imprevisto dell'applicazione a causa della modifica delle versioni dell'estensione dopo uno scambio. Se si desidera che anche le versioni dell'estensione si scambino, impostare su 0 in tutti gli slot.
WEBSITE_OVERRIDE_PRESERVE_DEFAULT_STICKY_SLOT_SETTINGS Definisce determinate impostazioni come permanenti o non scambiabili per impostazione predefinita. Il valore predefinito è true. Impostare questo valore su false o 0 per tutti gli slot di distribuzione per renderli scambiabili. Non esiste alcun controllo con granularità fine per tipi di impostazione specifici.
WEBSITE_SWAP_WARMUP_PING_PATH Percorso di ping per riscaldare lo slot di destinazione in uno scambio, a partire da una barra obliqua. Il valore predefinito è /, che esegue il ping del percorso radice su HTTP.

Esempio: /statuscheck
WEBSITE_SWAP_WARMUP_PING_STATUSES Codici di risposta HTTP validi per l'operazione di pre-riscaldamento durante uno swap. Se il codice di stato restituito non è presente nell'elenco, le operazioni di riscaldamento e scambio vengono arrestate. Per impostazione predefinita, sono validi tutti i codici di risposta.

Esempio: 200,202
WEBSITE_SLOT_NUMBER_OF_TIMEOUTS_BEFORE_RESTART Durante uno scambio di slot, numero massimo di timeout prima del riavvio forzato del sito in un'istanza di macchina virtuale specifica. Il valore predefinito è 3.
WEBSITE_SLOT_MAX_NUMBER_OF_TIMEOUTS Durante uno scambio di slot, numero massimo di richieste di timeout per un singolo URL da effettuare prima di rinunciare. Il valore predefinito è 5.
WEBSITE_SKIP_ALL_BINDINGS_IN_APPHOST_CONFIG Impostare su true o 1 per ignorare tutte le associazioni in applicationHost.config. Il valore predefinito è false. Se l'app attiva un riavvio perché applicationHost.config viene aggiornata con i nomi host scambiati degli slot, impostare questa variabile su true per evitare un riavvio di questo tipo. Se si esegue un'app di Windows Communication Foundation, non impostare questa variabile.

Contenitori personalizzati

Per altre informazioni sui contenitori personalizzati, vedere Eseguire un contenitore personalizzato in Azure.

Nome impostazione Descrizione
WEBSITES_ENABLE_APP_SERVICE_STORAGE Per i contenitori Linux, se questa impostazione dell'app non è specificata, per impostazione predefinita la directory /home viene condivisa tra istanze scalate. È possibile impostarlo su false per disabilitare la condivisione.

Per i contenitori di Windows, impostare su true per consentire la condivisione della c:\home directory tra istanze con scalabilità orizzontale. Il valore predefinito è true per i contenitori Windows.
WEBSITES_CONTAINER_STOP_TIME_LIMIT Quantità di tempo, in secondi, di attesa per il completamento normale del contenitore. Il valore predefinito è 5. È possibile aumentare fino a un massimo di 120.
DOCKER_REGISTRY_SERVER_URL URL del server del registro quando si esegue un contenitore personalizzato su App Service. Per la sicurezza, questa variabile non viene passata al contenitore.

Esempio: https://<server-name>.azurecr.io
DOCKER_REGISTRY_SERVER_USERNAME Nome utente per l'autenticazione con il server del Registro di sistema all'indirizzo DOCKER_REGISTRY_SERVER_URL. Per la sicurezza, questa variabile non viene passata al contenitore.
DOCKER_REGISTRY_SERVER_PASSWORD Password per l'autenticazione con il server del Registro di sistema all'indirizzo DOCKER_REGISTRY_SERVER_URL. Per la sicurezza, questa variabile non viene passata al contenitore.
DOCKER_ENABLE_CI Impostare su true per abilitare la distribuzione continua per i contenitori personalizzati. Il valore predefinito è false per i contenitori personalizzati.
WEBSITE_PULL_IMAGE_OVER_VNET Connettersi ed eseguire il pull da un registro all'interno di una rete virtuale o in locale. L'app deve essere connessa a una rete virtuale tramite la funzionalità di integrazione della rete virtuale. Questa impostazione è necessaria anche per Registro Azure Container con un endpoint privato.
WEBSITES_WEB_CONTAINER_NAME In un'app Docker Compose è possibile accedere a Internet solo uno dei contenitori. Impostare sul nome del contenitore definito nel file di configurazione per eseguire l'override della selezione predefinita del contenitore. Per impostazione predefinita, il contenitore accessibile da Internet è il primo contenitore a definire la porta 80 o 8080. Quando non viene trovato alcun contenitore di questo tipo, il valore predefinito è il primo contenitore definito nel file di configurazione.
WEBSITES_PORT Per un contenitore personalizzato, il numero di porta personalizzato nel contenitore a cui il Servizio app instrada le richieste. Per impostazione predefinita, il Servizio app tenta il rilevamento automatico delle porte 80 e 8080. Questa impostazione non viene inserita nel contenitore come variabile di ambiente.
WEBSITE_CPU_CORES_LIMIT Per impostazione predefinita, un contenitore Windows viene eseguito con tutti i core disponibili per il piano tariffario scelto. Per ridurre il numero di core, impostare un limite al numero di core desiderati. Per altre informazioni, vedere Personalizzare il numero di core di calcolo.
WEBSITE_MEMORY_LIMIT_MB Per impostazione predefinita, tutti i contenitori di Windows distribuiti nel servizio app hanno un limite di memoria configurato, a seconda del livello del piano di servizio app. Impostare sul limite di memoria desiderato in megabyte. Il totale cumulativo di questa impostazione tra le app nello stesso piano non deve superare l'importo consentito dal piano tariffario scelto. Per altre informazioni, vedere Personalizzare la memoria del contenitore.

Scalabilità

Nome impostazione Descrizione
WEBSITE_INSTANCE_ID Di sola lettura. ID univoco dell'istanza corrente della macchina virtuale, nel caso in cui l'app venga scalata su più istanze.
WEBSITE_IIS_SITE_NAME Deprecato. Usa WEBSITE_INSTANCE_ID.
WEBSITE_DISABLE_OVERLAPPED_RECYCLING Il riciclo sovrapposto garantisce che prima dell'arresto dell'istanza di macchina virtuale corrente di un'app venga avviata una nuova istanza di macchina virtuale. In alcuni casi, può causare problemi di blocco dei file. È possibile provare a disattivarlo impostando su 1.
WEBSITE_DISABLE_CROSS_STAMP_SCALE Per impostazione predefinita, le app possono essere ridimensionate tra stamp se usano File di Azure o un contenitore Docker. Impostare su 1 o true per disabilitare il ridimensionamento incrociato all'interno dell'area dell'app. Il valore predefinito è 0. I contenitori Docker personalizzati che impostano WEBSITES_ENABLE_APP_SERVICE_STORAGE su true o 1 non possono ridimensionare i cross-stamp perché il contenuto non è completamente incapsulato nel contenitore Docker.

Registrazione

Nome impostazione Descrizione
WEBSITE_HTTPLOGGING_ENABLED Di sola lettura. Indica se la registrazione del server Web per le app native di Windows è abilitata (1) o meno (0).
WEBSITE_HTTPLOGGING_RETENTION_DAYS Periodo di conservazione (in giorni) dei log del server Web, se i log del server Web sono abilitati per un'app nativa di Windows o Linux.

Esempio: 10
WEBSITE_HTTPLOGGING_CONTAINER_URL URL di firma di accesso condiviso del contenitore di archiviazione BLOB per archiviare i log del server Web per le app di Windows native, se sono abilitati i log del server Web. Se non è impostata, i log del server Web vengono archiviati nel file system dell'app (archiviazione condivisa predefinita).
DIAGNOSTICS_AZUREBLOBRETENTIONINDAYS Periodo di conservazione (in giorni) dei log applicazioni per le app di Windows native, se i log delle applicazioni sono abilitati.

Esempio: 10
DIAGNOSTICS_AZUREBLOBCONTAINERSASURL URL di firma di accesso condiviso del contenitore di archiviazione BLOB per archiviare i log applicazioni per le app di Windows native, se i log dell'applicazione sono abilitati.
APPSERVICEAPPLOGS_TRACE_LEVEL Livello di log minimo da spedire a Log Analytics per il tipo di log AppServiceAppLogs.
DIAGNOSTICS_LASTRESORTFILE Nome file da creare o percorso relativo alla directory di log per registrare gli errori interni per la risoluzione dei problemi del listener. Il valore predefinito è logging-errors.txt.
DIAGNOSTICS_LOGGINGSETTINGSFILE Percorso del file di impostazioni del log, relativo a D:\home o /home. Il valore predefinito è site\diagnostics\settings.json.
DIAGNOSTICS_TEXTTRACELOGDIRECTORY Cartella di log, relativa alla radice dell'app (D:\home\site\wwwroot o /home/site/wwwroot).

Esempio: ..\..\LogFiles\Application
DIAGNOSTICS_TEXTTRACEMAXLOGFILESIZEBYTES Dimensione massima del file log in byte. Il valore predefinito è 131072 (128 KB).
DIAGNOSTICS_TEXTTRACEMAXLOGFOLDERSIZEBYTES Dimensioni massime della cartella di log in byte. Il valore predefinito è 1048576 (1 MB).
DIAGNOSTICS_TEXTTRACEMAXNUMLOGFILES Numero massimo di file di log da conservare. Il valore predefinito è 20.
DIAGNOSTICS_TEXTTRACETURNOFFPERIOD Timeout, in millisecondi, per mantenere abilitata la registrazione delle applicazioni. Il valore predefinito è 43200000 (12 ore).
WEBSITE_LOG_BUFFERING Per impostazione predefinita, il buffering del log è abilitato. Impostare su 0 per disabilitarlo.
WEBSITE_ENABLE_PERF_MODE Per le applicazioni Windows native, impostare su TRUE per disattivare le voci di log di IIS per le richieste riuscite restituite entro 10 secondi. Si tratta di un modo rapido per eseguire il benchmarking delle prestazioni rimuovendo la registrazione estesa.

Contatori delle prestazioni

Di seguito sono riportate le variabili di ambiente "fake" che non esistono se vengono enumerate, ma restituiscono il relativo valore se vengono cercate singolarmente. Il valore è dinamico e può cambiare in ogni ricerca.

Nome impostazione Descrizione
WEBSITE_COUNTERS_ASPNET Oggetto JSON che contiene ASP.NET contatori delle prestazioni.
WEBSITE_COUNTERS_APP Oggetto JSON che contiene contatori sandbox.
WEBSITE_COUNTERS_CLR Oggetto JSON che contiene contatori di Common Language Runtime.
WEBSITE_COUNTERS_ALL Oggetto JSON che contiene la combinazione delle altre tre variabili.

Memorizzazione nella cache

Nome impostazione Descrizione
WEBSITE_LOCAL_CACHE_OPTION Indica se la cache locale è abilitata. Le opzioni disponibili sono:

- Default: eredita l'impostazione globale a livello di timbro.
- Always: abilitato per l'app.
- OnStorageUnavailability
- Disabled: Disattivazione per l'app.
WEBSITE_LOCAL_CACHE_READWRITE_OPTION Opzioni di lettura/scrittura della cache locale. Le opzioni disponibili sono:

- ReadOnly: la cache è di sola lettura.
- WriteButDiscardChanges: consente le scritture nella cache locale, ma elimina le modifiche apportate localmente.
WEBSITE_LOCAL_CACHE_SIZEINMB Dimensioni della cache locale in megabyte. Il valore predefinito è 1000 (1 GB).
WEBSITE_LOCALCACHE_READY Flag di sola lettura che indica se l'app usa la cache locale.
WEBSITE_DYNAMIC_CACHE A causa della natura della condivisione file di rete per consentire l'accesso a più istanze, la cache dinamica migliora le prestazioni memorizzando nella cache i file a cui si accede di recente localmente in un'istanza. La cache viene invalidata quando il file viene modificato. Il percorso della cache è %SYSTEMDRIVE%\local\DynamicCache. Viene applicata la stessa %SYSTEMDRIVE%\local quota.

Per abilitare la memorizzazione nella cache del contenuto completo, impostare su 1, che include sia il contenuto del file che i metadati di directory/file (timestamp, dimensioni, contenuto della directory). Per conservare l'uso del disco locale, impostare 2 per memorizzare nella cache solo i metadati di directory/file (timestamp, dimensioni, contenuto della directory). Per disattivare la memorizzazione nella cache, impostare su 0.

Per le app di Windows e per le app Linux create con il modelloWordPress, il valore predefinito è 1. Per tutte le altre app Linux, il valore predefinito è 0.
WEBSITE_READONLY_APP Quando si usa una cache dinamica, è possibile disabilitare l'accesso in scrittura alla radice dell'app (D:\home\site\wwwroot o /home/site/wwwroot) impostando questa variabile su 1. Ad eccezione della App_Data directory, non sono consentiti blocchi esclusivi in modo che i file bloccati non blocchino le distribuzioni.

Rete

Le variabili di ambiente seguenti sono correlate alle connessioni ibride e all'integrazione della rete virtuale.

Nome impostazione Descrizione
WEBSITE_RELAYS Di sola lettura. Dati necessari per configurare la connessione ibrida, inclusi gli endpoint e i dati del bus di servizio.
WEBSITE_REWRITE_TABLE Di sola lettura. Usato in fase di esecuzione per eseguire le ricerche e riscrivere le connessioni in modo appropriato.
WEBSITE_VNET_ROUTE_ALL Per impostazione predefinita, se si usa l'integrazione della rete virtuale regionale, l'app instrada solo il traffico RFC1918 nella rete virtuale. Impostare il valore di 1 per indirizzare tutto il traffico in uscita nella vostra rete virtuale e essere soggetto agli stessi gruppi di sicurezza della rete e alle route definite dall'utente. L'impostazione consente di accedere a endpoint non RFC1918 tramite la rete virtuale, proteggere tutto il traffico in uscita dall'app e forzare il tunneling di tutto il traffico in uscita verso un'appliance di rete di propria scelta.
WEBSITE_PRIVATE_IP Di sola lettura. Indirizzo IP associato all'app integrata con una rete virtuale. Per l'integrazione della rete virtuale a livello di area, il valore è un indirizzo IP compreso nell'intervallo di indirizzi della subnet delegata. Per l'integrazione della rete virtuale richiesta dal gateway, il valore è un indirizzo IP compreso nell'intervallo di indirizzi del pool di indirizzi da punto a sito configurato nel gateway di rete virtuale.

L'app usa questo indirizzo IP per connettersi alle risorse tramite la rete virtuale. Inoltre, può cambiare all'interno dell'intervallo di indirizzi descritto.
WEBSITE_PRIVATE_PORTS Di sola lettura. Nell'integrazione della rete virtuale, mostra le porte che l'app può usare per comunicare con altri nodi.
WEBSITE_CONTENTOVERVNET Se si sta montando una condivisione file di Azure nel servizio app e l'account di archiviazione è limitato a una rete virtuale, abilitare questa impostazione con il valore 1.

Riferimenti a Key Vault

Le variabili di ambiente seguenti sono correlate ai riferimenti a Key Vault.

Nome impostazione Descrizione
WEBSITE_KEYVAULT_REFERENCES Di sola lettura. Contiene informazioni (inclusi gli stati) per tutti i riferimenti a Key Vault attualmente configurati nell'app.
WEBSITE_SKIP_CONTENTSHARE_VALIDATION Se si imposta la connessione di archiviazione condivisa dell'app (usando WEBSITE_CONTENTAZUREFILECONNECTIONSTRING) a un riferimento alla chiave dell'archivio, l'app non può risolvere il riferimento alla chiave dell'archivio al momento della creazione o dell'aggiornamento dell'app se una delle condizioni seguenti è vera.

- L'app accede all'insieme di credenziali delle chiavi usando un'identità assegnata dal sistema.
- L'app accede al Key Vault utilizzando un'identità assegnata dall'utente e il Key Vault è bloccato con una rete virtuale.

Per evitare errori in fase di creazione o aggiornamento, impostare questa variabile su 1.
WEBSITE_DELAY_CERT_DELETION L'impostazione di questa variabile di ambiente su 1 garantisce che un certificato da cui dipende un processo di lavoro non venga eliminato fino a quando non viene chiuso.

Condivisione delle Risorse tra Origini Diverse (CORS)

Le variabili di ambiente seguenti sono correlate alla configurazione CORS (Cross-Origin Resource Sharing).

Nome impostazione Descrizione
WEBSITE_CORS_ALLOWED_ORIGINS Di sola lettura. Mostra le origini consentite per CORS.
WEBSITE_CORS_SUPPORT_CREDENTIALS Di sola lettura. Indica se l'impostazione dell'intestazione Access-Control-Allow-Credentials su true è abilitata (True) o meno (False).

Autenticazione e autorizzazione

Le variabili di ambiente seguenti sono correlate all'autenticazione del Servizio app.

Nome impostazione Descrizione
WEBSITE_AUTH_DISABLE_IDENTITY_FLOW Se impostato su true, disabilita l'assegnazione dell'identità principale del thread nelle applicazioni web basate su ASP.NET (comprese le app per le funzioni v1). Questa funzionalità consente agli sviluppatori di proteggere l'accesso al sito con l'autenticazione, ma usa comunque un meccanismo di accesso separato all'interno della logica dell'app. Il valore predefinito è false.
WEBSITE_AUTH_HIDE_DEPRECATED_SID true o false. Il valore predefinito è false. Si tratta di un'impostazione per l'integrazione legacy delle app per dispositivi mobili per Il servizio app di Azure. Impostando il valore su true viene risolto un problema a causa del quale l'ID di sicurezza generato per gli utenti autenticati potrebbe cambiare se l'utente modifica le informazioni del profilo.

La modifica di questo valore potrebbe causare la modifica degli ID utente di App per dispositivi mobili di Azure esistenti. La maggior parte delle app non deve usare questa impostazione.
WEBSITE_AUTH_NONCE_DURATION Valore dell'intervallo di tempo nel formato hours:minutes:seconds. Il valore predefinito è 00:05:00 o 5 minuti. Questa impostazione controlla la durata del nonce crittografico generato per tutti gli accessi basati su browser. Se un accesso non riesce a terminare nel tempo specificato, il flusso di accesso viene ritentato automaticamente.

Questa impostazione dell'applicazione è destinata all'uso con l'esperienza di configurazione V1 (classica). Se si usa lo schema di configurazione dell'autenticazione V2, usare invece il valore di configurazione login.nonce.nonceExpirationInterval.
WEBSITE_AUTH_PRESERVE_URL_FRAGMENT Se impostato su true e gli utenti selezionano i collegamenti dell'app che contengono frammenti di URL, il processo di accesso garantisce che la parte del frammento di URL dell'URL non venga persa nel processo di reindirizzamento dell'accesso. Per altre informazioni, vedere Personalizzare l'accesso e la disconnessione nell'autenticazione del Servizio app di Azure.
WEBSITE_AUTH_USE_LEGACY_CLAIMS Per mantenere la compatibilità con le versioni precedenti tra gli aggiornamenti, il modulo di autenticazione usa il mapping delle attestazioni legacy di nomi brevi a nomi lunghi nell'API /.auth/me, quindi alcuni mapping vengono esclusi (ad esempio, "ruoli"). Per ottenere la versione più moderna dei mapping delle attestazioni, impostare questa variabile su False. Nell'esempio "ruoli" viene eseguito il mapping al nome dell'attestazione lungo http://schemas.microsoft.com/ws/2008/06/identity/claims/role.
WEBSITE_AUTH_DISABLE_WWWAUTHENTICATE true o false. Il valore predefinito è false. Quando è impostato su true, rimuove l'intestazione WWW-Authenticate della risposta HTTP dalle risposte HTTP generate dal modulo 401.

Questa impostazione dell'applicazione è destinata all'uso con l'esperienza di configurazione V1 (classica). Se si usa lo schema di configurazione dell'autenticazione V2, usare invece il valore di configurazione identityProviders.azureActiveDirectory.login.disableWwwAuthenticate.
WEBSITE_AUTH_STATE_DIRECTORY Percorso della directory del file system locale in cui vengono archiviati i token quando l'archivio token basato su file è abilitato. Il valore predefinito è %HOME%\Data\.auth.

Questa impostazione dell'applicazione è destinata all'uso con l'esperienza di configurazione V1 (classica). Se si usa lo schema di configurazione dell'autenticazione V2, usare invece il valore di configurazione login.tokenStore.fileSystem.directory.
WEBSITE_AUTH_TOKEN_CONTAINER_SASURL URL completo del contenitore BLOB. Indica al modulo di autenticazione di archiviare e caricare tutti i token crittografati nel contenitore di archiviazione BLOB specificato anziché usare il file system locale predefinito.
WEBSITE_AUTH_TOKEN_REFRESH_HOURS Qualsiasi numero decimale positivo. Il valore predefinito è 72 (ore). Questa impostazione controlla il periodo di tempo dopo la scadenza di un token di sessione in cui l'API /.auth/refresh può essere usata per aggiornarlo. I tentativi di aggiornamento dopo questo periodo hanno esito negativo e gli utenti devono eseguire di nuovo l'accesso.

Questa impostazione dell'applicazione è destinata all'uso con l'esperienza di configurazione V1 (classica). Se si usa lo schema di configurazione dell'autenticazione V2, usare invece il valore di configurazione login.tokenStore.tokenRefreshExtensionHours.
WEBSITE_AUTH_TRACE_LEVEL Controlla il dettaglio delle tracce di autenticazione scritte in Registrazione applicazioni. I valori validi sono Off, Error, Warning, Information e Verbose. Il valore predefinito è Verbose.
WEBSITE_AUTH_VALIDATE_NONCE true o false. Il valore predefinito è true. Questo valore non deve mai essere impostato su false tranne quando si esegue temporaneamente il debug di errori di convalida nonce crittografici che si verificano durante gli accessi interattivi.

Questa impostazione dell'applicazione è destinata all'uso con l'esperienza di configurazione V1 (classica). Se si usa lo schema di configurazione dell'autenticazione V2, usare invece il valore di configurazione login.nonce.validateNonce.
WEBSITE_AUTH_V2_CONFIG_JSON Servizio app di Azure popola automaticamente questa variabile di ambiente. Questa variabile viene usata per configurare il modulo di autenticazione integrata. Il valore corrisponde alla configurazione di autenticazione V2 (non classica) per l'app corrente in Azure Resource Manager. Non deve essere configurato in modo esplicito.
WEBSITE_AUTH_ENABLED Di sola lettura. Inserito in un'app Windows o Linux per indicare se l'autenticazione del Servizio app è abilitata.
WEBSITE_AUTH_ENCRYPTION_KEY Per impostazione predefinita, la chiave generata automaticamente viene usata come chiave di crittografia. Per eseguire l'override, impostare su una chiave desiderata. È consigliabile usare questa variabile di ambiente se si vogliono condividere token o sessioni tra più app. Se lo si specifica, sostituisce l'impostazione MACHINEKEY_DecryptionKey .
WEBSITE_AUTH_SIGNING_KEY Per impostazione predefinita, la chiave generata automaticamente viene usata come chiave di firma. Per eseguire l'override, impostare su una chiave desiderata. È consigliabile usare questa variabile di ambiente se si vogliono condividere token o sessioni tra più app. Se lo si specifica, sostituisce l'impostazione MACHINEKEY_ValidationKey .

Identità gestita

Le variabili di ambiente seguenti sono correlate alle identità gestite.

Nome impostazione Descrizione
IDENTITY_ENDPOINT Di sola lettura. URL per recuperare il token per l'identità gestita dell'app.
MSI_ENDPOINT Deprecato. Usa IDENTITY_ENDPOINT.
IDENTITY_HEADER Di sola lettura. Valore che deve essere aggiunto all'intestazione X-IDENTITY-HEADER quando si effettua una richiesta HTTP GET a IDENTITY_ENDPOINT. La piattaforma ruota il valore.
MSI_SECRET Deprecato. Usa IDENTITY_HEADER.

Controllo integrità

Le variabili di ambiente seguenti sono correlate ai controlli di integrità.

Nome impostazione Descrizione
WEBSITE_HEALTHCHECK_MAXPINGFAILURES Numero massimo di ping non riusciti prima di rimuovere l'istanza. Impostare su un valore compreso tra 2 e 10. Quando si aumenta o si riducr il numero di istanze, il servizio app esegue il ping del percorso del controllo integrità per assicurarsi che le nuove istanze siano pronte. Per maggiori informazioni, vedere Controllo della salute.
WEBSITE_HEALTHCHECK_MAXUNHEALTHYWORKERPERCENT Per evitare di sovraccaricare le istanze integre, non viene esclusa più della metà delle istanze. Ad esempio, se un piano di servizio app viene ridimensionato su quattro istanze e tre non sono integre, al massimo due vengono escluse. Le altre due istanze (una sana e una non sana) continueranno a ricevere richieste. Nello scenario peggiore in cui tutte le istanze non sono integre, non ne verrà esclusa nessuna.

Per eseguire l'override di questo comportamento, impostare su un valore compreso tra 1 e 100. Un valore superiore indica che vengono rimosse più istanze malsane. L'impostazione predefinita è 50 (50%).

Notifiche push

Le variabili di ambiente seguenti sono correlate alla funzionalità notifiche push.

Nome impostazione Descrizione
WEBSITE_PUSH_ENABLED Di sola lettura. Aggiunta quando le notifiche push sono abilitate.
WEBSITE_PUSH_TAG_WHITELIST Di sola lettura. Contiene i tag nella registrazione delle notifiche.
WEBSITE_PUSH_TAGS_REQUIRING_AUTH Di sola lettura. Contiene un elenco di tag nella registrazione delle notifiche che richiedono l'autenticazione utente.
WEBSITE_PUSH_TAGS_DYNAMIC Di sola lettura. Contiene un elenco di tag nella registrazione delle notifiche che sono state aggiunte automaticamente.

Nota

La tabella precedente fa riferimento all'elenco elementi consentiti, un termine che Microsoft non usa più. Quando il termine viene rimosso dal software, lo rimuovono da questo articolo.

Attività Web

Le variabili di ambiente seguenti sono correlate ai processi Web.

Nome impostazione Descrizione
WEBJOBS_RESTART_TIME Per i processi continui, ritardare in secondi quando il processo di un processo diventa inattivo per qualsiasi motivo prima del riavvio.
WEBJOBS_IDLE_TIMEOUT Per i processi attivati, timeout in secondi. Dopo questo timeout, il lavoro viene arrestato se è inattivo, non ha tempo di CPU, o non produce output.
WEBJOBS_HISTORY_SIZE Per i processi attivati, numero massimo di esecuzioni mantenute nella directory della cronologia per processo. Il valore predefinito è 50.
WEBJOBS_STOPPED Impostare su 1 per disabilitare l'esecuzione di qualsiasi processo e arrestare tutti i processi attualmente in esecuzione.
WEBJOBS_DISABLE_SCHEDULE Impostare su 1 per disattivare tutti gli attivamenti programmati. I processi possono comunque essere richiamati manualmente.
WEBJOBS_ROOT_PATH Percorso assoluto o relativo dei file di WebJob. Per un percorso relativo, il valore viene combinato con il percorso radice predefinito (D:/home/site/wwwroot/ o /home/site/wwwroot/).
WEBJOBS_LOG_TRIGGERED_JOBS_TO_APP_LOGS Impostare su true per inviare l'output da processi Web attivati alla pipeline dei log applicazioni (che supporta file system, BLOB e tabelle).
WEBJOBS_SHUTDOWN_FILE File creato dal Servizio app quando viene rilevata una richiesta di arresto. È responsabilità del processo Webjob rilevare la presenza di questo file e avviare l'arresto. Quando si usa WebJobs SDK, questa parte viene gestita automaticamente.
WEBJOBS_PATH Di sola lettura. Percorso radice del processo attualmente in esecuzione, in una directory temporanea.
WEBJOBS_NAME Di sola lettura. Nome lavoro corrente.
WEBJOBS_TYPE Di sola lettura. Tipo di lavoro corrente (triggered o continuous).
WEBJOBS_DATA_PATH Di sola lettura. Percorso dei metadati per contenere i log, la cronologia e gli artefatti del processo corrente.
WEBJOBS_RUN_ID Di sola lettura. Per i processi attivati, l'ID di esecuzione corrente del processo.

Funzioni

Nome impostazione Descrizione
WEBSITE_FUNCTIONS_ARMCACHE_ENABLED Impostare su 0 per disabilitare la cache delle funzioni.
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT Consulta le informazioni di riferimento sulle impostazioni dell'app per le Funzioni di Azure.
AzureWebJobsSecretStorageType Consulta le informazioni di riferimento sulle impostazioni dell'app per le Funzioni di Azure.
FUNCTIONS_EXTENSION_VERSION Consulta le informazioni di riferimento sulle impostazioni dell'app per le Funzioni di Azure.
FUNCTIONS_WORKER_RUNTIME Consulta le informazioni di riferimento sulle impostazioni dell'app per le Funzioni di Azure.
AzureWebJobsStorage Consulta le informazioni di riferimento sulle impostazioni dell'app per le Funzioni di Azure.
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING Consulta le informazioni di riferimento sulle impostazioni dell'app per le Funzioni di Azure.
WEBSITE_CONTENTSHARE Consulta le informazioni di riferimento sulle impostazioni dell'app per le Funzioni di Azure.
WEBSITE_CONTENTOVERVNET Consulta le informazioni di riferimento sulle impostazioni dell'app per le Funzioni di Azure.
WEBSITE_ENABLE_BROTLI_ENCODING Consulta le informazioni di riferimento sulle impostazioni dell'app per le Funzioni di Azure.
WEBSITE_USE_PLACEHOLDER Consulta le informazioni di riferimento sulle impostazioni dell'app per le Funzioni di Azure.
WEBSITE_PLACEHOLDER_MODE Di sola lettura. Indica se l'app per le funzioni è in esecuzione in un host segnaposto (generalized) o nel proprio host (specialized).
WEBSITE_DISABLE_ZIP_CACHE Quando l'app viene eseguita da un pacchetto ZIP ( WEBSITE_RUN_FROM_PACKAGE=1), i cinque pacchetti ZIP distribuiti più di recente vengono memorizzati nella cache nel file system dell'app (D:\home\data\SitePackages). Impostare questa variabile su 1 per disabilitare questa cache. Per le app a consumo per Linux, la cache dei pacchetti ZIP è disabilitata per impostazione predefinita.