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

Создание и доступ к среде с помощью Azure CLI

В этой статье объясняется, как создать и получить доступ к среде в существующем проекте сред развертывания Azure с помощью Azure CLI.

Предпосылки

Категория Требование
Установка Расширение Azure CLI для сред развертывания Azure.
Процедура Завершение создания и настройки центра разработки с помощью Azure CLI.
Процедура Завершение создания и настройки проекта с помощью Azure CLI.
Разрешения Чтобы создать среду: роль пользователя среды развертывания , роль администратора проекта DevCenter или встроенную роль с соответствующими разрешениями.

Создание среды

Создание среды автоматически создает необходимые ресурсы и группу ресурсов для их хранения. Имя группы ресурсов следует шаблону {projectName}-{environmentName}. Группу ресурсов можно просмотреть в портале Azure.

Выполните следующие действия в Azure CLI, чтобы создать среду и настроить ресурсы. Выходные данные можно просмотреть в определенном шаблоне Azure Resource Manager (шаблон ARM).

Примечание.

Только пользователи с ролью "Пользователи сред развертывания" , роль администратора проекта DevCenter или встроенная роль с соответствующими разрешениями могут создавать среду. Пользователи, у которых есть роль читателя сред развертывания , могут просматривать собственные среды и среды, созданные другими пользователями.

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

    az login

  2. Установите или обновите расширение Центра разработки Azure для интерфейса командной строки:

    az extension add --name devcenter --upgrade

  3. Список всех проектов сред развертывания Azure, к которым у вас есть доступ:

    az graph query -q "Resources | where type =~ 'microsoft.devcenter/projects'" -o table

  4. Настройте подписку по умолчанию в качестве подписки, содержащей проект:

    az account set --subscription <subscriptionName>

  5. Настройте группу ресурсов по умолчанию в качестве группы ресурсов, содержащей проект:

    az config set defaults.group=<resourceGroupName>

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

    az devcenter dev environment-type list --dev-center <devcenterName> --project-name <projectName> -o table

  7. Список определений среды, доступных для определенного проекта:

    az devcenter dev environment-definition list --dev-center <devcenterName> --project-name <projectName> -o table

  8. Создайте среду с помощью определения среды (шаблона инфраструктуры как кода, определенного в файле environment.yaml ) из списка доступных определений среды:

    az devcenter dev environment create --dev-center-name <devcenterName>
    --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType>
    --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>

    Если для определения конкретной среды требуются какие-либо параметры, используйте --parameters и укажите параметры в виде строки JSON или JSON-файла. Рассмотрим пример.

    $params = "{ 'name': 'firstMsi', 'location': 'northeurope' }"
az devcenter dev environment create --dev-center-name <devcenterName>
    --project-name <projectName> --environment-name <environmentName> --environment-type <environmentType>
    --environment-definition-name <environmentDefinitionName> --catalog-name <catalogName>
    --parameters $params

Примечание.

Вы можете использовать --help для просмотра дополнительных сведений о любой команде, допустимых аргументах и примерах. Например, используйте az devcenter dev environment create --help для просмотра дополнительных сведений о создании среды.

Устранение неполадок с разрешениями

У вас должна быть роль пользователя среды развертывания , роль администратора проекта DevCenter или встроенная роль , которая имеет необходимые разрешения для создания среды.

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

(EnvironmentNotFound) The environment resource was not found.
Code: EnvironmentNotFound
Message: The environment resource was not found.

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

Получите доступ к среде

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

  1. Перечислить существующие среды, доступные в определенном проекте:

     az devcenter dev environment list --dev-center <devcenterName> --project-name <projectName>

  2. Просмотрите конечные точки доступа к различным ресурсам, как определено в выходных данных шаблона ARM.

  3. Доступ к определенным ресурсам с помощью конечных точек.

Развертывать среду

az devcenter dev environment deploy --action-id "deploy" --dev-center-name <devcenterName> \
    -g <resourceGroupName> --project-name <projectName> --environment-name <environmentName> --parameters <parametersJsonString>

Удаление среды

az devcenter dev environment delete --dev-center-name <devcenterName>  --project-name <projectName> --environment-name <environmentName> --user-id "me"

Связанный контент

  • Last updated on