Design Principles and Naming Conventions for Deployment Pipelines

A deployment pipeline visualizes the end‑to‑end flow from version control to the user, automatically triggering when code changes enter the repository and progressing through build, test, and deployment stages without manual intervention.

Design Principles : Pipelines should be as simple as possible while satisfying product code‑quality checks; fewer stages lead to faster feedback.

Branch Model Relationship : Each branch (e.g., microservice, app, SDK) typically has its own pipeline. More branches increase pipeline complexity, and each branch should have a corresponding pipeline unless it no longer receives commits.

Pipeline Naming Conventions :

Type label values: RELEASE (regular releases), PRE_RELEASE (pre‑release), HOTFIX (patches), MASTER (mainline), SHARE (shared team branches).

Category label values: MAIN (commit build), SECONDARY (secondary build), INTERVAL (scheduled), RELIABILITY (stability testing).

Typical label combinations include:

type=MASTER category=MAIN

type=SHARE category=INTERVAL

type=MASTER category=SECONDARY

type=MASTER category=RELIABILITY

Task Naming and Metrics :

Unit‑test tasks start with UT- and must report total time, case counts (total, passed, failed, skipped) and coverage metrics.

Code‑check tasks start with CCK- and upload result reports.

Build verification tests start with BVT- and report similar metrics.

Combined unit‑test and BVT tasks may use the UBVT- prefix.

Quality Red Line : A quality gate that enforces standards (e.g., test pass rate ≥ 100%, code‑scan thresholds) and can trigger notifications or manual reviews. Rules must specify name, ID, metric, control point, scope, and action.

Optimizing Build Time : Add parallel stages, analyze stage duration, use incremental or distributed compilation, move heavy tools (e.g., Coverity) to scheduled pipelines, and shift extensive tests to secondary builds.

The article concludes with a brief promotion for a Python‑based continuous deployment training course.