Functions

Configuring Build Environments and Images

CodeArts Build delivers containerized build environments. It supports two types of container images:

• System images: provided by CodeArts Build for compilation and packaging with popular programming languages.
• Custom images: customized for compilation and packaging with multiple languages and stored in SWR.

Managing Build Environments

CodeArts Build allows integration with custom Jenkins resources.

You can manually create pools and agents, as well as execute custom scripts to align with specific requirements. If no custom executor is defined, CodeArts Build automatically defaults to the public executor pool.

For scenarios where the common build environments are insufficient, you can create a custom environment. The workflow typically involves multiple operations. Add all required project dependencies and tools to the base image of your custom environment. Make a Dockerfile. Build a Docker image and push it to SoftWare Repository for Container (SWR). Then, you can leverage the SWR public image.

For details, see Building an Image and Pushing It to SWR, Configuring the Build Environment, and Building with Maven Based on Non-default Dependencies and Uploading the Software Package to a Self-Hosted Repo (Built-in Executors, GUI).

Accelerating Builds

When building with Maven or Gradle, repeatedly downloading dependency packages from repositories can significantly degrade build efficiency. To address this, CodeArts Build leverages shared caching mechanisms that optimize dependency management. During a build, CodeArts Build first attempts to retrieve required dependencies from the shared cache. If the requested package is available, it is reused, accelerating the build process. Only when a dependency is not found in the cache does CodeArts Build fall back to downloading the package from the repository.

Creating a Build Task

CodeArts Build provides an easy-to-use, cloud-based build platform that supports multiple programming languages, helping you achieve continuous delivery with shorter period and higher efficiency. With just a few clicks, you can create, configure, and run build tasks to automate code retrieval, build, and packaging. CodeArts Build also monitors build status in real time to keep you informed of the process.

For details, see Creating a Build Task.

Configuring Code Source

By default, CodeArts Build retrieves code from CodeArts Repo for build execution. To extend beyond these repositories, CodeArts Build leverages service endpoints. They are extensions or plug-ins that enable connectivity to third-party services.

Service endpoints connect CodeArts Build with third-party code repositories. Through these endpoints, CodeArts Build can fetch code from diverse sources. You can create, edit, and delete service endpoints.

For details, see Creating a Build Task with GUI.

Configuring Workflows

CodeArts Build offers flexible options for defining workflows. Besides leveraging built-in system templates, you can also create and maintain custom templates to satisfy specific needs.

If you prefer a visual approach, CodeArts Build also provides GUI-based extensions. They enable direct, intuitive configuration of workflows.

Configuring Parameters

Parameters can be defined as a string or enumerated type, set as private, and configured to allow change at runtime.

By default, each build task is provisioned with the codeBranch parameter along with a set of predefined parameters. The codeBranch parameter, as well as its type and value, can be modified to align with your requirements. You can also define additional custom parameters. Predefined parameters and their values are automatically generated by the system and can be referenced using the ${parameter_name} syntax.

Running a Build Task

Project creators, managers, and developers have flexibility to design and manage execution workflows. They can customize execution solutions, trigger build tasks manually, and define scheduled execution plans.

For details, see Running a Build Task.

Configuring Schedules

With CodeArts Build, you can configure automated triggers and scheduled tasks to enable continuous integration (CI).

For details, see Configuring Schedules.

Examining Build Results

Once a build task completes, you can access detailed insights through logs and visual charts. These outputs provide a clear view of both current and historical build executions, making it easier to check performance and validate outcomes.

For details, see Viewing a Build Task.

Managing Build Tasks

Authorized users, including project creators, managers, and designated developers, can perform task and project management operations. These include creating tasks and project templates, cloning or disabling tasks, and performing soft and hard task deletions through the recycle bin. Besides, these users can also review execution and change histories, manage project members and task-level permissions, and maintain digital certificates.

For details, see Managing Build Tasks.