Cloud Native Build provides out-of-the-box CI/CD capabilities. The core concept is declarative configuration: define a series of tasks to be executed automatically when specific events occur on specific branches.

This guide covers two tasks:

1. Create and run your first pipeline: Experience the complete workflow from code submission to automated build
2. Write a practical PR pipeline: Learn to configure a common pipeline for code quality gating

Part 1: Run Your First Pipeline in 5 Minutes

Step 1: Create a Repository and Enter the Dev Environment

If you don't have a code repository, create one first. After creation, click the Workspace button on the page to quickly create a development environment.

Create Workspace

Select WebIDE to enter the online development environment for a quick start.

Choose WebIDE

Step 2: Create and Submit the Pipeline Config File

1. In the WebIDE, create a file named .cnb.yml at the root of your repository.

2. Copy the following YAML configuration into the file and save it. This configuration defines: When code is pushed to the main branch, automatically run a task that outputs "hello world".

   .cnb.yml

   main:
     push:
       - stages:
           - name: echo-hello
             script: echo "hello world"

3. Commit and Push these changes to the remote main branch.

Submit CI Config

Step 3: View the Pipeline Execution Results

The pipeline will trigger automatically after the push.

1. Return to your repository homepage.
2. Click the Events tab to view all build records.
3. Click on the latest record (triggered by the push event) to view detailed build logs and status.

Congratulations! You've completed your first CI/CD practice.

Part 2: Write a Practical PR Validation Pipeline

Now let's implement a more practical scenario: Configure a Pull Request pipeline for the main branch to automatically perform code checks (lint) and tests (test), and notify the team upon failure.

1. Define the Branch, Event and Tasks

First, specify the target branch (main) and the event (pull_request), then define a pipeline named pr-check with two sequentially executed tasks.

.cnb.yml

main:
  pull_request:
    - name: pr-check
      stages:
        - name: lint
          script: echo "Running linting tools..."
        - name: test
          script: echo "Running test suites..."

2. Define Failure Handling

If any task in the main sequence fails, use failStages to automatically execute alert tasks.

.cnb.yml

main:
  pull_request:
    - name: pr-check
      stages:
        - name: lint
          script: echo "Running linting tools..."
        - name: test
          script: echo "Running test suites..."
      failStages:
        - name: notify-team
          script: echo "Notifying the chat group that the PR check failed!"

Pipeline Execution Logic:

1. Listen for pull_request events on the main branch.
2. Start the pr-check pipeline.
3. Execute the tasks in stages in order (lint → test).
4. If all tasks succeed, the pipeline status is marked as passed.
5. If any task fails, abort immediately and execute the tasks in failStages instead.

Next Steps

• 🔧 Dive Deeper into Configuration: Check out the Configuration Details to explore more advanced features.
• 📖 Master the Full Syntax: Go to the Syntax Guide to learn about all configuration items.
• 🚀 Reference Real-World Examples: Need more inspiration? Visit Best Practices(Open in new window) to fork sample repositories or reuse their configurations to quickly customize your pipeline.

Previous pageIntroduction to Cloud Native Build

Next pageTrigger Rules