简介

Automate Software Testing and Delivery Drone is a self-service Continuous Delivery platform for busy development teams.

Drone是一个为繁忙的开发团队提供的自助式连续交付平台。

除了Drone目前做的比较成熟的还有Gitlab-CI、Jenkins、最近新推出的Github-Actions等。因为Drone占用的资源比较少，并且喜欢它的容器即插件的理念，（~~是我大Golang写的~~）所以选择用它来体验一下CI。

！但是不得不吐槽的是Drone的文档做的很烂。。所以希望这篇文章能让你少走弯路😇

本文用的是Drone最新版本，不是网上很多1.0之前的版本，根据这个教程走下去应该不会有什么问题。

配置

整个CI流程需要通过 git hook来触发，Drone支持Github、GitLab、Gitea、Gogs、Bitbucket Cloud、Bitbucket Server几种SCM(source control management)，期初我是使用gogs来搭建的，由于https证书问题产生的x509错误最终放弃了gogs方案，最终使用的是github+drone。

Github相关配置

Drone和Github交互需要通过OAuth进行鉴权，所以要先申请一个OAuth应用。

打开github.com点击头像，选择Settings / Developer settings / OAuth Apps，然后点击New OAuth App创建OAuth应用。

其中http://cici.xxxx.com是你部署Drone的域名，注意callback url 不要填错。

然后注册应用，记录下其中的ClientID和ClientSecret下面要用到

docker-compose相关配置

我这里是通过docker的方式安装的，docker-compose编排。

安装Drone需要一个drone-server和drone-runner，

drone-runner不是必选的，官方不推荐吧runner和server安装在一个实例上，如果你安装到一个实例上的话可以设置DRONE_AGENTS_ENABLED=false，drone-server将会作为默认的runner，我这为了演示，runner和server是在一个同服务器上的。

docker-compose.yml 文件:

version: '2'

services:
  drone-server:
    image: drone/drone:latest
    container_name: drone-server
    networks: 
      - dronenet        # 让drone-server和drone-agent处于一个网络中，方便进行RPC通信
    ports:
      - '10081:80'      # Web管理面板的入口 PROTO=http  时使用该端口
      - '10082:443'     # Web管理面板的入口 PROTO=https 时使用该端口
      - '10083:9000'    # RPC服务端口
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock   # docker.sock [1]
      - /var/data/drone/:/var/lib/drone             # drone数据存放路径
    environment:
      - DRONE_AGENTS_ENABLED=true                   # 使用Runner
      - DRONE_GITHUB_SERVER=https://github.com                    # github的地址
      - DRONE_GITHUB_CLIENT_ID=${DRONE_GITHUB_CLIENT_ID}          # 上一步获得的ClientID
      - DRONE_GITHUB_CLIENT_SECRET=${DRONE_GITHUB_CLIENT_SECRET}  # 上一步获得的ClientSecret
      - DRONE_RPC_SECRET=${DRONE_RPC_SECRET}                      # RPC秘钥	[2]
      - DRONE_SERVER_HOST=${DRONE_SERVER_HOST}                    # RPC域名(在一个实例上可以不用)
      - DRONE_SERVER_PROTO=${DRONE_SERVER_PROTO}                  # git webhook使用的协议(我建议http)
      - DRONE_OPEN=true                                           # 开发drone
      - DRONE_DATABASE_DATASOURCE=/var/lib/drone/drone.sqlite     # 数据库文件
      - DRONE_DATABASE_DRIVER=sqlite3                             # 数据库驱动，我这里选的sqlite
      - DRONE_DEBUG=true                                          # 调试相关，部署的时候建议先打开
      - DRONE_LOGS_DEBUG=true                                     # 调试相关，部署的时候建议先打开
      - DRONE_LOGS_TRACE=true                                     # 调试相关，部署的时候建议先打开
      - DRONE_USER_CREATE=username:TheWinds，admin:true           # 初始管理员用户
      - TZ=Asia/Shanghai                                          # 时区
    restart: always
  drone-agent:
    image: drone/agent:latest
    container_name: drone-agent
    networks: 
      - dronenet     # 让drone-server和drone-agent处于一个网络中，方便进行RPC通信
    depends_on:
      - drone-server 
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock # docker.sock [1]
    environment:
      - DRONE_RPC_SERVER=http://drone-server  # RPC服务地址
      - DRONE_RPC_SECRET=${DRONE_RPC_SECRET}  # RPC秘钥
      - DRONE_RPC_PROTO=${DRONE_RPC_PROTO}    # RPC协议(http || https)
      - DRONE_RUNNER_CAPACITY=2               # 最大并发执行的 pipeline 数
      - DRONE_DEBUG=true                      # 调试相关，部署的时候建议先打开
      - DRONE_LOGS_DEBUG=true                 # 调试相关，部署的时候建议先打开
      - DRONE_LOGS_TRACE=true                 # 调试相关，部署的时候建议先打开
      - TZ=Asia/Shanghai
    restart: always
networks:
  dronenet:					# 让drone-server和drone-agent处于一个网络中，方便进行RPC通信

[1] 因为插件本身也是一个容器，要在容器中(docker-server、drone-runnere)中运行容器。将docker.sock挂载到容器中，可以让容器通过docker unix socket API得到管理容器的能力。
[2] 你可以通过 openssl rand -hex 16 这个命令随机生成秘钥

