Skip to content

Commit c0b58c7

Browse files
authored
Merge pull request #228370 from santiagxf/santiagxf/azureml-clouds
Update how-to-use-mlflow-configure-tracking.md
2 parents f44dab8 + 5e71d90 commit c0b58c7

File tree

1 file changed

+37
-9
lines changed

1 file changed

+37
-9
lines changed

articles/machine-learning/how-to-use-mlflow-configure-tracking.md

Lines changed: 37 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -26,30 +26,30 @@ However, if you are working outside of Azure Machine Learning (like your local m
2626
2727
## Prerequisites
2828

29-
You will need the following prerequisites to follow this tutorial:
29+
You need the following prerequisites to follow this tutorial:
3030

3131
[!INCLUDE [mlflow-prereqs](../../includes/machine-learning-mlflow-prereqs.md)]
3232

3333

3434
## Configure MLflow tracking URI
3535

36-
To connect MLflow to an Azure Machine Learning workspace you will need the tracking URI for the workspace. Each workspace has its own tracking URI and it has the protocol `azureml://`.
36+
To connect MLflow to an Azure Machine Learning workspace, you need the tracking URI for the workspace. Each workspace has its own tracking URI and it has the protocol `azureml://`.
3737

38-
[!INCLUDE [cli v2](../../includes/machine-learning-mlflow-configure-tracking.md)]
38+
[!INCLUDE [mlflow-configure-tracking](../../includes/machine-learning-mlflow-configure-tracking.md)]
3939

4040
## Configure authentication
4141

4242
Once the tracking is set, you'll also need to configure how the authentication needs to happen to the associated workspace. By default, the Azure Machine Learning plugin for MLflow will perform interactive authentication by opening the default browser to prompt for credentials.
4343

4444
The Azure Machine Learning plugin for MLflow supports several authentication mechanisms through the package `azure-identity`, which is installed as a dependency for the plugin `azureml-mlflow`. The following authentication methods are tried one by one until one of them succeeds:
4545

46-
1. __Environment__: it will read account information specified via environment variables and use it to authenticate.
47-
1. __Managed Identity__: If the application is deployed to an Azure host with Managed Identity enabled, it will authenticate with it.
48-
1. __Azure CLI__: if a user has signed in via the Azure CLI `az login` command, it will authenticate as that user.
49-
1. __Azure PowerShell__: if a user has signed in via Azure PowerShell's `Connect-AzAccount` command, it will authenticate as that user.
50-
1. __Interactive browser__: it will interactively authenticate a user via the default browser.
46+
1. __Environment__: it reads account information specified via environment variables and use it to authenticate.
47+
1. __Managed Identity__: If the application is deployed to an Azure host with Managed Identity enabled, it authenticates with it.
48+
1. __Azure CLI__: if a user has signed in via the Azure CLI `az login` command, it authenticates as that user.
49+
1. __Azure PowerShell__: if a user has signed in via Azure PowerShell's `Connect-AzAccount` command, it authenticates as that user.
50+
1. __Interactive browser__: it interactively authenticates a user via the default browser.
5151

52-
[!INCLUDE [cli v2](../../includes/machine-learning-mlflow-configure-auth.md)]
52+
[!INCLUDE [mlflow-configure-auth](../../includes/machine-learning-mlflow-configure-auth.md)]
5353

5454
If you'd rather use a certificate instead of a secret, you can configure the environment variables `AZURE_CLIENT_CERTIFICATE_PATH` to the path to a `PEM` or `PKCS12` certificate file (including private key) and
5555
`AZURE_CLIENT_CERTIFICATE_PASSWORD` with the password of the certificate file, if any.
@@ -91,6 +91,34 @@ export MLFLOW_EXPERIMENT_NAME="experiment_with_mlflow"
9191

9292
---
9393

94+
## Non-public Azure Clouds support
95+
96+
The Azure Machine Learning plugin for MLflow is configured by default to work with the global Azure cloud. However, you can configure the Azure cloud you are using by setting the environment variable `AZUREML_CURRENT_CLOUD`.
97+
98+
# [MLflow SDK](#tab/mlflow)
99+
100+
```Python
101+
import os
102+
103+
os.environ["AZUREML_CURRENT_CLOUD"] = "AzureChinaCloud"
104+
```
105+
106+
# [Using environment variables](#tab/environ)
107+
108+
```bash
109+
export AZUREML_CURRENT_CLOUD="AzureChinaCloud"
110+
```
111+
112+
---
113+
114+
You can identify the cloud you are using with the following Azure CLI command:
115+
116+
```bash
117+
az cloud list
118+
```
119+
120+
The current cloud has the value `IsActive` set to `True`.
121+
94122
## Next steps
95123

96124
Now that your environment is connected to your workspace in Azure Machine Learning, you can start to work with it.

0 commit comments

Comments
 (0)