Getting Started with Training: Training a Model with One Click
Scenario
This case is only available in the new console.
To lower the usage threshold and enhance user experience, we provide one-click training cases on the ModelArts console. Currently, ModelArts supports SFT and LoRA fine-tuning for the Qwen3-8B, Qwen3-32B, and Qwen3-30B-A3B models, helping you quickly master the model training functions of ModelArts.
After the model training is successful, you can directly use the model for subsequent operations such as model deployment, or create a model again on the training job creation page by referring to this training process as required.
Prerequisites
- You have registered a Huawei Cloud account, completed real-name authentication, and been granted related permissions. For details, see 1. Prerequisites: Accounts and Permissions.
- To use one-click model training, you need to configure the ModelArts FullAccess permission. Otherwise, you cannot access OBS. For details, see Configuring Common Operations Permissions for ModelArts.
Constraints
One-click training is supported only on the new console.
Billing
Model training in ModelArts uses compute and storage resources, which are billed. Compute resources are billed for running training jobs. Storage resources are billed for storing data in OBS or SFS. For details, see Model Training Billing Items.
Procedure
- Log in to the ModelArts console.
- In the navigation pane, choose . In the Popular Models area, select the model you want to train. Click Train on the card. The page for creating a training job is displayed.
Currently, the following models support one-click training.
Table 1 Models that support one-click training Model Name
Model Type
Description
Qwen3-8B
Dense model
Additionally, this model supports seamless switching between thinking and non-thinking modes. You can switch between the two as needed during a dialog. The model's inference capability reaches the SOTA level among models of the same scale in the industry, and its general capability significantly surpasses that of Qwen2.5-7B.
- Quickly configure basic information.
Table 2 Configuring parameters Parameter
Description
Default Value
Model
Create a model on which the training job depends.
Selected model
Name
Job name, which is mandatory.
The system automatically generates a name. You can rename it based on the following naming rules:
- The name contains 1 to 64 characters.
- Only letters, digits, hyphens (-), and underscores (_) are allowed.
Generated randomly
Training Method
Training method used to create a training job.
LoRA fine-tuning
Training Framework
Training framework used to create a training job.
MindSpeed
Model Output Path
Checkpoints and model assets generated by this training task will be saved to this path. The storage address must start with obs:// or / and end with a slash (/). It cannot contain double slashes (//) except in the prefix. For example, obs://bucketname/path/ or /bucketname/path/.
obs://bucketname/path/
Resource Pool Type
- Public resource pool: The public resource pool is available for all tenants and does not require user creation.
- Dedicated resource pool: Dedicated resource pools are created separately and used exclusively. For details, see Creating a Dedicated Resource Pool.
Public resource pool
Resource Pool
This parameter appears only for dedicated resource pools. In the Resource Pool section, click Select Resource Pool and choose your desired dedicated resource pool or logical subpool from the menu on the right. Click OK.
You can view the dedicated resource pool name, node pool specifications, number of available nodes/maximum number of nodes, number of available NPU/GPUs, available CPUs (vCPUs), available memory (GiB), and resource fragments. Hover over View in the Resource Fragment column to check fragment details and check whether the resource pool meets the training requirements.
Once you choose a resource pool, its details appear. To choose a different one, click Reselect.
-
Instance Specifications
Resource instance specifications used to create a training job.
Determines the hardware specifications for the training instances. For Dedicated resource pool, you must select a pool first. For Public resource pool, select a specification directly from the list.
8 x Ascend-snt9b2 | 192 vCPUs | 1536 GiB (modelarts.bm.npu.arm.8snt9b2) or higher is recommended.
8 x Ascend-snt9b2 | 192 vCPUs | 1536 GiB (modelarts.bm.npu.arm.8snt9b2)
Instances
Number of resource instances used to create a training job.
The value range displayed on the GUI is related to the instance specifications.
1
Select Dataset
Dataset used for creating a training job. You can choose Preset Data or My Data. In this example, choose a ModelArts preset dataset.
First dataset option
More Configurations
Environment variables of the training job. For details, see Table 4.
The parameters are set by default.
- Confirm the configuration and price, and click OK. The model training job list page is displayed.
A training job runs for a period of time. On the training job list page, view the basic information about the training job.
- In the training job list, Status of a newly created training job is Pending.
- When the status of a training job changes to Completed, the training job is finished, and the generated model is stored in the corresponding output path.
- If the status is Failed or Abnormal, click the training job name to go to the job details page, and view information such as the model output, task details, events, logs, and resource usage.
After the model training is successful, you can directly use the model for subsequent operations such as model deployment, or create a model again on the training job creation page by referring to this training process as required.
FAQ
For details about common errors and solutions, see Table 3.
| Common Error | Symptom | Possible Cause | Solution |
|---|---|---|---|
| The dataset list is empty when a training job is created. | When a training job is created, the dataset selection box is empty, and no training dataset is available. | The dataset is not published. | Create a training dataset corresponding to the model and publish the dataset in advance. |
| Message "root: XXX valid number is 0" is displayed in training logs. | Message "root: XXX valid number is 0" is displayed in logs, indicating that the number of valid samples in the training set or validation set is 0. For example: INFO: root: Train valid number is 0. | The number of valid samples in the dataset is 0. The possible causes are as follows:
| Check whether the data has been labeled and whether data labels meet algorithm requirements. |
| Message "ValueError: label_map not match" is displayed in training logs. | The training log contains "ValueError: label_map not match" and the label data, for example: ValueError: label_map not match. {1:'apple', 2:'orange', 3:'banana', 4:'pear'} & {1:'apple', 2:'orange', 3:'banana'} | The number of labels in the training set is different from that in the validation set. For example, there are four labels in the training set, and there are only three in the validation set. | Ensure that the number of labels in the training set is the same as that in the validation set. |
| A message is displayed indicating that you do not have the permission to access the OBS bucket. | OBS-related permissions, such as the OBS action obs:bucket:ListAllMyBuckets, have been manually added. However, the system still displays a message indicating that OBS cannot be accessed. | The OBS authorization scope required for ModelArts training is insufficient. | Configure the ModelArts FullAccess permission by referring to "Prerequisites." |
Default Environment Variables
| Parameter | Description | Default Value |
|---|---|---|
| LR | Learning rate. | 1.25e-6 |
| MIN_LR | Minimum learning rate. | 1.25e-7 |
| RUN_TYPE | Training type, for example, lora or sft. | lora |
| MODEL_NAME | Name of the model to train. | qwen3_8b |
| SEQ_LEN | Maximum sequence length to process. The default value is 4096. | 4096 |
| LR_WARMUP_RATIO | Ratio of LR_WARMUP_ITERS to TRAIN_ITERS. LR_WARMUP_ITERS=TRAIN_ITERS * LR_WARMUP_RATIO | 0.01 |
| DATA_TYPE | Choose one of the following values based on the dataset:
| AlpacaStyleInstructionHandler |
| EPOCH | Defines the number of training epochs, which should be modified based on requirements. An epoch is a process where all training samples are trained once. | 4 |
| GBS | The total number of samples processed across all servers in one training step. It affects the duration of each iteration. | 16 |
| LORA_R | In the LoRA matrix, the rank value is used to measure the complexity and information amount of the matrix. A larger value enhances the representation capability of the model, but increases the training duration. A smaller value reduces the number of parameters and the overfitting risk. | 16 |
What is your overall rating for this page?
Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot