Drone CI 中文文档

与 Gogs 集成

本文介绍如何为 Gogs 安装 Drone Server。Server 被打包为一个最小的 Docker 镜像,发布在 DockerHub 上。

请注意,我们强烈建议将 Gitea 与 Drone 一起使用。Gitea 与 Drone 的兼容性更好,某些功能可能不适用于 Gogs。

下载 Drone Server

Drone Server 使用轻量的 Docker 镜像分发。镜像包含自身运行的所有程序,没有任何外部依赖。使用 latest 标签可以确保你使用的 Drone 始终是最新版本。

$ docker pull drone/drone:2

配置

Drone Server 使用环境变量进行配置。本文引用了配置选项的子集,具体定义如下。有关配置选项的完整列表,请参阅 配置

  • DRONE_GOGS_SERVER
    必填项,提供你的 Gogs 服务器地址。例如 https://gogs.company.com
  • DRONE_GIT_ALWAYS_AUTH
    可选项,配置值为布尔值,用于配置 Drone 在克隆公共存储库时是否进行身份验证。
  • DRONE_RPC_SECRET
    必填项,提供在上一步中生成的共享密钥。这用于验证 Server 和 Runner 之间的 rpc 连接。必须为 Server 和 Runner 提供相同的秘密值。
  • DRONE_SERVER_HOST
    必填项,提供你的外部主机名或 IP 地址,例如 drone.company.com。如果使用 IP 地址,你可以包括端口。
  • DRONE_SERVER_PROTO
    必填项,提供你的外部协议方案。此值应设置为 httphttps。如果你配置 ssl 或 acme,此字段默认为 https如果你将 Drone 部署在负载均衡或带有禁止 SSL 的反向代理后面,则此值应设置为 https

启动 Drone Server

你可以使用以下命令启动 Server 容器。容器是通过环境变量配置的。有关配置参数的完整列表,请参阅 配置参考记住用适当的值替换下面的占位符值。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
docker run \
  --volume=/var/lib/drone:/data \
  --env=DRONE_AGENTS_ENABLED=true \
  --env=DRONE_GOGS_SERVER=https://gogs.company.com \
  --env=DRONE_RPC_SECRET=super-duper-secret \
  --env=DRONE_SERVER_HOST=drone.company.com \
  --env=DRONE_SERVER_PROTO=https \
  --publish=80:80 \
  --publish=443:443 \
  --restart=always \
  --detach=true \
  --name=drone \
  drone/drone:2

安装 Runner

一旦你的 Drone Server 启动并运行,你将需要安装 Runner 来执行你的构建 Pipeline。有关详细的安装说明,请参阅我们的 Runner 安装文档。

安装 Runner

登陆 Drone

你可以通过访问浏览器中的服务器地址来登录你的 Drone 服务器。你需要使用你的 Gogs 用户名和密码进行身份验证。这是必需的,因为 Gogs 不支持 OAuth。