Создание задач для настройки команды Dev Box
При создании задач для настроек команды Microsoft Dev Box можно определить конкретные действия для полей разработки, чтобы обеспечить согласованную и эффективную среду разработки. Создание новых задач в каталоге позволяет определять повторно используемые компоненты, адаптированные для команд разработки, и добавлять охранники вокруг возможных конфигураций. В этой статье описывается создание каталога для задач настройки, добавление задач и присоединение каталога к центру разработки или проекту.
Внимание
Функция настройки команды Dev Box в настоящее время находится в предварительной версии. Дополнительные сведения о состоянии предварительной версии см . в дополнительных условиях использования для предварительных версий Microsoft Azure. В документе определены юридические термины, которые применяются к функциям Azure, которые находятся в бета-версии, предварительной версии или в противном случае еще не выпущены в общую доступность.
Необходимые компоненты
Чтобы выполнить действия, описанные в этой статье, необходимо иметь следующее:
- Центр разработки, настроенный с помощью проекта dev box.
- Существующий каталог в GitHub или Azure Repos.
Разрешения, необходимые для настройки настроек
Чтобы выполнить необходимые действия для создания и применения настроек в поле разработки, вам потребуются следующие разрешения:
Действие | Разрешение или роль |
---|---|
Включите каталоги уровня проекта для центра разработки. | Инженер платформы с доступом на запись в подписке. |
Включите параметры синхронизации каталога для проекта. | Инженер платформы с доступом на запись в подписке. |
Присоединение каталога к проекту. | Разрешения администратора проекта или участника проекта. |
Создайте файл настройки. | Ни один из указанных. Любой пользователь может создать файл настройки. |
Используйте портал разработчика для отправки и применения YAML-файла во время создания поля разработки. | Пользователь Dev Box. |
Добавление задач в каталог. | Разрешение на добавление в репозиторий, на котором размещен каталог. |
Что такое задачи?
Задача выполняет определенное действие, например установку программного обеспечения. Каждая задача состоит из одного или нескольких скриптов PowerShell, а также файла task.yaml, который предоставляет параметры и определяет, как выполняются скрипты. Вы также можете включить команду PowerShell в файл task.yaml.
Вы можете хранить коллекцию курируемых задач в каталоге, подключенном к центру разработки, с каждой задачей в отдельной папке. Dev Box поддерживает использование репозитория GitHub или репозитория Azure Repos в качестве каталога. Dev Box сканирует указанную папку каталога рекурсивно, чтобы найти определения задач.
WinGet и PowerShell доступны в любом центре разработки без необходимости в каталоге. Если настройки используют только WinGet или PowerShell, можно создать задачи, которые используют их в файле настройки. Если вам нужно использовать другие средства или сценарии, можно создавать задачи в каталоге.
Корпорация Майкрософт предоставляет каталог краткого руководства, который поможет вам приступить к настройке. Он включает набор задач по умолчанию, определяющих общие действия:
- Установите программное обеспечение с помощью диспетчера пакетов WinGet.
- Развертывание требуемой конфигурации состояния (DSC) с помощью конфигурации WinGet.
- Клонирование репозитория с помощью
git-clone
. - Настройте такие приложения, как установка расширений Visual Studio.
- Запустите скрипты PowerShell.
Создание задач в каталоге
Задачи, такие как установка программного обеспечения или выполнение скриптов, организованы в каталог. Вы создаете задачи в каталоге и управляете ими, определяете новые задачи и присоединяете каталог к центру разработки. С помощью каталога краткого руководства Майкрософт вы можете приступить к работе с общими задачами, такими как установка программного обеспечения, развертывание DSC, клонирование репозиториев и настройка приложений.
Определение новых задач
Чтобы создать задачи для настройки команды Dev Box и управлять ими, выполните следующие действия.
Создайте репозиторий для хранения задач. При необходимости можно сделать копию каталога быстрого запуска в собственном репозитории для использования в качестве отправной точки.
Создайте задачи в репозитории, изменив существующие скрипты PowerShell или создав новые скрипты. Чтобы приступить к созданию задач, можно использовать примеры в репозитории GitHub для примеров центра разработки и документации По PowerShell.
Подключите репозиторий к центру разработки в качестве каталога.
Создайте файл конфигурации для этих задач, выполнив действия, описанные в разделе "Запись файла настройки".
Использование секретов из хранилища ключей Azure
Секреты из хранилища ключей Azure можно использовать в конфигурациях YAML для клонирования частных репозиториев или с помощью любой настраиваемой задачи, которую вы создаете, для этого требуется маркер доступа.
Центр разработки должен получить доступ к хранилищу ключей. DevCenter не поддерживает теги служб, поэтому если хранилище ключей хранится в закрытом режиме, необходимо разрешить доверенным службы Майкрософт обходить брандмауэр.
Чтобы настроить секреты хранилища ключей для использования в конфигурациях YAML, выполните следующие действия.
Убедитесь, что у управляемого удостоверения центра разработки есть роль читателя Key Vault и роль пользователя секретов Key Vault в хранилище ключей.
Предоставьте роль "Пользователь секретов Key Vault" для секрета хранилища ключей каждому пользователю или группе пользователей, которые должны иметь возможность использовать секрет во время настройки поля разработки. Пользователь или группа, которым предоставлена роль, должна включать управляемое удостоверение для центра разработки, собственную учетную запись пользователя и любую пользовательскую или группу, которая нуждается в секрете во время настройки поля разработки.
Дополнительные сведения об использовании секретов хранилища ключей в файле настройки см. в разделе Клонирование частного репозитория с помощью файла настройки.
Присоединение каталога
Вы можете присоединить каталог к проекту, чтобы сделать задачи доступными для команды разработчиков. Чтобы присоединить каталог к проекту, выполните действия, описанные в статье "Добавление и настройка каталога из GitHub или Azure Repos".