Modifica

Condividi tramite

Configurare le impostazioni dell'applicazione per App Web statiche di Azure

  • Procedure

Le impostazioni dell'applicazione contengono valori di configurazione che possono cambiare, ad esempio le stringhe di connessione del database. L'aggiunta delle impostazioni dell'applicazione consente di modificare l'input di configurazione per l'app, senza dover modificare il codice dell'applicazione.

Impostazioni dell'applicazione:

  • Sono disponibili come variabili di ambiente per l'API back-end di un'app Web statica
  • Possono essere usate per archiviare i segreti usati nella configurazione di autenticazione
  • Sono crittografate in stato di inattività
  • Sono copiate negli ambienti di staging e produzione
  • Possono essere costituite solo da caratteri alfanumerici, . e _

Importante

Le impostazioni dell'applicazione descritte in questo articolo si applicano solo all'API back-end di un'app Web statica di Azure.

Per configurare le variabili di ambiente necessarie per compilare l'applicazione Web front-end, vedere Configurazione di compilazione.

Prerequisiti

Configurare le impostazioni dell'applicazione API per lo sviluppo locale

Le API in App Web statiche di Azure sono basate su Funzioni di Azure, che consente di definire le impostazioni dell'applicazione nel file local.settings.json quando si esegue l’applicazione in locale. Questo file definisce le impostazioni dell'applicazione nella proprietà Values della configurazione.

Nota

Il file local.settings.json viene usato solo per lo sviluppo locale. Usare il portale di Azure per configurare le impostazioni dell'applicazione per la produzione.

Il file local.settings.json di esempio seguente mostra come aggiungere un valore per la stringa di connessione del database in DATABASE_CONNECTION_STRING.

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "",
    "FUNCTIONS_WORKER_RUNTIME": "node",
    "DATABASE_CONNECTION_STRING": "<YOUR_DATABASE_CONNECTION_STRING>"
  }
}

Settings defined in the Values property can be referenced from code as environment variables. In Node.js functions, for example, they're available in the process.env object.

const connectionString = process.env.DATABASE_CONNECTION_STRING;

The local.settings.json file isn't tracked by the GitHub repository because sensitive information, like database connection strings, are often included in the file. Since the local settings remain on your machine, you need to manually configure your settings in Azure.

Generally, configuring your settings is done infrequently, and isn't required with every build.

Configurare le impostazioni dell'applicazione

È possibile configurare le impostazioni dell'applicazione tramite il portale di Azure o con l'interfaccia della riga di comando di Azure.

Usare il portale di Azure

Il portale di Azure fornisce un'interfaccia per la creazione, l'aggiornamento e l'eliminazione delle impostazioni dell'applicazione.

  1. Vai al portale di Azure.

  2. Aprire l'app Web statica.

  3. Selezionare Variabili di ambiente nella barra laterale.

  4. Selezionare l'ambiente in cui si desidera creare le variabili di ambiente. È possibile creare variabili per ogni ambiente. Quando si crea una richiesta pull, gli ambienti di staging vengono creati automaticamente e quindi passati all’ambiente di produzione quando si unisce la richiesta pull.

  5. Selezionare + Aggiungi per aggiungere una nuova variabile di ambiente. Screenshot della visualizzazione delle variabili di ambiente di App Web statiche di Azure

  6. Specificare le informazioni per Nome e Valore.

  7. Seleziona OK.

  8. Seleziona Salva.

Usare l'interfaccia della riga di comando di Azure

Usare il comando az staticwebapp appsettings per aggiornare le impostazioni in Azure.

In un terminale o nella riga di comando, eseguire il comando seguente per aggiungere o aggiornare un'impostazione denominata message con il valore Hello world. Assicurarsi di sostituire il segnaposto <YOUR_APP_ID> con il proprio valore.

az staticwebapp appsettings set --name <YOUR_APP_ID> --setting-names "message=Hello world"

Tip

You can add or update multiple settings by passing multiple name-value pairs to --setting-names.

View application settings with the Azure CLI

In a terminal or command line, execute the following command. Make sure to replace the placeholder <YOUR_APP_ID> with your value.

az staticwebapp appsettings list --name <YOUR_APP_ID>

Delete application settings with the Azure CLI

In a terminal or command line, execute the following command to delete a setting named message. Make sure to replace the placeholder <YOUR_APP_ID> with your value.

az staticwebapp appsettings delete --name <YOUR_APP_ID> --setting-names "message"

Tip

Delete multiple settings by passing multiple setting names to --setting-names.

Contenuto correlato