Skip to content

Commit 3133afe

Browse files
authored
Merge pull request #201916 from sdgilley/sdg-migrate
add links where possible
2 parents 61b182b + 090b50a commit 3133afe

File tree

3 files changed

+7
-5
lines changed

3 files changed

+7
-5
lines changed

articles/machine-learning/concept-azure-machine-learning-v2.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -278,5 +278,6 @@ An Azure Machine Learning [component](concept-component.md) is a self-contained
278278

279279
## Next steps
280280

281+
* [How to migrate from v1 to v2](how-to-migrate-from-v1.md)
281282
* [Train models with the CLI (v2)](how-to-train-cli.md)
282283
* [Train models with the Azure ML Python SDK v2 (preview)](how-to-train-sdk.md)

articles/machine-learning/concept-v2.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -116,6 +116,7 @@ The Azure Machine Learning Python SDK v1 doesn't have a planned deprecation date
116116

117117
## Next steps
118118

119+
* [How to migrate from v1 to v2](how-to-migrate-from-v1.md)
119120
* Get started with CLI v2
120121

121122
* [Install and set up CLI (v2)](how-to-configure-cli.md)

articles/machine-learning/how-to-migrate-from-v1.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -79,7 +79,7 @@ This section gives an overview of migration recommendations for specific resourc
7979

8080
Workspaces don't need to be migrated with v2. You can use the same workspace, regardless of whether you're using v1 or v2. We recommend creating a new workspace for using v2 to keep v1/v2 entities separate and avoid backward/forward compatibility considerations.
8181

82-
Do consider migrating the code for deploying a workspace to v2. Typically Azure resources are managed via Azure Resource Manager (and Bicep) or similar resource provisioning tools. Alternatively, you can use the CLI (v2) and YAML files.
82+
Do consider migrating the code for creating a workspace to v2. Typically Azure resources are managed via Azure Resource Manager (and Bicep) or similar resource provisioning tools. Alternatively, you can use the [CLI (v2) and YAML files](how-to-manage-workspace-cli.md#create-a-workspace).
8383

8484
> [!IMPORTANT]
8585
> If your workspace uses a private endpoint, it will automatically have the `v1_legacy_mode` flag enabled, preventing usage of v2 APIs. See [how to configure network isolation with v2](how-to-configure-network-isolation-with-v2.md) for details.
@@ -94,7 +94,7 @@ We recommend migrating the code for creating connections to v2.
9494

9595
Object storage datastore types created with v1 are fully available for use in v2. Database datastores are not supported; export to object storage (usually Azure Blob) is the recommended migration path.
9696

97-
We recommend migrating the code for creating datastores to v2.
97+
We recommend migrating the code for [creating datastores](how-to-datastore.md) to v2.
9898

9999
### Compute
100100

@@ -122,7 +122,7 @@ To migrate, you'll need to change your code for submitting jobs to v2. We recomm
122122

123123
:::code language="yaml" source="~/azureml-examples-main/cli/jobs/basics/hello-world.yml":::
124124

125-
What you run *within* the job does not need to be migrated to v2. However, it is recommended to remove any code specific to Azure ML from your model training scripts. This separation allows for an easier transition between local and cloud and is considered best practice for mature MLOps. In practice, this means removing `azureml.*` lines of code. Model logging and tracking code should be replaced with MLflow. See [how to use MLflow in v2](how-to-use-mlflow-cli-runs.md) for details.
125+
What you run *within* the job does not need to be migrated to v2. However, it is recommended to remove any code specific to Azure ML from your model training scripts. This separation allows for an easier transition between local and cloud and is considered best practice for mature MLOps. In practice, this means removing `azureml.*` lines of code. Model logging and tracking code should be replaced with MLflow. For more details, see [how to use MLflow in v2](how-to-use-mlflow-cli-runs.md).
126126

127127
We recommend migrating the code for creating jobs to v2. You can see [how to train models with the CLI (v2)](how-to-train-cli.md) and the [job YAML references](reference-yaml-job-command.md) for authoring jobs in v2 YAMLs.
128128

@@ -134,13 +134,13 @@ Data assets in v2 (or File Datasets in v1) are *references* to files in object s
134134

135135
For details on data in v2, see the [data concept article](concept-data.md).
136136

137-
We recommend migrating the code for creating data assets to v2.
137+
We recommend migrating the code for [creating data assets](how-to-create-register-data-assets.md) to v2.
138138

139139
### Model
140140

141141
Models created from v1 can be used in v2. In v2, explicit model types are introduced. Similar to data assets, it may be easier to re-create a v1 model as a v2 model, setting the type appropriately.
142142

143-
We recommend migrating the code for creating models to v2.
143+
We recommend migrating the code for creating models with [SDK](how-to-train-sdk.md) or [CLI](how-to-train-cli.md) to v2.
144144

145145
### Environment
146146

0 commit comments

Comments
 (0)