Configurare un'app servizio app

1. Nel portale di Azure cercare e selezionare Servizi app, quindi selezionare la propria app.

   

2. Nel menu a sinistra dell'app selezionare Impostazioni applicazione di configurazione>.

   

   Per impostazione predefinita, i valori per le impostazioni app sono nascosti nel portale per motivi di sicurezza. Per visualizzare un valore nascosto di un'impostazione dell'app, selezionare il relativo campo Valore . Per visualizzare i valori nascosti di tutte le impostazioni dell'app, selezionare il pulsante Mostra valori .

3. Per aggiungere una nuova impostazione dell'app, selezionare Nuova impostazione applicazione. Per modificare un'impostazione, selezionare il pulsante Modifica sul lato destro.

4. Nella finestra di dialogo è possibile attaccare l'impostazione allo slot corrente.

   Nota

   In un servizio app Linux predefinito o in un contenitore Linux personalizzato qualsiasi struttura di chiave JSON annidata nel nome dell'impostazione dell'app, ad ApplicationInsights:InstrumentationKey esempio, deve essere configurata in servizio app come ApplicationInsights__InstrumentationKey per il nome della chiave. In altre parole, qualsiasi elemento : deve essere sostituito da __ (doppia sottolineatura). Tutti i punti nel nome dell'impostazione dell'app verranno sostituiti con un _ (singolo carattere di sottolineatura).

5. Al termine, selezionare Aggiorna. Non dimenticare di selezionare Salva nella pagina Configurazione.

Aggiungere o modificare un'impostazione dell'app con az webapp config app settings set:

az webapp config appsettings set --name <app-name> --resource-group <group-name> --settings <setting-name>="<value>"

Sostituire <setting-name> con il nome dell'impostazione e <value> con il valore da assegnare.

Mostra tutte le impostazioni e i relativi valori con az webapp config appsettings list:

az webapp config appsettings list --name <app-name> --resource-group <group-name>

Rimuovere una o più impostazioni con az webapp config app settings delete:

az webapp config appsettings delete --name <app-name> --resource-group <group-name> --setting-names {<setting-name1>,<setting-name2>,...}

Impostare una o più impostazioni dell'app con Set-AzWebApp:

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -AppSettings @{"<setting-name1>"="<value1>"; "<setting-name2>"="<value2>";...}

Questo cmdlet sostituisce l'intero set di impostazioni dell'app con quelle specificate. Per aggiungere o modificare un'impostazione dell'app all'interno di un set esistente, includere le impostazioni dell'app esistenti nella tabella Hash di input usando il cmdlet Get-AzWebApp . Ad esempio:

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy app settings to a new Hashtable
$appSettings = @{}
ForEach ($item in $webapp.SiteConfig.AppSettings) {
$appSettings[$item.Name] = $item.Value
}

# Add or edit one or more app settings
$appSettings['<setting-name1>'] = '<value1>'
$appSettings['<setting-name2>'] = '<value2>'

# Save changes
Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -AppSettings $appSettings

Per verificare se un'impostazione dell'app è specifica dello slot, usare Get-AzWebAppSlotConfigName:

Get-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> | select AppSettingNames

Per impostare una o più impostazioni dell'app specifiche dello slot, usare Set-AzWebAppSlotConfigName:

Set-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> -AppSettingNames <setting-name1>,<setting-name2>,...

Selezionare il pulsante Modifica avanzata. Modificare le impostazioni nell'area di testo. Al termine, selezionare Aggiorna. Non dimenticare di selezionare Salva nella pagina Configurazione.

Le impostazioni dell'app hanno la formattazione JSON seguente:

[
  {
    "name": "<key-1>",
    "value": "<value-1>",
    "slotSetting": false
  },
  {
    "name": "<key-2>",
    "value": "<value-2>",
    "slotSetting": false
  },
  ...
]

Eseguire az webapp config app settings set con il nome del file JSON.

az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings "@fileName.json"

Il formato di file necessario è una matrice JSON di impostazioni in cui il campo delle impostazioni dello slot è facoltativo. Ad esempio:

[
  {
    "name": "key1",
    "slotSetting": false,
    "value": "value1"
  },
  {
    "name": "key2",
    "value": "value2"
  }
]

