Configurare l'ambiente di sviluppo JavaScript per Azure

Quando si creano applicazioni cloud, gli sviluppatori preferiscono in genere testare il codice nelle workstation locali prima di distribuirlo in un ambiente cloud come Azure. Lo sviluppo locale offre il vantaggio di un'ampia gamma di strumenti insieme a un ambiente familiare.

Questo articolo fornisce istruzioni di configurazione per creare e convalidare un ambiente di sviluppo locale adatto per JavaScript con Azure.

Creazione della sottoscrizione una tantum

Le risorse di Azure vengono create all'interno di una sottoscrizione e di un gruppo di risorse.

Tipo

Descrizione

Sottoscrizione alla versione di valutazione

Creare una prova gratuita.

Sottoscrizione esistente

Se si ha già una sottoscrizione, accedere alla sottoscrizione esistente con:

• Portale di Azure
• Interfaccia della riga di comando di Azure
• Librerie client di Azure per JavaScript
• estensioni di Visual Studio Code

Tra più sottoscrizioni

Se è necessario gestire più sottoscrizioni, vedere come creare un gruppo di gestione con JavaScript.

Installazione di software una tantum

Sviluppo di Azure con JavaScript nella workstation locale, è consigliabile installare gli strumenti seguenti:

Nome/Programma di installazione	Descrizione
Node.js LTS	Installare l'ambiente di runtime LTS (Long-Term Support) più recente per lo sviluppo in workstation locali. Altre informazioni sulla selezione di una versione di Node.js per Azure.
Visual Studio Code	Visual Studio Code offre un'esperienza ottimale di integrazione e scrittura del codice JavaScript, ma non è necessaria. È infatti possibile usare qualsiasi editor di codice.
estensioni di Visual Studio Code	Installare tutte le estensioni pertinenti per i servizi di Azure che si intende usare.

Runtime di hosting di Azure

Quando si usa una risorsa di Azure come ambiente di hosting per l'applicazione, ad esempio un'app Web di Azure o Funzioni di Azure, verificare che la versione di runtime dell'ambiente di sviluppo locale Node.js di Node.js corrisponda al runtime delle risorse di Azure che si intende usare.

Installazioni locali consigliate

Le installazioni comuni seguenti in workstation locali sono consigliate per semplificare le attività di sviluppo locali.

Nome	Descrizione
Interfaccia della riga di comando di Azure	Interfaccia della riga di comando locale o basata sul cloud per creare e usare le risorse di Azure.
Interfaccia della riga di comando per sviluppatori di Azure	Strumento da riga di comando incentrato sugli sviluppatori per la creazione di app cloud nel flusso di lavoro per sviluppatori.
Estensioni di Visual Studio Code per Azure	Estensioni di VS Code nell'IDE.
Git o Git per Windows	Strumenti da riga di comando per il controllo del codice sorgente. Se si preferisce, è possibile usare uno strumento diverso per il controllo del codice sorgente.
Docker per Windows o Mac	Usare i contenitori di sviluppo per ambienti di sviluppo coerenti.
Node.js LTS	Ulteriori informazioni

Installare Node.js

Azure supporta le versioni LTS di Node.js. Altre informazioni sulla selezione di una versione di Node.js per Azure.

Configurazione monouso per l'autenticazione

Per usare lo stesso codice di autenticazione nello sviluppo locale e nell'ambiente di hosting remoto di Azure, usare DefaultAzureCredential. Altre informazioni su questa identità gestita.

Creare un gruppo di risorse per il progetto

Portale di Azure

1. Nel Web browser aprire il portale di Azure.

2. Nella barra di ricerca immettere i gruppi di risorse e selezionarlo.

3. Selezionare + Crea.

4. Immettere le impostazioni del gruppo di risorse:

   Proprietà	valore
   Abbonamento	Selezionare la propria sottoscrizione.
   Gruppo di risorse	Immettere il nome del gruppo di risorse. Questo nome del gruppo di risorse viene usato come parte di un URI delle risorse quando si accede a Resource Manager (piano di gestione). Il nome non viene usato per il controllo (ad esempio per la creazione di un database) o per il piano dati (inserimento di dati in una tabella).
   Paese	Selezionare un'area geografica per il gruppo di risorse.

5. Selezionare Rivedi e crea per iniziare la convalida.

6. Quando la convalida ha esito positivo, selezionare Crea.

Visual Studio Code

1. Aprire il riquadro comandi, CTRL + MAIUSC + P.

2. Cercare crea gruppo di risorse e selezionarlo.

3. Rispondere alle richieste usando le impostazioni seguenti:

   Richiesta	valore
   Selezionare la sottoscrizione	Se richiesto, accedere ad Azure. Selezionare una sottoscrizione esistente o creare un account Azure, se non ne è disponibile uno.
   Immettere il nome del nuovo gruppo di risorse.	Immettere il nome del gruppo di risorse. Questo nome del gruppo di risorse viene usato come parte di un URI delle risorse quando si accede a Resource Manager (piano di gestione). Il nome non viene usato per il controllo (ad esempio per la creazione di un database) o per il piano dati (inserimento di dati in una tabella).
   Selezionare una località per le nuove risorse.	Selezionare un'area geografica per il gruppo di risorse.

Interfaccia della riga di comando di Azure

1. Accedere ad Azure:

   az login
   

   Completare l'autenticazione in un browser.

2. Elencare i nomi e gli ID delle sottoscrizioni. Copiare il valore SubscriptionId per usare il comando successivo.

   az account subscription list --output table 
   

