Среды в наборе средств Microsoft Teams

Статья
05/18/2023

Набор средств Teams предоставляет способ запуска и тестирования приложения в различных целевых объектах для развертывания, например для разработки, промежуточного, рабочего или локального развертывания на компьютере. Для этого Набор средств Teams включает необязательный набор функций, которые оркеструют конфигурацию этих различных целевых объектов с помощью информации в файлах среды. Файлы среды представляют коллекцию всех ресурсов целевого объекта развертывания. Шаблоны проектов Набора средств Teams включают две группы сред по умолчанию: одну для запуска приложения на компьютере с именем local, а другую — для размещения в другом месте с именем dev. Вы можете переименовать среду dev и добавить другую среду с помощью окна Среды или вручную с новым .env.{environment-name} файлом. Вы не можете переименовать локальную среду.

Добавляя различные файлы среды, Teams Toolkit помогает автоматизировать подготовку ресурсов, необходимых для запуска приложения и развертывания кода в этих ресурсах. Вы можете использовать один набор правил развертывания для количества сред, использующих эти функции.

Использование файлов среды с набором средств Teams

Teams Toolkit использует соглашение об именовании для файлов среды, таких как : .env.{environment-name}. Используя команды жизненного цикла набора средств (подготовка, развертывание или публикация), необходимо указать имя среды. Имя среды должно совпадать со значением, выбранным при {environment-name} создании файла среды.

Примечание.

В текущей среде оболочки можно определить переменные среды для Набора средств Teams, которые переопределяют любые значения в .env файле во время конфликта именования.

Расположение файла среды

По умолчанию набор средств Teams не загружает переменные env и просто продолжает выполнять действия и записывать выходные данные в ./env/.env.dev. Если environmentFolderPath параметр не определен, teams Toolkit не загружает переменные среды из .env файла и выполняет действия, предполагая, что env является разработчиком. Выходные данные записываются в ./env/.env.dev.

Локальные среды

Для создания приложения Microsoft Teams определенные ресурсы, такие как регистрация приложений и клиент Teams, размещаются в облаке. Однако другие ресурсы, такие как логика приложения, могут размещаться локально, чтобы упростить тестирование изменений во время разработки приложения. Все шаблоны и примеры проектов набора средств Teams настраиваются с local помощью среды. Локальная среда содержит ./env/.env.local файлы и ./env/.env.local.user помогает запускать приложение на локальном веб-сервере. При использовании Visual Studio Code (VS Code) и Visual Studio (VS) шаблоны проектов и примеры настраиваются для поддержки отладки с точками останова.

Чтобы отличить локальную среду от всех остальных сред, можно создать отдельный файл проекта с именем teamsapp.local.yml в том же каталоге, что teamsapp.ymlи .

Создание среды вручную в Visual Studio Code

Каждый проект может иметь одну локальную среду, но несколько удаленных сред. После создания проекта Набор средств Teams настраивает следующие среды по умолчанию:

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

Чтобы создать новую среду, выполните следующие действия: