Tutorial: Create resources you need to get started

In this tutorial, you will create the resources you need to start working with Azure Machine Learning.

  • A workspace. To use Azure Machine Learning, you'll first need a workspace. The workspace is the central place to view and manage all the artifacts and resources you create.
  • A compute instance. A compute instance is a pre-configured cloud-computing resource that you can use to train, automate, manage, and track machine learning models. A compute instance is the quickest way to start using the Azure Machine Learning SDKs and CLIs. You'll use it to run Jupyter notebooks and Python scripts in the rest of the tutorials.

This video shows you how to create a workspace and compute instance. The steps are also described in the sections below.


Create the workspace

The workspace is the top-level resource for your machine learning activities, providing a centralized place to view and manage the artifacts you create when you use Azure Machine Learning.

If you already have a workspace, skip this section and continue to Create a compute instance.

If you don't yet have a workspace, create one now:

  1. Sign in to Azure Machine Learning studio

  2. Select Create workspace

  3. Provide the following information to configure your new workspace:

    Field Description
    Workspace name Enter a unique name that identifies your workspace. Names must be unique across the resource group. Use a name that's easy to recall and to differentiate from workspaces created by others. The workspace name is case-insensitive.
    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 holds related resources for an Azure solution. You need contributor or owner role to use an existing resource group. For more information about access, see Manage access to an Azure Machine Learning workspace.
    Region Select the Azure region closest to your users and the data resources to create your workspace.
  4. Select Create to create the workspace


This creates a workspace along with all required resources. If you would like to reuse resources, such as Storage Account, Azure Container Registry, Azure KeyVault, or Application Insights, use the Azure portal instead.

Create a compute instance

You'll use the compute instance to run Jupyter notebooks and Python scripts in the rest of the tutorials. If you don't yet have a compute instance, create one now:

  1. On the left navigation, select Notebooks.

  2. Select Create compute in the middle of the page.

    Screenshot shows create compute in the middle of the screen.


    You'll only see this option if you don't yet have a compute instance in your workspace.

  3. Supply a name. Keep all the defaults on the first page.

  4. Keep the default values for the rest of the page.

  5. Select Create.

Quick tour of the studio

The studio is your web portal for Azure Machine Learning. This portal combines no-code and code-first experiences for an inclusive data science platform.

Review the parts of the studio on the left-hand navigation bar:

  • The Authoring section of the studio contains multiple ways to get started in creating machine learning models. You can:

    • Notebooks section allows you to create Jupyter Notebooks, copy sample notebooks, and run notebooks and Python scripts.
    • Automated ML steps you through creating a machine learning model without writing code.
    • Designer gives you a drag-and-drop way to build models using prebuilt components.
  • The Assets section of the studio helps you keep track of the assets you create as you run your jobs. If you have a new workspace, there's nothing in any of these sections yet.

  • The Manage section of the studio lets you create and manage compute and external services you link to your workspace. It's also where you can create and manage a Data labeling project.

Screenshot of Azure Machine Learning studio.

Learn from sample notebooks

Use the sample notebooks available in studio to help you learn about how to train and deploy models. They're referenced in many of the other articles and tutorials.

  1. On the left navigation, select Notebooks.
  2. At the top, select Samples.

Screenshot shows sample notebooks.

  • Use notebooks in the SDK v2 folder for examples that show the current version of the SDK, v2.
  • These notebooks are read-only, and are updated periodically.
  • When you open a notebook, select the Clone this notebook button at the top to add your copy of the notebook and any associated files into your own files. A new folder with the notebook is created for you in the Files section.

Create a new notebook

When you clone a notebook from Samples, a copy is added to your files and you can start running or modifying it. Many of the tutorials will mirror these sample notebooks.

But you could also create a new, empty notebook, then copy/paste code from a tutorial into the notebook. To do so:

  1. Still in the Notebooks section, select Files to go back to your files,

  2. Select + to add files.

  3. Select Create new file.

    Screenshot shows how to create a new file.

Clean up resources

If you plan to continue now to other tutorials, skip to Next steps.

Stop compute instance

If you're not going to use it now, stop the compute instance:

  1. In the studio, on the left, select Compute.
  2. In the top tabs, select Compute instances
  3. Select the compute instance in the list.
  4. On the top toolbar, select Stop.

Delete all resources


The resources that you created can be used as prerequisites to other Azure Machine Learning tutorials and how-to articles.

If you don't plan to use any of the resources that you created, delete them so you don't incur any charges:

  1. In the Azure portal, select Resource groups on the far left.

  2. From the list, select the resource group that you created.

  3. Select Delete resource group.

    Screenshot of the selections to delete a resource group in the Azure portal.

  4. Enter the resource group name. Then select Delete.

Next steps

You now have an Azure Machine Learning workspace, which contains a compute instance to use for your development environment.

Continue on to learn how to use the compute instance to run notebooks and scripts in the Azure Machine Learning cloud.

Use your compute instance with the following tutorials to train and deploy a model.

Tutorial Description
Upload, access and explore your data in Azure Machine Learning Store large data in the cloud and retrieve it from notebooks and scripts
Model development on a cloud workstation Start prototyping and developing machine learning models
Train a model in Azure Machine Learning Dive in to the details of training a model
Deploy a model as an online endpoint Dive in to the details of deploying a model
Create production machine learning pipelines Split a complete machine learning task into a multistep workflow.