Skip to content

Commit 452873b

Browse files
Merge pull request #265346 from sdgilley/sdg-freshness
Freshness samples-notebooks
2 parents 58ce632 + e5baa2f commit 452873b

File tree

2 files changed

+26
-21
lines changed

2 files changed

+26
-21
lines changed

articles/machine-learning/includes/aml-your-server-v2.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,15 +8,13 @@ ms.author: sgilley
88
manager: scottpolly
99
ms.custom: "include file"
1010
ms.topic: "include"
11-
ms.date: 08/30/2022
11+
ms.date: 02/05/2024
1212
---
1313

1414
1. Use the instructions at [Azure Machine Learning SDK](https://aka.ms/sdk-v2-install) to install the Azure Machine Learning SDK (v2) for Python
1515

1616
1. Create an [Azure Machine Learning workspace](../how-to-manage-workspace.md).
1717

18-
1. Write a [configuration file](../how-to-configure-environment.md#) file (**aml_config/config.json**).
19-
2018
1. Clone [the AzureML-Examples repository](https://aka.ms/aml-notebooks).
2119

2220
```bash
Lines changed: 25 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,15 @@
11
---
22
title: Example Jupyter Notebooks (v2)
33
titleSuffix: Azure Machine Learning
4-
description: Learn how to find and use the Juypter Notebooks designed to help you explore the SDK (v2) and serve as models for your own machine learning projects.
4+
description: Learn how to find and use the Jupyter Notebooks designed to help you explore the SDK (v2) and serve as models for your own machine learning projects.
55
services: machine-learning
66
ms.service: machine-learning
77
ms.subservice: core
88
ms.topic: sample
9-
109
author: sdgilley
1110
ms.author: sgilley
1211
ms.reviewer: sgilley
13-
ms.date: 08/30/2022
12+
ms.date: 02/05/2024
1413
#Customer intent: As a professional data scientist, I find and run example Jupyter Notebooks for Azure Machine Learning.
1514
---
1615

@@ -29,50 +28,58 @@ This article shows you how to access the repository from the following environme
2928

3029
## Option 1: Access on Azure Machine Learning compute instance (recommended)
3130

32-
The easiest way to get started with the samples is to complete the [Create resources to get started](quickstart-create-resources.md). Once completed, you'll have a dedicated notebook server pre-loaded with the SDK and the Azure Machine Learning Notebooks repository. No downloads or installation necessary.
31+
The easiest way to get started with the samples is to complete the [Create resources to get started](quickstart-create-resources.md). Once completed, you'll have a dedicated notebook server preloaded with the SDK and the Azure Machine Learning Notebooks repository. No downloads or installation necessary.
3332

3433
To view example notebooks:
3534

3635
1. Sign in to [studio](https://ml.azure.com) and select your workspace if necessary.
3736
1. Select **Notebooks**.
3837
1. Select the **Samples** tab. Use the **SDK v2** folder for examples using Python SDK v2.
39-
38+
1. Open the notebook you want to run. Select **Clone this notebook** to create a copy in your workspace file share. This action will copy the notebook along with any dependent resources.
4039

4140
## Option 2: Access on your own notebook server
4241

4342
If you'd like to bring your own notebook server for local development, follow these steps on your computer.
4443

4544
[!INCLUDE [aml-your-server](includes/aml-your-server-v2.md)]
4645

47-
These instructions install the base SDK packages necessary for the quickstart and tutorial notebooks. Other sample notebooks may require you to install extra components. For more information, see [Install the Azure Machine Learning SDK for Python](https://aka.ms/sdk-v2-install).
48-
46+
These instructions install the base SDK packages necessary for the quickstart and tutorial notebooks. Other sample notebooks might require you to install extra components. For more information, see [Install the Azure Machine Learning SDK for Python](https://aka.ms/sdk-v2-install).
4947

5048
## Option 3: Access on a DSVM
5149

5250
The Data Science Virtual Machine (DSVM) is a customized VM image built specifically for doing data science. If you [create a DSVM](how-to-configure-environment.md#local-and-dsvm-only-create-a-workspace-configuration-file), the SDK and notebook server are installed and configured for you. However, you'll still need to create a workspace and clone the sample repository.
5351

5452
1. [Create an Azure Machine Learning workspace](how-to-manage-workspace.md).
5553

56-
1. Download a workspace configuration file:
57-
58-
* Sign in to [Azure Machine Learning studio](https://ml.azure.com)
59-
* Select your workspace settings in the upper right
60-
* Select **Download config file**
61-
62-
![Screenshot of download config.json.](./media/aml-dsvm-server/download-config.png)
63-
64-
1. From the directory where you added the configuration file, clone the [the AzureML-Examples repository](https://aka.ms/aml-notebooks).
54+
1. Clone the [the AzureML-Examples repository](https://aka.ms/aml-notebooks).
6555

6656
```bash
6757
git clone https://github.com/Azure/azureml-examples.git --depth 1
6858
```
6959

70-
1. Start the notebook server from the directory, which now contains the clone and the config file.
60+
1. Start the notebook server from the directory that contains the clone.
7161

7262
```bash
7363
jupyter notebook
7464
```
7565

66+
## Connect to a workspace
67+
68+
Some of the samples use `MLClient.from_config()` to connect to a workspace. For these samples to work, you need a configuration file in a directory on the path to the sample.
69+
70+
The configuration file is created for you on the Azure Machine Learning compute instance. To use the code on your own notebook server or DSVM, create the configuration file manually. Use either of the following methods:
71+
72+
* Write a [configuration file](how-to-configure-environment.md#) file (**aml_config/config.json**) in the root of your cloned repository.
73+
74+
* Download the workspace configuration file:
75+
76+
* Sign in to [Azure Machine Learning studio](https://ml.azure.com)
77+
* Select your workspace settings in the upper right
78+
* Select **Download config file**
79+
* Place the file in the root of your cloned repository.
80+
81+
![Screenshot of download config.json.](./media/aml-dsvm-server/download-config.png)
82+
7683
## Next steps
7784
7885
Explore the [AzureML-Examples](https://github.com/Azure/azureml-examples) repository to discover what Azure Machine Learning can do.
@@ -81,6 +88,6 @@ For more examples of MLOps, see [https://github.com/Azure/mlops-v2](https://gith
8188
8289
Try these tutorials:
8390
84-
- [Train and deploy an image classification model with MNIST](tutorial-train-deploy-notebook.md)
91+
- [Quickstart: Get started with Azure Machine Learning](tutorial-azure-ml-in-a-day.md)
8592
8693
- [Tutorial: Train an object detection model with AutoML and Python](tutorial-auto-train-image-models.md)

0 commit comments

Comments
 (0)