Go test and build

Step 1: Create a test and build pipeline

1. Log on to the Alibaba Cloud DevOps console and click Create Pipeline in the upper-right corner.

2. In the Select Pipeline Template dialog box, select Go · Test, Build, and then click Create.

Step 2: Configure pipeline source

1. In the Pipeline Source stage, click Add Pipeline Source.

2. Select Sample Code Source, set Code Type to Go, and click Add.

Step 3: Configure test job

Flow runs test jobs in separate Test stages. Each job can use a different build cluster and build environment.

1. Configure the basic parameters.

   Parameter	Description
   Job Name	Enter a custom name for the job, or use the default.
   Build Cluster	The following build clusters are supported: Alibaba Cloud DevOps default build cluster Private build cluster
   Build Environment	The following build environments are supported: Specify Container Environment (for Alibaba Cloud DevOps default build cluster): Flow starts a specified container on the build machine and performs the build in that single-container environment. Alibaba Cloud DevOps provides a list of official images. You can also specify your own image as the runtime environment. Default VM Environment (supported only for private build clusters): You must select Specify Build Nodes. Flow installs the environment and runs the job directly on the build machine. To speed up the job, we recommend installing the required SDKs and environment on the build machine in advance. Default Environment (for Alibaba Cloud DevOps default/private build cluster): Flow uses different default container images based on the job type. These images come pre-installed with the necessary SDKs and environments and cannot be modified. (Deprecated) Note During job execution, you have full control over the build environment and the job execution script.
   Download Pipeline Source	If enabled, the configured code source is downloaded to the corresponding working directory. The available options are: Download All Pipeline Sources Do Not Download Pipeline Sources Download Selected Pipeline Sources

2. Configure the Go unit test job.

   Configure the test job for the build environment you selected.

   Container and VM environments

   1. In the Install Go step, select an appropriate Golang Version for your project and set the GOPATH environment variable to your Go workspace directory.

   2. Add and configure the Execute Test Command step. Set the Step name to Execute Test Command, and in the Execute Command field, enter the shell commands. For example, use mkdir -p golang-report to create a report output directory, and then run go test to execute unit tests, outputting the results as a jsonl report.

   3. In the Unit test report step, configure the following parameters.

      Parameter	Description
      Test report file path	The path to the test report file. Must point to a specific file. The directory containing this file is uploaded automatically. Example: golang-report/report.jsonl.
      Test tool	The testing tool or framework used. Example: Golang-Test.
      Fail on error	When enabled, the pipeline stops if a unit test fails. Enabled by default.

   Default environment

   Note

   By default, the pipeline template uses the specified container environment. If you switch to the Default environment, the existing job steps become invalid. You must clear the existing configuration and add the required steps again.

   Navigate to Add Step > Test > Golang Unit Test, and configure the parameters.

   Parameter	Description
   Step name	A custom name for the step.
   Go version	Select a Go version based on your project requirements.
   Test command	The command to run tests and generate a unit test report.
   Test report directory	The directory where the HTML test report is generated. The pipeline uploads all files from this directory. Example: golang-report.
   Test report file	The test report file generated by Golang, such as report.jsonl. The pipeline parses and displays the report content.
   Test report entry file	The entry file for the HTML test report, such as index.html. This page opens by default when you access the generated report link.
   Quality gate	Conditions that determine whether the job succeeds or fails.

   For example, set Go version to go1.14.x, configure the Test command with export GOPROXY, mkdir -p golang-report, and go test ./... -v -json > golang-report/report.jsonl to generate a test report, and set a quality gate rule requiring 100% test pass rate.

Step 4: Configure build job

In the Go build stage, configure the build job for the build environment you selected.

Step 5: Run pipeline and view results

1. After configuring the pipeline, click Save and Run in the upper-right corner, and then click Run in the dialog box to start the pipeline job.

2. After the pipeline finishes, click Logs in the lower-right area of the job node to view the execution log. The Recent Runs page shows the run details: the pipeline source section shows the code repository and branch, the Test stage shows Go unit test results including line coverage and pass rates, and the Build stage shows Go build results and the generated artifact, such as Artifacts_3428715.

3. If you uploaded the artifact to a private generic artifact repository, you can view it in the corresponding repository in Packages. For more information, see Manage generic artifacts.