🚀 CI/CD 全流程全解

一篇适合设备端开发者、嵌入式工程师、新手工程师的保姆级教程，涵盖从 GitLab CI/CD 搭建到边缘设备部署。

---

🧠 目录

1. CI/CD 简介
2. 环境准备
3. 创建 .gitlab-ci.yml
4. 自定义编译脚本
5. 部署配置 SSH 密钥
6. 流程示意图
7. 调试技巧
8. 实际应用场景

---

CI/CD 简介

缩写	全称	作用
CI	Continuous Integration	自动编译、测试
CD	Continuous Deployment	自动部署、上线

---

环境准备

✅ 安装 GitLab Runner

sudo apt install gitlab-runner
sudo gitlab-runner register

注册信息填写示例：

GitLab URL: https://gitlab.com
Token: <项目Token>
描述: edge-runner
执行器: shell

---

创建 .gitlab-ci.yml

在项目根目录新建：

stages:- build- deployvariables:PROJECT_DIR: "/build/project"build:stage: buildscript:- echo "🔧 开始编译..."- mkdir -p $PROJECT_DIR- cp -r * $PROJECT_DIR- cd $PROJECT_DIR- bash scripts/build_rk3588.shartifacts:paths:- $PROJECT_DIR/output/deploy:stage: deployscript:- echo "🚀 开始部署..."- scp $PROJECT_DIR/output/* root@192.168.1.100:/opt/heahu/- ssh root@192.168.1.100 'systemctl restart heahu.service'

---

自定义编译脚本

scripts/build_rk3588.sh

#!/bin/bash
export TOOLCHAIN=/opt/toolchains/rk3588
export PATH=$TOOLCHAIN/bin:$PATHmkdir -p output
arm-linux-gnueabihf-g++ -o output/main core/main.cpp
cp configs/*.yaml output/

---

部署配置 SSH 密钥

ssh-keygen -t rsa -f deploy_key

将公钥添加到设备 ~/.ssh/authorized_keys

私钥添加到 GitLab 的变量：

变量名	值
SSH_PRIVATE_KEY	deploy_key 内容

.gitlab-ci.yml 添加：

before_script:- 'which ssh-agent || ( apt-get update -y && apt-get install openssh-client -y )'- eval $(ssh-agent -s)- echo "$SSH_PRIVATE_KEY" | tr -d '\r' | ssh-add -- mkdir -p ~/.ssh- chmod 700 ~/.ssh- ssh-keyscan 192.168.1.100 >> ~/.ssh/known_hosts

---

流程示意图

GitLab 提交代码↓
CI Runner 编译构建↓
打包产物↓
部署到设备↓
自动重启服务

---

调试技巧

• GitLab -> CI/CD -> Pipelines -> 查看日志
• 构建失败时添加 echo 输出诊断信息
• 确保 Runner 有权限连接设备

---

实际应用场景

场景	示例
模型更新	提交新 .rknn 自动替换部署
OTA 升级	提交代码后自动部署
一键测试	本地提交触发部署设备

---

如果你还需要 VSCode + GitLab 使用教程、边缘设备系统初始化脚本、部署模型自动更新流程等，欢迎关注后续内容。