Python test and build

Step 1: Create a test build pipeline

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

2. In the Choose a Template dialog box, select Python · Test, build , and then click Create .

Step 2: Configure the pipeline source

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

2. Select Sample Code Source. Set Code Type to Python and click Add.

Step 3: Configure the test stage

In the Test stage, configure tasks for different build clusters and build environments.

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, the build environment is allocated to you. You have full control over the build environment and the job execution script.
   Download Pipeline Source	If you enable this option, 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 Python Unit Test task.

   Configure the test task based on your selected build environment.

   Specified container environment and Default VM environment

   1. Add an Install Python step. Set the Step Name to Install Python and select a Python version for your project, such as 3.7.

   2. Add an Execute Test Command step. In the Execute Command field, enter pip install pytest pytest-html -i https://mirrors.aliyun.com/pypi/simple to install test dependencies, then pytest --ignore=Python --html=report/index.html || true to run tests and generate an HTML report.

   3. In the Unit Test Report step, configure the following parameters.

      Parameter	Description
      Test report file path	Path to the test report file, such as report/index.html. The containing directory is uploaded.
      testing tool	Testing tool or framework, such as Python-Pytest.
      Fail on Error	If enabled, the pipeline stops when a unit test fails. This option is enabled by default.

   Default environment

   Note

   Pipelines created from templates use the specified container environment by default. If you switch to the Default environment, existing task steps become invalid. Clear the original configuration and add the following steps.

   Go to Add Step > Test > Python Unit Test and configure the parameters.

   Parameter	Description
   Step name	A custom name for the step.
   Python version	Select a Python version based on your project requirements.
   Test command	Custom command to run tests and generate reports. Runs from the code repository root and supports pytest-html reports.
   Test report directory	Directory containing the generated test report, such as report. Automatically uploaded for display.
   Test report entry file	Entry file for the report, such as index.html.
   Redline information	Define the success and failure conditions for the task.

   The default test command is pytest --html=report/index.html. In Redline Information, select metrics such as Test Pass Rate and set a comparison condition and threshold (for example, greater than 100).

Step 4: Configure the build stage

In the Python build stage, you can configure build tasks for different build environments.

Step 5: Run the pipeline and check the results

1. After the pipeline completes, the results page shows #2 Succeeded . The visualization displays the Pipeline Source (master branch), Test stage (Python unit test, 21s), and Build stage (Python build, 47s) with the output artifact.

2. Click Logs on a task node to view its execution log. A green checkmark indicates success. For example, the artifact upload log confirms the artifact was uploaded.

3. If you used the Organization-private generic artifact repository, find the artifact in Artifact Repository Packages. Generic artifact management.