A helyi JavaScript fejlesztői környezet konfigurálása az Azure-hoz

Felhőalkalmazások létrehozásakor a fejlesztők általában inkább a helyi munkaállomásokon tesztelik a kódot, mielőtt üzembe helyeznék a kódot egy felhőkörnyezetben, például az Azure-ban. A helyi fejlesztés a megszokott környezettel együtt a szélesebb körű eszközök előnyeit is biztosítja.

Ez a cikk telepítési utasításokat tartalmaz egy olyan helyi fejlesztési környezet létrehozásához és érvényesítéséhez, amely alkalmas a JavaScripthez az Azure-ral.

Egyszeri előfizetés létrehozása

Az Azure-erőforrások egy előfizetésen és erőforráscsoporton belül jönnek létre.

Type	Description
Feliratkozás próbaverzióra	Hozzon létre egy ingyenespróbaverziós előfizetést.
Meglévő előfizetés	Ha már rendelkezik előfizetéssel, a meglévő előfizetését az Azure Portalon, az Azure CLI-ben vagy a JavaScripthez készült Azure SDK-kban érheti el.
Több előfizetés között	Ha több előfizetést is kezelnie kell, megtudhatja, hogyan hozhat létre felügyeleti csoportot JavaScript használatával.

Egyszeri szoftvertelepítés

Az Azure JavaScripttel való fejlesztése a helyi munkaállomáson, javasoljuk, hogy telepítse a következőket:

Név/telepítő	Leírás
Node.js LTS	Telepítse a legújabb hosszú távú támogatási (LTS) futtatókörnyezetet a helyi munkaállomások fejlesztéséhez.
Visual Studio Code	A Visual Studio Code nagyszerű JavaScript-integrációs és kódolási élményt nyújt, de nem szükséges. Bármilyen kódszerkesztőt használhat.

Azure hosting runtime

Ha azure-erőforrást szeretne használni az alkalmazás üzemeltetési környezeteként, például egy Azure-webalkalmazást vagy az Azure Functionst, ellenőrizze, hogy a Node.js helyi Node.js fejlesztési környezetének futtatókörnyezete megegyezik-e a használni kívánt Azure-erőforrás-futtatókörnyezettel.

Ajánlott helyi telepítések

A helyi fejlesztési feladatok elvégzéséhez az alábbi gyakori helyi munkaállomás-telepítéseket javasoljuk.

Name	Leírás
Azure CLI	Helyi vagy felhőalapú parancssori felület Azure-erőforrások létrehozásához és használatához.
Azure Developer CLI	Fejlesztőközpontú parancssori eszköz felhőalkalmazások fejlesztői munkafolyamatban való létrehozásához.
Visual Studio Code-bővítmények az Azure-hoz	VS Code-bővítmények az IDE-hez.
Git vagy Git for Windows	Parancssori eszközök a forrásvezérléshez. Tetszés szerint másik forrásvezérlő eszközt is használhat.

Egyszeri hitelesítés konfigurálása

Ha ugyanazt a hitelesítési kódot szeretné használni a helyi fejlesztésben és a távoli Azure-üzemeltetési környezetben, használja a DefaultAzureCredential parancsot.

Erőforráscsoport létrehozása a projekthez

Azure Portal

1. Nyissa meg az Azure Portalt egy webböngészőben.

2. A keresősávon adja meg az erőforráscsoportokat , és jelölje ki.

3. Válassza a +Létrehozás lehetőséget.

4. Adja meg az erőforráscsoport beállításait:

   Tulajdonság	Érték
   Előfizetés	Select your subscription.
   Erőforráscsoport	Adja meg az erőforráscsoport nevét. Ezt az erőforráscsoportnevet az erőforrás-URI részeként használja a Resource Manager (felügyeleti sík) elérésekor. A név nem használható vezérlőhöz (például adatbázis létrehozásához) vagy adatsíkhoz (adatok táblázatba való beszúrásához).
   Region	Válasszon egy földrajzi régiót az erőforráscsoporthoz.

5. Az ellenőrzés megkezdéséhez válassza a Véleményezés + létrehozás lehetőséget .

6. Sikeres érvényesítés esetén válassza a Létrehozás lehetőséget.

Visual Studio Code

1. Nyissa meg a Ctrl Shift + P parancskatalógusát. +

2. Keressen rá az erőforráscsoport létrehozására, és válassza ki.

3. A következő beállításokkal válaszoljon a kérdésekre:

   Adatkérés	Érték
   Előfizetés kiválasztása	Ha a rendszer kéri, jelentkezzen be az Azure-ba. Válasszon ki egy meglévő előfizetést, vagy hozzon létre egy Azure-fiókot, ha nem rendelkezik ilyen fiókkal.
   Adja meg az új erőforráscsoport nevét.	Adja meg az erőforráscsoport nevét. Ezt az erőforráscsoportnevet az erőforrás-URI részeként használja a Resource Manager (felügyeleti sík) elérésekor. A név nem használható vezérlőhöz (például adatbázis létrehozásához) vagy adatsíkhoz (adatok táblázatba való beszúrásához).
   Válasszon egy helyet az új erőforrásokhoz.	Válasszon egy földrajzi régiót az erőforráscsoporthoz.

Azure CLI

