rancher/drone

Drone 中文技术文档

一、镜像概述和主要用途

Drone 是一款开源的持续集成/持续部署（CI/CD）工具，旨在自动化软件开发流程中的构建、测试和部署环节。通过与 GitHub、GitLab、Bitbucket 等主流代码托管平台集成，Drone 可监听代码仓库事件（如提交、合并请求），自动触发预定义的构建流程，帮助开发团队提升开发效率、缩短交付周期。

二、核心功能和特性

• 多数据库支持：默认使用 SQLite 数据库，同时兼容 PostgreSQL 和 MySQL，满足不同规模项目的存储需求。
• 多平台集成：支持与 GitHub、GitHub Enterprise、GitLab、Bitbucket 等代码托管平台对接，实现代码事件的自动响应。
• 灵活配置方式：支持通过 TOML 配置文件或环境变量自定义系统参数，适配不同部署场景。
• 安全增强：提供 SSL 加密配置、会话密钥管理（含过期时间设置），保障数据传输和访问安全。
• 可扩展架构：支持配置多个 Worker 节点，分布式执行构建任务，提升并发处理能力。
• 用户注册控制：可通过配置开关控制是否允许用户自助注册，适配团队管理需求。

三、使用场景和适用范围

适用场景

• 开发团队自动化代码构建、测试、部署流程；
• 监听代码仓库提交/合并事件，自动触发构建验证；
• 集成邮件通知（SMTP 配置），实时反馈构建结果。

适用范围

• 系统环境：支持 Ubuntu、Debian、CentOS、RedHat 等 Linux 发行版；
• 项目规模：中小型软件开发项目，或对 CI/CD 流程有轻量化需求的团队；
• 技术栈：兼容各类编程语言和构建工具，需通过 .drone.yml 定义项目构建流程。

四、系统要求

• Docker：需预先安装 Docker 环境；
• AUFS 存储驱动：推荐使用 AUFS 作为 Docker 存储驱动，可通过以下命令验证：

  bash
  sudo docker info | grep Driver:
  

  输出结果中需包含 aufs。

五、安装与部署

5.1 安装说明

注意：当前项目处于 Alpha 阶段，稳定性有待验证，生产环境使用需谨慎。

Ubuntu/Debian

bash
wget downloads.drone.io/master/drone.deb
sudo dpkg -i drone.deb

CentOS/RedHat

bash
wget downloads.drone.io/master/drone.rpm
sudo yum localinstall drone.rpm

5.2 Docker 部署示例

通过 Docker 运行 Drone（需提前准备配置文件）：

bash
docker run -d \
  --name drone \
  -p 8000:8000 \
  -v /etc/drone/drone.toml:/etc/drone/drone.toml \
  -v /var/run/docker.sock:/var/run/docker.sock \
  drone/drone:latest \
  droned --config=/etc/drone/drone.toml

六、详细配置说明

6.1 数据库配置

Drone 默认使用 SQLite 数据库（自动创建），同时支持 PostgreSQL 和 MySQL，需通过配置文件指定。

配置示例（TOML 格式）

toml
# PostgreSQL 配置
[database]
driver = "postgres"
datasource = "host=127.0.0.1 user=postgres dbname=drone sslmode=disable"

# MySQL 配置
[database]
driver = "mysql"
datasource = "root@tcp(127.0.0.1:3306)/drone"

6.2 配置文件（TOML）

默认路径：/etc/drone/drone.toml（通过 deb/rpm 包安装时），支持通过 droned --config=/path/to/drone.toml 指定自定义路径。

配置项说明

6.3 环境变量配置

所有配置文件中的参数均可通过环境变量设置，格式为 DRONE_<配置段>_<字段名>（嵌套配置段用下划线连接）。示例如下：

bash
# 数据库配置
export DRONE_DATABASE_DRIVER="mysql"
export DRONE_DATABASE_DATASOURCE="root@tcp(127.0.0.1:3306)/drone"

# GitHub 集成
export DRONE_GITHUB_CLIENT="your-client-id"
export DRONE_GITHUB_SECRET="your-client-secret"

# 会话配置
export DRONE_SESSION_SECRET="your-random-secret"
export DRONE_SESSION_EXPIRES="24h"

# 注册控制
export DRONE_REGISTRATION_OPEN=false

七、数据库配置详解

7.1 默认配置（SQLite）

无需额外配置，Drone 会自动在运行目录创建 SQLite 数据库文件（drone.sqlite）。

7.2 PostgreSQL 配置

toml
[database]
driver = "postgres"
datasource = "host=数据库地址 user=用户名 dbname=数据库名 password=密码 sslmode=disable"

需提前创建数据库（如 drone），并确保用户有读写权限。

7.3 MySQL 配置

toml
[database]
driver = "mysql"
datasource = "用户名:密码@tcp(数据库地址:端口)/数据库名?charset=utf8mb4"

示例："root:password@tcp(127.0.0.1:3306)/drone?charset=utf8mb4"

八、GitHub 集成步骤

1. 创建 GitHub OAuth 应用

• 访问 https://github.com/settings/applications/new%EF%BC%8C%E5%A1%AB%E5%86%99%E5%BA%94%E7%94%A8%E4%BF%A1%E6%81%AF%EF%BC%9A
  • Homepage URL：Drone 服务地址（如 http://drone.example.com:8000）；
  • Authorization callback URL：http://drone.example.com:8000/api/auth/github.com。

2. 配置 Drone

将 GitHub OAuth 应用的 Client ID 和 Secret 填入配置文件或环境变量：

toml
# 配置文件方式
[github]
client = "your-github-client-id"
secret = "your-github-client-secret"

bash
# 环境变量方式
export DRONE_GITHUB_CLIENT="your-github-client-id"
export DRONE_GITHUB_SECRET="your-github-client-secret"

九、升级说明

• 从 0.2 版本升级：0.2 版本数据库结构存在重大变更，无自动化迁移工具，需重新部署并初始化新实例；
• 稳定性建议：0.2 版本因重构可能存在不稳定性，建议生产环境等待主分支稳定后再升级。

十、项目构建配置

项目需在根目录添加 .drone.yml 文件定义构建流程，详细语法可参考 https://github.com/drone/drone/blob/v0.2.1/README.md#builds%EF%BC%88%E6%B3%A8%EF%BC%9A%E5%BD%93%E5%89%8D%E9%A1%B9%E7%9B%AE%E5%A4%84%E4%BA%8E Alpha 阶段，语法可能更新）。