Konfigurace místního prostředí pro vývoj v JavaScriptu pro Azure

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 tohoto kódu do cloudového prostředí, jako je Azure. Místní vývoj vám dává výhodu široké škály nástrojů spolu se známým prostředím.

Tento článek poskytuje pokyny k instalaci pro vytvoření a ověření místního vývojového prostředí, které je vhodné pro JavaScript s Azure.

Vytvoření jednorázového předplatného

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

Jednorázová instalace softwaru

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

Hostující modul runtime Azure

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

Doporučené místní instalace

Následující běžné instalace místní pracovní stanice doporučujeme, aby vám pomohly s místními úlohami vývoje.

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

Pokud chcete použít stejný ověřovací kód v místním prostředí pro vývoj a vzdálené hostování Azure, použijte DefaultAzureCredential.

Chcete-li použít stejný kód ve všech prostředích:

• Pro místní vývojvytvořte instanční objekt pro vytváření a správu prostředků Azure bez použití osobního účtu.
• Pro hostování Azurese dozvíte víc.

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

Knihovny Azure SDK jsou k dispozici 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 používající Azure by měl:

• Vytvořte prostředky Azure a uložte přidružené klíče nebo konfiguraci do zabezpečeného umístění.
• Nainstalujte knihovny Azure SDK z NPM nebo příze.
• Použijte místní přihlašovací údaje instančního objektu k ověření v sadě Azure SDK a pak použijte konfigurační informace pro přístup ke konkrétním službám.

Zabezpečení informací o konfiguraci

K dispozici je několik možností, jak uložit informace o konfiguraci:

• Azure Key Vault k vytváření a údržbě klíčů, které přistupují k prostředkům cloudu, aplikacím a řešením a jejich šifrování.
• Dotenv je oblíbený balíček npm pro čtení proměnných prostředí ze souboru. Nezapomeňte soubor přidat .env do .gitignore souboru, takže soubor není vrácen do .env správy zdrojového kódu. Přečtěte si další informace o proměnných prostředí ve službě Web Apps for Azure.

Vytvoření proměnných prostředí pro knihovny Azure

Pokud chcete pro přístup ke cloudu Azure použít nastavení Azure, které jsou potřebné pro knihovny Azure SDK, nastavte nejběžnější hodnoty na proměnné prostředí. Následující příkazy nastaví 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íč hlavní části služby.

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

Hodnoty uvedené v těchto příkazech nahraďte konkrétní instančním objektem.

Vytvořit .env soubor

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 nechcete .env do správy zdrojového kódu. Přidání .env souboru do .ignore souboru Git je standardní způsob, jak zajistit, aby se tato nastavení kontrolovala 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 její vlastní package.json soubor pomocí následujících kroků:

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

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

2. Inicializovat soubor balíčku:

   npm init -y
   

   Tím se vytvoří soubor Package. JSON a inicializuje se minimální vlastnosti.

3. Nainstalujte knihovny Azure SDK, které potřebujete, třeba tento příklad:

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

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

Doporučujeme, abyste se přihlásili do nedostatku k vytváření úložiště správy zdrojového kódu při každém spuštění projektu. Můžete to provést z Visual Studio Code.

1. v Visual Studio Code vyberte ikonu správy zdrojového kódu a otevřete průzkumníka správy zdrojového kódu a pak vyberte inicializovat úložiště pro inicializaci místního úložiště Git:

   

2. Po inicializaci úložiště a když máte soubory, které chcete uložit do správy zdrojového kódu, zadejte zprávu Initial commit a zaškrtnutím políčka vytvořte počáteční potvrzení zdrojových souborů.

   

3. vytvořte nové úložiště v GitHub nebo Azure DevOps a zkopírujte adresu URL úložiště pro další krok.

4. v Visual Studio integrovaném terminálu 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 vlastními hodnotami.

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

Visual Studio Code obsahuje mnoho vestavěných funkcí git. Další informace naleznete v tématu použití správy verzí v vs Code.

Další kroky

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