Skip to content

Commit f2dc7d7

Browse files
authored
update doc with aks auth details (#239)
1 parent 352ebbe commit f2dc7d7

File tree

1 file changed

+14
-9
lines changed

1 file changed

+14
-9
lines changed

docs/getting_started.md

Lines changed: 14 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@ We recommend working through this guide completely to ensure everything is worki
1717
- [Set up the Pipeline](#set-up-the-pipeline)
1818
- [Further Exploration](#further-exploration)
1919
- [Deploy the model to Azure Kubernetes Service](#deploy-the-model-to-azure-kubernetes-service)
20+
- [Web Service Authentication on Azure Kubernetes Service](#web-service-authentication-on-azure-kubernetes-service)
2021
- [Deploy the model to Azure App Service (Azure Web App for containers)](#deploy-the-model-to-azure-app-service-azure-web-app-for-containers)
2122
- [Example pipelines using R](#example-pipelines-using-r)
2223
- [Observability and Monitoring](#observability-and-monitoring)
@@ -48,15 +49,15 @@ Create a variable group named **``devopsforai-aml-vg``**. The YAML pipeline defi
4849

4950
The variable group should contain the following required variables. **Azure resources that don't exist yet will be created in the [Provisioning resources using Azure Pipelines](#provisioning-resources-using-azure-pipelines) step below.**
5051

51-
| Variable Name | Suggested Value | Short description |
52-
| ------------------------ | ------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
53-
| BASE_NAME | [your project name] | Unique naming prefix for created resources - max 10 chars, letters and numbers only |
54-
| LOCATION | centralus | [Azure location](https://azure.microsoft.com/en-us/global-infrastructure/locations/), no spaces |
55-
| RESOURCE_GROUP | mlops-RG | Azure Resource Group name |
56-
| WORKSPACE_NAME | mlops-AML-WS | Azure ML Workspace name |
57-
| AZURE_RM_SVC_CONNECTION | azure-resource-connection | [Azure Resource Manager Service Connection](#create-an-azure-devops-service-connection-for-the-azure-resource-manager) name |
58-
| WORKSPACE_SVC_CONNECTION | aml-workspace-connection | [Azure ML Workspace Service Connection](#create-an-azure-devops-azure-ml-workspace-service-connection) name |
59-
| ACI_DEPLOYMENT_NAME | mlops-aci | [Azure Container Instances](https://azure.microsoft.com/en-us/services/container-instances/) name |
52+
| Variable Name | Suggested Value | Short description |
53+
| ------------------------ | ------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
54+
| BASE_NAME | [your project name] | Unique naming prefix for created resources - max 10 chars, letters and numbers only |
55+
| LOCATION | centralus | [Azure location](https://azure.microsoft.com/en-us/global-infrastructure/locations/), no spaces |
56+
| RESOURCE_GROUP | mlops-RG | Azure Resource Group name |
57+
| WORKSPACE_NAME | mlops-AML-WS | Azure ML Workspace name |
58+
| AZURE_RM_SVC_CONNECTION | azure-resource-connection | [Azure Resource Manager Service Connection](#create-an-azure-devops-service-connection-for-the-azure-resource-manager) name |
59+
| WORKSPACE_SVC_CONNECTION | aml-workspace-connection | [Azure ML Workspace Service Connection](#create-an-azure-devops-azure-ml-workspace-service-connection) name |
60+
| ACI_DEPLOYMENT_NAME | mlops-aci | [Azure Container Instances](https://azure.microsoft.com/en-us/services/container-instances/) name |
6061

6162
Make sure you select the **Allow access to all pipelines** checkbox in the variable group configuration.
6263

@@ -200,6 +201,10 @@ After successfully deploying to Azure Container Instances, the next stage will d
200201

201202
Consider enabling [manual approvals](https://docs.microsoft.com/en-us/azure/devops/pipelines/process/approvals) before the deployment stages.
202203

204+
#### Web Service Authentication on Azure Kubernetes Service
205+
206+
When deploying to Azure Kubernetes Service, key-based authentication is enabled by default. You can also enable token-based authentication. Token-based authentication requires clients to use an Azure Active Directory account to request an authentication token, which is used to make requests to the deployed service. For more details on how to authenticate with ML web service deployed on the AKS service please follow [Smoke Test](../ml_service/util/smoke_test_scoring_service.py) or the Azure documentation on [web service authentication](https://docs.microsoft.com/en-us/azure/machine-learning/how-to-deploy-azure-kubernetes-service#web-service-authentication).
207+
203208
### Deploy the model to Azure App Service (Azure Web App for containers)
204209

205210
If you want to deploy your scoring service as an [Azure App Service](https://docs.microsoft.com/en-us/azure/machine-learning/service/how-to-deploy-app-service) instead of Azure Container Instances and Azure Kubernetes Service, follow these additional steps.

0 commit comments

Comments
 (0)