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
Copy file name to clipboardExpand all lines: articles/machine-learning/concept-workspace.md
+20-20Lines changed: 20 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,34 +17,33 @@ ms.date: 03/13/2023
17
17
18
18
# What is an Azure Machine Learning workspace?
19
19
20
-
Workspaces are places to collaborate with colleagues and group related work. For example, experiments, jobs, datasets, components, and inference endpoints.
20
+
Workspaces are places to collaborate with colleagues to create machine learning artifacts and group related work. For example, experiments, jobs, datasets, models, components, and inference endpoints. This article describes workspaces, how to manage access to them, and how to use them to organize your work.
21
+
22
+
Ready to get started? [Create a workspace](#create-a-workspace).
21
23
22
24
:::image type="content" source="./media/concept-workspace/workspace.png" alt-text="Screenshot of the Azure Machine Learning workspace.":::
23
25
24
-
We recommend creating a workspace _per project_. While a workspace can be used for multiple projects, limiting it to one project per workspace allows for cost reporting accrued to a project level. It also allows you to manage configurations like datastores in the scope of each project.
26
+
## Working with workspaces
25
27
28
+
For machine learning teams, the workspace is a place to organize their work. To administrators, workspaces serve as containers for access management, cost management and data isolation. Below are some tips for working with workspaces:
26
29
27
-
## Working with a workspace
30
+
+**Use [user roles](how-to-assign-roles.md)** for permission management in the workspace between users. For example a data scientist, a machine learning engineer or an admin.
31
+
+**Assign access to user groups**: By using Azure Active Directory user groups you don't have to add individual users to each workspace and other resources the same group of users requires access to.
32
+
+**Create a workspace per project**: While a workspace can be used for multiple projects, limiting it to one project per workspace allows for cost reporting accrued to a project level. It also allows you to manage configurations like datastores in the scope of each project.
33
+
+**Share Azure resources**: Workspaces require you to create a number of [associated resources](#associated-resources). Share these resources between workspaces to save repetitive set up steps.
34
+
+**Enable self-serve**: Pre-create and secure [associated resources](#associated-resources) as an IT admin, and use [user roles](how-to-assign-roles.md) to let data scientists create workspaces on their own.
35
+
+**Share assets**: You can share assets between workspaces** using [Azure Machine Learning registries (preview)](how-to-share-models-pipelines-across-workspaces-with-registries.md).
28
36
29
-
Machine learning tasks read and/or write artifacts to your workspace.
37
+
## What content is stored in a workspace?
30
38
31
-
+ Run an experiment to train a model - writes job run results to the workspace.
32
-
+ Use automated ML to train a model - writes training results to the workspace.
33
-
+ Register a model in the workspace.
34
-
+ Deploy a model - uses the registered model to create a deployment.
35
-
+ Create and run reusable workflows.
36
-
+ View machine learning artifacts such as jobs, pipelines, models, deployments.
37
-
+ Track and monitor models.
38
-
+ You can share assets between workspaces using [Azure Machine Learning registries (preview)](how-to-share-models-pipelines-across-workspaces-with-registries.md).
39
+
Your workspace keeps a history of all training runs, with logs, metrics, output, lineage metadata, and a snapshot of your scripts. When performing tasks in Azure Machine Learning, artifacts are generated. Their metadata and data are stored in the workspace and on its [associated resources](#associated-resources).
39
40
40
-
## Taxonomy
41
+
## Tasks performed within a workspace
41
42
42
-
+ A workspace can contain [Azure Machine Learning compute instances](concept-compute-instance.md), cloud resources configured with the Python environment necessary to run Azure Machine Learning.
43
+
The following constructs you can find and manage within the workspace boundary.
43
44
44
-
+[User roles](how-to-assign-roles.md) enable you to share your workspace with other users, teams, or projects.
45
45
+[Compute targets](concept-compute-target.md) are used to run your experiments.
46
-
+ When you create the workspace, [associated resources](#associated-resources) are also created for you.
47
-
+ Jobs are training runs you use to build your models. You can organize your jobs into Experiments.
46
+
+ Jobs are training runs you use to build your models. You can organize your jobs into Experiments.
48
47
+[Pipelines](concept-ml-pipelines.md) are reusable workflows for training and retraining your model.
49
48
+[Data assets](concept-data.md) aid in management of the data you use for model training and pipeline creation.
50
49
+ Once you have a model you want to deploy, you create a registered model.
@@ -99,7 +98,7 @@ These sub resources are the main resources that are made in the Azure Machine Le
99
98
100
99
## Associated resources
101
100
102
-
When you create a new workspace, it automatically creates several Azure resources that are used by the workspace:
101
+
When you create a new workspace, you are required to bring a number of additional Azure resources to store your data:
103
102
104
103
+[Azure Storage account](https://azure.microsoft.com/services/storage/): Is used as the default datastore for the workspace. Jupyter notebooks that are used with your Azure Machine Learning compute instances are stored here as well.
105
104
@@ -109,12 +108,13 @@ When you create a new workspace, it automatically creates several Azure resource
109
108
110
109
To use an existing Azure Storage account, it can't be of type BlobStorage or a premium account (Premium_LRS and Premium_GRS). It also can't have a hierarchical namespace (used with Azure Data Lake Storage Gen2). Neither premium storage nor hierarchical namespaces are supported with the _default_ storage account of the workspace. You can use premium storage or hierarchical namespace with _non-default_ storage accounts.
111
110
112
-
+[Azure Container Registry](https://azure.microsoft.com/services/container-registry/): Registers docker containers that are used for the following components:
111
+
+[Azure Container Registry](https://azure.microsoft.com/services/container-registry/) (ACR): When you build custom docker containers via Azure Machine Learning. For example in the following scenarios:
113
112
*[Azure Machine Learning environments](concept-environments.md) when training and deploying models
To minimize costs, ACR is **lazy-loaded** until images are needed.
116
+
> [!NOTE]
117
+
> Workspaces can be created without Azure Container Registry as a dependency if you do not have a need to build custom docker containers. To read container images, Azure Machine Learning also works with external container registries. Azure Container Registry is automatically provisioned when you build customer docker images. Use Azure RBAC to prevent customer docker containers from being build.
118
118
119
119
> [!NOTE]
120
120
> If your subscription setting requires adding tags to resources under it, Azure Container Registry (ACR) created by Azure Machine Learning will fail, since we cannot set tags to ACR.
0 commit comments