Поделиться через


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

В этом кратком руководстве описано, как создать поле разработки с помощью настроек команды Microsoft Dev Box. Эта функция использует файл определения изображения, чтобы вы могли создавать согласованные настраиваемые поля разработки для вашей команды разработки и предоставлять адаптированную среду для проектов.

Внимание

Функция настройки команды Dev Box в настоящее время находится в предварительной версии. Дополнительные сведения о состоянии предварительной версии см . в дополнительных условиях использования для предварительных версий Microsoft Azure. В документе определены юридические термины, которые применяются к функциям Azure, которые находятся в бета-версии, предварительной версии или в противном случае еще не выпущены в общую доступность.

Необходимые компоненты

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

Разрешения, необходимые для настройки настроек

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

Действие Разрешение или роль
Включите каталоги уровня проекта для центра разработки. Инженер платформы с доступом на запись в подписке.
Включите параметры синхронизации каталога для проекта. Инженер платформы с доступом на запись в подписке.
Присоединение каталога к проекту. Разрешения администратора проекта или участника проекта.
Создайте файл настройки. Ни один из указанных. Любой пользователь может создать файл настройки.
Используйте портал разработчика для отправки и применения YAML-файла во время создания поля разработки. Пользователь Dev Box.
Добавление задач в каталог. Разрешение на добавление в репозиторий, на котором размещен каталог.

Создание определения образа

  1. Скачайте пример файла настройки YAML.
  2. Откройте файл и изучите задачи.

Файл определения изображения указывает имя определения изображения с помощью name поля. Используйте это имя для идентификации определения образа в пуле полей разработки.

Включение каталогов на уровне проекта

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

  1. В портал Azure перейдите в центр разработки.

  2. В меню службы в разделе "Параметры" выберите "Конфигурация".

    Снимок экрана: страница обзора центра разработки с выделенной конфигурацией.

  3. На панели каталогов уровня проекта выберите "Включить каталоги для каждого проекта" и нажмите кнопку "Применить".

    Снимок экрана: панель каталогов на уровне проекта с флажком включения каталогов для каждого проекта.

Добавление каталога в проект

В следующих разделах описаны следующие задачи:

  1. Вилку примера репозитория каталога в организацию GitHub.
  2. Установите и настройте приложение Microsoft Центр разработки.
  3. Назначьте разрешения в GitHub для репозиториев.
  4. Добавьте репозиторий в качестве каталога.

Вилка примера репозитория каталога

  1. Откройте пример репозитория каталога.
  2. Выберите вилку , чтобы вставить репозиторий в организацию GitHub.

Установка приложения Microsoft Центр разработки

  1. Войдите на портал Azure.

  2. Перейдите в центр разработки или проект.

  3. В меню службы в разделе "Конфигурация среды" выберите каталоги и нажмите кнопку "Добавить".

  4. В области "Добавить каталог" введите или выберите следующие значения:

    Поле Значение
    Имя Введите имя каталога.
    Источник каталога Выберите GitHub.
    Тип проверки подлинности Выберите приложение GitHub.
  5. Выберите ссылку настройки репозиториев .

    Снимок экрана: портал Azure, в котором показаны выбранные варианты добавления каталога со ссылкой на настройку репозиториев.

  6. Если вам будет предложено пройти проверку подлинности в GitHub, выполните проверку подлинности.

  7. На странице Microsoft DevCenter выберите "Настроить".

    Снимок экрана: страница приложения Microsoft Центр разработки с выделенной кнопкой

  8. Выберите организацию GitHub, содержащую репозиторий, который нужно добавить в качестве каталога. Чтобы установить это приложение, необходимо быть владельцем организации.

    Снимок экрана: страница

  9. На странице "Установка Microsoft DevCenter" выберите только репозитории, выберите репозиторий, который нужно добавить в качестве каталога, а затем нажмите кнопку "Установить".

    Снимок экрана: страница установки Microsoft DevCenter с выбранным и выделенным репозиторием.

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

  10. На странице Microsoft DevCenter от Майкрософт требуется разрешение на страницу, просмотрите необходимые разрешения и выберите "Авторизовать Microsoft DevCenter".

    Снимок экрана: страница, которая запрашивает разрешения Microsoft DevCenter, с выделенной кнопкой для авторизации разрешений.

