Azure Machine Learning Docs
Reference Architecture

Reference Architecture for Azure Machine Learning

Overview

This reference architecture provides a comprehensive blueprint for building, deploying, and managing end‑to‑end machine learning solutions on Azure. It describes the recommended components, networking, security, and operational practices to ensure scalability, reliability, and compliance.

Key Components

Architecture Diagram

Azure Machine Learning reference architecture diagram

Sample Deployment Pipeline (YAML)

trigger:
  - main

stages:
  - stage: Build
    jobs:
      - job: Train
        pool:
          vmImage: 'ubuntu-latest'
        steps:
          - task: UsePythonVersion@0
            inputs:
              versionSpec: '3.9'
          - script: |
              pip install -r requirements.txt
              python train.py --config config.yaml
            displayName: 'Run training script'

  - stage: Deploy
    dependsOn: Build
    condition: succeeded()
    jobs:
      - deployment: DeployModel
        environment: 'ml-prod'
        strategy:
          runOnce:
            deploy:
              steps:
                - task: AzureCLI@2
                  inputs:
                    azureSubscription: '$(azureSubscription)'
                    scriptType: 'bash'
                    scriptLocation: 'inlineScript'
                    inlineScript: |
                      az ml model deploy -n mymodel -f model.pkl -e myendpoint --compute aks-cluster
                  displayName: 'Deploy model to AKS'

Further Reading