Настройка среды разработки JavaScript для Azure

При создании облачных приложений разработчики обычно предпочитают тестировать код на локальных рабочих станциях перед развертыванием этого кода в облачной среде, такой как Azure. Локальная разработка позволяет применять более широкий ряд инструментов и знакомую среду.

В этой статье приведены инструкции по настройке для создания и проверки локальной среды разработки, которая подходит для использования JavaScript в Azure.

Разовый процесс создания подписки

Ресурсы Azure создаются в подписке и группе ресурсов.

Тип

Описание

Пробная подписка

Создайте бесплатнуюпробную подписку.

Существующая подписка

Если у вас уже есть подписка, обратитесь к существующей подписке с помощью:

• Портал Azure
• Azure CLI
• Клиентские библиотеки Azure для JavaScript
• Расширения Visual Studio Code

Несколько подписок

Если вам нужно управлять несколькими подписками, узнайте, как создать группу управления с помощью JavaScript.

Одноразовая установка программного обеспечения

Разработка Azure с использованием JavaScript на локальной рабочей станции, мы рекомендуем установить следующие инструменты:

Имя или установщик	Описание
Node.js LTS	Установите последнюю версию среды выполнения с долгосрочной поддержкой (LTS) для разработки на локальной рабочей станции. Узнайте больше о выборе версии Node.js для Azure.
Visual Studio Code	Visual Studio Code предоставляет отличный интерфейс интеграции и программирования JavaScript, но это не обязательно. Вы можете использовать любой удобный редактор кода.
Расширения Visual Studio Code	Установите все соответствующие расширения для служб Azure, которые вы планируете использовать.

Среда размещения Azure

При использовании ресурса Azure в качестве среды размещения приложения, например веб-приложения Azure или Функции Azure, убедитесь, что Node.js локальная версия среды выполнения среды разработки Node.js соответствует используемой среде выполнения ресурсов Azure.

Рекомендуемые локальные установки

Следующие популярные установки локальной рабочей станции рекомендуется использовать для выполнения задач локальной разработки.

Имя	Описание
Azure CLI	Локальный или облачный интерфейс командной строки для создания и использования ресурсов Azure.
Интерфейс командной строки разработчика Azure	Средство командной строки, ориентированное на разработчика, для создания облачных приложений в рабочем процессе разработчика.
Расширения Visual Studio Code для Azure	Расширения VS Code для интегрированной среды разработки.
Git или Git for Windows	Средства командной строки для управления исходным кодом. При желании можно использовать другой инструмент контроля версий.
Docker для Windows или Mac	Используйте контейнеры разработки для согласованных сред разработки.
Node.js LTS	Подробнее

Установка Node.js

Azure поддерживает версии LTS Node.js. Узнайте больше о выборе версии Node.js для Azure.

Единоразовая настройка для проверки подлинности

Чтобы применять один и тот же код проверки подлинности в локальной среде разработки и в удаленной среде размещения Azure, используйте метод DefaultAzureCredential. Дополнительные сведения об этом управляемом удостоверении.

Создание группы ресурсов для проекта

Портал Azure

1. Откройте портал Azure в веб-браузере.

2. В строке поиска введите группы ресурсов и выберите его.

3. Выберите + Создать.

4. Введите параметры группы ресурсов:

   Свойство	Значение
   Подписка	Выберите свою подписку.
   Группа ресурсов	Введите имя группы ресурсов. Это имя группы ресурсов используется в составе URI ресурсов при доступе к Resource Manager (плоскости управления). Имя не используется для управления (например, создания базы данных) или плоскости данных (например, вставки данных в таблицу).
   Область/регион	Выберите географический регион для группы ресурсов.

5. Нажмите кнопку "Проверка и создание ", чтобы начать проверку.

6. При успешном выполнении проверки нажмите кнопку "Создать".

Visual Studio Code

1. Откройте палитру команд, Ctrl + Shift + P.

2. Найдите создать группу ресурсов и выберите ее.

3. Ответьте на запросы с помощью следующих параметров:

   Подсказка	Значение
   Выбор подписки	При появлении запроса войдите в Azure. Выберите существующую подписку или создайте учетную запись Azure, если у вас ее нет.
   Введите имя новой группы ресурсов.	Введите имя группы ресурсов. Это имя группы ресурсов используется в составе URI ресурсов при доступе к Resource Manager (плоскости управления). Имя не используется для управления (например, создания базы данных) или плоскости данных (например, вставки данных в таблицу).
   Выберите расположение для новых ресурсов.	Выберите географический регион для группы ресурсов.

