Konfigurera din lokala JavaScript-utvecklingsmiljö för Azure

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

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

Skapa en prenumeration en gång

Azure-resurser skapas i en prenumeration och resursgrupp.

Installation av en-gång-programvara

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

Körtid för Azure-värd

Om du planerar att använda en Azure-resurs som värdmiljö för ditt program, till exempel en Azure-webbapp eller Azure Functions, bör du kontrollera att körningsversionen av Node.js för din lokala Node.js-utvecklingsmiljö 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 till med dina lokala utvecklingsuppgifter.

Konfiguration en gång för autentisering

Om du vill använda samma autentiseringskod i lokal utveckling och den fjärranslutna Azure-värdmiljön använder du DefaultAzureCredential.

Så här använder du samma kod i alla miljöer:

• För lokal utveckling skapardu ett huvudnamn för tjänsten för att skapa och hantera Azure-resurser utan att använda ditt personliga konto.
• För Azure-värdtjänsterkan du läsa mer.

Arbeta med Azure och Azure SDK-klientbibliotek

Azure SDK-biblioteken tillhandahålls separat 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 och spara associerade nycklar eller konfiguration på en säker plats.
• Installera Azure SDK-bibliotek från NPM eller Yarn.
• Använd dina lokala autentiseringsuppgifter för tjänstens huvudnamn för att autentisera till Azure SDK och använd sedan konfigurationsinformation för att få åtkomst till specifika tjänster.

Skydda konfigurationsinformation

Det finns flera alternativ för att lagra konfigurationsinformation:

• Azure Key Vault att skapa och underhålla nycklar som ger åtkomst till och krypterar dina molnresurser, appar och lösningar.
• Dotenv är ett populärt npm-paket för att läsa miljövariabler från en fil. Se till att lägga till .env filen i filen så att filen inte .gitignore.env checkas in i källkontrollen. Läs mer om miljövariabler i webbappar för Azure.

Skapa miljövariabler för Azure-biblioteken

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

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

AZURE_SUBSCRIPTION_ID="aa11bb33-cc77-dd88-ee99-0918273645aa"
AZURE_TENANT_ID="00112233-7777-8888-9999-aabbccddeeff"
AZURE_CLIENT_ID="12345678-1111-2222-3333-1234567890ab"
AZURE_CLIENT_SECRET="abcdef00-4444-5555-6666-1234567890ab"

set AZURE_SUBSCRIPTION_ID="aa11bb33-cc77-dd88-ee99-0918273645aa"
set AZURE_TENANT_ID=00112233-7777-8888-9999-aabbccddeeff
set AZURE_CLIENT_ID=12345678-1111-2222-3333-1234567890ab
set AZURE_CLIENT_SECRET=abcdef00-4444-5555-6666-1234567890ab

Ersätt värdena som visas i de här kommandona med värdena för ditt specifika huvudnamn för tjänsten.

Skapa .env fil

En annan vanlig metod är att använda DOTENV NPM-paketet för att skapa .env en fil för dessa inställningar. Om du planerar att använda .env en ska du inte checka in .env i källkontrollen. Att lägga .env till filen i .ignore git-filen är standard för att se till att dessa inställningar checkas in 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, kommandotolk eller 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
   

   Då skapas filen package.json och minimiegenskaperna initieras.

3. Installera de Azure SDK-bibliotek som du behöver, till exempel det här exemplet:

   npm install @azure/ai-text-analytics@5.0.0
   

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 ikonen för källkontroll för att öppna Utforskaren för källkodskontroll 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 och markerar bockmarkeringen för att skapa den första incheckningen Initial commit av dina källfiler.

   

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

4. I den Visual Studio terminalen använder du följande git-kommando för att lägga till fjärrlagringsplatsen till din lokala lagringsplats. Ersätt YOUR-ALIAS och med dina egna YOUR-REPOSITORY värden.

   git remote add origin https://github.com/YOUR-ALIAS/YOUR-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