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.

Típus

Leírás

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 következőkkel érheti el meglévő előfizetését:

• Azure Portal
• Azure CLI
• Azure-ügyfélkódtárak JavaScripthez
• Visual Studio Code-bővítmények

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ő eszközö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. Tudjon meg többet a az AzureNode.js verziójának kiválasztásáról.
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.
Visual Studio Code-bővítmények	Telepítse a használni kívánt Azure-szolgáltatások megfelelő bővítményeit.

Azure hoszting futtatási környezet

Ha azure-erőforrást használ 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ői környezet futtatókörnyezetének verziója 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.

Név	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.
Docker Windowshoz vagy Machez	Fejlesztési tárolók használata konzisztens fejlesztési környezetekhez.
Node.js LTS	További információ

A Node.js telepítése

Az Azure támogatja Node.jsLTS-verzióit. Tudjon meg többet a az AzureNode.js verziójának kiválasztásáról.

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. További információ erről a felügyelt identitásról.

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	Válassza ki előfizetését.
   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).
   Régió	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 kattintson a Létrehozás gombra.

Visual Studio Code

1. Nyissa meg a parancskatalógust, Ctrl + +Shift + +P.

2. Keresse meg a create resource group parancsot, és válassza ki.

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

   Felszólítá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élda:

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

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

Az Azure-ügyfélkó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:

• Azure-erőforrások létrehozása.
• Telepítse az Azure-ügyfélkódtárakat egy csomagkezelőből, például az NPM-ből.
• Felügyelt identitással hitelesíthet az Azure-ügyfélkódtárban, majd konfigurációs adatokkal é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:

• Az Azure Key Vault olyan titkos kulcsokat, kulcsokat és tanúsítványokat hoz létre és tart fenn, amelyek hozzáférnek a felhőbeli erőforrásokhoz, amelyek még nem biztosítanak felügyelt identitás-hozzáférést.
• A Dotenv egy népszerű npm-csomag, amely környezeti változókat olvas be egy .env fájlból. Győződjön meg róla, hogy a .env fájlt hozzáadja a .gitignore fájlhoz, hogy a .env fájl ne kerüljön be a forrásvezérlőbe.

Környezeti változók létrehozása

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.

erősen megüt

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évő zárójelek <> értékeit az adott környezeti változó é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, vegye fel a fájlt a .gitignore fájlba, hogy ne jelentkezzen be a forrásvezérlőbe. A .env fájl hozzáadása a git .ignore fájljához a szokásos módja annak biztosítására, 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
   

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

3. Telepítse a szükséges Azure-ügyfélkódtárakat, például ezt a hitelesítési ügyfélkódtárat:

   npm install @azure/identity
   

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, é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 a <YOUR-ACCOUNT> és <REPOSITORY> értékeket a saját értékeire.

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

Következő lépések

• Szolgáltatási főazonosító létrehozása és használata
• Hitelesítés az Azure-modulokkal, amelyek a Node.js-hez készültek