Updated on 2026-01-08 GMT+08:00

Managing Build Tasks

Ensure you have the required permissions before you perform operations on build tasks.

Editing a Build Task

  1. Search for the target build task.
  2. In the row of the target build task, click and select Edit from the drop-down list.
    • On the Basic Information tab page, configure the task name, code source, source code repository, branch, and task description.
    • On the Build Actions tab page, modify build steps and parameters.
    • On the Parameters tab page, customize parameters for running the build task.
    • On the Schedule tab page, configure continuous integration (the triggering event) and scheduled execution.
    • On the Change History tab page, view the change history of the build task.
    • On the Permissions tab page, configure permissions for different roles.
    • On the Notifications tab page, configure notifications for different event types (including Build succeeded, Build failed, Task deleted, Task configurations updated, and Task disabled).
  3. Edit the information on a tab page, and click Save.

Deleting the Build Task

Click in the row that contains the target build task and select Delete from the drop-down list. Exercise caution when performing this operation.

You can view the deleted build task in the recycle bin. In the upper right corner of the CodeArts Build homepage, click More and select Recycle Bin from the drop-down list.

The page displays deleted build tasks and allows the operations listed in the following table.

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 to search.

Delete a task

Select the task to be deleted from the list and click Delete to delete the task from the recycle bin.

Restore a task

Select the task to be restored from the list and click Restore. Then you can find this task again in the task list of CodeArts Build.

Clear the recycle bin

Click Empty Recycle Bin to delete all tasks from the recycle bin.

Cloning the Build Task

  1. Click in the row of the build task and select Clone from the drop-down list.
  2. On the page that is displayed, modify the task information and click Clone.

Cloning a task retains the permission matrix of the original task.

Disabling a Task

  1. Click in the row that contains the target build task and select Disable from the drop-down list.
  2. In the displayed Disable Task dialog box, enter the reason and click OK.
    • Build tasks that are running cannot be disabled or deleted.
    • After a build task is disabled, Disabled is displayed next to the build task name. To run the build task, click in the row that contains the build task and select Enable from the drop-down list.

Favoriting the Build Task

  1. Move the cursor to row that contains the target build task and click . If the color of the icon changes, the task is successfully favorited.
  2. (Optional) Click to unfavorite the task.
  • After you favorite 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 favorite many build tasks, the tasks are sorted by task creation time in descending order.
  • If you favorite 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.