Skip to content

Commit a465368

Browse files
authored
Merge pull request #72475 from sdgilley/master
put back Azure Notebook
2 parents 5878a12 + 5ae5197 commit a465368

File tree

2 files changed

+32
-37
lines changed

2 files changed

+32
-37
lines changed
-66.1 KB
Loading

articles/machine-learning/service/quickstart-run-cloud-notebook.md

Lines changed: 32 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -15,70 +15,72 @@ ms.custom: seodec18
1515

1616
# Quickstart: Use a cloud-based notebook server to get started with Azure Machine Learning
1717

18-
Create a cloud-based notebook server, then use it to run code that logs values in the Azure Machine Learning service [workspace](concept-azure-machine-learning-architecture.md). Your workspace is the foundational block in the cloud that you use to experiment, train, and deploy machine learning models with Machine Learning.
18+
In this article, you use Azure Notebooks to run code that is logged in the Azure Machine Learning service [workspace](concept-azure-machine-learning-architecture.md). Your workspace is the foundational block in the cloud that you use to experiment, train, and deploy machine learning models with Machine Learning.
1919

20-
This quickstart shows how to create a cloud resource in your Azure Machine Learning workspace, configured with the Python environment necessary to run Azure Machine Learning. To use your own environment instead, see [Quickstart: Use your own notebook server to get started with Azure Machine Learning](quickstart-run-local-notebook.md).
20+
This quickstart uses cloud resources and requires no installation. To use your own environment instead, see [Quickstart: Use your own notebook server to get started with Azure Machine Learning](quickstart-run-local-notebook.md).
2121

2222
In this quickstart, you take the following actions:
2323

24-
* Create a workstation
25-
* Start a Jupyter Notebook server on your workstation
26-
* Open a notebook that contains code to estimate pi and logs errors at each iteration.
27-
* Run the notebook.
28-
* View the logged error values in your workspace. This example shows how the workspace can help you keep track of information generated in a script.
24+
* Connect to your workspace with Python in a Jupyter notebook. The notebook contains code to estimate pi and logs errors at each iteration.
25+
* View the logged error values in your workspace.
2926

3027
If you don’t have an Azure subscription, create a free account before you begin. Try the [free or paid version of Azure Machine Learning service](https://aka.ms/AMLFree) today.
3128

32-
## Prerequisites
29+
## Prerequisite
3330

3431
1. [Create an Azure Machine Learning workspace](setup-create-workspace.md#portal) if you don't have one.
3532

36-
1. Open your workspace in the [Azure portal](https://portal.azure.com/). If you're not sure how to locate your workspace in the portal, see how to [find your workspace](how-to-manage-workspace.md#view).
33+
1. Open your workspace in the [Azure portal](https://portal.azure.com/). See how to [find your workspace](how-to-manage-workspace.md#view).
3734

38-
## Create a workstation
35+
## Use your workspace
3936

40-
A notebook workstation gives you a cloud-based platform for Jupyter Notebooks that is preconfigured with everything you need to run Azure Machine Learning service. From your workspace, you can create this platform to get started using Jupyter notebooks.
37+
> [!VIDEO https://www.microsoft.com/en-us/videoplayer/embed/RE2F9Ad]
4138
42-
1. On your workspace page in Azure portal, select **Notebook Workstation** on the left.
4339

44-
1. Select **Create Notebooks in an Azure Machine Learning workstation (Preview)**
4540

46-
![Explore the workspace](./media/quickstart-run-cloud-notebook/explore-aml.png)
41+
Learn how a workspace helps you manage your machine learning scripts. In this section, you take the following steps:
42+
43+
* Open a notebook in Azure Notebooks.
44+
* Run code that creates some logged values.
45+
* View the logged values in your workspace.
4746

48-
1. The **Notebook Workstations** section shows a list of all the cloud-based notebook servers available in your workspace. From here you can also manage these resources and delete them when they are no longer needed.
47+
This example shows how the workspace can help you keep track of information generated in a script.
4948

50-
1. Select **Add Workstation** to create a notebook workstation.
49+
### Open a notebook
5150

52-
![Select Add Workstation](./media/quickstart-run-cloud-notebook/add-workstation.png)
51+
[Azure Notebooks](https://notebooks.azure.com) provides a free cloud platform for Jupyter notebooks that is preconfigured with everything you need to run Machine Learning. From your workspace, you can launch this platform to get started using your Azure Machine Learning service workspace.
5352

54-
1. On the Add Notebook Workstation section, give your workstation a **Compute name** and select a **Compute type**. Then select **Create**.
53+
1. On the workspace Overview page, select **Get Started Azure Notebooks** to try your first experiment in Azure Notebooks. Azure Notebooks is a separate service that lets you run Jupyter notebooks for free in the cloud. When you use this link to the service, information about how to connect to your workspace will be added to the library you create in Azure Notebooks.
54+
55+
![Explore the workspace](./media/quickstart-run-cloud-notebook/explore-aml.png)
5556

56-
![Create new workstation](media/quickstart-run-cloud-notebook/create-new-workstation.png)
57+
1. Sign into Azure Notebooks. Make sure you sign in with the same account you used to sign into the Azure portal. Your organization might require [administrator consent](https://notebooks.azure.com/help/signing-up/work-or-school-account/admin-consent) before you can sign in.
5758

58-
> [!NOTE]
59-
> Your workstation takes approximately two minutes to create. When finished, the status updates to "Running" and links to Jupyter and JupyterLab appear.
59+
1. After you sign in, a new tab opens and a `Clone Library` prompt appears. Cloning this library will load a set of notebooks and other files into your Azure Notebooks account. These files help you explore the capabilities of Azure Machine Learning.
6060

61-
## Launch Jupyter web interface
61+
1. Uncheck **Public** so that you don't share your workspace information with others.
6262

63-
After your workstation is created, use the Notebook Workstations section to launch the Jupyter web interface.
63+
1. Select **Clone**.
6464

65-
* Select **Jupyter** or **Jupyter Lab** in the **Launch** column for your workstation.
65+
![Clone a library](./media/quickstart-run-cloud-notebook/clone.png)
6666

67-
![Start Jupyter notebook server](./media/quickstart-run-cloud-notebook/start-notebook-server.png)
67+
1. If you see that the project status is stopped, click on **Run on Free Computer** to use the free notebook server.
6868

69-
This starts your notebook server and opens the server homepage in a new browser tab. Your server shows sample notebooks for you to use to get started with Azure Machine Learning service.
69+
![Run a project on free compute](./media/quickstart-run-cloud-notebook/run-project.png)
7070

7171
### Run the notebook
7272

73-
Run a notebook that estimates pi and logs the error to your workspace.
73+
In the list of files for this project, you see a `config.json` file. This config file contains information about the workspace you created in the Azure portal. This file allows your code to connect to and add information into your workspace.
7474

7575
1. Select **01.run-experiment.ipynb** to open the notebook.
7676

7777
1. The status area tells you to wait until the kernel has started. The message disappears once the kernel is ready.
7878

7979
![Wait for kernel to start](./media/quickstart-run-cloud-notebook/wait-for-kernel.png)
8080

81-
1. After the kernel has started, run the cells one at a time using **Shift+Enter**. Or select **Cells** > **Run All** to run the entire notebook. When you see an asterisk(__*__) next to a cell, the cell is still running. After the code for that cell finishes, a number appears.
81+
1. After the kernel has started, run the cells one at a time using **Shift+Enter**. Or select **Cells** > **Run All** to run the entire notebook. When you see an asterisk, __*__, next to a cell, the cell is still running. After the code for that cell finishes, a number appears.
82+
83+
1. Follow instructions in the notebook to authenticate your Azure subscription.
8284

8385
After you've finished running all of the cells in the notebook, you can view the logged values in your workspace.
8486

@@ -102,18 +104,11 @@ Because the code to approximate pi uses random values, your plots will show diff
102104

103105
You can also keep the resource group but delete a single workspace. Display the workspace properties and select **Delete**.
104106

105-
106107
## Next steps
107108

108-
In this quickstart, you completed the following:
109-
110-
* Create a workstation
111-
* Start a Jupyter Notebook server on your workstation
112-
* Open a notebook that contains code to estimate pi and logs errors at each iteration.
113-
* Run the notebook.
114-
* View the logged error values in your workspace. This example shows how the workspace can help you keep track of information generated in a script.
109+
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.
115110

116111
For an in-depth workflow experience, follow Machine Learning tutorials to train and deploy a model:
117112

118113
> [!div class="nextstepaction"]
119-
> [Tutorial: Train an image classification model](tutorial-train-models-with-aml.md)
114+
> [Tutorial: Train an image classification model](tutorial-train-models-with-aml.md)

0 commit comments

Comments
 (0)