DevOps

docker+jenkins+golang持续集成实践


起因 #

因为生产需要最近又重新折腾了一下Jenkins和docker。主要目的是想自动编译,打包,部署一些Golang的HttpServer。于是决定使用Jenkins来做这个持续集成的载体,选择Jenkins出于两点原因:

1. 以前就使用过,上手会更快 2. 社区比较成熟,插件和文档丰富


安装Docker和Pull Jenkins镜像 #

这一步,作为前置条件且不是本文主要要描述的步骤,因此略去。网上也有很多参考资料~


Jenkins & docker-compose配置 #

为了方便我才用了docker-compose这个工具,docker-compose 基础可以参见我的docker-compose上手。这里直接上配置:

version: '2'

services:
  jenkins:
    container_name: jenkins-lts
    ports:
      - 9001:8080
      - 50000:50000
    image: jenkins/jenkins:lts
    volumes:
      - /home/worker/jenkins/jenkins_home:/var/jenkins_home

配置也是官方的示例配置。

Note: 将宿主机的/home/worker/jenkins/jenkins_home挂载为容器的/var/jenkins_home目录。这样做的目的是,如果容器被不小心删除也不至于Jenkins的数据丢失。

到这里,我们只需要执行docker-compose up -d便可以将Jenkins容器跑起来了,再配置一下Nginx,便可以直接访问到Jenkins页面了,并进行初始化。

我的目录结构如下:

➜  jenkins ll
total 8.0K
-rw-rw-r--  1 worker worker  220 May  2 17:19 docker-compose.yml
drwxrwxr-x 19 worker worker 4.0K May  3 15:53 jenkins_home
➜  jenkins pwd
/home/worker/jenkins
➜  jenkins docker-compose up -d # 运行

Publish Over SSH配置 #

Publish Over SSH配置,由于我们是通过docker运行的Jenkins,因此要特别配置一下SSH,方便Jenkins部署项目。这里先列出步骤:

...

Drone体验

相较于Jenkins,Gitlab-CI…等,尝试Drone的首要原因是,天生的docker支持。不用去操心部署CI或者CD的环境配置等等烦心事。只需要上手,如何配置这个CD工具,让我使用更加畅快和顺手。

安装部署 #

前提:已经安装了docker,docker-compose,并基本掌握docker用法,基本熟悉docker-compose配置文件

pull镜像 #

docker pull drone/drone:0.8  # droner-server 镜像
docker pull dorner/agent:0.8 # drone-agent 镜像

也可以跳过这一步,docker运行的时候,如果匹配不到本地镜像,会自动拉取。

docker-compose.yml配置文件 #

为了方便,新建一个Drone文件夹,目录结构如下:

