az ml environment
Заметка
Эта ссылка является частью расширения машинного обучения
Управление средами Машинного обучения Azure.
Среды машинного обучения Azure определяют среду выполнения для заданий и развертываний конечных точек, инкапсулируя зависимости для обучения и вывода. Эти определения среды встроены в образы Docker.
Команды
Имя | Описание | Тип | Состояние |
---|---|---|---|
az ml environment archive |
Архивируйте среду. |
Расширение | ГА |
az ml environment create |
Создайте среду. |
Расширение | ГА |
az ml environment list |
Вывод списка сред в рабочей области. |
Расширение | ГА |
az ml environment restore |
Восстановление архивной среды. |
Расширение | ГА |
az ml environment share |
Предоставление общего доступа к определенной среде из рабочей области в реестр. |
Расширение | ГА |
az ml environment show |
Отображение сведений о среде. |
Расширение | ГА |
az ml environment update |
Обновление среды. |
Расширение | ГА |
az ml environment archive
Архивируйте среду.
Архивация среды по умолчанию скрывается из запросов списка (az ml environment list
). Вы по-прежнему можете ссылаться и использовать архивную среду в рабочих процессах. Можно архивировать контейнер среды или определенную версию среды. Архивация контейнера среды будет архивировать все версии среды под этим именем. Архивную среду можно восстановить с помощью az ml environment restore
. Если весь контейнер среды архивирован, вы не сможете восстановить отдельные версии среды. Необходимо восстановить контейнер среды.
az ml environment archive --name
[--label]
[--registry-name]
[--resource-group]
[--version]
[--workspace-name]
Примеры
Архивируйте контейнер среды (архивирует все версии этой среды)
az ml environment archive --name my-env --resource-group my-resource-group --workspace-name my-workspace
Архивация конкретной версии среды
az ml environment archive --name my-env --version 1 --resource-group my-resource-group --workspace-name my-workspace
Обязательные параметры
Имя среды.
Необязательные параметры
Метка среды.
Если это указано, команда будет нацелена на реестр вместо рабочей области. Поэтому не требуется группа ресурсов и рабочая область.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Версия среды.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az ml environment create
Создайте среду.
Среды можно определить из образа Docker, Dockerfile или файла Conda. Машинное обучение Azure поддерживает набор образов ЦП и GPU Docker, которые можно использовать в качестве базовых образов. Дополнительные сведения об этих изображениях см. в https://github.com/Azure/AzureML-Containers.
Созданная среда будет отслеживаться в рабочей области под указанным именем и версией.
az ml environment create [--build-context]
[--conda-file]
[--datastore]
[--description]
[--dockerfile-path]
[--file]
[--image]
[--name]
[--no-wait]
[--os-type]
[--registry-name]
[--resource-group]
[--set]
[--tags]
[--version]
[--workspace-name]
Примеры
Создание среды из файла спецификации YAML
az ml environment create --file my_env.yml --resource-group my-resource-group --workspace-name my-workspace
Создание среды из образа Docker
az ml environment create --name my-env --version 1 --file my_env.yml --image pytorch/pytorch --resource-group my-resource-group --workspace-name my-workspace
Создание среды из контекста сборки
az ml environment create --name my-env --version 1 --file my_env.yml --build-context envs/context/ --dockerfile-path Dockerfile --resource-group my-resource-group --workspace-name my-workspace
Создание среды из спецификации conda
az ml environment create --name my-env --version 1 --file my_env.yml --conda-file conda_dep.yml --image mcr.microsoft.com/azureml/openmpi3.1.2-ubuntu18.04 --resource-group my-resource-group --workspace-name my-workspace
Создание среды в реестре из файла спецификации YAML
az ml environment create --file my_env.yml --registry-name my-registry-name --resource-group my-resource-group
Необязательные параметры
Локальный путь к каталогу для использования в качестве контекста сборки Docker. --build-context/-b и --image/-i являются взаимоисключающими аргументами.
Локальный путь к файлу спецификации conda. --image/-i также необходимо указать, если этот аргумент используется.
Хранилище данных для отправки локального артефакта в.
Описание среды.
Относительный путь к Dockerfile в каталоге, указанном в --build-context/-b. Если опущено, используется файл ./Dockerfile.
Локальный путь к YAML-файлу, содержаму спецификацию среды Машинного обучения Azure. Справочные документы YAML для среды можно найти по адресу: https://aka.ms/ml-cli-v2-environment-yaml-reference.
Образ Docker. --image/-i и --build-context/-b являются взаимоисключающими аргументами.
Имя среды.
Не дождитесь завершения длительной операции.
Тип операционной системы. Допустимые значения: linux, windows. По умолчанию: Linux.
Если это указано, команда будет нацелена на реестр вместо рабочей области. Поэтому не требуется группа ресурсов и рабочая область.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=value.
Пары "ключ-значение", разделенные пробелами, для тегов объекта.
Версия среды.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az ml environment list
Вывод списка сред в рабочей области.
az ml environment list [--archived-only]
[--include-archived]
[--max-results]
[--name]
[--registry-name]
[--resource-group]
[--workspace-name]
Примеры
Вывод списка всех сред в рабочей области
az ml environment list --resource-group my-resource-group --workspace-name my-workspace
Вывод списка всех версий среды для указанного имени в рабочей области
az ml environment list --name my-env --resource-group my-resource-group --workspace-name my-workspace
Вывод списка всех сред в рабочей области с помощью аргумента --query для выполнения запроса JMESPath в результатах команд.
az ml environment list --query "[].{Name:name}" --output table --resource-group my-resource-group --workspace-name my-workspace
Перечисление всех сред в реестре
az ml environment list --registry-name my-registry-name --resource-group my-resource-group
Список всех версий среды для указанного имени в реестре
az ml environment list --name my-env --registry-name my-registry-name --resource-group my-resource-group
Необязательные параметры
Список только архивных сред.
Вывод списка архивированных сред и активных сред.
Максимальное количество возвращаемых результатов.
Имя среды. Если указано, будут возвращены все версии среды под этим именем.
Если это указано, команда будет нацелена на реестр вместо рабочей области. Поэтому не требуется группа ресурсов и рабочая область.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az ml environment restore
Восстановление архивной среды.
При восстановлении архивной среды он больше не будет скрыт из запросов списка (az ml environment list
). Если архивируется весь контейнер среды, можно восстановить архивированный контейнер. При этом будут восстановлены все версии среды под этим именем. Невозможно восстановить только определенную версию среды, если весь контейнер среды архивирован, потребуется восстановить весь контейнер. Если архивирована только отдельная версия среды, можно восстановить эту конкретную версию.
az ml environment restore --name
[--label]
[--registry-name]
[--resource-group]
[--version]
[--workspace-name]
Примеры
Восстановление архивированного контейнера среды (восстанавливает все версии этой среды)
az ml environment restore --name my-env --resource-group my-resource-group --workspace-name my-workspace
Восстановление определенной архивной версии среды
az ml environment restore --name my-env --version 1 --resource-group my-resource-group --workspace-name my-workspace
Обязательные параметры
Имя среды.
Необязательные параметры
Метка среды.
Если это указано, команда будет нацелена на реестр вместо рабочей области. Поэтому не требуется группа ресурсов и рабочая область.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Версия среды.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az ml environment share
Предоставление общего доступа к определенной среде из рабочей области в реестр.
Скопируйте существующую среду из рабочей области в реестр для повторного использования нескольких рабочих областей.
az ml environment share --name
--registry-name
--share-with-name
--share-with-version
--version
[--resource-group]
[--workspace-name]
Примеры
Предоставление общего доступа к существующей среде из рабочей области в реестр
az ml environment share --name my-environment --version my-version --resource-group my-resource-group --workspace-name my-workspace --share-with-name new-name-in-registry --share-with-version new-version-in-registry --registry-name my-registry
Обязательные параметры
Имя среды.
Целевой реестр.
Имя создаваемой среды.
Версия среды, с которой нужно создать.
Версия среды.
Необязательные параметры
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az ml environment show
Отображение сведений о среде.
az ml environment show --name
[--label]
[--registry-name]
[--resource-group]
[--version]
[--workspace-name]
Примеры
Отображение сведений о среде с указанным именем и версией
az ml environment show --name my-env --version 1 --resource-group my-resource-group --workspace-name my-workspace
Отображение сведений о среде в реестре с указанным именем и версией
az ml environment show --name my-env --version 1 --registry-name my-registry-name --resource-group my-resource-group
Обязательные параметры
Имя среды.
Необязательные параметры
Метка среды.
Если это указано, команда будет нацелена на реестр вместо рабочей области. Поэтому не требуется группа ресурсов и рабочая область.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Версия среды.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az ml environment update
Обновление среды.
Можно обновить только свойства description и tags.
az ml environment update --name
[--add]
[--force-string]
[--label]
[--registry-name]
[--remove]
[--resource-group]
[--set]
[--version]
[--workspace-name]
Обязательные параметры
Имя среды.
Необязательные параметры
Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>
.
При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.
Метка среды.
Если это указано, команда будет нацелена на реестр вместо рабочей области. Поэтому не требуется группа ресурсов и рабочая область.
Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove>
ИЛИ --remove propertyToRemove
.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>
.
Версия среды.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.