Variabili di ambiente e impostazioni dell'app in Servizio app di Azure
Nota
A partire dal 1° giugno 2024, tutte le app del servizio app appena create avranno la possibilità di generare un nome host predefinito univoco usando la convenzione di denominazione <app-name>-<random-hash>.<region>.azurewebsites.net
. I nomi delle app esistenti rimarranno invariati.
Esempio: myapp-ds27dh7271aah175.westus-01.azurewebsites.net
Per altri dettagli, vedere Nome host predefinito univoco per la risorsa Servizio app.
In Servizio app di Azure, alcune impostazioni sono disponibili per l'ambiente di distribuzione o runtime come variabili di ambiente. Alcune di queste impostazioni possono essere personalizzate quando vengono impostate manualmente come impostazioni dell'app. Questo riferimento mostra le variabili che è possibile usare o personalizzare.
Ambiente app
Le variabili di ambiente seguenti sono correlate all'ambiente dell'app in generale.
Nome impostazione | Descrizione | Esempio |
---|---|---|
WEBSITE_SITE_NAME |
Sola lettura. Nome dell'app. | |
WEBSITE_RESOURCE_GROUP |
Sola lettura. Nome del gruppo di risorse di Azure che contiene la risorsa dell'app. | |
WEBSITE_OWNER_NAME |
Sola lettura. Contiene l'ID sottoscrizione di Azure proprietario dell'app, del gruppo di risorse e dello spazio Web. | |
REGION_NAME |
Sola lettura. Nome dell'area dell'app. | |
WEBSITE_PLATFORM_VERSION |
Sola lettura. Versione della piattaforma del Servizio app. | |
HOME |
Sola lettura. Percorso della home directory (ad esempio, D:\home per Windows). |
|
SERVER_PORT |
Sola lettura. La porta che l'app deve ascoltare. | |
WEBSITE_WARMUP_PATH |
Percorso relativo per il ping che riscalda l'app, a partire da una barra obliqua. Il valore predefinito è / , che esegue il ping del percorso radice. Il percorso specifico può essere eseguito tramite un client non autenticato, ad esempio Gestione traffico di Azure, anche se l'autenticazione del Servizio app è impostata per rifiutare i client non autenticati. (NOTA: questa impostazione dell'app non modifica il percorso usato da Always On.) |
|
WEBSITE_COMPUTE_MODE |
Sola lettura. Specifica se l'app viene eseguita in macchine virtuali dedicate (Dedicated ) o condivise (Shared ). |
|
WEBSITE_SKU |
Sola lettura. SKU dell'app. I valori consentiti sono Free , Shared , Basic e Standard . |
|
SITE_BITNESS |
Sola lettura. Indica se l'app è a 32 bit (x86 ) o a 64 bit (AMD64 ). |
|
WEBSITE_HOSTNAME |
Sola lettura. Nome host primario per l'app. I nomi host personalizzati non vengono conteggiati qui. | |
WEBSITE_VOLUME_TYPE |
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 |
Sola lettura. Limite per le richieste simultanee di WebSocket. Per i livelli Standard e superiori, il valore è -1 , ma esiste ancora un limite per macchina virtuale in base alle dimensioni della macchina virtuale (vedere Limiti numerici di più 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, viene usato UTC. | Atlantic Standard Time |
WEBSITE_ADD_SITENAME_BINDINGS_IN_APPHOST_CONFIG |
Dopo gli scambi di slot, l'app potrebbe riscontrare riavvii imprevisti. Ciò è dovuto al fatto che dopo uno scambio, la configurazione dell'associazione nome host non viene sincronizzata, che di per sé non causa i riavvii. Tuttavia, alcuni eventi di archiviazione sottostanti, ad esempio i failover del volume di archiviazione, possono 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 tutti gli slot (il valore predefinito è0 ). Tuttavia, non impostare questo valore se si esegue un'applicazione Windows Communication Foundation (WCF). Per altre informazioni, vedere Risolvere i problemi relativi agli scambi |
|
WEBSITE_PROACTIVE_AUTOHEAL_ENABLED |
Per impostazione predefinita, un'istanza di macchina virtuale viene "corretta automaticamente" in modo proattivo quando usa più del 90% della memoria allocata per più di 30 secondi, o quando l'80% delle richieste totali negli ultimi due minuti richiede più di 200 secondi. Se un'istanza di macchina virtuale ha attivato 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 Correzione automatica proattiva. |
|
WEBSITE_PROACTIVE_CRASHMONITORING_ENABLED |
Ogni volta che il processo di 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 e 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 Monitoraggio proattivo degli arresti anomali. |
|
WEBSITE_DAAS_STORAGE_SASURI |
Durante il monitoraggio degli arresti anomali (proattivo o manuale), i dump della memoria vengono eliminati per impostazione predefinita. Per salvare i dump di memoria in un contenitore BLOB di archiviazione, specificare l'URI di 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 solo lo stack di chiamate senza salvare il dump di arresto anomalo nell'account di archiviazione, aggiungere ,"UseStorageAccount":"false" in JSON. |
|
REMOTEDEBUGGINGVERSION |
Versione del 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 Funzioni. | 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. |
myapp123 |
WEBSITE_SCM_ALWAYS_ON_ENABLED |
Sola lettura. Indica se Always On è abilitato (1 ) o meno (0 ). |
|
WEBSITE_SCM_SEPARATE_STATUS |
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 |
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 una variabile viene impostata dal cliente come impostazione nella configurazione dell'app. Viene inserito in un'app .NET come impostazione dell'app. |
MAINSITE_ |
Indica che una variabile è specifica per l'app stessa. |
SCMSITE_ |
Indica che una variabile è specifica per l'app Kudu. |
SQLCONNSTR_ |
Indica una stringa di connessione di SQL Server nella configurazione dell'app. Viene inserito in un'app .NET come stringa di connessione. |
SQLAZURECONNSTR_ |
Indica una stringa di connessione del database SQL di Azure nella configurazione dell'app. Viene inserito in un'app .NET come stringa di connessione. |
POSTGRESQLCONNSTR_ |
Indica una stringa di connessione PostgreSQL nella configurazione dell'app. Viene inserito in un'app .NET come stringa di connessione. |
CUSTOMCONNSTR_ |
Indica una stringa di connessione personalizzata nella configurazione dell'app. Viene inserito in un'app .NET come stringa di connessione. |
MYSQLCONNSTR_ |
Indica una 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 Archiviazione BLOB di Azure. |
NOTIFICATIONHUBCONNSTR_ |
Indica una stringa di connessione a un hub di notifica in Hub di notifica di Azure. |
SERVICEBUSCONNSTR_ |
Indica una stringa di connessione a un'istanza del bus di servizio di Azure. |
EVENTHUBCONNSTR_ |
Indica una stringa di connessione a un hub eventi in Hub eventi di Azure. |
DOCDBCONNSTR_ |
Indica una stringa di connessione a un database in Azure Cosmos DB. |
REDISCACHECONNSTR_ |
Indica una stringa di connessione a una cache in Cache Redis di Azure. |
FILESHARESTORAGE_ |
Indica una 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 compilazione del Servizio app, vedere Automazione della compilazione.
Nome impostazione | Descrizione |
---|---|
DEPLOYMENT_BRANCH |
Per la distribuzione Git locale o Git cloud (ad esempio, GitHub), impostare sul ramo di 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 sull'URL di 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. Usare WEBSITE_RUN_FROM_PACKAGE . |
WEBSITE_RUN_FROM_ZIP |
Deprecato. Usare WEBSITE_RUN_FROM_PACKAGE . |
SCM_MAX_ZIP_PACKAGE_COUNT |
L'app mantiene 5 dei file ZIP più recenti distribuiti usando la distribuzione zip. È possibile mantenerne di più o di meno impostando l'impostazione dell'app su un numero diverso. |
WEBSITE_WEBDEPLOY_USE_SCM |
Impostare su false per WebDeploy per interrompere l'uso del motore di distribuzione Kudu. Il valore predefinito è true . Per eseguire la distribuzione in app Linux usando Visual Studio (WebDeploy/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 WebDeploy. 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 Git deploy 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 la distribuzione con un modello di Resource Manager consente di evitare condizioni di competizione con le chiamate ARM successive. |
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 | Esempio |
---|---|---|
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. | Per eseguire una compilazione pulita: -t:Clean;Compile |
SCM_SCRIPT_GENERATOR_ARGS |
Kudu usa il comando azure site deploymentscript descritto qui 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. |
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 altre tracce. |
4 |
SCM_COMMAND_IDLE_TIMEOUT |
Timeout in secondi per ogni comando avviato dal processo di compilazione prima senza produrre alcun output. Successivamente, il comando viene considerato inattivo e quindi viene disattivato. 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 continuerà comunque a eseguire il lato server. |
|
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 è applicabile solo quando WEBSITE_COMPUTE_MODE è Dedicated . |
|
WEBSITE_SCM_IDLE_TIMEOUT_IN_MINUTES |
Timeout in minuti per il sito SCM (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 di compilazione di in Git deploy, impostare su true . |
Impostazioni specifiche della lingua
Questa sezione illustra le impostazioni di runtime configurabili per ogni framework di linguaggio supportato. Durante l'automazione della compilazione in fase di distribuzione sono disponibili impostazioni aggiuntive.
Nome impostazione | Descrizione |
---|---|
PORT |
Sola lettura. Per le app Linux, convertire il runtime .NET in ascolto nel contenitore. |
WEBSITE_ROLE_INSTANCE_ID |
Sola lettura. ID dell'istanza corrente. |
HOME |
Sola lettura. Directory che punta all'archiviazione condivisa (/home ). |
DUMP_DIR |
Sola lettura. Directory per i dump di arresto anomalo del sistema (/home/logs/dumps ). |
APP_SVC_RUN_FROM_COPY |
Solo app Linux. 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 usa questa opzione, assicurarsi di non impostare come hardcoded alcun riferimento a /home/site/wwwroot . Usare invece un percorso relativo a /home/site/wwwroot . |
MACHINEKEY_Decryption |
Per le app native di Windows o le app in contenitori di Windows, questa variabile viene inserita nell'ambiente dell'app o nel contenitore 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 native di Windows o le app in contenitori di Windows, 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 native di Windows o le app in contenitori di Windows, 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 native di Windows o le app in contenitori di Windows, 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 | Max | Descrizione |
---|---|---|---|---|
WEBSITES_ENABLE_APP_SERVICE_STORAGE |
App Web | true | - | Se impostato su TRUE, il contenuto del file viene mantenuto durante i riavvii. |
WP_MEMORY_LIMIT |
WordPress | 128M | 512M | Limite di memoria PHP per front-end o generico 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, gli script di dashboard amministratore/back-end richiedono molta memoria rispetto agli script front-end. Non può essere più di PHP_MEMORY_LIMIT. |
PHP_MEMORY_LIMIT |
PHP | 512M | 512M | Limiti di memoria per lo script PHP generale. Può solo essere ridotto. |
FILE_UPLOADS |
PHP | Attivato | - | Può essere Attivato o Disattivato. Si noti che questi valori distinguono tra maiuscole e minuscole. Abilita o disabilita i caricamenti di file. |
UPLOAD_MAX_FILESIZE |
PHP | 50M | Limite massimo di caricamento file 256M. Può essere ingrandita fino a 256M. | |
POST_MAX_SIZE |
PHP | 128M | 256M | Può essere ingrandita fino a 256M. In genere deve essere più di UPLOAD_MAX_FILESIZE. |
MAX_EXECUTION_TIME |
PHP | 120 | 120 | Può essere solo ridotto. Suddividere gli script se richiede più di 120 secondi. Aggiunta per evitare che gli script errati rallentano il sistema. |
MAX_INPUT_TIME |
PHP | 120 | 120 | Limite massimo di tempo per l'analisi delle richieste di input. Può essere solo ridotto. |
MAX_INPUT_VARS |
PHP | 10000 | 10000 | - |
DATABASE_HOST |
Database | - | - | Host di database utilizzato per connettersi a WordPress. |
DATABASE_NAME |
Database | - | - | Nome del database utilizzato per connettersi a WordPress. |
DATABASE_USERNAME |
Database | - | - | Nome utente del database utilizzato per connettersi a WordPress. |
DATABASE_PASSWORD |
Database | - | - | 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 | - | - | E-mail amministratore WordPress. |
WORDPRESS_ADMIN_PASSWORD |
Solo distribuzione | - | - | Password amministratore di WordPress. Questa operazione è 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 Reimpostazione della password. |
WORDPRESS_ADMIN_USER |
Solo distribuzione | - | - | Nome utente amministratore WordPress |
WORDPRESS_ADMIN_LOCALE_CODE |
Solo distribuzione | - | - | Nome utente del database utilizzato per connettersi a WordPress. |
Dominio e DNS
Nome impostazione | Descrizione | Esempio |
---|---|---|
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. |
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 verranno scaricate, oltre alla cache esistente da scaricare 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 separati da virgole nel certificato da caricare nel codice o * per consentire il caricamento di tutti i certificati nel codice. È possibile caricare solo i certificati aggiunti all'app. |
WEBSITE_PRIVATE_CERTS_PATH |
Sola lettura. Percorso in un contenitore di Windows per i certificati privati caricati. |
WEBSITE_PUBLIC_CERTS_PATH |
Sola lettura. Percorso in un contenitore di Windows per i certificati pubblici caricati. |
WEBSITE_INTERMEDIATE_CERTS_PATH |
Sola lettura. Percorso in un contenitore di Windows per i certificati intermedi caricati. |
WEBSITE_ROOT_CERTS_PATH |
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 | Esempio |
---|---|---|
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS |
Per impostazione predefinita, le versioni per le estensioni del sito sono specifiche di ogni slot. Ciò impedisce il comportamento imprevisto dell'applicazione, dovuto alla modifica delle versioni dell'estensione dopo uno scambio. Se si desidera che anche le versioni dell'estensione si scambino, impostare su 0 su 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 questa impostazione su false o 0 per tutti gli slot di distribuzione per renderli scambiabili. Non esiste alcun controllo granulare 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. |
/statuscheck |
WEBSITE_SWAP_WARMUP_PING_STATUSES |
Codici di risposta HTTP validi per l'operazione di riscaldamento. durante uno scambio. Se il codice di stato restituito non è presente nell'elenco, l'operazione preliminare di preparazione e l'operazione di scambio vengono arrestate. Per impostazione predefinita, sono validi tutti i codici di risposta. | 200,202 |
WEBSITE_SLOT_NUMBER_OF_TIMEOUTS_BEFORE_RESTART |
Durante uno scambio di slot, numero massimo di timeout dopo il quale viene forzato il riavvio 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 il riavvio di questo tipo. Se si esegue un'app Windows Communication Foundation (WCF), non impostare questa variabile. |
Contenitori personalizzati
Per altre informazioni sui contenitori personalizzati, vedere Eseguire un contenitore personalizzato in Azure.
Nome impostazione | Descrizione | Esempio |
---|---|---|
WEBSITES_ENABLE_APP_SERVICE_STORAGE |
Per i contenitori personalizzati Linux: impostare su true per abilitare la condivisione della directory /home tra istanze con scalabilità orizzontale. Il valore predefinito è false per i contenitori personalizzati Linux.Per i contenitori personalizzati Windows: impostare su true per abilitare la condivisione della directory c:\home tra istanze con scalabilità orizzontale. Il valore predefinito è true per i contenitori Windows. |
|
WEBSITES_CONTAINER_START_TIME_LIMIT |
Tempo in secondi di attesa del completamento dell'avvio del contenitore prima del riavvio del contenitore. Il valore predefinito è 230 . È possibile aumentarlo fino al massimo di 1800 . |
|
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 di sistema, quando si esegue un contenitore personalizzato nel Servizio app. Per la sicurezza, questa variabile non viene passata al contenitore. | 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 dovrà essere connessa a una rete virtuale usando la funzionalità di integrazione rete virtuale. Questa configurazione è 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 oppure, quando non viene trovato alcun contenitore di questo tipo, 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 sul 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 Windows distribuiti nel Servizio app di Azure hanno un limite di memoria configurato a seconda dello SKU del piano di Servizio app. Impostare sul limite di memoria desiderato in MB. 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 |
Sola lettura. ID univoco dell'istanza di macchina virtuale corrente, quando l'app viene ridimensionata in più istanze. |
WEBSITE_IIS_SITE_NAME |
Deprecato. Usare WEBSITE_INSTANCE_ID . |
WEBSITE_DISABLE_OVERLAPPED_RECYCLING |
Il riciclo sovrapposto lo rende in modo che prima che l'istanza di macchina virtuale corrente di un'app venga arrestata, viene 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 | Esempio |
---|---|---|
WEBSITE_HTTPLOGGING_ENABLED |
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 di log del server Web, se i log del server Web sono abilitati per un'app nativa di Windows o Linux. | 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 native di Windows, se sono abilitati i log del server Web. Se non è impostato, i log del server Web vengono archiviati nel file system dell'app (archiviazione condivisa predefinita). | |
DIAGNOSTICS_AZUREBLOBRETENTIONINDAYS |
Periodo di conservazione in giorni di log applicazioni per le app native di Windows, se i log delle applicazioni sono abilitati. | 10 |
DIAGNOSTICS_AZUREBLOBCONTAINERSASURL |
URL di firma di accesso condiviso del contenitore di archiviazione BLOB per archiviare i log applicazioni per le app native di Windows, 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 un percorso relativo alla directory di log per la registrazione degli 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 ). |
..\..\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 app di Windows native, impostare su TRUE per disattivare le voci di log 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 contenente i contatori delle prestazioni ASP.NET. |
WEBSITE_COUNTERS_APP |
Oggetto JSON contenente contatori sandbox. |
WEBSITE_COUNTERS_CLR |
Oggetto JSON contenente contatori CLR. |
WEBSITE_COUNTERS_ALL |
Oggetto JSON contenente 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 : disabilitato 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 MB. 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 condivisa dei 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 in locale in un'istanza. La cache viene invalidata quando il file viene modificato. Il percorso della cache è %SYSTEMDRIVE%\local\DynamicCache (viene applicata la stessa quota %SYSTEMDRIVE%\local ). 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 risparmiare l'uso del disco locale, impostare su 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 la 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 directory App_Data , non sono consentiti blocchi esclusivi, in modo che le distribuzioni non vengano bloccate dai file bloccati. |
Rete
Le variabili di ambiente seguenti sono correlate alle connessioni ibride e all'integrazione della rete virtuale.
Nome impostazione | Descrizione |
---|---|
WEBSITE_RELAYS |
Sola lettura. Dati necessari per configurare la connessione ibrida, inclusi gli endpoint e i dati del bus di servizio. |
WEBSITE_REWRITE_TABLE |
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 integrazione rete virtuale a livello di area, l'app instrada solo il traffico RFC1918 nella rete virtuale. Impostare su 1 per instradare tutto il traffico in uscita nella rete virtuale ed essere soggetto agli stessi gruppi di sicurezza di rete e route definite dall'utente. L'impostazione consente di accedere agli 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 |
Sola lettura. Indirizzo IP associato all'app quando integrato con una rete virtuale. Per integrazione rete virtuale a livello di area, il valore è un indirizzo IP compreso nell'intervallo di indirizzi della subnet delegata e per l'integrazione della rete virtuale richiesta dal gateway, il valore è un indirizzo IP compreso nell'intervallo di indirizzi da punto a sito configurato nel gateway di rete virtuale. Questo indirizzo IP viene usato dall'app per connettersi alle risorse tramite la rete virtuale. Inoltre, può cambiare all'interno dell'intervallo di indirizzi descritto. |
WEBSITE_PRIVATE_PORTS |
Sola lettura. Nell'integrazione della rete virtuale, mostra le porte utilizzabili dall'app 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, assicurarsi di 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 |
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 a Key Vault, l'app non può risolvere il riferimento all'insieme di credenziali delle chiavi durante la creazione o l'aggiornamento dell'app se una delle condizioni seguenti è vera: - L'app accede all'insieme di credenziali delle chiavi con un'identità assegnata dal sistema. - L'app accede all'insieme di credenziali delle chiavi con un'identità assegnata dall'utente e l'insieme di credenziali delle chiavi è bloccato con una retevirtuale. Per evitare errori in fase di creazione o aggiornamento, impostare questa variabile su 1 . |
WEBSITE_DELAY_CERT_DELETION |
Questa variabile di env può essere impostata su 1 dagli utenti per assicurarsi che un certificato da cui dipende un processo di lavoro non venga eliminato fino a quando non viene chiuso. |
CORS
Le variabili di ambiente seguenti sono correlate alla configurazione CORS (Cross-Origin Resource Sharing).
Nome impostazione | Descrizione |
---|---|
WEBSITE_CORS_ALLOWED_ORIGINS |
Sola lettura. Mostra le origini consentite per CORS. |
WEBSITE_CORS_SUPPORT_CREDENTIALS |
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à dell'entità thread in ASP. Applicazioni Web basate su NET (incluse le app per le funzioni v1). Questa funzionalità è progettata per consentire agli sviluppatori di proteggere l'accesso al sito con l'autenticazione, ma è comunque necessario usare 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 di App per dispositivi mobili di Azure per Il Servizio app di Azure. Impostando questa opzione su true risolve un problema a causa del quale il SID (ID di sicurezza) generato per gli utenti autenticati potrebbe cambiare se l'utente modifica le informazioni del profilo. La modifica di questo valore può comportare 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 timespan 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 account di accesso basati su browser. Se un accesso non viene completato nel tempo specificato, il flusso di accesso verrà 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 . Se impostato su true , rimuove l'intestazione della risposta HTTP WWW-Authenticate dalle risposte HTTP 401 generate dal modulo. 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 la quantità di tempo trascorsa la scadenza di un token di sessione che l'API /.auth/refresh può essere usata per aggiornarla. I tentativi di aggiornamento dopo questo periodo avranno esito negativo e gli utenti finali dovranno 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 la 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 |
Questa variabile di ambiente viene popolata automaticamente dalla piattaforma del Servizio app di Azure e viene usata per configurare il modulo di autenticazione integrata. Il valore di questa variabile di ambiente 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 |
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. Questa opzione è consigliata se si vogliono condividere token o sessioni tra più app. Se specificato, 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. Questa opzione è consigliata se si vogliono condividere token o sessioni tra più app. Se specificato, sostituisce l'impostazione MACHINEKEY_ValidationKey . |
Identità gestita
Le variabili di ambiente seguenti sono correlate alle identità gestite.
Nome impostazione | Descrizione |
---|---|
IDENTITY_ENDPOINT |
Sola lettura. URL per recuperare il token per l'identità gestita dell'app. |
MSI_ENDPOINT |
Deprecato. Usare IDENTITY_ENDPOINT . |
IDENTITY_HEADER |
Sola lettura. Valore che deve essere aggiunto all'intestazione X-IDENTITY-HEADER quando si effettua una richiesta HTTP GET a IDENTITY_ENDPOINT . Il valore viene ruotato dalla piattaforma. |
MSI_SECRET |
Deprecato. Usare 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 100 . Quando si aumenta o si aumentano le prestazioni, il Servizio app esegue il ping del percorso di controllo integrità per assicurarsi che le nuove istanze siano pronte. Per altre informazioni, vedere Controllo integrità. |
WEBSITE_HEALTHCHECK_MAXUNHEALTHYWORKERPERCENT |
Per evitare di sovraccaricare le istanze integre, non verrà esclusa più della metà delle istanze. Ad esempio, se un piano di Servizio app viene ridimensionato su quattro istanze e tre non sono integri, al massimo due verranno esclusi. Le altre due istanze (una integra e una non integra) continueranno a ricevere le richieste. Nello scenario peggiore in cui tutte le istanze non sono integre, nessuna verrà esclusa. Per eseguire l'override di questo comportamento, impostare su un valore compreso tra 1 e 100 . Un valore superiore indica che verranno rimosse più istanze non integre. L'impostazione predefinita è 50 (50%). |
Notifiche push
Le variabili di ambiente seguenti sono correlate alla funzionalità notifiche push.
Nome impostazione | Descrizione |
---|---|
WEBSITE_PUSH_ENABLED |
Sola lettura. Aggiunta quando le notifiche push sono abilitate. |
WEBSITE_PUSH_TAG_WHITELIST |
Sola lettura. Contiene i tag nella registrazione delle notifiche. |
WEBSITE_PUSH_TAGS_REQUIRING_AUTH |
Sola lettura. Contiene un elenco di tag nella registrazione delle notifiche che richiede l'autenticazione utente. |
WEBSITE_PUSH_TAGS_DYNAMIC |
Sola lettura. Contiene un elenco di tag nella registrazione delle notifiche che sono state aggiunte automaticamente. |
Nota
Questo articolo contiene riferimenti a un termine che Microsoft non usa più. Quando il termine verrà rimosso dal software, verrà rimosso anche dall'articolo.
Processi 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 di riavviarlo. |
WEBJOBS_IDLE_TIMEOUT |
Per i processi attivati, timeout in secondi, dopo il quale il processo viene interrotto se è inattiva, non ha tempi di CPU o 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 i trigger pianificati. I processi possono comunque essere richiamati manualmente. |
WEBJOBS_ROOT_PATH |
Percorso assoluto o relativo dei file di processi Web. 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 dai processi Web attivati alla pipeline dei log dell'applicazione, 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 Web rilevare la presenza di questo file e avviare l'arresto. Quando si usa WebJobs SDK, questa parte viene gestita automaticamente. |
WEBJOBS_PATH |
Sola lettura. Percorso radice del processo attualmente in esecuzione (si trova in una directory temporanea). |
WEBJOBS_NAME |
Sola lettura. Nome processo corrente. |
WEBJOBS_TYPE |
Sola lettura. Tipo di processo corrente (triggered o continuous ). |
WEBJOBS_DATA_PATH |
Sola lettura. Percorso dei metadati del processo corrente per contenere i log, la cronologia e qualsiasi artefatto del processo. |
WEBJOBS_RUN_ID |
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 |
Riferimento per le impostazioni dell’app per Funzioni di Azure |
AzureWebJobsSecretStorageType |
Riferimento per le impostazioni dell’app per Funzioni di Azure |
FUNCTIONS_EXTENSION_VERSION |
Riferimento per le impostazioni dell’app per Funzioni di Azure |
FUNCTIONS_WORKER_RUNTIME |
Riferimento per le impostazioni dell’app per Funzioni di Azure |
AzureWebJobsStorage |
Riferimento per le impostazioni dell’app per Funzioni di Azure |
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING |
Riferimento per le impostazioni dell’app per Funzioni di Azure |
WEBSITE_CONTENTSHARE |
Riferimento per le impostazioni dell’app per Funzioni di Azure |
WEBSITE_CONTENTOVERVNET |
Riferimento per le impostazioni dell’app per Funzioni di Azure |
WEBSITE_ENABLE_BROTLI_ENCODING |
Riferimento per le impostazioni dell’app per Funzioni di Azure |
WEBSITE_USE_PLACEHOLDER |
Riferimento per le impostazioni dell’app per Funzioni di Azure |
WEBSITE_PLACEHOLDER_MODE |
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. |