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

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

  • Статья

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

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

Создать среду

Создание среды автоматически создает необходимые ресурсы и группу ресурсов для их хранения. Имя группы ресурсов следует шаблону {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 --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"

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