Drone

基于 DockerCI/CD 工具 Drone 所有编译、测试的流程都在 Docker 容器中进行。

开发者只需在项目中包含 .drone.yml 文件,将代码推送到 git 仓库,Drone 就能够自动化的进行编译、测试、发布。

本小节以 GitHub + Drone 来演示 Drone 的工作流程。当然在实际开发过程中,你的代码也许不在 GitHub 托管,那么你可以尝试使用 Gogs + Drone 来进行 CI/CD

要求

  • 拥有公网 IP、域名 (如果你不满足要求,可以尝试在本地使用 Gogs + Drone)

  • 域名 SSL 证书 (目前国内有很多云服务商提供免费证书)

  • 熟悉 Docker 以及 Docker Compose

  • 熟悉 Git 基本命令

  • CI/CD 有一定了解

新建 GitHub 应用

登录 GitHub,在 https://github.com/settings/applications/new 新建一个应用。

Drone - 图1

接下来查看这个应用的详情,记录 Client IDClient Secret,之后配置 Drone 会用到。

配置 Drone

我们通过使用 Docker Compose 来启动 Drone,编写 docker-compose.yml 文件。

  1. version: '3'
  2. services:
  3. drone-server:
  4. image: drone/drone:0.8-alpine
  5. ports:
  6. - 443:443
  7. # - "${PRO_PUBLIC_IP}:8000:8000"
  8. volumes:
  9. - drone-data:/var/lib/drone/:rw
  10. - ${SSL_PATH}:/etc/certs:rw
  11. restart: always
  12. environment:
  13. - DRONE_SECRET=drone
  14. - DRONE_OPEN=false
  15. - DRONE_ADMIN=${GITHUB_SERNAME}
  16. - DRONE_HOST=${DRONE_HOST}
  17. - DRONE_GITHUB=true
  18. - DRONE_GITHUB_CLIENT=${DRONE_GITHUB_CLIENT}
  19. - DRONE_GITHUB_SECRET=${DRONE_GITHUB_SECRET}
  20. - DRONE_SERVER_CERT=/etc/certs/drone.domain.com.crt
  21. - DRONE_SERVER_KEY=/etc/certs/drone.domain.com.key
  22. drone-agent:
  23. image: drone/agent:0.8-alpine
  24. restart: always
  25. depends_on:
  26. - drone-server
  27. volumes:
  28. - /var/run/docker.sock:/var/run/docker.sock:rw
  29. environment:
  30. - DRONE_SECRET=drone
  31. - DRONE_SERVER=drone-server:9000
  32. dns: 114.114.114.114
  33. volumes:
  34. drone-data:

替换 ${SSL_PATH} 为你网站的 SSL 证书路径。

替换 ${GITHUB_SERNAME} 为你 GitHub 的用户名,该用户将成为 Drone 的管理员。

替换 ${DRONE_HOST} 为你部署 Drone 的域名。

替换 ${DRONE_GITHUB_CLIENT} 为你 GitHub 应用的 Client ID

替换 ${DRONE_GITHUB_SECRET} 为你 GitHub 应用的 Client Secret

注意: 如果你的服务器占用了 443 端口,请配置 Nginx 代理,这里不再赘述。

启动 Drone

  1. $ docker-compose up -d

Drone 关联项目

在 Github 新建一个名为 drone-demo 的仓库。

打开我们已经部署好的 Drone 网站,使用 GitHub 账号登录,在界面中关联刚刚新建的 drone-demo 仓库。

编写项目源代码

在本机初始化一个 git 仓库

  1. $ mkdir drone-demo
  2. $ cd drone-demo
  3. $ git init
  4. $ git remote add origin git@github.com:username/drone-demo.git

这里以一个简单的 Go 程序为例,该程序输出 Hello World!

编写 app.go 文件

  1. package main
  2. import "fmt"
  3. func main(){
  4. fmt.Printf("Hello World!");
  5. }

编写 .drone.yml 文件

  1. workspace:
  2. base: /srv/drone-demo
  3. path: .
  4. pipeline:
  5. build:
  6. image: golang:alpine
  7. # pull: true
  8. environment:
  9. - KEY=VALUE
  10. secrets: [key1, key2]
  11. commands:
  12. - echo $$KEY
  13. - pwd
  14. - ls
  15. - CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o app .
  16. - ./app

workspace 指明 git 源代码克隆的目标路径,本例中 git 源代码将被克隆到 golang 容器中的 /srv/drone-demo 目录中。

pipeline 指明构建所需的 Docker 镜像,环境变量,编译指令等。

现在目录结构如下

  1. .
  2. ├── .drone.yml
  3. └── app.go

推送项目源代码到 GitHub

  1. $ git add .
  2. $ git commit -m "test drone ci"
  3. $ git push origin master

查看项目构建过程及结果

打开我们部署好的 Drone 网站,即可看到构建结果。

Drone - 图2

当然我们也可以把构建结果上传到 GitHub,Docker Registry,云服务商提供的对象存储,或者生产环境中。

本书 GitBook 也使用 Drone 进行 CI/CD,具体配置信息请查看本书根目录 .drone.yml 文件。

参考链接