【11-11】基于华为云CodeArts流水线的自动化构建实践

背景

团队项目从本地手工构建迁移到云端流水线后，部署效率明显提升，但迁移过程踩了不少坑。本文以一个 Node.js 服务为例，记录在华为云 CodeArts 上配置自动化流水线的过程。

流水线配置步骤

1. 新建代码仓库并导入代码

在 CodeArts 的代码托管中新建仓库，将本地代码推送到远端。注意 .gitignore 要排除 node_modules 和构建产物，否则首次同步会非常慢。

2. 配置编译构建任务

选择 Node.js 构建模板，核心的构建命令只有两条：

npm install --registry=https://mirrors.huaweicloud.com/repository/npm/
npm run build

使用华为云内部的 npm 镜像源可以显著缩短依赖下载时间。

3. 编排流水线

流水线按"代码检查 → 构建 → 部署"三个阶段串行编排。代码检查阶段开启告警门禁，只有严重级别问题清零才允许进入下一阶段。

两个典型问题

问题一：构建任务超时

首次执行构建时任务在依赖安装阶段超时失败。排查发现默认的 30 分钟超时不够用，且未使用镜像源导致下载缓慢。将超时调整为 60 分钟并切换镜像源后解决。

问题二：产物路径错误

部署阶段一直提示找不到构建产物。原因是构建脚本输出到了 dist/server，而发布配置里填的是 dist。修正产物路径后部署恢复正常。

小结

流水线迁移的核心是三点：镜像源加速、合理的超时配置、准确的产物路径。配置一次，长期受益。