## Drone
基于 `Docker` 的 `CI/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 新建一個應用。

接下來查看這個應用的詳情,記錄 `Client ID` 和 `Client Secret`,之后配置 Drone 會用到。
### 配置 Drone
我們通過使用 `Docker Compose` 來啟動 `Drone`,編寫 `docker-compose.yml` 文件。
```yaml
version: '3'
services:
drone-server:
image: drone/drone:0.8-alpine
ports:
- 443:443
# - "${PRO_PUBLIC_IP}:8000:8000"
volumes:
- drone-data:/var/lib/drone/:rw
- ${SSL_PATH}:/etc/certs:rw
restart: always
environment:
- DRONE_SECRET=drone
- DRONE_OPEN=false
- DRONE_ADMIN=${GITHUB_SERNAME}
- DRONE_HOST=${DRONE_HOST}
- DRONE_GITHUB=true
- DRONE_GITHUB_CLIENT=${DRONE_GITHUB_CLIENT}
- DRONE_GITHUB_SECRET=${DRONE_GITHUB_SECRET}
- DRONE_SERVER_CERT=/etc/certs/drone.domain.com.crt
- DRONE_SERVER_KEY=/etc/certs/drone.domain.com.key
drone-agent:
image: drone/agent:0.8-alpine
restart: always
depends_on:
- drone-server
volumes:
- /var/run/docker.sock:/var/run/docker.sock:rw
environment:
- DRONE_SECRET=drone
- DRONE_SERVER=drone-server:9000
dns: 114.114.114.114
volumes:
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
```bash
$ docker-compose up -d
```
### Drone 關聯項目
在 Github 新建一個名為 `drone-demo` 的倉庫。
打開我們已經部署好的 Drone 網站,使用 GitHub 賬號登錄,在界面中關聯剛剛新建的 `drone-demo` 倉庫。
### 編寫項目源代碼
在本機初始化一個 git 倉庫
```bash
$ mkdir drone-demo
$ cd drone-demo
$ git init
$ git remote add origin git@github.com:username/drone-demo.git
```
這里以一個簡單的 `Go` 程序為例,該程序輸出 `Hello World!`
編寫 `app.go` 文件
```go
package main
import "fmt"
func main(){
fmt.Printf("Hello World!");
}
```
編寫 `.drone.yml` 文件
```yaml
workspace:
base: /srv/drone-demo
path: .
pipeline:
build:
image: golang:alpine
# pull: true
environment:
- KEY=VALUE
secrets: [key1, key2]
commands:
- echo $$KEY
- pwd
- ls
- CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o app .
- ./app
```
`workspace` 指明 git 源代碼克隆的目標路徑,本例中 git 源代碼將被克隆到 golang 容器中的 `/srv/drone-demo` 目錄中。
`pipeline` 指明構建所需的 Docker 鏡像,環境變量,編譯指令等。
現在目錄結構如下
```bash
.
├── .drone.yml
└── app.go
```
### 推送項目源代碼到 GitHub
```bash
$ git add .
$ git commit -m "test drone ci"
$ git push origin master
```
### 查看項目構建過程及結果
打開我們部署好的 `Drone` 網站,即可看到構建結果。

當然我們也可以把構建結果上傳到 GitHub,Docker Registry,云服務商提供的對象存儲,或者生產環境中。
本書 GitBook 也使用 Drone 進行 CI/CD,具體配置信息請查看本書根目錄 [`.drone.yml`](https://github.com/yeasy/docker_practice/blob/master/.drone.yml) 文件。
## 參考鏈接
* [Drone Github](https://github.com/drone/drone)
* [Drone 文檔](http://docs.drone.io/)
- 前言
- 修訂記錄
- 如何貢獻
- Docker 簡介
- 什么是 Docker
- 為什么要用 Docker
- 基本概念
- 鏡像
- 容器
- 倉庫
- 安裝 Docker
- Ubuntu
- Debian
- CentOS
- Raspberry Pi
- macOS
- Windows PC
- 鏡像加速器
- 使用鏡像
- 獲取鏡像
- 列出鏡像
- 刪除本地鏡像
- 利用 commit 理解鏡像構成
- 使用 Dockerfile 定制鏡像
- Dockerfile 指令詳解
- COPY 復制文件
- ADD 更高級的復制文件
- CMD 容器啟動命令
- ENTRYPOINT 入口點
- ENV 設置環境變量
- ARG 構建參數
- VOLUME 定義匿名卷
- EXPOSE 暴露端口
- WORKDIR 指定工作目錄
- USER 指定當前用戶
- HEALTHCHECK 健康檢查
- ONBUILD 為他人作嫁衣裳
- 參考文檔
- Dockerfile 多階段構建
- 其它制作鏡像的方式
- 實現原理
- 操作容器
- 啟動
- 守護態運行
- 終止
- 進入容器
- 導出和導入
- 刪除
- 訪問倉庫
- Docker Hub
- 私有倉庫
- 私有倉庫高級配置
- Nexus 3
- 數據管理
- 數據卷
- 掛載主機目錄
- 使用網絡
- 外部訪問容器
- 容器互聯
- 配置 DNS
- 高級網絡配置
- 快速配置指南
- 容器訪問控制
- 端口映射實現
- 配置 docker0 網橋
- 自定義網橋
- 工具和示例
- 編輯網絡配置文件
- 實例:創建一個點到點連接
- Docker 三劍客之 Compose 項目
- 簡介
- 安裝與卸載
- 使用
- 命令說明
- Compose 模板文件
- 實戰 Django
- 實戰 Rails
- 實戰 WordPress
- Docker 三劍客之 Machine 項目
- 安裝
- 使用
- Docker 三劍客之 Docker Swarm
- Swarm mode
- 基本概念
- 創建 Swarm 集群
- 部署服務
- 使用 compose 文件
- 管理敏感數據
- 管理配置信息
- 滾動升級
- 安全
- 內核命名空間
- 控制組
- 服務端防護
- 內核能力機制
- 其它安全特性
- 總結
- 底層實現
- 基本架構
- 命名空間
- 控制組
- 聯合文件系統
- 容器格式
- 網絡
- Etcd 項目
- 簡介
- 安裝
- 集群
- 使用 etcdctl
- CoreOS 項目
- 簡介
- 工具
- 快速搭建 CoreOS 集群
- Kubernetes 項目
- 簡介
- 快速上手
- 基本概念
- kubectl 使用
- 架構設計
- Mesos - 優秀的集群資源調度平臺
- Mesos 簡介
- 安裝與使用
- 原理與架構
- Mesos 配置項解析
- 日志與監控
- 常見應用框架
- 本章小結
- 容器與云計算
- 簡介
- 亞馬遜云
- 騰訊云
- 阿里云
- 小結
- 實戰案例-操作系統
- Busybox
- Alpine
- Debian Ubuntu
- CentOS Fedora
- 本章小結
- 實戰案例-CI/CD
- Drone
- Docker 開源項目
- LinuxKit
- 附錄
- 附錄一:常見問題總結
- 附錄二:熱門鏡像介紹
- Ubuntu
- CentOS
- MySQL
- MongoDB
- Redis
- Nginx
- WordPress
- Node.js
- 附錄三:Docker 命令查詢
- 附錄四:Dockerfile 最佳實踐
- 附錄五:資源鏈接
- 附錄六:Docker 中文資源