1. Jelentkezzen be az Azure-ba:

   az login
   

   Végezze el a hitelesítést egy böngészőben.

2. Listázhatja az előfizetések nevét és azonosítóit. Másolja ki az SubscriptionId értéket a következő parancs használatához.

   az account subscription list --output table 
   

3. Állítsa be az alapértelmezett előfizetést, amelyet a következő parancsok használnak:

   az account set --subscription YOUR_SUBSCRIPTION_ID
   

4. Válasszon az előfizetéséhez támogatott helyek listájából. Másolja ki az Önhöz közeli régió névértékét .

   az account list-locations --output table
   

5. Az alábbi Azure CLI használatával hozzon létre egy erőforráscsoportot az előfizetés nevével vagy azonosítójával:

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

   Például:

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

Az Azure és az Azure SDK ügyfélkódtárainak használata

Az Azure SDK-kódtárakat minden szolgáltatáshoz külön-külön biztosítjuk. Az egyes kódtárakat a használni kívánt Azure-szolgáltatás alapján kell telepítenie.

Az Azure-t használó minden új projektnek a következőnek kell lennie:

• Hozzon létre Azure-erőforrásokat, és mentse a társított kulcsokat vagy konfigurációkat egy biztonságos helyre.
• Telepítse az Azure SDK-kódtárakat az NPM-ből vagy a Yarnból.
• A helyi szolgáltatásnév hitelesítő adataival hitelesítheti magát az Azure SDK-ban, majd konfigurációs adatok használatával érhet el bizonyos szolgáltatásokat.

Konfigurációs információk védelme

A konfigurációs adatok tárolására többféle lehetőség közül választhat:

• Azure Key Vault a felhőbeli erőforrásokhoz, alkalmazásokhoz és megoldásokhoz hozzáférő és titkosító kulcsok létrehozásához és karbantartásához.
• A Dotenv egy népszerű npm-csomag, amely környezeti változókat olvas be egy .env fájlból. Mindenképpen adja hozzá a .env fájlt a .gitignore fájlhoz, hogy a .env fájl ne legyen beadva a forrásvezérlőbe. További információ az Azure-beli webalkalmazások környezeti változóiról.

Környezeti változók létrehozása az Azure-kódtárakhoz

Az Azure SDK-kódtárak által az Azure-felhő eléréséhez szükséges Azure-beállítások használatához állítsa be a leggyakoribb értékeket környezeti változókra. Az alábbi parancsok a helyi munkaállomás környezeti változóit állítják be.

Az alábbi példákban az ügyfélazonosító a szolgáltatásnév azonosítója és a szolgáltatásnév titkos kódja.

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

Cserélje le az ezekben a parancsokban látható értékeket az adott szolgáltatásnév értékeire.

Fájl létrehozása .env

Egy másik gyakori mechanizmus az, hogy az DOTENV NPM-csomag használatával hoz létre egy .env fájlt ezekhez a beállításokhoz. Ha használni szeretne egy .envfájlt, győződjön meg arról, hogy nem jelentkezik be a fájl a forrásvezérlőbe. Adja hozzá a fájlt a .env Git-fájlhoz .ignore , így biztosítható, hogy ezek a beállítások bekerüljenek a forrásvezérlőbe.

NPM-csomagok telepítése

Minden projekthez javasoljuk, hogy mindig hozzon létre egy külön mappát és annak saját package.json fájlját az alábbi lépések végrehajtásával:

1. Nyisson meg egy terminált, parancssort vagy bash-felületet, és hozzon létre egy új mappát a projekthez. Ezután lépjen az új mappába.

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

2. A csomagfájl inicializálása:

   npm init -y
   

   Ezzel létrehozza a package.json fájlt, és inicializálja a minimális tulajdonságokat.

3. Telepítse a szükséges Azure SDK-kódtárakat, például a következő példát:

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

Forrásvezérlő használata a Visual Studio Code-tal

Javasoljuk, hogy a projekt minden indításakor kezdjen el forrásvezérlő adattárat létrehozni. Ezt a Visual Studio Code-ból teheti meg.

1. A Visual Studio Code-ban válassza a forrásvezérlő ikont a Forrásvezérlő explorer megnyitásához, majd válassza az Inicializálási adattár lehetőséget egy helyi Git-adattár inicializálásához:

   

2. Miután az adattár inicializálva lett, és a forrásvezérlőben tárolandó fájlok vannak, írja be az üzenetet Initial commit , és jelölje be a pipát a forrásfájlok kezdeti véglegesítésének létrehozásához.

   

3. Hozzon létre egy új adattárat a GitHubon vagy az Azure DevOpsban, és másolja az adattár URL-címét a következő néhány lépéshez.

4. A Visual Studio integrált termináljában az alábbi Git-paranccsal adja hozzá a távoli adattárat a helyi adattárhoz. Cserélje le és YOUR-REPOSITORY cserélje le YOUR-ALIAS a saját értékeit.

   git remote add origin https://github.com/YOUR-ALIAS/YOUR-REPOSITORY
   

A Visual Studio Code számos beépített Git-funkciót tartalmaz. További információ: Verziókövetés használata a VS Code-ban.

További lépések

• Szolgáltatásnév létrehozása és használata
• Hitelesítés a Node.js Azure-moduljaival