Quickstart: Use the Azure portal to get started with Azure Machine Learning
In this quickstart, you use the Azure portal to create an Azure Machine Learning workspace. This workspace is the foundational block in the cloud that you use to experiment, train, and deploy machine learning models with Machine Learning. This quickstart uses cloud resources and requires no installation. To configure your own Jupyter notebook server instead, see Quickstart: Use Python to get started with Azure Machine Learning.
In this quickstart, you:
- Create a workspace in your Azure subscription.
- Try it out with Python in an Azure notebook, and log values across multiple iterations.
- View the logged values in your workspace.
The following Azure resources are added automatically to your workspace when they're regionally available:
The resources you create can be used as prerequisites to other Machine Learning service tutorials and how-to articles. As with other Azure services, there are limits on certain resources associated with Machine Learning. An example is Azure Batch AI cluster size. For information on default limits and how to increase your quota, see this article.
If you don’t have an Azure subscription, create a free account before you begin.
Create a workspace
The portal's workspace dashboard is supported on Edge, Chrome, and Firefox browsers only.
In the upper-left corner of the portal, select Create a resource.
In the search bar, enter Machine Learning. Select the Machine Learning service workspace search result.
In the Machine Learning service workspace pane, scroll to the bottom and select Create to begin.
In the ML service workspace pane, configure your workspace.
|Workspace name||Enter a unique name that identifies your workspace. Here we use docs-ws. Names must be unique across the resource group. Use a name that's easy to recall and differentiate from workspaces created by others.|
|Subscription||Select the Azure subscription that you want to use.|
|Resource group||Use an existing resource group in your subscription, or enter a name to create a new resource group. A resource group is a container that holds related resources for an Azure solution. Here we use docs-aml.|
|Location||Select the location closest to your users and the data resources. This location is where the workspace is created.|
To start the creation process, select Create. It can take a few moments to create the workspace.
To check on the status of the deployment, select the Notifications icon (bell) on the toolbar.
When the process is finished, a deployment success message appears. It's also present in the notifications section. To view the new workspace, select Go to resource.
On the workspace page, select
Explore your Azure Machine Learning service workspace.
Use the workspace
Now see how a workspace helps you manage your machine learning scripts. In this section, you:
- Open a notebook in Azure Notebooks.
- Run code that creates some logged values.
- View the logged values in your workspace.
This example shows how the workspace can help you keep track of information generated in a script.
Open a notebook
Azure Notebooks provides a free cloud platform for Jupyter notebooks that are preconfigured with everything you need to run Machine Learning.
Open Azure Notebooks to try your first experiment.
Your organization might require administrator consent before you can sign in.
After you sign in, a new tab opens and a
Clone Library prompt appears. Select
Run the notebook
Along with two notebooks, you see a
config.json file. This config file contains information about the workspace you created.
01.run-experiment.ipynb to open the notebook.
To run the cells one at a time, use
Enter. Or select
Run All to run the entire notebook. When you see an asterisk [*] next to a cell, it's running. After the code for that cell finishes, a number appears.
After you've completed running all of the cells in the notebook, you can view the logged values in your workspace.
View logged values
After you run all the cells in the notebook, go back to the portal page.
See information about the run you just performed. Scroll down the page to find the table of runs. Select the run number link.
You see plots that were automatically created of the logged values. Whenever you log multiple values with the same name parameter, a plot is automatically generated for you.
Since the code to approximate pi uses random values, your plots will show different values.
Clean up resources
The resources you created can be used as prerequisites to other Azure Machine Learning service tutorials and how-to articles.
If you don't plan to use the resources you created here, delete them so you don't incur any charges.
In the Azure portal, select Resource groups on the far left.
From the list, select the resource group you created.
Select Delete resource group.
Enter the resource group name, and then select Delete.
If you see the error message "Cannot delete resource before nested resources are deleted," you must delete any nested resources first. For information on how to delete nested resources, see this troubleshooting section.
You also can keep the resource group but delete a single workspace. Display the workspace properties, and select Delete.
You created the necessary resources to experiment with and deploy models. You also ran some code in a notebook. And you explored the run history from that code in your workspace in the cloud.
For an in-depth workflow experience, follow Machine Learning tutorials to train and deploy a model.