3. Impostare la sottoscrizione predefinita, usata dai comandi successivi:

   az account set --subscription YOUR_SUBSCRIPTION_ID
   

4. Selezionare un elenco di località supportate per la sottoscrizione. Copia il valore Name di una regione vicina.

   az account list-locations --output table
   

5. Usare l'interfaccia della riga di comando di Azure seguente per creare un gruppo di risorse con il nome o l'ID della sottoscrizione:

   az group create --name "YOUR_RESOURCE_GROUP_NAME" --location YOUR_REGION
   

   Ad esempio:

   az group create --name "my-azure-app" --location westus
   

Uso di Azure e delle librerie client di Azure SDK

Le librerie client di Azure vengono fornite singolarmente per ogni servizio. Ogni libreria viene installata in base al servizio di Azure che è necessario usare.

Ogni nuovo progetto che usa Azure deve:

• Creare le risorse di Azure.
• Installare le librerie client di Azure da una gestione pacchetti, ad esempio NPM.
• Usare l'identità gestita per eseguire l'autenticazione con la libreria client di Azure, quindi usare le informazioni di configurazione per accedere a servizi specifici.

Protezione delle informazioni di configurazione

Sono disponibili diverse opzioni per archiviare le informazioni di configurazione:

• Azure Key Vault per creare e gestire segreti, chiavi e certificati che accedono alle risorse cloud, che non offrono ancora l'accesso alle identità gestite.
• Dotenv è un pacchetto npm diffuso per leggere le variabili di ambiente da un .env file. Assicurarsi di aggiungere il .env file al .gitignore file in modo che il .env file non sia archiviato nel controllo del codice sorgente.

Creare variabili di ambiente

Per usare le impostazioni di Azure richieste dalle librerie di Azure SDK per accedere al cloud di Azure, impostare i valori più comuni per le variabili di ambiente. I comandi seguenti impostano le variabili di ambiente per la workstation locale.

Negli esempi seguenti l'ID client corrisponde all'ID e al segreto dell'entità servizio.

Bash

AZURE_SUBSCRIPTION_ID="<REPLACE-WITH-YOUR-AZURE-SUBSCRIPTION-ID>"
AZURE_TENANT_ID="<REPLACE-WITH-YOUR-AZURE-TENANT-ID>"
AZURE_CLIENT_ID="<REPLACE-WITH-YOUR-AZURE-CLIENT-ID>"
AZURE_CLIENT_SECRET="<REPLACE-WITH-YOUR-AZURE-CLIENT-SECRET>"

Cmd

set AZURE_SUBSCRIPTION_ID="<REPLACE-WITH-YOUR-AZURE-SUBSCRIPTION-ID>"
set AZURE_TENANT_ID="<REPLACE-WITH-YOUR-AZURE-TENANT-ID>"
set AZURE_CLIENT_ID="<REPLACE-WITH-YOUR-AZURE-CLIENT-ID>"
set AZURE_CLIENT_SECRET="<REPLACE-WITH-YOUR-AZURE-CLIENT-SECRET>"

Sostituire i valori tra parentesi <> in questi comandi con quelli della vostra variabile di ambiente specifica.

Creare un .env file

Un altro meccanismo comune consiste nell'usare il pacchetto npm DOTENV per creare un file .env per queste impostazioni. Se si prevede di usare un `.env`, assicurarsi di aggiungere il file a `.gitignore` per evitare di archiviare il file nel controllo del codice sorgente. Per assicurarsi che tali impostazioni vengano archiviate nel controllo del codice sorgente, il modo più semplice consiste nell'aggiungere il file .env al file .ignore di git.

Installa nuovi pacchetti npm

Per ogni progetto è consigliabile creare una cartella separata e un file package.json specifico seguendo questa procedura:

1. Aprire un terminale, un prompt dei comandi o una shell bash e creare una nuova cartella per il progetto. Passare quindi alla nuova cartella.

   mkdir MY-NEW-PROJECT && cd MY-NEW-PROJECT
   

2. Inizializzare il file di pacchetto:

   npm init -y
   

   Questo comando crea il file package.json e inizializza le proprietà minime.

3. Installare le librerie client di Azure necessarie, ad esempio questa libreria client di autenticazione:

   npm install @azure/identity
   

Usare il controllo del codice sorgente con Visual Studio Code

È consigliabile creare un repository del controllo del codice sorgente ogni volta che si avvia un progetto. È possibile eseguire questa operazione da Visual Studio Code.

1. In Visual Studio Code, selezionare l'icona del controllo del codice sorgente per aprire l'esploratore Controllo del Codice Sorgente, quindi selezionare Inizializza Repository per inizializzare un repository Git locale.

   

2. Dopo l'inizializzazione del repository e i file da archiviare nel controllo del codice sorgente, immettere il messaggio Initial commit e selezionare il segno di spunta per creare il commit iniziale dei file di origine.

   

3. Creare un nuovo repository in GitHub e copiare l'URL del repository per il passaggio successivo.

4. Nel terminale integrato di Visual Studio usare il comando git seguente per aggiungere il repository remoto al repository locale. Sostituire <YOUR-ACCOUNT> e <REPOSITORY> con valori personalizzati.

   git remote add origin https://github.com/<YOUR-ACCOUNT>/<REPOSITORY>
   

Visual Studio Code include molte funzionalità Git predefinite. Per altre informazioni, vedere Uso del controllo della versione in VS Code.

Passaggi successivi

• Creare e usare un'entità servizio
• Eseguire l'autenticazione con i moduli di Azure per Node.js