KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #codex #ai-agents #claude-code #dsh #dsh-plugin #cli #macos #ai-agent #deepseek-harness #open-source

azureml-template

★ 31 Open GitHub ↗

under renovation

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Azure Machine Learning (AML) Template

[![run-workflows-badge](https://github.com/Azure/azureml-template/workflows/run-workflows/badge.svg)](https://github.com/Azure/azureml-template/actions?query=workflow%3Arun-workflows)
[![cleanup](https://github.com/Azure/azureml-template/workflows/cleanup/badge.svg)](https://github.com/Azure/azureml-template/actions?query=workflow%3Acleanup)
[![smoke](https://github.com/Azure/azureml-template/workflows/smoke/badge.svg)](https://github.com/Azure/azureml-template/actions?query=workflow%3Asmoke)
[![code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![license: MIT](https://img.shields.io/badge/License-MIT-purple.svg)](https://raw.githubusercontent.com/Azure/azureml-template/main/LICENSE)

Welcome to the Azure Machine Learning (AML) template repository!

## Prerequisites

1. An Azure subscription. If you don't have an Azure subscription, [create a free account](https://aka.ms/AMLFree) before you begin.
2. A terminal and Python >=3.6,[\<3.9](https://pypi.org/project/azureml-core).

## Getting started

Click "Use this template" above and create a repository.

Follow the setup guide below to add your Azure credentials and create required Azure resources. At the end, you will have a repository with:

- simple LightGBM training workflow running every 2 hours and on push/PR
- code format check on push/PR
- resource cleanup script running nightly

## Setup

First, export your Azure subscription id as an environment variable:

```console
export ID=<your-subscription-id>
```

Second, create the Azure resource group and required AML resources:

```console
python setup-workspace.py --subscription-id $ID
```

This will create a resource group named `azureml-template`, a workspace named `default`, and a cluster named `cpu-cluster`. Edit `setup-workspace.py` as needed. If you change the names, ensure you change corresponding names in the `.github/workflows` files and in the third step below.

Third, create a service principal for the resource group:

```console
az ad sp create-for-rbac --name "azureml-template" \
                         --role contributor \
                         --scopes /subscriptions/$ID/resourceGroups/azureml-template \
                         --sdk-auth
```

Copy the output json, which looks like this:

```console
{
    "clientId": "<GUID>",
    "clientSecret": "<GUID>",
    "subscriptionId": "<GUID>",
    "tenantId": "<GUID>",
    (...)
}
```

In your repository, navigate to "Settings > Secrets > New Secret". Name the secret `AZ_CREDS` and paste the json output from above. This is used in the Azure login action in the GitHub Actions. If you use a different name for the secret, ensure you change the corresponding names in the `.github/workflows` files.

## Contents

Adapt this template to automate the entire ML lifecycle on GitHub, using AML for centralized tracking and scaling up/out on Azure compute.

## GitHub Actions

Modify all files as needed.

**Actions**:

- [`.github/workflows/smoke.yml`](.github/workflows/smoke.yml) runs on every PR and push to `main` to check code format
- [`.github/workflows/cleanup.yml`](.github/workflows/cleanup.yml) runs daily and can be used to cleanup AML resources
- [`.github/workflows/run-workflows.yml`](.github/workflows/run-workflows.yml) runs a ml workflow every two hours and push/PR to `main`

**Other**:

- [`requirements.txt`](requirements.txt) specifies required pip packages for GitHub actions
- [`setup-workspace.py`](setup-workspace.py) can be modified for workspace and resource setup
- [`cleanup.py`](cleanup.py) can be modified for nightly workspace cleanup tasks
- [`workflows/basic/job.py`](workflows/basic/job.py) is the AML control code
- [`workflows/basic/src/train.py`](workflows/basic/src/train.py) is the ML training script with mlflow tracking
- [`workflows/basic/requirements.txt`](workflows/basic/requirements.txt) specifies required pip packages for the training script

## Reference

- [Azure Machine Learning Examples](https://github.com/Azure/azureml-examples)
- [Cheat Sheet, VSCode Snippets, and Templates](https://azure.github.io/azureml-web)
- [Azure Machine Learning Documentation](https://docs.microsoft.com/azure/machine-learning)

azureml-template

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README