Konfigurera din JavaScript-utvecklingsmiljö för Azure

När du skapar molnprogram föredrar utvecklare vanligtvis att testa kod på sina lokala arbetsstationer innan de distribuerar koden till en molnmiljö som Azure. Lokal utveckling ger dig fördelen av ett bredare utbud av verktyg tillsammans med en välbekant miljö.

Den här artikeln innehåller installationsinstruktioner för att skapa och verifiera en lokal utvecklingsmiljö som är lämplig för JavaScript med Azure.

Skapa en engångsprenumeration

Azure-resurser skapas i en prenumeration och resursgrupp.

Engångsinstallation av programvara

Azure-utveckling med JavaScript på din lokala arbetsstation rekommenderar vi att du installerar följande verktyg:

Azure-värdkörning

När du använder en Azure-resurs som värdmiljö för ditt program, till exempel en Azure-webbapp eller Azure Functions, kontrollerar du att din lokala Node.js körningsversion av utvecklingsmiljön av Node.js matchar den Azure-resurskörning som du planerar att använda.

Rekommenderade lokala installationer

Följande vanliga lokala arbetsstationsinstallationer rekommenderas för att hjälpa dig med dina lokala utvecklingsuppgifter.

Installera Node.js

Azure stöder LTS-versioner av Node.js. Läs mer om att välja en version av Node.js för Azure.

Engångskonfiguration för autentisering

Om du vill använda samma autentiseringskod i lokal utveckling och azure-fjärrmiljön använder du DefaultAzureCredential. Läs mer om den här hanterade identiteten.

Skapa en resursgrupp för projektet

Arbeta med Azure och Azure SDK-klientbibliotek

Azure-klientbiblioteken tillhandahålls individuellt för varje tjänst. Du installerar varje bibliotek baserat på den Azure-tjänst som du behöver använda.

Varje nytt projekt som använder Azure bör:

• Skapa Azure-resurser.
• Installera Azure-klientbibliotek från en pakethanterare, till exempel NPM.
• Använd hanterad identitet för att autentisera med Azure-klientbiblioteket och använd sedan konfigurationsinformation för att komma åt specifika tjänster.

Skydda konfigurationsinformation

Du har flera alternativ för att lagra konfigurationsinformation:

• Azure Key Vault för att skapa och underhålla hemligheter, nycklar och certifikat som har åtkomst till molnresurser, som ännu inte erbjuder åtkomst till hanterad identitet.
• Dotenv är ett populärt npm-paket för att läsa miljövariabler från en .env fil. Se till att lägga till .env filen i .gitignore filen så .env att filen inte checkas in i källkontrollen.

Skapa miljövariabler

Om du vill använda De Azure-inställningar som behövs av Azure SDK-biblioteken för att få åtkomst till Azure-molnet anger du de vanligaste värdena till miljövariabler. Följande kommandon anger miljövariablerna för den lokala arbetsstationen.

I följande exempel är klient-ID:t tjänstens huvudnamns-ID och tjänstens huvudnamnshemlighet.

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>"

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>"

Ersätt värdena inom <> hakparenteser i dessa kommandon med värdena för din specifika miljövariabel.

Skapa .env fil

En annan vanlig mekanism är att använda DOTENV NPM-paketet för att skapa en .env fil för de här inställningarna. Om du planerar att använda en .envska du lägga till filen i så att .gitignore du inte checkar in filen i källkontrollen. Lägg till filen i .env git-filen .ignore är standardsättet för att säkerställa att inställningarna är incheckade i källkontrollen.

Installera npm-paket

För varje projekt rekommenderar vi att du alltid skapar en separat mapp och en egen package.json fil med hjälp av följande steg:

1. Öppna en terminal, en kommandotolk eller ett bash-gränssnitt och skapa en ny mapp i projektet. Flytta sedan till den nya mappen.

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

2. Initiera paketfilen:

   npm init -y
   

   Det här kommandot skapar filen package.json och initierar de minsta egenskaperna.

3. Installera de Azure-klientbibliotek som du behöver, till exempel det här autentiseringsklientbiblioteket:

   npm install @azure/identity
   

Använda källkontroll med Visual Studio Code

Vi rekommenderar att du använder för vana att skapa en lagringsplats för källkontroll när du startar ett projekt. Du kan göra detta från Visual Studio Code.

1. I Visual Studio Code väljer du källkontrollikonen för att öppna Utforskaren för källkontroll och väljer sedan Initiera lagringsplats för att initiera en lokal Git-lagringsplats:

   

2. När lagringsplatsen har initierats och du har filer att lagra i källkontrollen anger du meddelandet Initial commit och markerar bockmarkeringen för att skapa den första incheckningen av källfilerna.

   

3. Skapa en ny lagringsplats på GitHub och kopiera lagringsplatsens URL för nästa steg.

4. I den integrerade Terminalen i Visual Studio använder du följande git-kommando för att lägga till fjärrlagringsplatsen på den lokala lagringsplatsen. Ersätt <YOUR-ACCOUNT> och <REPOSITORY> med dina egna värden.

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

Visual Studio Code innehåller många inbyggda git-funktioner. Mer information finns i Använda versionskontroll i VS Code.

Nästa steg

• Skapa och använda ett huvudnamn för tjänsten
• Autentisera med Azure-modulerna för Node.js