实战-CI/CD

持续集成(Continuous integration)是一种软件开发实践，每次集成都通过自动化的构建（包括编译，发布，自动化测试）来验证，从而尽早地发现集成错误。

持续部署（continuous deployment）是通过自动化的构建、测试和部署循环来快速交付高质量的产品。

与 Jenkins 不同的是，基于 Docker 的 CI/CD 每一步都运行在 Docker 镜像中，所以理论上支持所有的编程语言。

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 应用

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

配置 Drone

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

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

docker-compose up -d

Drone 关联项目

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

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

编写项目源代码

在本机初始化一个 git 仓库

mkdir drone-demo

cd drone-demo

git init

git remote add origin [email protected]:username/drone-demo.git

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

编写 app.go 文件

package main

import "fmt"

func main(){  
    fmt.Printf("Hello World!");
}

编写 .drone.yml 文件

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 镜像，环境变量，编译指令等。

现在目录结构如下

.
├── .drone.yml
└── app.go

推送项目源代码到 GitHub

git add .

git commit -m "test drone ci"

git push origin master

查看项目构建过程及结果

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

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

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

参考链接

在 Travis CI 中使用 Docker

当代码提交到 GitHub 时，Travis CI 会根据项目根目录 .travis.yml 文件设置的指令，执行一系列操作。

本小节介绍如何在 Travis CI 中使用 Docker 进行持续集成/持续部署（CI/CD）。这里以当代码提交到 GitHub 时自动构建 Docker 镜像并推送到 Docker Hub 为例进行介绍。

准备

首先登录 https://travis-ci.com/account/repositories 选择 GitHub 仓库，按照指引安装 GitHub App 来启用 GitHub 仓库构建。

在项目根目录新建一个 Dockerfile 文件。

FROM alpine

RUN echo "Hello World"

新建 Travis CI 配置文件 .travis.yml 文件。

language: bash

dist: xenial

services:
  - docker

before_script:
  # 登录到 docker hub
  - echo "$DOCKER_PASSWORD" | docker login -u "$DOCKER_USERNAME" --password-stdin

script:
  # 这里编写测试代码的命令
  - echo "test code"

after_success:
  # 当代码测试通过后执行的命令
  - docker build -t username/alpine .
  - docker push username/alpine

请提前在 Travis CI 仓库设置页面配置 DOCKER_PASSWORD DOCKER_USERNAME 变量

查看结果

将项目推送到 GitHub, 登录 Travis CI 查看构建详情。

# 实战-CI/CD

# Drone

# 要求

# 新建 GitHub 应用

# 配置 Drone

# 启动 Drone

# Drone 关联项目

# 编写项目源代码

# 推送项目源代码到 GitHub

# 查看项目构建过程及结果

# 参考链接

# 在 Travis CI 中使用 Docker

# 准备

# 查看结果