Python test and build

Step 1: Create a test build pipeline

1. Log on to the Flow console. In the upper-right corner, click Create Pipeline.

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	You can specify a custom job name or use the default name.
   Build Cluster	The following build clusters are supported: Alibaba Cloud DevOps default build cluster self-hosted build cluster
   Build Environment	The following build environments are supported: Specify Container Environment (Alibaba Cloud DevOps default build cluster): Flow starts a specified container on the build machine and performs the build in that container. You can select from the provided Flow System Images or specify your own custom image as the runtime environment. Default VM Environment (supported only for self-hosted build clusters): You must select a build node from the Specify Build Nodes list. Flow installs the required environment and runs the job directly on the build machine. To speed up the build process, we recommend that you install the necessary SDKs and environment dependencies on the machine beforehand. Default Environment (Alibaba Cloud DevOps default build cluster/self-hosted build cluster): (Deprecated) Flow uses a default container image based on the job type. The image comes pre-installed with the required SDKs and environment, and cannot be changed. Note During job execution, the build environment is exclusively allocated to you. You have full control over the environment and can customize the execution scripts.
   Download Pipeline Source	When enabled, the configured source files are downloaded to the working directory. The following options are available: 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.