Help Center/ CodeArts Build/ User Guide/ Managing Build Tasks
Updated on 2026-02-11 GMT+08:00
View PDF
Share

Managing Build Tasks

Before operating on any build task, you must have the necessary permissions.

Editing a Build Task

  1. Access the CodeArts Build homepage from the project page.
  2. Search for the desired task in the build task list.
  3. Locate the desired task, click , and choose Edit from the drop-down list.
    • The basic information page lets you define the core attributes of the task, including its name, code source, repository, default branch, and description.
    • The build actions page lets you modify build actions and their associated parameters.
    • The parameters page lets you configure custom parameters that influence how the task executes.
    • The schedule page lets you configure continuous integration (CI) triggers and scheduled executions.
    • The change history page records task modifications. Click Compare Difference to see what has changed from the previous versions.
    • The permissions page lets you configure permissions for different roles.
    • The notifications page lets you set up notifications for key events in a task's lifecycle (including build success, build failure, task deletion, configuration updates, and moments when a task is disabled).
  4. After adjusting the required settings across these pages, click Save to apply your changes.

Deleting the Build Task

Locate the desired task, click , and choose Delete from the drop-down list. Exercise caution when performing this operation.

Deleted build tasks are retained in the recycle bin. To access them, navigate to the upper-right corner of the CodeArts Build homepage, click More and select Recycle Bin from the drop-down list.

The recycle bin displays deleted build tasks and allows the following operations.

Operation

Description

Modify the task retention period

Click the select box next to Task Retention Period and select from 1 to 30 days.

Search for a task

Enter a keyword in the search box and click . Matching results will appear on this page.

Delete a task

Select a desired task and click Delete. The task will be permanently deleted from the recycle bin.

Restore a task

Select a desired task and click Restore. The task will reappear in the task list.

Clear the recycle bin

Click Empty Recycle Bin. All retained tasks will be deleted from the recycle bin.

Cloning the Build Task

  1. Locate the desired task, click , and choose Clone from the drop-down list.
  2. On the displayed page, modify the task information as needed, and click Save to create a clone of the build task.

    If you want the cloned task to run after creation, select Save and Execute.

Cloning a task will duplicate all of its permissions. The new task has identical access control settings as the original.

Disabling a Task

  • A build task that is currently in progress cannot be disabled or deleted.
  • Once a task is disabled, a Disabled label appears next to its name. To enable it again, locate the task, click , and choose Enable from the drop-down list.
  1. Locate the desired task, click , and choose Disable from the drop-down list.
  2. In the displayed Disable Task dialog box, enter the reason and click OK.

Favoriting the Build Task

  • Favorited tasks will appear at the top of the task list the next time you refresh or revisit the page. When multiple tasks are favorited, they are ordered by creation time in descending sequence.
  • If you favorite a task created by another user, you will receive notifications according to the task's configured event rules.
  1. Locate the desired task, hover over its row, and click . A color change indicates the action was successful.
  2. (Optional) Click to unfavorite the task.
  • After you follow a build task, the task is displayed on the top of the task list when you refresh the page or access the task list next time. If you follow many build tasks, the tasks are sorted by task creation time in descending order.
  • If you follow a task that is not created by yourself, you can obtain the corresponding notification based on the notification event type set for the task.

Stopping a Build Task

  1. Click the name of a running build task. The Build History page is displayed.
  2. Click the Build ID.
  3. On the displayed page, click Stop in the upper right corner.

Managing Build Tasks in Batches

Check the boxes next to the desired build tasks. In the displayed dialog box, you can click different buttons to perform batch operations on the selected build tasks: Move To changes the group of the build tasks to a specified one. Permissions sets permissions for build task roles. Delete removes the build tasks.

Figure 1 Managing build tasks in batches