Per praticità, è possibile salvare le impostazioni esistenti in un file JSON con az webapp config appsettings list. L'esempio seguente può essere eseguito in Bash.

# Save the settings
az webapp config appsettings list --name <app-name> --resource-group <group-name> > settings.json

# Edit the JSON file
...

# Update the app with the JSON file
az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings @settings.json

Non è possibile modificare le impostazioni dell'app in blocco usando un file JSON con Azure PowerShell.

1. Nel portale di Azure cercare e selezionare Servizi app, quindi selezionare la propria app.

   

2. Nel menu a sinistra dell'app selezionare Impostazioni applicazione di configurazione>.

   

   Per impostazione predefinita, i valori per le stringa di connessione sono nascosti nel portale per la sicurezza. Per visualizzare un valore nascosto di un stringa di connessione, selezionare il relativo campo Valore. Per visualizzare i valori nascosti di tutti i stringa di connessione, selezionare il pulsante Mostra valore.

3. Per aggiungere una nuova stringa di connessione, selezionare Nuovo stringa di connessione. Per modificare un stringa di connessione, selezionare il pulsante Modifica sul lato destro.

4. Nella finestra di dialogo è possibile attaccare il stringa di connessione allo slot corrente.

5. Al termine, selezionare Aggiorna. Non dimenticare di selezionare Salva nella pagina Configurazione.

Aggiungere o modificare un'impostazione dell'app con az webapp config connection-string set:

az webapp config connection-string set --name <app-name> --resource-group <group-name> --connection-string-type <type> --settings <string-name>='<value>'

Sostituire <string-name> con il nome del stringa di connessione e <value> con il valore da assegnare. Per i valori possibili di ( ad esempio , SQLAzure), vedere la documentazione del comando dell'interfaccia della riga di <type> comando.

Visualizzare tutti i stringa di connessione e i relativi valori con az webapp config connection-string list:

az webapp config connection-string list --name <app-name> --resource-group <group-name>

Rimuovere una o più stringa di connessione con az webapp config connection-string delete:

az webapp config connection-string delete --name <app-name> --resource-group <group-name> --setting-names {<string-name1>,<string-name2>,...}

Impostare una o più stringa di connessione con Set-AzWebApp:

$PropertiesObject = @{
  "<string-name1>" = @{
    value="<connection-string1>";
    type="<type>"};
  "<string-name2>" = @{
    value="<connection-string2>";
    type="<type>"}
}

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -ConnectionStrings $PropertiesObject

Ogni stringa di connessione contiene un nome (), un valore (<string-name1><connection-string1>) e il tipo , ovvero un valore numerico che corrisponde a uno dei campi enumerazione Connessione ionStringType. Ad esempio, per SQL Azure, specificare type="2".

Questo cmdlet sostituisce l'intero set di stringa di connessione con quelli specificati. Per aggiungere o modificare un'impostazione dell'app all'interno di un set esistente, includere le impostazioni dell'app esistenti nella tabella hash di input usando il cmdlet Get-AzWebApp . Ad esempio:

# Get app configuration
$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Copy connection strings to a new hashtable
$connStrings = @{}
ForEach ($item in $webapp.SiteConfig.ConnectionStrings) {
    $connStrings[$item.Name] = @{value=$item.ConnectionString; type=$item.Type.ToString()}
}

# Add or edit one or more connection strings
$connStrings['<string-name1>'] = @{value='<connection-string1>', type='<type>'}
$connStrings['<string-name2>'] = @{value='<connection-string2>', type='<type>'}

# Save changes
Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -ConnectionStrings $connStrings

Per verificare se un stringa di connessione è specifico dello slot, usare Get-AzWebAppSlotConfigName:

Get-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> | select ConnectionStringNames

Per creare uno o più stringa di connessione specifici dello slot, usare Set-AzWebAppSlotConfigName:

Set-AzWebAppSlotConfigName -ResourceGroupName <group-name> -Name <app-name> -ConnectionStringNames <string-name1>,<string-name2>,...

Selezionare il pulsante Modifica avanzata. Modificare le stringa di connessione nell'area di testo. Al termine, selezionare Aggiorna. Non dimenticare di selezionare Salva nella pagina Configurazione.

Connessione stringhe di Connessione hanno la formattazione JSON seguente:

[
  {
    "name": "name-1",
    "value": "conn-string-1",
    "type": "SQLServer",
    "slotSetting": false
  },
  {
    "name": "name-2",
    "value": "conn-string-2",
    "type": "PostgreSQL",
    "slotSetting": false
  },
  ...
]

Eseguire az webapp config connection-string set con il nome del file JSON.

az webapp config connection-string set --resource-group <group-name> --name <app-name> --settings "@fileName.json"

Il formato di file necessario è una matrice JSON di stringa di connessione in cui il campo delle impostazioni dello slot è facoltativo. Ad esempio:

[
  {
    "name": "name-1",
    "value": "conn-string-1",
    "type": "SQLServer",
    "slotSetting": false
  },
  {
    "name": "name-2",
    "value": "conn-string-2",
    "type": "PostgreSQL",
  },
  ...
]

Per praticità, è possibile salvare le stringa di connessione esistenti in un file JSON con az webapp config connection-string list. L'esempio seguente può essere eseguito in Bash.

# Save the connection strings
az webapp config connection-string list --resource-group <group-name> --name <app-name> > settings.json

# Edit the JSON file
...

# Update the app with the JSON file
az webapp config connection-string set --resource-group <group-name> --name <app-name> --settings @settings.json

Non è possibile modificare stringa di connessione in blocco usando un file JSON con Azure PowerShell.

Nel portale di Azure cercare e selezionare Servizi app, quindi selezionare la propria app. Nel menu a sinistra dell'app selezionare Impostazioni generali di configurazione>.

Qui è possibile configurare alcune impostazioni comuni per l'app. Alcune impostazioni richiedono di aumentare le prestazioni fino ai piani tariffari più elevati.

• Impostazioni stack: stack software per eseguire l'app, incluse le versioni del linguaggio e dell'SDK.

  Per le app Linux, è possibile selezionare la versione del runtime del linguaggio e impostare un comando di avvio facoltativo o un file di comando di avvio.

  

• Impostazioni piattaforma: consente di configurare le impostazioni per la piattaforma di hosting, ad esempio quelle riportate in seguito.

  • Bitness della piattaforma: a 32 bit o a 64 bit. Solo per le app di Windows.
  • Stato FTP: consente solo FTPS o disabilita completamente FTP.
  • Versione HTTP: impostare su 2.0 per abilitare il supporto per il protocollo HTTPS/2 .

  Nota

  I browser più recenti supportano il protocollo HTTP/2 solo su TLS, mentre il traffico non crittografato continua a usare il protocollo HTTP/1.1. Per assicurarsi che i browser client si connettano all'app con HTTP/2, proteggere il nome DNS personalizzato. Per altre informazioni, vedere Proteggere un nome DNS personalizzato con un'associazione TLS/SSL in app Azure Service.

  • Web socket: per ASP.NET SignalR o socket.io, ad esempio.

  • Always On: mantiene l'app caricata anche quando non è presente traffico. Quando Always On non è attivato (impostazione predefinita), l'app viene scaricata dopo 20 minuti senza richieste in ingresso. L'app scaricata può causare una latenza elevata per le nuove richieste a causa del tempo di riscaldamento. Quando Always On è attivato, il servizio di bilanciamento del carico front-end invia una richiesta GET alla radice dell'applicazione ogni cinque minuti. Il ping continuo impedisce che l'app venga scaricata.

    Always On è necessario per processi Web continui o per processi Web attivati tramite un'espressione CRON.

  • Affinità ARR: in una distribuzione a più istanze assicurarsi che il client sia instradato alla stessa istanza per tutta la durata della sessione. È possibile impostare questa opzione su Disattivato per le applicazioni senza stato.

  • Solo HTTPS: se abilitato, tutto il traffico HTTP viene reindirizzato a HTTPS.

  • Versione minima di TLS: selezionare la versione minima della crittografia TLS richiesta dall'app.

• Debug: abilitare il debug remoto per le app ASP.NET, ASP.NET Core o Node.js . Questa opzione si disattiva automaticamente dopo 48 ore.

• Certificati client in ingresso: richiedono certificati client nell'autenticazione reciproca.

È possibile impostare molte delle opzioni configurabili comuni usando az webapp config set. Nell'esempio seguente viene illustrato un subset delle opzioni configurabili.

