Konfigurace vývojového prostředí JavaScriptu pro Azure

Když vytváříte cloudové aplikace, vývojáři obvykle dávají přednost testování kódu na místních pracovních stanicích před nasazením kódu do cloudového prostředí, jako je Azure. Místní vývoj poskytuje výhodu širší škály nástrojů spolu se známým prostředím.

Tento článek obsahuje pokyny k nastavení pro vytvoření a ověření místního vývojového prostředí vhodného pro JavaScript pomocí Azure.

Jednorázové vytvoření předplatného

Prostředky Azure se vytvářejí v rámci předplatného a skupiny prostředků.

Typ

Popis

Zkušební předplatné

Vytvořte si bezplatnézkušební předplatné.

Stávající předplatné

Pokud už předplatné máte, přejděte ke stávajícímu předplatnému pomocí:

• Azure Portal
• Azure CLI
• Klientské knihovny Azure pro JavaScript
• Rozšíření editoru Visual Studio Code

Napříč několika předplatnými

Pokud potřebujete spravovat více předplatných, zjistěte, jak vytvořit skupinu pro správu pomocí JavaScriptu.

Jednorázová instalace softwaru

Vývoj pro Azure pomocí JavaScriptu na místní pracovní stanici doporučujeme nainstalovat následující nástroje:

Název/instalační program	Popis
Node.js LTS	Nainstalujte nejnovější prostředí běhu s dlouhodobou podporou (LTS) pro vývoj na místní pracovní stanici. Přečtěte si další informace o výběru verze Node.js pro Azure.
Visual Studio Code	Visual Studio Code poskytuje skvělé prostředí javascriptové integrace a kódování, ale nevyžaduje se. Můžete použít libovolný editor kódu.
Rozšíření editoru Visual Studio Code	Nainstalujte všechna relevantní rozšíření pro služby Azure, které chcete použít.

Běhové prostředí hostování v Azure

Při použití prostředku Azure jako hostitelského prostředí pro vaši aplikaci, jako je webová aplikace Azure nebo Azure Functions, ověřte, jestli místní Node.js verze modulu runtime vývojového prostředí Node.js odpovídá modulu runtime prostředků Azure, který plánujete použít.

Doporučené místní instalace

Doporučují se následující standardní instalace lokálních pracovních stanic, které pomohou s vašimi lokálními vývojovými úkoly.

Název	Popis
Azure CLI	Místní nebo cloudové rozhraní příkazového řádku pro vytváření a používání prostředků Azure
Azure Developer CLI	Nástroj příkazového řádku orientovaný na vývojáře pro vytváření cloudových aplikací v pracovním postupu vývojáře
Rozšíření editoru Visual Studio Code pro Azure	Rozšíření VS Code pro integrované vývojové prostředí (IDE).
Git nebo Git pro Windows	Nástroje příkazového řádku pro správu zdrojového kódu Pokud chcete, můžete použít jiný nástroj pro správu zdrojového kódu.
Docker pro Windows nebo Mac	Používejte vývojové kontejnery pro konzistentní vývojová prostředí.
Node.js LTS	Další informace

Instalace Node.js

Azure podporuje verze LTS Node.js. Přečtěte si další informace o výběru verze Node.js pro Azure.

Jednorázová konfigurace pro ověřování

Pokud chcete použít stejný ověřovací kód v místním vývoji a vzdáleném hostitelském prostředí Azure, použijte defaultAzureCredential. Přečtěte si další informace o této spravované identitě.

Vytvoření skupiny prostředků pro projekt

Azure Portal

1. Otevřete web Azure Portal ve webovém prohlížeči.

2. Na panelu hledání zadejte skupiny prostředků a vyberte je.

3. Vyberte + Vytvořit.

4. Zadejte nastavení skupiny prostředků:

   Vlastnost	Hodnota
   Předplatné	Vyberte své předplatné.
   Skupina prostředků	Zadejte název skupiny prostředků. Tento název skupiny prostředků se používá jako součást identifikátoru URI prostředků při přístupu k Resource Manageru (rovina správy). Název se nepoužívá pro kontrolní činnosti (například vytvoření databáze) nebo datovou rovinu (vložení dat do tabulky).
   Oblast	Vyberte geografickou oblast pro skupinu prostředků.

5. Pokud chcete zahájit ověření, vyberte Zkontrolovat a vytvořit .

6. Po úspěšném ověření vyberte Vytvořit.

Visual Studio Code

1. Otevřete paletu příkazů, Ctrl + Shift + P.

2. Vyhledejte skupinu prostředků a vyberte ji.

3. Pomocí následujících nastavení odpovězte na výzvy:

   Podnět	Hodnota
   Výběr předplatného	Pokud se zobrazí výzva, přihlaste se k Azure. Vyberte existující předplatné nebo vytvořte účet Azure, pokud ho nemáte.
   Zadejte název nové skupiny prostředků.	Zadejte název skupiny prostředků. Tento název skupiny prostředků se používá jako součást identifikátoru URI prostředků při přístupu k Resource Manageru (rovina správy). Název se nepoužívá pro kontrolní činnosti (například vytvoření databáze) nebo datovou rovinu (vložení dat do tabulky).
   Vyberte umístění pro nové prostředky.	Vyberte geografickou oblast pro skupinu prostředků.

