microsoft / azureml-r-template Goto Github PK

Patterns and examples for running R code with Azure Machine Learning

License: MIT License

Dockerfile 16.89% R 76.11% Shell 7.00%

azureml-r-template's Introduction

Azure Machine Learning R Template

This repo provides examples for using R with Azure Machine Learning. While an Azure Machine Learning SDK for R exists, this SDK will be deprecated in the near future. This goal of this repository is to provide examples for running R in Azure Machine Learning without a dependency on an R SDK by using supported AzureML CLI and YAML interfaces where possible.

Current examples for running R using the AML CLI include:

Creating R environments for using AmlCompute
Onboarding existing R code to migrate to Azure ML

[Note: the examples in the main branch are based on the AzureML CLI v2, currently in preview. This offers a simpler and more reliable approach to running R in AzureML but updates may introduce breaking changes. For a supported approach, refer to the azureml-cli-v1 branch of this repo. When CLI v2 is released, the v1 branch will be deleted. ]

Getting Started

To begin, start in 00-setup/.

This repo structure is as follows:

File/folder	Description
`.github/workflows`	Folder for GitHub workflows used for MLOps
`00-setup/`	Quick steps to configure an Azure ML environment for running the samples
`01-job/`	Simple AzureML job example to train a model on the penguins dataset
`02-logging/`	Simple AzureML job example to train a model on the penguins dataset with logging to experiment using MLflow
`utils`	Environment setup script run by GitHub workflows

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

azureml-r-template's People

Contributors

Stargazers

Watchers

Forkers

azeltov standardgalactic daniel-barnett wahalulu andreasbotsikas test-mass-forker-org-1 sdonohoo edhotpur

azureml-r-template's Issues

Tracking metrics using mlflow on locally running R session

Hi,

Thanks for your work on these examples - they're extremely useful. Do you know if it possible to log metrics from a locally running R session to Azure ML using MLflow at the moment? Attempting to use any of the mlflow package functions is not possible due to those not including an Azure authentication token to the API call.

Using the Azure ML functions to track should be OK, but would appreciate any thoughts on Azure+MLflow locally using R.

Update main Readme

Getting started README

Need instructions/00-prerequisites.md detailing

environment configuration
sample data upload
move docker image creation from pipeline readme

ACTION REQUIRED: Microsoft needs this private repository to complete compliance info

There are open compliance tasks that need to be reviewed for your AML-R-acceleration-template repo.

Action required: 4 compliance tasks

To bring this repository to the standard required for 2021, we require administrators of this and all Microsoft GitHub repositories to complete a small set of tasks within the next 60 days. This is critical work to ensure the compliance and security of your microsoft GitHub organization.

Please take a few minutes to complete the tasks at: https://repos.opensource.microsoft.com/orgs/microsoft/repos/AML-R-acceleration-template/compliance

The GitHub AE (GitHub inside Microsoft) migration survey has not been completed for this private repository
No Service Tree mapping has been set for this repo. If this team does not use Service Tree, they can also opt-out of providing Service Tree data in the Compliance tab.
No repository maintainers are set. The Open Source Maintainers are the decision-makers and actionable owners of the repository, irrespective of administrator permission grants on GitHub.
Classification of the repository as production/non-production is missing in the Compliance tab.

You can close this work item once you have completed the compliance tasks, or it will automatically close within a day of taking action.

If you no longer need this repository, it might be quickest to delete the repo, too.

GitHub inside Microsoft program information

More information about GitHub inside Microsoft and the new GitHub AE product can be found at https://aka.ms/gim or by contacting [email protected]

FYI: current admins at Microsoft include @sriramgana, @helloMitchell, @ezwiefel, @classicboyir, @sdonohoo, @sqlmartini