Добавление репозитория в качестве каталога

  1. Вернитесь на портал Azure.

  2. В области "Добавить каталог" введите следующие сведения и нажмите кнопку "Добавить".

    Поле значение
    Репо Выберите репозиторий, который нужно добавить в качестве каталога.
    Ветвь Выберите ветвь.
    Путь к папке Выберите папку, содержащую вложенные папки, содержащие определения среды.

    Снимок экрана: панель портал Azure для добавления каталога с выделенными полями для репозитория, ветви и пути к папке. Кнопка

  3. На панели каталогов убедитесь, что каталог появится. Когда подключение выполнено успешно, в столбце "Состояние " отображается успешное выполнение синхронизации.

    Снимок экрана: область каталогов портал Azure с состоянием подключения.

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

Чтобы сделать файл настройки imagedefintion.yaml доступным для создания полей разработки, необходимо указать его в качестве определения образа для пула.

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

  1. Войдите на портал Azure.

  2. В поле поиска введите проекты. В списке результатов выберите "Проекты".

  3. Откройте проект, в котором нужно создать пул средств разработки.

  4. Выберите пулы полей разработки и нажмите кнопку "Создать".

  5. В области создания пула поля разработки введите следующие значения:

    Параметр Значение
    Имя Введите имя пула. Имя пула отображается разработчикам, чтобы выбрать при создании полей разработки. Имя должно быть уникальным в пределах проекта.
    Определение Выберите определение, как по имени в файле определения изображения.
    Сетевое подключение 1. Выберите "Развернуть в размещенной сети Майкрософт".
    2. Выберите нужный регион развертывания для полей разработки. Выберите регион, близкий к пользователям поля разработки, для оптимального взаимодействия с пользователем.
    Права создателя поля разработки Выберите локальный администратор или стандартный пользователь.
    Включение автоматической остановки Да — значение по умолчанию. Выберите "Нет ", чтобы отключить расписание автоматической остановки. После создания пула можно настроить расписание автоматической остановки.
    Время остановки Выберите время, чтобы завершить работу всех полей разработки в пуле. Все поля разработки в этом пуле завершаются каждый день.
    Часовой пояс Выберите часовой пояс для времени остановки.
    Лицензирование Установите этот флажок, чтобы убедиться, что у вашей организации есть Преимущество гибридного использования Azure лицензии, которые вы хотите применить к полям разработки в этом пуле.

    Снимок экрана: панель ввода основных сведений о новом пуле полей разработки, включая поля для имени и определения. Выделено определение изображения MyImageDefinition.yaml.

  6. Нажмите кнопку создания.

  7. Убедитесь, что в списке появится новый пул полей разработки. Может потребоваться обновить экран.

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

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

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

Чтобы создать поле разработки на портале разработчика Microsoft Dev Box, выполните следующие действия.

  1. Войдите на портал разработчика Microsoft Dev Box.

  2. Выберите новое>поле разработки.

  3. В поле "Добавление разработки" введите следующие значения:

    Параметр Значение
    Имя Введите имя поля разработки. Имена полей разработки должны быть уникальными в проекте.
    Проект Выберите проект из раскрывающегося списка.
    Пул полей разработки Выберите пул из раскрывающегося списка, который включает все пулы полей разработки для этого проекта. Выберите пул полей разработки рядом с вами для наименьшей задержки.

    После выбора на странице отображаются следующие сведения:

    • Сколько полей разработки можно создать в выбранном проекте, если в проекте настроены ограничения.
    • Поддерживается ли гибернация.
    • Включена ли настройка.
    • Время завершения работы, если пул, в котором вы создаете поле разработки, имеет расписание завершения работы.
    • Уведомление о том, что процесс создания поля разработки может занять 25 минут или больше.
  4. Нажмите кнопку "Создать", чтобы начать создание поля разработки.

  5. Чтобы отслеживать ход создания, используйте плитку поля разработки на портале разработчика.

Убедитесь, что настройка применена

Dev Box применяет настройки в качестве конечного этапа процесса создания. Dev Box отправляет сообщения электронной почты, когда поле разработки готово. Затем можно проверить, применены ли настройки.

  1. Дождитесь подтверждения электронной почты о создании поля разработки.

  2. На портале разработчика на плитке поля разработки выберите "Настройки действий>".

    Снимок экрана: плитка поля разработки с выделенным меню

  3. В области сведений о настройке подтвердите настройки, примененные к поле разработки.

    Снимок экрана: панель сведений о настройке, в которой показаны настройки, примененные к поле разработки.

Очистка ресурсов

  1. Войдите на портал разработчика.

  2. Чтобы удалить поле разработки, в меню "Действия " нажмите кнопку "Удалить".

    Снимок экрана: меню

  3. Чтобы подтвердить удаление, нажмите кнопку "Удалить".

    Снимок экрана: сообщение подтверждения об удалении поля разработки.