Konfigurowanie lokalnego środowiska deweloperskiego JavaScript dla platformy Azure

Podczas tworzenia aplikacji w chmurze deweloperzy zazwyczaj wolą testować kod na lokalnych stacjach roboczych przed wdrożeniem tego kodu w środowisku chmury, takim jak platforma Azure. Programowanie lokalne umożliwia korzystanie z szerszej gamy narzędzi wraz ze znanym środowiskiem.

Ten artykuł zawiera instrukcje konfiguracji umożliwiające tworzenie i weryfikowanie lokalnego środowiska deweloperskiego odpowiedniego dla języka JavaScript na platformie Azure.

Jednorazowe tworzenie subskrypcji

Zasoby platformy Azure są tworzone w ramach subskrypcji i grupy zasobów.

Type	Opis
Subskrypcja wersji próbnej	Utwórz subskrypcję bezpłatnejwersji próbnej.
Istniejąca subskrypcja	Jeśli masz już subskrypcję, uzyskaj dostęp do istniejącej subskrypcji w witrynie Azure Portal, interfejsie wiersza polecenia platformy Azure lub zestawach AZURE SDK dla języka JavaScript.
W wielu subskrypcjach	Jeśli musisz zarządzać wieloma subskrypcjami, dowiedz się, jak utworzyć grupę zarządzania przy użyciu języka JavaScript.

Jednorazowa instalacja oprogramowania

Programowanie na platformie Azure przy użyciu języka JavaScript na lokalnej stacji roboczej sugerujemy zainstalowanie następujących elementów:

Nazwa/Instalator	opis
Node.js LTS	Zainstaluj najnowsze środowisko uruchomieniowe obsługi długoterminowej (LTS) na potrzeby tworzenia lokalnych stacji roboczych.
Visual Studio Code	Program Visual Studio Code zapewnia doskonałą integrację i kodowanie w języku JavaScript, ale nie jest to wymagane. Możesz użyć dowolnego edytora kodu.

Środowisko uruchomieniowe hostingu platformy Azure

Jeśli planujesz użyć zasobu platformy Azure jako środowiska hostingu dla aplikacji, takiej jak aplikacja internetowa platformy Azure lub usługa Azure Functions, sprawdź lokalną wersję środowiska uruchomieniowego środowiska deweloperskiego Node.js node.js zgodną ze środowiskiem uruchomieniowym zasobów platformy Azure, którego planujesz użyć.

Zalecane instalacje lokalne

Następujące typowe lokalne instalacje stacji roboczych są zalecane, aby ułatwić lokalne zadania programistyczne.

Nazwa/nazwisko	opis
Interfejs wiersza polecenia platformy Azure	Lokalny lub oparty na chmurze interfejs wiersza polecenia do tworzenia zasobów platformy Azure i korzystania z nich.
Interfejs wiersza polecenia dla deweloperów platformy Azure	Skoncentrowane na deweloperach narzędzie wiersza polecenia do tworzenia aplikacji w chmurze w przepływie pracy deweloperów.
Rozszerzenia programu Visual Studio Code dla platformy Azure	Rozszerzenia programu VS Code w środowisku IDE.
Git lub Git dla systemu Windows	Narzędzia wiersza polecenia do kontroli źródła. Jeśli wolisz, możesz użyć innego narzędzia kontroli źródła.

Jednorazowa konfiguracja uwierzytelniania

Aby użyć tego samego kodu uwierzytelniania w środowisku programowania lokalnego i zdalnego hostingu platformy Azure, użyj wartości DefaultAzureCredential.

Tworzenie grupy zasobów dla projektu

Witryna Azure Portal

1. Otwórz witrynę Azure Portal w przeglądarce internetowej.

2. Na pasku wyszukiwania wprowadź grupy zasobów i wybierz je.

3. Wybierz + Utwórz.

4. Wprowadź ustawienia grupy zasobów:

   Właściwości	Wartość
   Subskrypcja	Wybierz subskrypcję.
   Grupa zasobów	Wprowadź nazwę grupy zasobów. Ta nazwa grupy zasobów jest używana jako część identyfikatora URI zasobów podczas uzyskiwania dostępu do usługi Resource Manager (płaszczyzny zarządzania). Nazwa nie jest używana do kontrolowania (na przykład tworzenia bazy danych) ani płaszczyzny danych (wstawiania danych do tabeli).
   Region (Region)	Wybierz region geograficzny dla grupy zasobów.

5. Wybierz pozycję Przejrzyj i utwórz , aby rozpocząć walidację.

6. Gdy walidacja zakończy się powodzeniem, wybierz pozycję Utwórz.

Visual Studio Code

1. Otwórz paletę poleceń, Ctrl + Shift + P.

2. Wyszukaj pozycję Utwórz grupę zasobów i wybierz ją.

3. Odpowiedz na monity, korzystając z następujących ustawień:

   Monit	Wartość
   Wybieranie subskrypcji	Zaloguj się do platformy Azure, jeśli zostanie wyświetlony monit. Wybierz istniejącą subskrypcję lub utwórz konto platformy Azure, jeśli go nie masz.
   Wprowadź nazwę nowej grupy zasobów.	Wprowadź nazwę grupy zasobów. Ta nazwa grupy zasobów jest używana jako część identyfikatora URI zasobów podczas uzyskiwania dostępu do usługi Resource Manager (płaszczyzny zarządzania). Nazwa nie jest używana do kontrolowania (na przykład tworzenia bazy danych) ani płaszczyzny danych (wstawiania danych do tabeli).
   Wybierz lokalizację nowych zasobów.	Wybierz region geograficzny dla grupy zasobów.