az webapp config set --resource-group <group-name> --name <app-name> --use-32bit-worker-process [true|false] --web-sockets-enabled [true|false] --always-on [true|false]--http20-enabled --auto-heal-enabled [true|false] --remote-debugging-enabled [true|false] --number-of-workers

Per visualizzare le impostazioni esistenti, usare il comando az webapp config show .

È possibile impostare molte delle opzioni configurabili comuni usando Set-AzWebApp. Nell'esempio seguente viene illustrato un subset delle opzioni configurabili.

Set-AzWebApp -ResourceGroupName <group-name> -Name <app-name> -Use32BitWorkerProcess [True|False] -WebSocketsEnabled [True|False] -AlwaysOn [True|False] -NumberOfWorkers

Per visualizzare le impostazioni esistenti, usare il comando Get-AzWebApp .

1. Nel portale di Azure cercare e selezionare Servizi app, quindi selezionare la propria app.

2. Nel menu a sinistra dell'app selezionare Configurazione>documenti predefiniti.

   

3. Per aggiungere un documento predefinito, selezionare Nuovo documento. Per rimuovere un documento predefinito, selezionare Elimina a destra.

Aggiungere un documento predefinito usando az resource update:

az resource update --resource-group <group-name> --resource-type "Microsoft.Web/sites/config" --name <app-name>/config/web --add properties.defaultDocuments <filename>

Aggiungere un documento predefinito modificando l'oggetto PowerShell dell'app di aggiornamento:

$webapp = Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>
$webapp.SiteConfig.DefaultDocuments.Add("<filename>")
Set-AzWebApp $webapp

1. Nel portale di Azure cercare e selezionare Servizi app, quindi selezionare la propria app.

2. Nel menu a sinistra dell'app selezionare Mapping percorso di configurazione>

3. Selezionare Nuova applicazione virtuale o directory.

   • Per eseguire il mapping di una directory virtuale a un percorso fisico, lasciare selezionata la casella di controllo Directory . Specificare la directory virtuale e il percorso relativo (fisico) corrispondente alla radice del sito Web (D:\home).
   • Per contrassegnare una directory virtuale come applicazione Web, deselezionare la casella di controllo Directory.

   

4. Seleziona OK.

L'esempio seguente imposta il percorso / radice sulla public sottodirectory (che funziona per Laravel) e aggiunge anche una seconda applicazione virtuale nel /app2 percorso. Per eseguirlo, creare un file denominato json.txt con il contenuto seguente.

[
  {
    "physicalPath"':' "site\\wwwroot\\public",
    "preloadEnabled"':' false,
    "virtualDirectories"':' null,
    "virtualPath"':' "/"
  },
  {
    "physicalPath"':' "site\\wwwroot\\app2",
    "preloadEnabled"':' false,
    "virtualDirectories"':' null,
    "virtualPath"':' "/app2"
  }
]

Modificare <group-name> e <app-name> per le risorse ed eseguire il comando seguente. Tenere presente i caratteri di escape durante l'esecuzione di questo comando. Per altre informazioni sui caratteri di escape, vedere Suggerimenti per l'uso corretto dell'interfaccia della riga di comando di Azure.

az resource update --resource-group <group-name> --resource-type Microsoft.Web/sites/config --name <app-name>/config/web --set properties.virtualApplications="@json.txt"

L'esempio seguente imposta il percorso / radice sulla public sottodirectory (che funziona per Laravel) e aggiunge anche una seconda applicazione virtuale nel /app2 percorso. Per eseguirlo, modificare <group-name> e <app-name>.

$webapp=Get-AzWebApp -ResourceGroupName <group-name> -Name <app-name>

# Set default / path to public subdirectory
$webapp.SiteConfig.VirtualApplications[0].PhysicalPath= "site\wwwroot\public"

# Add a virtual application
$virtualApp = New-Object Microsoft.Azure.Management.WebSites.Models.VirtualApplication
$virtualApp.VirtualPath = "/app2"
$virtualApp.PhysicalPath = "site\wwwroot\app2"
$virtualApp.PreloadEnabled = $false
$webapp.SiteConfig.VirtualApplications.Add($virtualApp)

# Save settings
Set-AzWebApp $webapp