Azure CLI

1. Přihlaste se k Azure:

   az login
   

   Dokončete ověřování v prohlížeči.

2. Uveďte názvy a ID předplatného. Zkopírujte hodnotu SubscriptionId a použijte další příkaz.

   az account subscription list --output table 
   

3. Nastavte výchozí předplatné, které používají následující příkazy:

   az account set --subscription YOUR_SUBSCRIPTION_ID
   

4. Vyberte ze seznamu umístění podporovaných pro vaše předplatné. Zkopírujte hodnotu Název regionu blízko vás.

   az account list-locations --output table
   

5. Pomocí následujícího Azure CLI vytvořte skupinu prostředků s názvem nebo ID vašeho předplatného:

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

   Příklad:

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

Práce s Azure a klientskými knihovnami Azure SDK

Klientské knihovny Azure jsou poskytovány jednotlivě pro každou službu. Každou knihovnu nainstalujete na základě služby Azure, kterou potřebujete použít.

Každý nový projekt využívající Azure by měl:

• Vytvořte prostředky Azure.
• Nainstalujte klientské knihovny Azure ze správce balíčků, například NPM.
• Spravovanou identitu použijte k ověření v klientské knihovně Azure a pak použijte konfigurační informace pro přístup ke konkrétním službám.

Zabezpečení informací o konfiguraci

Informace o konfiguraci můžete uložit několika způsoby:

• Azure Key Vault umožňuje vytvářet a udržovat tajemství, klíče a certifikáty, které přistupují ke cloudovým prostředkům, které ještě nenabízejí přístup spravované identity.
• Dotenv je oblíbený balíček npm pro čtení proměnných prostředí ze .env souboru. Nezapomeňte .env soubor přidat do .gitignore souboru, aby soubor .env nebyl zařazen do správy zdrojového kódu.

Vytvořte proměnné prostředí

Pokud chcete použít nastavení Azure potřebná knihovnami sady Azure SDK pro přístup ke cloudu Azure, nastavte nejběžnější hodnoty na proměnné prostředí. Následující příkazy nastavují proměnné prostředí pro místní pracovní stanici.

V následujících příkladech je ID klienta ID služebního principálu a tajný klíč služebního principálu.

udeřit

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

Nahraďte hodnoty v závorkách <> v těchto příkazech hodnotami z vaší konkrétní proměnné prostředí.

Vytvoření .env souboru

Dalším běžným mechanismem je použití DOTENV balíčku NPM k vytvoření .env souboru pro tato nastavení. Pokud plánujete použít .env, ujistěte se, že soubor přidáte do .gitignore, abyste ho nezahrnuli do správy zdrojového kódu. Přidání souboru .env do souboru .ignore Gitu je standardní způsob, jak zajistit, že tato nastavení budou zahrnuta do správy zdrojového kódu.

Instalace balíčků npm

Pro každý projekt doporučujeme vždy vytvořit samostatnou složku a vlastní package.json soubor pomocí následujícího postupu:

1. Otevřete terminál, příkazový řádek nebo prostředí Bash a vytvořte do projektu novou složku. Pak přejděte do této nové složky.

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

2. Inicializace souboru balíčku:

   npm init -y
   

   Tento příkaz vytvoří soubor package.json a inicializuje minimální vlastnosti.

3. Nainstalujte požadované klientské knihovny Azure, například tento příklad klientské knihovny ověřování:

   npm install @azure/identity
   

Použití správy zdrojového kódu v editoru Visual Studio Code

Doporučujeme, abyste se při každém spuštění projektu dostali do zvyku vytvářet úložiště správy zdrojového kódu. Můžete to udělat v editoru Visual Studio Code.

1. V editoru Visual Studio Code vyberte ikonu správy zdrojového kódu pro otevření Průzkumníka pro správu zdrojového kódu, a poté vyberte Inicializovat úložiště pro inicializaci místního úložiště Git:

   

2. Po inicializaci úložiště a pokud máte soubory k uložení ve správě zdrojového kódu, zadejte zprávu Initial commit a klikněte na zaškrtávací políčko pro vytvoření počátečního potvrzení vašich zdrojových souborů.

   

3. Vytvořte nové úložiště na GitHubu a zkopírujte adresu URL úložiště pro další pár kroků.

4. V integrovaném terminálu sady Visual Studio přidejte vzdálené úložiště do místního úložiště pomocí následujícího příkazu Git . Nahraďte <YOUR-ACCOUNT> a <REPOSITORY> nahraďte vlastními hodnotami.

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

Visual Studio Code obsahuje řadu integrovaných funkcí Gitu. Další informace naleznete v tématu Použití správy verzí v nástroji VS Code.

Další kroky

• Vytvoření a použití služebního účtu
• Ověřování pomocí modulů Azure pro Node.js