Skip to content

Commit 7225257

Browse files
committed
added model artifact manual instructions
1 parent 72f69a3 commit 7225257

File tree

5 files changed

+24
-16
lines changed

5 files changed

+24
-16
lines changed

docs/getting_started.md

Lines changed: 24 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -134,7 +134,7 @@ On the next screen, click on **Save** and then click **Ok** to save the empty re
134134
![release create ](./images/release-create.png)
135135
- On the next screen click on **Create** button, this creates a manual release for you.
136136

137-
**Note**: This release pipeline will call the published AML pipeline. The AML pipeline will train the model and package it into image. It will take around 10 mins to complete. The next steps need this pipeline to complete successfully.
137+
**Note**: This release pipeline will call the published AML pipeline. The AML pipeline will train the model and package it into image. It will take around 10 mins to complete. The next steps need this pipeline to complete successfully. At this point, you can go to the Azure Portal AML WOrkspace resource created inside resource group "DevOps_AzureML_Demo" and click on the **Pipeline** tab to see the running pipeline.
138138

139139
### 7. Set up release (Deployment) pipeline
140140

@@ -174,26 +174,34 @@ Let's set up the release deployment pipeline now.
174174
- Click on **Add**, and then **Save** the pipeline
175175
![release retraining artifact](./images/release-retrainingartifact.png)
176176

177-
Here are the steps to add ACR as an artifact
177+
**Here are the steps to add [Azure ML Model as an artifact](https://marketplace.visualstudio.com/items?itemName=ms-air-aiagility.vss-services-azureml)**
178178

179-
![release retraining agent](./images/release-deployment-service-conn.png)
180-
181-
179+
180+
- Install the Azure Machine Learning extension for your DevOps organization from [here](https://marketplace.visualstudio.com/items?itemName=ms-air-aiagility.vss-services-azureml). You need to have admin rights to install it.
181+
182+
- Create Service Connection
183+
1. Go to your DevOps project and click on Project settings on bottom left corner
184+
2. Under Project Settings -> Pipelines, click on Service connections, click on "New service connection" and select Azure Resource Manager
185+
![release retraining agent](./images/service-connection.png)
186+
187+
3. Provide following info and click Ok once done:
188+
![release retraining agent](./images/service-connection-add.png)
189+
190+
182191
- Click on pipeline tab to go back to pipeline view and click **Add an artifact**. This will open a pop up window
183-
- For Source type, click on **more artifact types** dropdown and select **Azure Container Registry**
184-
- For **service connection**, select an existing service connection to Azure, if you don't see anything in the dropdown, click on **Manage** and [create new **Azure Resource Manager**](https://docs.microsoft.com/en-us/azure/devops/pipelines/library/service-endpoints?view=azure-devops#create-a-service-connection) service connection for your subscription.
192+
- For Source type, click on **more artifact types** dropdown and select **AzureML Model Artifact**
193+
- For **Service Endpoint**, select an existing endpoint **MLOpsPython**, if you don't see anything in the dropdown, click on **Manage** and [create new **Azure Resource Manager**](https://docs.microsoft.com/en-us/azure/devops/pipelines/library/service-endpoints?view=azure-devops#create-a-service-connection) service connection for your subscription.
194+
![release retraining agent](./images/model-artifact.png)
185195
**Note:** You must have sufficient privileges to create a service connection, if not contact your subscription adminstrator.
186-
- For Resource Group, select **DevOps_AzureML_Demo**, this is the default resource group name that we are using and if the previous pipelines executed properly you will see this resource group in the drop down.
187-
- Under Azure container registry dropdown, select the container registry, there should be only one container registry entry.
188-
- For repository, select **diabetes-model-score** repository.
189-
- For Default version, keep it to **latest**
196+
- For Model Names, select **sklearn_regression_model.pkl**, this is the name of the newly trained model and if the previous pipelines executed properly you will see this model name in the drop down.
197+
- For Default version, keep it to **Latest version**
190198
- For Source alias, keep the default generated name.
191199
- Click Add
192-
- Click on lighting sign to enable the **Continous Deployment Trigger**, click Save.
193-
![release retraining artifact](./images/release-deploymentcitrigger.png)
200+
- Click on lighting sign to enable the **Continous Deployment Trigger**, click **Save**.
201+
![release retraining artifact](./images/model-artifact-cd-trigger.png)
194202

195203

196-
1. We now have QA environment continously deployed each time there is a new image available in container registry. You can select pre-deployment conditions for prod environment, normally you don't want it to be auto deployed, so select manual only trigger here.
204+
1. We now have QA environment continously deployed each time there is a new ml model registered in AML Model Management. You can select pre-deployment conditions for prod environment, normally you don't want it to be auto deployed, so select manual only trigger here.
197205

198206
![release retraining artifact](./images/release-deploymentprodtrigger.png)
199207

@@ -202,6 +210,6 @@ Let's set up the release deployment pipeline now.
202210

203211
Congratulations, you now have three pipelines set up end to end.
204212
- Build pipeline: triggered on code change to master branch on GitHub.
205-
- Release Trigger pipeline: triggered on build pipeline execution and produces a new model image if better than previous one.
206-
- Release Deployment pipeline: QA environment is auto triggered when there is a new image.
213+
- Release Trigger pipeline: triggered on build pipeline execution and registers a new ML model to AML Model Management if better than previous one.
214+
- Release Deployment pipeline: QA environment is auto triggered when there is a new model.
207215
Prod is manual only and user decides when to release to this environment.
181 KB
Loading

docs/images/model-artifact.png

195 KB
Loading
233 KB
Loading

docs/images/service-connection.png

106 KB
Loading

0 commit comments

Comments
 (0)