.env文件:

DRONE_GITHUB_CLIENT_ID=your_github_client_id
DRONE_GITHUB_CLIENT_SECRET=your_github_client_secret 
DRONE_RPC_SECRET=your_rpc_secret
DRONE_SERVER_HOST=cici.xxxx.com
DRONE_SERVER_PROTO=http
DRONE_RPC_SERVER=rpc.cici.xxxx.com
DRONE_RPC_PROTO=http

启动

将docker-compose.yml和.env文件上传至服务器同一目录，然后执行

docker-compose up -d

启动服务，一起顺利的话打开你的域名你将会看到

OAuth的授权页面，进行授权之后就可以看到管理面板了 💜

使用

基本使用基本上参考https://docs.drone.io/上面的文档就可以了，没什么好说的，下面我主要想说一下Secret管理和私有仓库的使用方法。

Secret管理

CI工作流编排是写在仓库中的.drone.yml中的，如果我们想进行一些私有的操作(比如ssh_key，用于通知的账号密码…)就要把这些敏感信息写在yml里，而这些私有信息的暴露肯定是不允许发生的。所以这些秘密信息一般在构建过程中由CI工具注入到环境变量中的。

drone支持多种secret管理方式，最基本和最方便的方式就是直接通过Web后台进行管理。

打开Repositories/your_repo_name/settings 找到Secrets选项卡，输入Secret Name和Secret Value就可以添加Name=>Value的秘钥键值对了，这些秘钥将在构建过程中被注入。

下面就来试一下

Github创建项目 drone_test_pub

.
├── .drone.yml
└── main.go

main.go

package main

import (
	"fmt"
	"os"
	"strings"
)

func main() {
	aSecret := os.Getenv("A_SECRET")
	fmt.Println(aSecret)
	fmt.Println(reverseString(aSecret))
}

func reverseString(s string) string {
	r := []rune(s)
	sb := strings.Builder{}
	for i := len(r) - 1; i >= 0; i-- {
		sb.WriteRune(r[i])
	}
	return sb.String()
}

.drone.yml

---
kind: pipeline
type: docker
name: default

steps:
- name: build
  image: golang
  environment:
    A_SECRET:
      from_secret: a_secret
  commands:
  - echo ?A_SECRET
  - go run . > test_secret.txt
  - cat test_secret.txt

Drone管理面板，激活仓库drone_test_pub 并创建一个仓库级别的Secret a_secret = terces elbakaepsnu

推送代码到Github查看构建情况

▶ git commit --allow-empty
[master 0460b0d] test push

▶ git push
Enumerating objects: 1， done.
Counting objects: 100% (1/1)， done.
Writing objects: 100% (1/1)， 179 bytes | 179.00 KiB/s， done.
Total 1 (delta 0)， reused 0 (delta 0)
To github.com:TheWinds/drone_test_pub.git
   0ccca9b..0460b0d  master -> master

4.构建结果

从活动流里可以看到，已经成功进行了克隆和构建，首先是进行了默认的clone步骤，然后进行的build步骤。

从build的执行结果来看，我们 echo $A_SECRET的时候得到的是一个掩码********，然后在main.go将 $A_SECRET进行反转后得到了unspeakable secret说明已经成功得到了注入的Secret。

通过查看Drone-Runtime的源码可以看到，运行的时候对于要显示在控制台的内容，都会把Secret Value 加入到string replacer中，统一被替换为掩码********。~~然而这并没有什么卵用，通过字符串操作就能使其输出未进行掩码的Secret，然后就能进行还原了。。~~

克隆私有仓库

Drone默认会有一个Clone的步骤，要克隆私有仓库要把这个步骤关闭。

然后把Github该仓库的 deploy_key对应的私钥设为Secret注入到 SSH_KEY 环境变量中。

接下来创建一个clone的步骤，我这里使用的是alpine/git的镜像，通过echo "?SSH_KEY" > /root/.ssh/id_rsa吧私钥写入到id_rsa中，git clone 填写你的私有仓库ssh地址就可以进行克隆了。

deploy_key相比github的全局sshkey，可以控制到仅克隆仓库的权限，适合进行部署操作，具体怎么去设置我就不再赘述了

生成一对sshkey可以用 ssh-keygen -t rsa -b 4096 -C "your_email" 这个命令

.drone.yml

---
kind: pipeline
type: docker
name: default

clone:
  disable: true
steps:
- name: clone
  image: alpine/git
  environment:
    SSH_KEY:
      from_secret: ssh_key
  commands:
    - mkdir -p /root/.ssh/
    - echo "?SSH_KEY" > /root/.ssh/id_rsa
    - chmod -R 600 /root/.ssh/
    - ssh-keyscan -t rsa github.com >> ~/.ssh/known_hosts
    - git clone -v git@github.com:TheWinds/drone_test.git .
- name: build
  image: golang
  commands:
  - go run . > hello.txt
  - cat hello.txt

结语

DroneCI断断续续搞了将近一周的时间，期间因为文档不清楚找不到问题还放弃了几次🙃。但是都开始了，就很难放弃，查了很多资料看了一下源码后终于整好了。

祝你好运。