Linux安装Drone CI教程详解

本文详细解析了在Linux系统上成功部署Drone CI持续集成服务的关键步骤与常见故障排除方法，直击安装失败的核心原因——Docker环境缺失、RPC通信密钥不一致、Gitee OAuth配置错误、Server与Runner混部不当，以及.drone.yml语法或权限问题；通过分步指导验证依赖、生成并同步密钥、正确配置Gitee应用、分离部署Server与Runner、校验配置文件与权限，帮助开发者快速定位并解决从环境搭建到流水线触发的全链路问题，真正实现开箱即用的CI自动化。

如果您在Linux系统上尝试部署Drone CI持续集成服务，但无法完成安装或配置失败，则可能是由于依赖环境缺失、OAuth凭证错误或Server与Runner通信密钥不一致所致。以下是解决此问题的步骤：

一、验证并安装基础依赖

Drone CI运行依赖Docker引擎与Docker Compose，且需确保系统时间同步、SELinux（如启用）策略允许容器网络通信。缺失任一组件将导致Server无法启动或Runner注册失败。

1、执行命令检查Docker是否已安装并运行：docker --version && systemctl is-active docker

2、若未安装Docker，在Ubuntu系统中运行：sudo apt update && sudo apt install docker.io -y && sudo systemctl enable --now docker

3、在CentOS/RHEL系统中运行：sudo yum install -y yum-utils && sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo && sudo yum install docker-ce docker-ce-cli containerd.io -y && sudo systemctl enable --now docker

4、安装Docker Compose（v2）：sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose && sudo chmod +x /usr/local/bin/docker-compose

二、生成并配置RPC通信密钥

Drone Server与Runner之间通过共享密钥进行身份认证与任务调度，密钥不匹配将导致Runner无法连接Server，日志中常见rpc: not authorized错误。

1、在终端中生成32字节十六进制密钥：openssl rand -hex 16

2、将输出结果复制为DRONE_RPC_SECRET值，用于后续Server与Runner的environment配置项

3、确保Server容器启动时包含该环境变量：- DRONE_RPC_SECRET=your_generated_secret_here

4、确保Runner容器启动时使用完全相同的DRONE_RPC_SECRET值，且不可为空或含空格

三、配置Gitee OAuth应用并注入凭证

Gitee作为代码源时，Drone Server需通过OAuth 2.0协议获取仓库读取权限与Webhook事件推送能力；Client ID与Secret填写错误或回调地址不匹配将导致登录页面跳转失败或401授权拒绝。

1、登录Gitee账户，进入【设置】→【第三方应用】→【创建应用】

2、填写应用信息：应用名称设为Drone CI，主页URL为http://your-server-ip:8080，回调地址严格填写为http://your-server-ip:8080/login

3、创建后记录Client ID与Client Secret，二者须原样填入docker-compose.yml中对应字段

4、确认Server环境变量设置完整：DRONE_GITEE_CLIENT_ID、DRONE_GITEE_CLIENT_SECRET、DRONE_GITEE_SERVER=https://gitee.com

四、使用Docker Compose部署Server与Runner分离实例

生产级部署要求Server与Runner运行于不同容器甚至不同主机，避免资源争抢与单点故障；混部在同一容器或使用默认bridge网络可能导致端口冲突或DNS解析异常。

1、创建drone-data持久化目录：mkdir -p ./drone-data

2、编写docker-compose.yml，定义server与runner两个service，network_mode均设为host或共用自定义网络

3、Server服务中挂载./drone-data:/data，并声明以下必需环境变量：DRONE_SERVER_HOST、DRONE_SERVER_PROTO、DRONE_LOGS_DEBUG=true

4、Runner服务镜像使用drone/drone-runner-docker:1，设置DRONE_RPC_PROTO=http、DRONE_RPC_HOST=host.docker.internal:3000（Docker Desktop）或宿主机IP（Linux裸机），并传入相同DRONE_RPC_SECRET

五、校验.drone.yml语法与权限范围

即使Server与Runner成功运行，流水线仍可能因配置文件语法错误或Gitee OAuth权限不足而跳过执行；.drone.yml未被识别通常源于仓库根目录缺失该文件、文件名大小写错误（必须为小写.drone.yml），或Gitee应用未授予public_repo与webhook权限。

1、在项目根目录创建.drone.yml，首行必须为kind: pipeline，不可缩进或添加BOM头

2、检查Gitee OAuth应用的scopes选项，确保勾选public_repo（读取私有仓库）、webhook（管理Webhook）、user_info（获取用户资料）

3、推送文件后，访问Drone Web界面，进入对应仓库页面，点击Activate Repository按钮手动启用

4、触发一次push操作，观察构建日志中是否出现cloning repository字样，而非skipping build: no matching config file

到这里，我们也就讲完了《Linux安装Drone CI教程详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！