Sdílet prostřednictvím

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

  • Článek

Při vytváření cloudových aplikací 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í:

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ázev/instalační program Popis
Node.js LTS Nainstalujte nejnovější dlouhodobé prostředí runtime (LTS) pro vývoj místních pracovních stanic.
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.

Modul runtime hostování 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čuje se vám následující běžné instalace místních pracovních stanic, které vám pomůžou s místními úlohami vývoje.

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

Sada Azure SDK podporuje verzi Node.js dlouhodobé podpory (LTS). Další podrobnosti najdete v zásadách podpory sady Azure SDK.

Minimální verze služeb Azure Node.js

Pokud chcete hostovat javascriptové aplikace v hostitelském prostředí Azure, ujistěte se, že místní vývojové prostředí Node.js runtime napodobuje hostující modul runtime Azure, který chcete použít.

  • Azure App Service používá modul runtime Node.js. Pokud chcete zobrazit všechny podporované verze Node.js, spusťte v Cloud Shellu následující příkaz:

    az webapp list-runtimes | grep node

  • Doby spuštění webové aplikace Azure Static jsou relevantní jenom pro rozhraní API funkcí.

  • Podporované Node.js verze Azure Functions jsou založené na tom, jakou verzi funkcí používáte.

  • Vlastní doby spuštění – vlastní modul runtime se podporuje následujícími způsoby:

Správa více verzí Node.js

Pokud potřebujete spravovat více než jednu verzi Node.js v místním a vzdáleném prostředí, doporučujeme:

  • Vývojové kontejnery: Použijte kontejner s konkrétní verzí Node.js. Pomocí kontejnerů můžete spravovat verzi Node.js napříč několika prostředími. Rozšíření Remote – Containers editoru Visual Studio Code tento proces zjednodušuje.
  • NVM (Node Version Manager):: Rozhraní příkazového řádku pro nastavení nebo přepnutí místní verze Node.js.

Stažení a instalace Node.js na základě zamýšleného použití

Na základě vašich požadavků si můžete stáhnout a nainstalovat Node.js.

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

  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 řízení (například vytvoření databáze) nebo rovinu dat (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.

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ů, jako je 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 tajné kódy, klíče a certifikáty, které přistupuje ke cloudovým prostředkům, které ještě nenabízí přístup ke spravované identitě.
  • Dotenv je oblíbený balíček npm pro čtení proměnných prostředí ze .env souboru. Nezapomeňte do .gitignore souboru přidat .env soubor, aby .env se soubor nezaškrtl do správy zdrojového kódu.

Vytvoření proměnných 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 instančního objektu a tajný klíč instančního objektu.

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

Nahraďte hodnoty uvedené v těchto příkazech hodnotami 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 .envsoubor , nezapomeňte soubor přidat do .gitignore složky, abyste soubor nezaškrtli do správy zdrojového kódu. .env Přidání souboru do souboru Gitu .ignore je standardní způsob, jak zajistit, aby tato nastavení byla vrácena 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

    Tím se vytvoří soubor package.json a inicializuje minimální vlastnosti.

  3. Nainstalujte knihovny Azure CL, které potřebujete, například v tomto příkladu:

    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 výběrem ikony správy zdrojového kódu otevřete Průzkumníka správy zdrojového kódu a pak výběrem možnosti Inicializovat úložiště pro inicializaci místního úložiště Git:

    Inicializace úložiště Git

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

    Dokončení počátečního potvrzení do úložiště

  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-ALIAS a YOUR-REPOSITORY nahraďte vlastními hodnotami.

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