You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Made sure to distinguish how to reference a curated environment and how to reference a custom environment.
Curated environments must be referenced through the asset ID.
Only custom environments can be referenced through their name.
Copy file name to clipboardExpand all lines: articles/machine-learning/how-to-manage-environments-v2.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -71,13 +71,13 @@ To connect to the workspace, you need identifier parameters - a subscription, re
71
71
72
72
There are two types of environments in Azure Machine Learning: curated and custom environments. Curated environments are predefined environments containing popular ML frameworks and tooling. Custom environments are user-defined and can be created via `az ml environment create`.
73
73
74
-
Curated environments are provided by Azure Machine Learning and are available in your workspace by default. Azure Machine Learning routinely updates these environments with the latest framework version releases and maintains them for bug fixes and security patches. They're backed by cached Docker images, which reduce job preparation cost and model deployment time.
74
+
Curated environments are provided by Azure Machine Learning and are available by default. Azure Machine Learning routinely updates these environments with the latest framework version releases and maintains them for bug fixes and security patches. They're backed by cached Docker images, which reduce job preparation cost and model deployment time.
75
75
76
-
You can use these curated environments out of the box for training or deployment by referencing a specific environment using the `azureml:<curated-environment-name>:<version>` or `azureml:<curated-environment-name>@latest` syntax. You can also use them as reference for your own custom environments by modifying the Dockerfiles that back these curated environments.
76
+
You can use these curated environments out of the box for training or deployment by referencing a specific version or latest version of the environment. Use the following syntax: `azureml://registries/azureml/environment/<curated-environment-name>/versions/<version-number>` or `azureml://registries/azureml/environment/<curated-environment-name>/labels/latest`. You can also use them as a reference for your own custom environments by modifying the Dockerfiles that back these curated environments.
77
77
78
78
You can see the set of available curated environments in the Azure Machine Learning studio UI, or by using the CLI (v2) via `az ml environment list`.
79
79
80
-
## Create an environment
80
+
## Create a custom environment
81
81
82
82
You can define an environment from a Docker image, a Docker build context, and a conda specification with Docker image.
To use an environment for a training job, specify the `environment` field of the job YAML configuration. You can either reference an existing registered Azure Machine Learning environment via `environment: azureml:<environment-name>:<environment-version>` or `environment: azureml:<environment-name>@latest` (to reference the latest version of an environment), or define an environment specification inline. If defining an environment inline, don't specify the `name` and `version` fields, as these environments are treated as "unregistered" environments and aren't tracked in your environment asset registry.
300
+
To use a **custom environment** for a training job, specify the `environment` field of the job YAML configuration. You can either reference an existing registered Azure Machine Learning environment via `environment: azureml:<environment-name>:<environment-version>` or `environment: azureml:<environment-name>@latest` (to reference the latest version of an environment), or define an environment specification inline. If defining an environment inline, don't specify the `name` and `version` fields, as these environments are treated as "unregistered" environments and aren't tracked in your environment asset registry.
0 commit comments