Skip to content

Commit 75941d2

Browse files
authored
Clarify workspace concepts for customer feedback
1 parent ae72094 commit 75941d2

File tree

1 file changed

+20
-20
lines changed

1 file changed

+20
-20
lines changed

articles/machine-learning/concept-workspace.md

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -17,34 +17,33 @@ ms.date: 03/13/2023
1717

1818
# What is an Azure Machine Learning workspace?
1919

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).
2123

2224
:::image type="content" source="./media/concept-workspace/workspace.png" alt-text="Screenshot of the Azure Machine Learning workspace.":::
2325

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
2527

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:
2629

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).
2836

29-
Machine learning tasks read and/or write artifacts to your workspace.
37+
## What content is stored in a workspace?
3038

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).
3940

40-
## Taxonomy
41+
## Tasks performed within a workspace
4142

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.
4344

44-
+ [User roles](how-to-assign-roles.md) enable you to share your workspace with other users, teams, or projects.
4545
+ [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.
4847
+ [Pipelines](concept-ml-pipelines.md) are reusable workflows for training and retraining your model.
4948
+ [Data assets](concept-data.md) aid in management of the data you use for model training and pipeline creation.
5049
+ 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
9998

10099
## Associated resources
101100

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:
103102

104103
+ [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.
105104

@@ -109,12 +108,13 @@ When you create a new workspace, it automatically creates several Azure resource
109108
110109
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.
111110

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:
113112
* [Azure Machine Learning environments](concept-environments.md) when training and deploying models
114113
* [AutoML](concept-automated-ml.md) when deploying
115114
* [Data profiling](v1/how-to-connect-data-ui.md#data-preview-and-profile)
116115

117-
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.
118118
119119
> [!NOTE]
120120
> 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

Comments
 (0)