Modifica

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 i stringa di connessione di 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
  • Può essere usato per archiviare i segreti usati nella configurazione di autenticazione
  • Sono crittografati inattivi
  • Vengono copiati in ambienti di gestione temporanea e di produzione
  • Può essere costituito 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

  • Applicazione App Web statiche di Azure
  • Interfaccia della riga di comando di Azure obbligatoria se si usa la riga di comando

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 Configurazione nella barra laterale.

  4. Selezionare l'ambiente a cui applicare le impostazioni dell'applicazione. È possibile configurare le impostazioni dell'applicazione per ogni ambiente. Quando si crea una richiesta pull, gli ambienti di staging vengono creati automaticamente e quindi alzati di livello nell'ambiente di produzione quando si unisce la richiesta pull.

  5. Selezionare + Aggiungi per aggiungere una nuova impostazione dell'app. Screenshot della visualizzazione della configurazione di App Web statiche di Azure

  6. Immettere un nome e un valore.

  7. Seleziona OK.

  8. Seleziona Salva.

Usare l'interfaccia della riga di comando di Azure

Usare il az staticwebapp appsettings comando 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 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