Interfejs wiersza polecenia platformy Azure

1. Zaloguj się do platformy Azure:

   az login
   

   Ukończ uwierzytelnianie w przeglądarce.

2. Wyświetl listę nazw subskrypcji i identyfikatorów. Skopiuj wartość SubscriptionId, aby użyć następnego polecenia.

   az account subscription list --output table 
   

3. Ustaw domyślną subskrypcję używaną przez kolejne polecenia:

   az account set --subscription YOUR_SUBSCRIPTION_ID
   

4. Wybierz z listy lokalizacji obsługiwanych dla subskrypcji. Skopiuj wartość Nazwa regionu blisko Ciebie.

   az account list-locations --output table
   

5. Użyj następującego interfejsu wiersza polecenia platformy Azure, aby utworzyć grupę zasobów o nazwie subskrypcji lub identyfikatorze:

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

   Na przykład:

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

Praca z platformą Azure i bibliotekami klienta zestawu Azure SDK

Biblioteki zestawu Azure SDK są udostępniane indywidualnie dla każdej usługi. Każda biblioteka jest instalowana na podstawie usługi platformy Azure, której potrzebujesz.

Każdy nowy projekt korzystający z platformy Azure powinien:

• Utwórz zasoby platformy Azure i zapisz skojarzone klucze lub konfigurację w bezpiecznej lokalizacji.
• Zainstaluj biblioteki zestawu Azure SDK z poziomu programu NPM lub Yarn.
• Użyj lokalnego poświadczenia jednostki usługi, aby uwierzytelnić się w zestawie Azure SDK, a następnie użyj informacji o konfiguracji, aby uzyskać dostęp do określonych usług.

Zabezpieczanie informacji o konfiguracji

Istnieje kilka opcji przechowywania informacji o konfiguracji:

• Usługa Azure Key Vault umożliwia tworzenie i konserwację kluczy, które uzyskują dostęp do zasobów, aplikacji i rozwiązań w chmurze oraz szyfrują je.
• Dotenv to popularny pakiet npm do odczytywania zmiennych środowiskowych z .env pliku. Pamiętaj, aby dodać .env plik do .gitignore pliku, aby .env plik nie był zaewidencjonowany do kontroli źródła. Dowiedz się więcej o zmiennych środowiskowych w aplikacjach internetowych dla platformy Azure.

Tworzenie zmiennych środowiskowych dla bibliotek platformy Azure

Aby użyć ustawień platformy Azure wymaganych przez biblioteki zestawu Azure SDK w celu uzyskania dostępu do chmury platformy Azure, ustaw najbardziej typowe wartości na zmienne środowiskowe. Następujące polecenia ustawiają zmienne środowiskowe dla lokalnej stacji roboczej.

W poniższych przykładach identyfikator klienta to identyfikator jednostki usługi i klucz tajny jednostki usługi.

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

Zastąp wartości wyświetlane w tych poleceniach wartościami określonej jednostki usługi.

Tworzenie .env pliku

Innym typowym mechanizmem jest użycie DOTENV pakietu NPM do utworzenia .env pliku dla tych ustawień. Jeśli planujesz użyć elementu .env, pamiętaj, aby nie zaewidencjonować pliku w celu kontroli źródła. .env Dodanie pliku do pliku git .ignore jest standardowym sposobem sprawdzenia tych ustawień w kontroli źródła.

Instalowanie pakietów npm

W przypadku każdego projektu zalecamy, aby zawsze utworzyć oddzielny folder i własny package.json plik, wykonując następujące czynności:

1. Otwórz terminal, wiersz polecenia lub powłokę bash i utwórz nowy folder w projekcie. Następnie przejdź do tego nowego folderu.

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

2. Zainicjuj plik pakietu:

   npm init -y
   

   Spowoduje to utworzenie pliku package.json i zainicjowanie minimalnych właściwości.

3. Zainstaluj potrzebne biblioteki zestawu Azure SDK, takie jak w tym przykładzie:

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

Używanie kontroli źródła z programem Visual Studio Code

Zalecamy zapoznanie się z nawykiem tworzenia repozytorium kontroli źródła przy każdym uruchomieniu projektu. Można to zrobić w programie Visual Studio Code.

1. W programie Visual Studio Code wybierz ikonę kontroli źródła, aby otworzyć Eksploratora kontroli źródła, a następnie wybierz pozycję Zainicjuj repozytorium, aby zainicjować lokalne repozytorium Git:

   

2. Po zainicjowaniu repozytorium i przechowywaniu plików w kontroli źródła wprowadź komunikat Initial commit i wybierz znacznik wyboru, aby utworzyć początkowe zatwierdzenie plików źródłowych.

   

3. Utwórz nowe repozytorium w witrynie GitHub lub usłudze Azure DevOps i skopiuj adres URL repozytorium w następnym kroku.

4. W zintegrowanym terminalu programu Visual Studio użyj następującego polecenia git , aby dodać repozytorium zdalne do repozytorium lokalnego. Zastąp YOUR-ALIAS wartości i YOUR-REPOSITORY własnymi wartościami.

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

Program Visual Studio Code zawiera wiele wbudowanych funkcji git. Aby uzyskać więcej informacji, zobacz Using Version Control in VS Code (Używanie kontroli wersji w programie VS Code).

Następne kroki

• Tworzenie i używanie jednostki usługi
• Uwierzytelnianie za pomocą modułów platformy Azure dla środowiska Node.js