Skip to content

Commit a4f44bb

Browse files
authored
Update getting_started.md
1 parent e433ca8 commit a4f44bb

1 file changed

Lines changed: 16 additions & 14 deletions

File tree

docs/getting_started.md

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -118,17 +118,19 @@ Configure a pipeline to see values from the previously defined variable group **
118118

119119
![retrain pipeline vg](./images/retrain-pipeline-vg.png)
120120

121-
Add an empty stage with name **``Invoke Training Pipeline``** and make sure that the **Agent Specification** is **``ubuntu-16.04``**:
121+
Add an empty stage with name **Invoke Training Pipeline** and make sure that the **Agent Specification** is **ubuntu-16.04**:
122122

123123
![agent specification](./images/agent-specification.png)
124124

125-
Add a command line step **``Invoke Training Pipeline``** with the following script:
125+
Add a command line step **Run Training Pipeline** with the following script:
126126

127127
```bash
128-
docker run -v $(System.DefaultWorkingDirectory)/_ci-build/mlops-pipelines/ml_service/pipelines:/pipelines -w=/pipelines -e MODEL_NAME=$MODEL_NAME -e EXPERIMENT_NAME=$EXPERIMENT_NAME microsoft/mlopspython python run_train_pipeline.py
128+
docker run -v $(System.DefaultWorkingDirectory)/_ci-build/mlops-pipelines/ml_service/pipelines:/pipelines \
129+
-w=/pipelines -e MODEL_NAME=$MODEL_NAME -e EXPERIMENT_NAME=$EXPERIMENT_NAME \
130+
microsoft/mlopspython python run_train_pipeline.py
129131
```
130132

131-
This release pipeline is triggered whenever a new **ML training pipeline** is published by the **AzDo builder pipeline**. It can also be triggered manually or configured to run on a scheduled basis. Create a new release to trigger the pipeline manually:
133+
This release pipeline should be triggered whenever a new **ML training pipeline** is published by the **AzDo builder pipeline**. It can also be triggered manually or configured to run on a scheduled basis. Create a new release to trigger the pipeline manually:
132134

133135
![create release](./images/create-release.png)
134136

@@ -142,43 +144,43 @@ The training pipeline will train, evaluate and register a new model. Wait until
142144

143145
Good! Now we have a trained model.
144146

145-
### 6. Train the Model
147+
### 8. Deploy the Model
146148

147149
The final step is to deploy the model across environments with a release pipeline. There will be a **``QA``** environment running on [Azure Container Instances](https://azure.microsoft.com/en-us/services/container-instances/) and a **``Prod``** environment running on [Azure Kubernetes Service](https://azure.microsoft.com/en-us/services/kubernetes-service).
148150

149151
![deploy model](./images/deploy-model.png)
150152

151153

152-
This pipeline leverages the **Azure Machine Learning** extension that should be installed in your organization from the [marketplace](https://marketplace.visualstudio.com/items?itemName=ms-air-aiagility.vss-services-azureml)
154+
This pipeline leverages the **Azure Machine Learning** extension that should be installed in your organization from the [marketplace](https://marketplace.visualstudio.com/items?itemName=ms-air-aiagility.vss-services-azureml).
153155

154156
The pipeline consumes two artifacts: the result of the **Build Pipeline** as it contains configuration files and the **model** trained and registered by the ML training pipeline.
155157

156-
Configuration of a code **``_ci-build``** artifact is similar to what we did in the previous chapter.
158+
Configuration of a code **_ci-build** artifact is similar to what we did in the previous chapter.
157159

158-
In order to configure a model artifact there should be a service connection to **``mlops-AML-WS``** workspace.
160+
In order to configure a model artifact there should be a service connection to **mlops-AML-WS** workspace:
159161

160162
![workspace connection](./images/workspace-connection.png)
161163

162-
Add an artifact to the pipeline and select **AzureML Model Artifact** source type. Select the **Service Endpoint** and **Model Names** from the drop down lists
164+
Add an artifact to the pipeline and select **AzureML Model Artifact** source type. Select the **Service Endpoint** and **Model Names** from the drop down lists:
163165

164166
![model artifact](./images/model-artifact.png)
165167

166-
Create a stage **``QA (ACI)``** and add a single task to the job **Azure ML Model Deploy**. Specify task parameters as it is shown below
168+
Create a stage **QA (ACI)** and add a single task to the job **Azure ML Model Deploy**. Specify task parameters as it is shown below:
167169

168170
![deploy aci](./images/deploy-aci.png)
169171

170-
In a similar way create a stage **``Prod (AKS)``** and add a single task to the job **Azure ML Model Deploy**. Specify task parameters as it is shown below
172+
In a similar way create a stage **Prod (AKS** and add a single task to the job **Azure ML Model Deploy**. Specify task parameters as it is shown below:
171173

172174
![deploy aks](./images/deploy-aks.png)
173175

174176

175-
Note! Creating of a Kubernetes cluster on AKS is out of scope of this tutorial, so you should take care of it on your own.
177+
**Note:** Creating of a Kubernetes cluster on AKS is out of scope of this tutorial, so you should take care of it on your own.
176178

177-
Save the pipeline and craete a release for it to trigger the pipeline manually. Once it's finished, check out deployments in the **``mlops-AML-WS``** workspace.
179+
Save the pipeline and craete a release to trigger it manually. Once the pipeline exection is finished, check out deployments in the **mlops-AML-WS** workspace.
178180

179181

180182

181-
Congratulations, you now have three pipelines set up end to end.
183+
Congratulations! You have three pipelines set up end to end:
182184
- Build pipeline: triggered on code change to master branch on GitHub, performs linting, unit testing and publishing a trainig pipeline
183185
- Release Trigger pipeline: runs a published training pipeline to trian, evaluate and register a model
184186
- Release Deployment pipeline: deploys a model to QA (ACI) and Prod (AKS) environemts

0 commit comments

Comments
 (0)