Azure CLI

1. Войдите в Azure:

   az login
   

   Выполните проверку подлинности в браузере.

2. Перечислите имена и идентификаторы ваших подписок. Скопируйте значение SubscriptionId, чтобы использовать следующую команду.

   az account subscription list --output table 
   

3. Задайте подписку по умолчанию, используемую последующими командами:

   az account set --subscription YOUR_SUBSCRIPTION_ID
   

4. Выберите из списка расположений, поддерживаемых для вашей подписки. Скопируйте значение имени региона, близкого к вам.

   az account list-locations --output table
   

5. Чтобы создать группу ресурсов с именем или идентификатором подписки, используйте следующую команду Azure CLI:

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

   Например:

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

Работа с Azure и клиентскими библиотеками Azure SDK

Клиентские библиотеки Azure предоставляются отдельно для каждой службы. Каждая библиотека устанавливается в зависимости от службы Azure, которую необходимо использовать.

Для каждого нового проекта, использующего Azure, необходимо сделать следующее:

• Создайте ресурсы Azure.
• Установите клиентские библиотеки Azure из диспетчера пакетов, например NPM.
• Используйте управляемое удостоверение для проверки подлинности в клиентской библиотеке Azure, а затем используйте сведения о конфигурации для доступа к определенным службам.

Защита сведений о конфигурации

Существует несколько способов хранения сведений о конфигурации:

• Azure Key Vault для создания и обслуживания секретов, ключей и сертификатов, которые связаны с облачными ресурсами, для которых пока не предусмотрены управляемые удостоверения.
• Dotenv — популярный пакет npm для считывания переменных среды из файла .env. Не забудьте добавить .env файл к .gitignore файлу, чтобы .env файл не был отправлен в систему контроля версий.

Создание переменной среды

Чтобы использовать параметры Azure, которые требуются библиотекам Azure SDK для доступа к облаку Azure, задайте для переменных среды обычные значения. Следующие команды задают переменные среды на локальной рабочей станции.

В следующих примерах идентификатор клиента также выступает в роли идентификатора участника службы и его секрета.

бить

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

Замените значения в <> квадратных скобках в этих командах определенными переменными среды.

Создание файла .env

Еще один распространенный механизм — использовать пакет NPM DOTENV для создания файла .env для этих параметров. Если вы планируете использовать .env, обязательно добавьте файл в .gitignore, чтобы не добавлять его в систему управления версиями. Стандартный способ гарантировать, что эти настройки добавляются в систему контроля версий, — это добавить файл .env в файл .ignore Git.

Установка пакетов npm

Для каждого проекта рекомендуется всегда создавать отдельную папку и собственный файл package.json, выполняя указанные ниже действия:

1. Откройте терминал, командную строку или оболочку Bash и создайте папку для проекта. Затем перейдите в эту папку.

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

2. Инициализируйте файл пакета:

   npm init -y
   

   Эта команда создает файл package.json и инициализирует минимальные свойства.

3. Установите необходимые клиентские библиотеки Azure, например этот пример клиентской библиотеки проверки подлинности:

   npm install @azure/identity
   

Использование системы управления версиями с помощью Visual Studio Code

Мы рекомендуем приучить себя к созданию репозитория системы управления версиями каждый раз, когда вы начинаете проект. Это можно сделать из Visual Studio Code.

1. В Visual Studio Code выберите значок системы управления версиями, чтобы открыть обозреватель системы управления версиями. Затем щелкните элемент Инициализировать репозиторий, чтобы инициализировать локальный репозиторий Git:

   

2. После инициализации репозитория и при наличии файлов для хранения в системе управления версиями, введите сообщение Initial commit и нажмите на галочку, чтобы создать первый коммит ваших исходных файлов.

   

3. Создайте репозиторий на сайте GitHub и скопируйте URL-адрес репозитория на следующий шаг.

4. В интегрированном терминале Visual Studio выполните следующую команду git, чтобы добавить удаленный репозиторий в локальный. Замените <YOUR-ACCOUNT> и <REPOSITORY> собственными значениями.

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

Visual Studio Code включает множество встроенных функций Git. Дополнительные сведения в см. в статье Использование системы управления версиями в VS Code.

Следующие шаги

• Создание и использование сущности-службы
• Проверка подлинности с помощью модулей Azure для Node.js