华为云 CodeArts 流水线:从手工部署到自动化发布
项目原来发布靠手工:本地打包、scp 上传、ssh 上去重启。一次发布二十分钟,还容易漏步骤。接了 CodeArts 之后做到一键发布。这篇记录配置过程和实际收益。
CodeArts 包含什么
一套 DevOps 工具链:
| 服务 | 用途 |
|---|---|
| CodeArts Repo | 代码托管(Git) |
| CodeArts Check | 代码检查 |
| CodeArts Build | 编译构建 |
| CodeArts Deploy | 部署 |
| CodeArts Pipeline | 流水线编排 |
| CodeArts TestPlan | 测试管理 |
| CodeArts Artifact | 制品仓库 |
可以只用其中几个,也可以串起来用。我们用的是 Repo + Build + Deploy + Pipeline。
第一步:代码托管
可以迁到 CodeArts Repo,也可以继续用 GitHub/GitLab,通过 webhook 触发。
我们代码在自建 GitLab,所以用 webhook 方式:
在 CodeArts Pipeline 里创建流水线,源选择「GitHub」或者「通用 Git」,填仓库地址和凭据。
凭据配置:SSH key 或者 access token。推荐用 token,好撤销。
第二步:编译构建
「构建任务」定义怎么把代码变成可部署的产物。
以 Go 项目为例:
version: 2.0
steps:
- name: build
image: golang:1.23
commands:
- export GOPROXY=https://goproxy.cn,direct
- go mod download
- CGO_ENABLED=0 GOOS=linux go build -trimpath -ldflags="-s -w" -o app ./cmd/server
- name: package
commands:
- tar -czf app.tar.gz app config/
artifacts:
- name: app-package
path: app.tar.gz
关键点:
image指定构建环境。用官方镜像省得自己装工具链。artifacts定义产物,会传到制品仓库,供部署环节使用。- 构建日志会完整保留,出问题能回看。
如果构建慢,可以把依赖缓存在制品仓库或者用自建缓存。
第三步:部署
「部署任务」定义怎么把产物放到服务器。
方式一:主机部署
适合传统 ECS 部署。
version: 2.0
env:
hosts:
- 192.168.1.10
- 192.168.1.11
steps:
- name: stop-service
script: |
systemctl stop myapp || true
- name: deploy
script: |
cd /opt/myapp
tar -xzf /tmp/app.tar.gz
chmod +x app
- name: start-service
script: |
systemctl start myapp
sleep 3
systemctl is-active myapp
sleep 3 后检查服务状态——如果启动失败,部署任务会失败,不会静默通过。
方式二:容器部署
推到 CCE 或 SWR,用 kubectl 或平台的部署能力。
steps:
- name: build-image
script: |
docker build -t $REGISTRY/myapp:$BUILD_NUMBER .
docker push $REGISTRY/myapp:$BUILD_NUMBER
- name: deploy
script: |
kubectl set image deployment/myapp myapp=$REGISTRY/myapp:$BUILD_NUMBER
kubectl rollout status deployment/myapp --timeout=300s
rollout status 会等滚动更新完成,超时则失败。
第四步:编排流水线
把构建和部署串起来:
version: 2.0
stages:
- name: 构建
jobs:
- build-job
- name: 部署测试环境
jobs:
- deploy-test
- name: 部署生产
jobs:
- deploy-prod
approval: true
approval: true 是关键——生产部署需要人工审批。测试环境自动过,生产环境点一下确认。
审批人可以指定具体的人或角色,审批记录会留痕。
一次完整的发布流程
1. 开发提交代码到 feature 分支
2. 提 MR,触发代码检查
3. 合并到 develop 分支
4. 自动触发流水线:
- 编译
- 单测
- 构建镜像
- 部署到测试环境
5. 测试验证
6. 合并到 master
7. 自动触发生产流水线:
- 编译
- 构建镜像
- 等待审批
- 审批通过 → 部署生产
8. 部署后自动化冒烟测试
整个流程从「人工二十分钟」变成「审批点一下 + 等待三分钟」。
踩过的坑
坑一:构建环境没网
默认构建环境能访问外网,但如果项目配了 VPC,可能出不去。
解决:构建任务里指定「使用公网」或者配置 VPC 终端节点。
坑二:凭据权限过大
部署用的 SSH 凭据如果给了 root,一旦流水线配置被人改了,等于把服务器交出去了。
建议:部署用户只给必要权限(能写 /opt/myapp、能重启指定服务),不要给 root。
坑三:部署脚本没有失败退出
# 错:出错继续往下走
tar -xzf app.tar.gz
systemctl restart myapp
# 对:出错立即退出
set -e
tar -xzf app.tar.gz
systemctl restart myapp
没有 set -e 的话,解压失败也会继续重启服务,最后服务起不来但流水线显示成功。
坑四:回滚没做准备
部署失败要能快速回滚。两种做法:
- 保留上一版本产物,回滚时重新部署旧版本
- 部署前打快照,回滚时恢复
我们用的是方案 1——每次构建的产物都存制品仓库,带版本号,回滚就是重新部署上一个版本号。
坑五:环境变量管理混乱
数据库密码、API key 这些不该写在代码里,也不该写在构建脚本里。
CodeArts 有「参数管理」,可以定义加密参数,流水线里引用。这样配置和代码分离,换环境只改参数。
收益
| 项 | 之前 | 之后 |
|---|---|---|
| 单次发布耗时 | 20 分钟 | 3 分钟(含审批) |
| 发布频率 | 每周 1 次 | 每天 2-3 次 |
| 人为失误 | 偶尔漏步骤 | 无(流程固定) |
| 回滚耗时 | 15 分钟 | 2 分钟 |
最大的变化不是速度,是敢发布了。以前怕出事,一周发一次,攒一堆改动一起上,出问题难定位。现在小步快跑,出问题回滚成本低。
值不值得上
值得:
- 团队超过 3 人,发布需要协作
- 发布频率高于每周一次
- 有测试环境和生产环境的区分
不值得:
- 个人项目,一周发一次
- 单机部署,手工操作两分钟搞定
- 团队没人维护流水线(流水线也会坏)
流水线本身需要维护——依赖升级、镜像更新、凭据轮换。没有专人管的话,半年后就跑不起来了。
小结
CodeArts 的价值在于「把发布流程固化下来」。流程一旦固定,就变成了可重复、可审计、可优化的事情。
上手建议:先自动化「构建」这一步(收益最直接),再自动化「部署」,最后加「审批」和「测试」。一次性全上容易卡在细节里。
- 点赞
- 收藏
- 关注作者
评论(0)