You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
title: Create a Training Job with the job creation UI
2
+
title: Create a Training Job with the Job Creation UI
3
3
titleSuffix: Azure Machine Learning
4
-
description: Learn how to submit a training job in Azure Machine Learning studio
4
+
description: Learn how to submit a training job in the Azure Machine Learning studio by using the job creation UI.
5
5
services: machine-learning
6
6
ms.service: azure-machine-learning
7
7
ms.subservice: training
8
8
ms.topic: how-to
9
9
ms.custom: devplatv2
10
10
author: ssalgadodev
11
11
ms.author: ssalgado
12
-
ms.date: 02/04/2024
12
+
ms.date: 03/28/2025
13
13
ms.reviewer: amipatel
14
14
---
15
15
16
-
# Submit a training job in studio
16
+
# Submit a training job in the Azure Machine Learning studio
17
17
18
-
There are many ways to create a training job with Azure Machine Learning. You can use the CLI (see [Train models (create jobs)](how-to-train-model.md)), the REST API (see [Train models with REST (preview)](how-to-train-with-rest.md)), or you can use the UI to directly create a training job. In this article, you learn how to use your own data and code to train a machine learning model with a guided experience for submitting training jobs in Azure Machine Learning studio.
18
+
There are many ways to create a training job with Azure Machine Learning. You can train models by using the [Azure CLI](how-to-train-model.md), the [REST API](how-to-train-with-rest.md), or you can use the studio UI to directly create a training job.
19
+
20
+
In this article, you learn how to use your own data and code to train a machine learning model with a guided experience for submitting training jobs in the Azure Machine Learning studio.
* An Azure subscription. If you don't have an Azure subscription, create a free account before you begin. Try the [free or paid version of Azure Machine Learning](https://azure.microsoft.com/free/machine-learning/search/)today.
26
+
* An Azure subscription. If you don't have an Azure subscription, create a [free Azure account](https://azure.microsoft.com/free/machine-learning/search/)before you begin.
25
27
26
-
* An Azure Machine Learning workspace. See [Create workspace resources](quickstart-create-resources.md).
28
+
* An Azure Machine Learning workspace. To learn how, see [Create workspace resources](quickstart-create-resources.md).
27
29
28
-
*Understanding of what a job is in Azure Machine Learning. See[how to train models](how-to-train-model.md).
30
+
*An understanding of what a training job is in Azure Machine Learning. To learn more, see[how to train models](how-to-train-model.md).
29
31
30
32
## Get started
31
33
32
-
1. Sign in to [Azure Machine Learning studio](https://ml.azure.com).
34
+
1. Sign in to the [Azure Machine Learning studio](https://ml.azure.com), then select your subscription and workspace.
33
35
34
-
1. Select your subscription and workspace.
36
+
1.Enter the job creation UI from the homepage. Select **New +** and choose **Training job**.
35
37
36
-
37
-
* You may enter the job creation UI from the homepage. Select **Create new** and select **Job**.
38
-
[](media/how-to-train-with-ui/unified-job-submission-home.png)
38
+
:::image type="content" source="media/how-to-train-with-ui/unified-job-submission-home.png" alt-text="Screenshot that shows the Azure Machine Learning studio homepage.":::
39
39
40
-
In this step, you can select your method of training, complete the rest of the submission form based on your selection, and submit the training job. Below we walk through the form with the steps for running a custom script (command job).
40
+
1. Select your method of training, complete the rest of the submission form based on your selection, and then submit the training job. In the next section, we walk through the form with the steps for running a custom script (command job).
41
41
42
-
[](media/how-to-train-with-ui/training-method.png)
42
+
:::image type="content" source="media/how-to-train-with-ui/training-method.png" alt-text="Screenshot that shows the trainingmethod options on the Azure Machine Learning studio training form.":::
43
43
44
44
## Configure basic settings
45
45
46
-
The first step is configuring basic information about your training job. You can proceed next if you're satisfied with the defaults we chose for you, or make changes to your desired preference.
46
+
Configure the basic information about your training job. You can proceed next if you're satisfied with the defaults we chose for you, or make changes to your desired preference.
47
47
48
-
[](media/how-to-train-with-ui/basic-settings.png)
48
+
:::image type="content" source="media/how-to-train-with-ui/basic-settings.png" alt-text="Screenshot that shows the basicsettings form for training jobs.":::
49
49
50
-
These are the fields available:
50
+
The following fields are available:
51
51
52
52
|Field| Description|
53
53
|------| ------|
54
54
|Job name| The job name field is used to uniquely identify your job. It's also used as the display name for your job.|
55
-
|Experiment name| This helps organize the job in Azure Machine Learning studio. Each job's run record is organized under the corresponding experiment in the studio's "Experiment" tab. By default, Azure puts the job in the **Default** experiment.|
55
+
|Experiment name| This helps organize the job in Azure Machine Learning studio. Each job's run record is organized under the corresponding experiment in the studio's **Experiment** tab. By default, Azure puts the job in the **Default** experiment.|
56
56
|Description| Add some text describing your job, if desired.|
57
-
|Timeout| Specify number of hours the entire training job is allowed to run. Once this limit is reached the system cancels the job including any child jobs.|
57
+
|Timeout| Specify number of hours the entire training job is allowed to run. After this limit is reached, the system cancels the job including any child jobs.|
58
58
|Tags| Add tags to your job to help with organization.|
59
59
60
60
## Training script
61
61
62
-
Next step is to upload your source code, configure any inputs or outputs required to execute the training job, and specify the command to execute your training script.
62
+
Upload your source code, configure any inputs or outputs required to execute the training job, and specify the command to execute your training script.
63
63
64
-
This can be a code file or a folder from your local machine or workspace's default blob storage. Azure will show the files to be uploaded after you make the selection.
64
+
You can use a code file or a folder from your local machine or workspace's default blob storage. Azure shows the files to be uploaded after you make the selection.
65
65
66
66
|Field| Description|
67
67
|------| ------|
68
-
|Code|This can be a file or a folder from your local machine or workspace's default blob storage as your training script. Studio will show the files to be uploaded after you make the selection.|
69
-
|Inputs| Specify as many inputs as needed of the following types data, integer, number, boolean, string). |
68
+
|Code|A file or a folder from your local machine or workspace's default blob storage as your training script. Studio shows the files to be uploaded after you make the selection.|
69
+
|Inputs| Specify as many inputs as needed of the following types data: integer, number, boolean, string. |
70
70
|Command| The command to execute. Command-line arguments can be explicitly written into the command or inferred from other sections, specifically **inputs** using curly braces notation, as discussed in the next section.|
71
71
72
-
73
72
### Code
74
-
The command is run from the root directory of the uploaded code folder. After you select your code file or folder, you can see the files to be uploaded. Copy the relative path to the code containing your entry point and paste it into the box labeled **Enter the command to start the job**.
73
+
74
+
The command is run from the root directory of the uploaded code folder. After you select your code file or folder, you can see the files to be uploaded. Copy the relative path to the code containing your entry point and paste it into the box labeled **Enter the command to start the job**.
75
75
76
76
If the code is in the root directory, you can directly refer to it in the command. For instance, `python main.py`.
77
77
@@ -84,74 +84,76 @@ If the code isn't in the root directory, you should use the relative path. For e
84
84
└── src
85
85
└── main.py
86
86
```
87
+
87
88
Here, the source code is in the `src` subdirectory. The command would be `python ./src/main.py` (plus other command-line arguments).
88
89
89
-
[](media/how-to-train-with-ui/training-script-code.png)
90
+
:::image type="content" source="media/how-to-train-with-ui/training-script-code.png" alt-text="Screenshot of the files to be uploaded in the training job submission form.":::
90
91
91
92
### Inputs
92
93
93
94
When you use an input in the command, you need to specify the input name. To indicate an input variable, use the form `${{inputs.input_name}}`. For instance, `${{inputs.wiki}}`. You can then refer to it in the command, for instance, `--data ${{inputs.wiki}}`.
94
95
95
-
[](media/how-to-train-with-ui/training-script-inputs.png)
96
+
:::image type="content" source="media/how-to-train-with-ui/training-script-inputs.png" alt-text="Screenshot that shows the input variables in the training job submission form.":::
96
97
97
98
## Select compute resources
98
99
99
-
Next step is to select the compute target on which you'd like your job to run. The job creation UI supports several compute types:
100
+
Select the compute target on which you'd like your job to run. The job creation UI supports several compute types:
100
101
101
-
| Compute Type | Introduction |
102
-
| --- | --- |
103
-
| Compute instance |[What is an Azure Machine Learning compute instance?](concept-compute-instance.md)|
104
-
| Compute cluster |[What is a compute cluster?](how-to-create-attach-compute-cluster.md#what-is-a-compute-cluster)|
| Compute instance |[What is an Azure Machine Learning compute instance?](concept-compute-instance.md)|
105
+
| Compute cluster |[What is a compute cluster?](how-to-create-attach-compute-cluster.md#what-is-a-compute-cluster)|
106
+
| Attached Kubernetes cluster |[Configure and attach Kubernetes cluster anywhere](how-to-attach-kubernetes-anywhere.md)|
107
+
108
+
1. Select a compute type.
106
109
107
-
1. Select a compute type
108
110
1. Select an existing compute resource. The dropdown shows the node information and SKU type to help your choice.
109
-
1. For a compute cluster or a Kubernetes cluster, you may also specify how many nodes you want for the job in **Instance count**. The default number of instances is 1.
110
-
1. When you're satisfied with your choices, choose **Next**.
111
-
[](media/how-to-train-with-ui/compute.png)
111
+
112
+
1. For a compute cluster or a Kubernetes cluster, you can also specify how many nodes you want for the job in **Instance count**. The default number of instances is *1*.
113
+
114
+
1. When you're satisfied with your choices, choose **Next**.
112
115
113
116
If you're using Azure Machine Learning for the first time, you see an empty list and a link to create a new compute. For more information on creating the various types, see:
114
117
115
-
| Compute Type| How to |
116
-
| --- | --- |
117
-
| Compute instance |[Create an Azure Machine Learning compute instance](how-to-create-compute-instance.md)|
118
-
| Compute cluster |[Create an Azure Machine Learning compute cluster](how-to-create-attach-compute-cluster.md)|
119
-
| Attached Kubernetes cluster |[Attach an Azure Arc-enabled Kubernetes cluster](how-to-attach-kubernetes-anywhere.md)|
118
+
| Compute type| How to |
119
+
| --- | --- |
120
+
| Compute instance |[Create an Azure Machine Learning compute instance](how-to-create-compute-instance.md)|
121
+
| Compute cluster |[Create an Azure Machine Learning compute cluster](how-to-create-attach-compute-cluster.md)|
122
+
| Attached Kubernetes cluster |[Attach an Azure Arc-enabled Kubernetes cluster](how-to-attach-kubernetes-anywhere.md)|
120
123
121
124
## Specify the necessary environment
122
125
123
126
After selecting a compute target, you need to specify the runtime environment for your job. The job creation UI supports three types of environment:
124
127
125
128
* Curated environments
126
129
* Custom environments
127
-
* Container registry image
130
+
* Container registry image
128
131
129
132
### Curated environments
130
133
131
-
Curated environments are Azure-defined collections of Python packages used in common ML workloads. Curated environments are available in your workspace by default. These environments are backed by cached Docker images, which reduce the job preparation overhead. The cards displayed in the "Curated environments" page show details of each environment. To learn more, see [curated environments in Azure Machine Learning](resource-curated-environments.md).
134
+
Curated environments are Azure-defined collections of Python packages used in common ML workloads. Curated environments are available in your workspace by default. These environments are backed by cached Docker images, which reduce the job preparation overhead. The cards displayed in the **Curated environments** page show details of each environment. To learn more, see [Azure Machine Learning Curated Environments](resource-curated-environments.md).
132
135
133
-
[](media/how-to-train-with-ui/curated-environments.png)
136
+
:::image type="content" source="media/how-to-train-with-ui/curated-environments.png" alt-text="Screenshot of the curatedenvironments selector page showing various environment cards.":::
134
137
135
138
### Custom environments
136
139
137
-
Custom environments are environments you specified yourself. You can specify an environment or reuse an environment that you already created. To learn more, see [Manage software environments in Azure Machine Learning studio (preview)](how-to-manage-environments-in-studio.md#create-an-environment).
140
+
Custom environments are environments that you specify. You can specify an environment or reuse an environment that you already created. To learn more, see [Manage software environments in Azure Machine Learning studio](how-to-manage-environments-in-studio.md).
138
141
139
142
### Container registry image
140
143
141
-
If you don't want to use the Azure Machine Learning curated environments or specify your own custom environment, you can use a docker image from a public container registry such as [Docker Hub](https://hub.docker.com/).
142
-
144
+
If you don't want to use the Azure Machine Learning curated environments or specify your own custom environment, you can use a docker image from a public container registry such as [Docker Hub](https://hub.docker.com).
143
145
144
-
## Review and Create
146
+
## Review and create
145
147
146
-
Once you configured the job, choose **Next** to go to the **Review** page. To modify a setting, choose the pencil icon and make the change.
147
-
[](media/how-to-train-with-ui/review.png)
148
+
After you configure the job, choose **Next** to go to the **Review** page. To modify a setting, choose the pencil icon and make the change.
148
149
149
-
To launch the job, choose **Submit training job**. Once the job is created, Azure shows you the job details page, where you can monitor and manage your training job.
150
+
:::image type="content" source="media/how-to-train-with-ui/review.png" alt-text="Screenshot that shows the review pane to validate your selections before submission.":::
To launch the job, choose **Submit training job**. After the job is created, Azure shows you the job details page, where you can monitor and manage your training job.
0 commit comments