--Drone                  # 文件夹
  |---docker-compose.yml # docker-compose 配置文件
  |---data               # 用于挂载的数据文件
  |---drone.domain.com   # nginx sever 配置文件
  `---other.file         # 其他文件

已知文件结构后,编写的docker-compose.yml文件如下:

version: '2'

services:
  drone-server:
    image: drone/drone:0.8
    container_name: drone-server
    ports:
      - 8000:8000
      - 9000:9000
    volumes:
      - ./data:/var/lib/drone/ # 在没有跟数据库绑定的情况下,默认使用sqlite数据库
    restart: always
    environment:
      - DRONE_OPEN=false
      - DRONE_HOST=http://127.0.0.1:8000 # 最好是在服务器上,localhost无法收到webhook的通知
      - DRONE_ADMIN=yourname

      - DRONE_GITHUB=true
      - DRONE_GITHUB_CLIENT=7bc7971bxxxxx # 需要预先注册一个github oauth应用
      - DRONE_GITHUB_SECRET=9456c630xxxxxxxxxxxxxx

      - DRONE_SECRET=secret
      - DRONE_DEBUG=false

  drone-agent:
    image: drone/agent:0.8
    container_name: drone-agent
    command: agent
    restart: always
    depends_on:
      - drone-server
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - DRONE_SERVER=drone-server:9000
      - DRONE_SECRET=secret
      - DRONE_DEBUG=true

启动Drone #

启动就很简单了,Drone目录下执行:docker-compose up -d,启动结果截图如下: Drone-starting.png 如果是首次打开,会先去github请求授权,然后回调schema://drone.your_domain.com/authorize,如截图: Drone-running-web.png

...

docker探索

docker 学习实战笔记。关于docker的详细信息参见官方文档

实战环境配置:

系统 Docker
MacOS 17.12.0-ce

实战一 简单部署可执行文件 #

本次实战是部署一个golang的web服务, 需要mongo, redis支持

  1. 省略代码,打包过程(Mac用户别忘了打包GOOS=linux,0·0)

  2. 编写Dockerfile

FROM alpine # 简版linux

RUN mkdir /app # 在镜像中创建一个文件夹

COPY ./webapp /app 
COPY ./config /app/config
COPY ./logs /app/logs

EXPOSE 35764 # 暴露35764端口,也就是为了从外部可以访问到容器类的服务

WORKDIR /app # 切换到应用文件夹(在镜像执行的时候,会自动切换)
  1. 构建镜像 执行命令 docker build -t tp-api:v1 .

执行结果如下:

Sending build context to Docker daemon   55.5MB
Step 1/7 : FROM alpine
 ---> 3fd9065eaf02
Step 2/7 : RUN mkdir /app
 ---> Using cache
 ---> 6948fdc89bbd
Step 3/7 : COPY ./webapp /app
 ---> Using cache
 ---> 555307961735
Step 4/7 : COPY ./config /app/config
 ---> ab15feb5a3ab
Step 5/7 : COPY ./logs /app/logs
 ---> 0055512da60b
Step 6/7 : EXPOSE 35764
 ---> Running in db0503538961
Removing intermediate container db0503538961
 ---> 1d214b7aff6d
Step 7/7 : WORKDIR /app
Removing intermediate container 42889dd384a7
 ---> f0b05bcb428d
Successfully built f0b05bcb428d
Successfully tagged tp-api:v2
  1. 调试容器

执行命令docker run -it --rm -p 35765:35764 tp-api:v1,会进入容器交互模式,如下:

...

持续集成-Jenkins

持续集成是一种软件开发实践,即团队开发成员经常集成它们的工作,通过每个成员每天至少集成一次,也就意味着每天可能会发生多次集成。每次集成都通过自动化的构建(包括编译,发布,自动化测试)来验证,从而尽早地发现集成错误。

关于持续集成 #

要素

. 统一的代码库 . 自动构建 . 自动测试 . 每个人每天都要向代码库主干提交代码 . 每次代码递交后都会在持续集成服务器上触发一次构建 . 保证快速构建 . 模拟生产环境的自动测试 . 每个人都可以很容易的获取最新可执行的应用程序 . 每个人都清楚正在发生的状况 . 自动化的部署

Jenkins的搭建与使用: #

前提:安装好Java环境

. 下载参见下载地址, 我采用的是java -jar jenkins.war的方式部署 . 可能有用的教程 http://geek.csdn.net/news/detail/95824

更改jenkins服务端口 #

使用java -jar jenkins.war这样的命令来启动jenkins时会使用默认的端口8080,有些情况下8080端口已经被我们使用了,这个时候如果希望修改这个端口应该怎么办呢?

在命令行后面添加 --httpPort=8899,其实就是配置jetty的启动端口。如下:

set JENKINS_HOME=./
java -Djsse.enableSNIExtension=false -jar path/to/jenkins.war --httpPort=8899 

zsh设置Jenkins环境变量 #

export JENKINS_HOME = "your/jenkins/path"

补充 #

于2018-1-26日更新

鉴于尝试了drone和docker, 强烈建议采用docker部署jenkins,或者替换Jenkins为Drone

最后 #

写得很简略,没有提供配置时候遇到的坑以及解决方法,遇到之后再补上。。。以上hahah

...

访问量 访客数