从Docker 到Jenkins 到Ansible的部署经验

工作中,除了开发功能,还负责系统的部署工作。我从频繁的部署工作中,逐渐找到了一些偷懒的方法。从传统的Java -jar命令启动服务,到通过Docker 容器构建部署服务,再后来通过自动化部署工具Jenkins来完成部署,最后再结合Ansible完成远程部署。一步步的进步极大的减少部署工作,提高了工作效率(增加了许多划水时间)。

Docker

简介

Docker 是一个开源的应用容器引擎,让开发者可以打包他们的应用以及依赖包到一个可移植的容器中,然后发布到任何流行的Linux机器上,也可以实现虚拟化,容器是完全使用沙箱机制,相互之间不会有任何接口。

Docker给我的印象很深,没有什么环境是docker pull 解决不了的,

常用命令

docker ps           , docker ps 默认显示运行中的容器,-a 显示所有,-l显示近期创建的容器

docker start xxx    , 启动xxx容器

docker restart xxx  , 重启xxx容器

docker run xxx      , 创建并运行xxx容器

docker build -t xxx .   ,使用 Dockerfile 创建镜像

docker stop xxx     , 关闭容器

docker rm xxx       , 删除容器

docker images       , 查看所有镜像

docker rmi xxx      , 删除xxx镜像

docker exec -it xxx sh          , 进入xxx容器中,用quit退出

docker logs -f xxx --tail 500   , 查看xxx容器的日志,显示最后500行,常用命令

docker inspect xxxx             , 查看容器配置信息

docker-compose -f app.yml up -d , 按照app.yml文件配置以debug形式启动

docker-compose -f app.yml down  , 按照app.yml文件配置形式关闭

使用场景

第一步:在gradle项目加入docker插件,即在gradle.build 文件中加入以下代码。需要注意的有插件的版本,项目打包后的名称,Dockerfile文件目录

dependencies {
    classpath("se.transmode.gradle:gradle-docker:1.2")
}

apply plugin: 'docker'

task buildDocker(type: Docker, dependsOn: build) {
    push = false
    applicationName = "项目名"
    dockerfile = file('src/main/docker/Dockerfile文件目录')
    doFirst {
        copy {
            from jar
            into stageDir
        }
    }
}

第二步:创建Dockerfile文件,文件目录要和第一步中设置的保持一致。需要配置jdk镜像和基本的启动参数

FROM frolvlad/alpine-oraclejdk8:slim
VOLUME /tmp
ADD 项目jar名称.jar app.jar
RUN sh -c 'touch /app.jar'
ENV JAVA_OPTS=""
ENV PORT="6666"
ENV DB_CONNECTION="jdbc:mysql://ip:port/database"
ENV DB_USER="user"
ENV DB_PASSWORD="password"
ENTRYPOINT [ "sh", "-c", "java $JAVA_OPTS -Djava.security.egd=file:/dev/./urandom -jar /app.jar --spring.datasource.url=$DB_CONNECTION --spring.datasource.usernam=$DB_USER --spring.datasource.password=$DB_PASSWORD --port=$PORT"]

第三步:将jar拷贝到服务器上,然后执行编译,运行的docker命令

一)、通过gradle的bootJar,将项目打包。同时需要把引入的第三方jar也要一起打入到项目jar中。

二)、Windows系统中可以通过Xftp将jar和Dockerfile文件拷贝同一个目录下。Linux系统可以通过scp命令上传文件。

三)、执行docker ps,查看当前运行的容器,执行docker stop和docker rm 关闭和删除之前旧版本的容器

四)、找到jar的目录,并在当前目录下,执行 docker build -t 镜像名称 . 的命令编译项目,注意后面的点不要漏了。

五)、编译成功后执行 docker run --name 容器名 -v /tmp:/tmp -p 对外开发的端口:项目启动的端口 镜像名:latest 。启动容器

六)、执行docker ps,查看容器启动是否正常启动。同时执行docker logs -f 容器名 --tail 500,查看容器启动日志,检查是否有异常

七)、最后浏览器访问一下,已确保部署成功。

全称大概需要几分钟的时间,虽然不算麻烦。可次数多了,就很麻烦了。有没有什么好的工具帮助我们完成这一系列操作呢?答案是肯定的。

Jenkins

简介

The leading open source automation server, Jenkins provides hundreds of plugins to support building, deploying and automating any project.

Jenkins 的logo是一个管家的形象,很贴切。对它的理解比较肤浅。他通过管理Git上的项目,来确保每次打包的jar都是最新的。同时在构建成功后执行我们输入的shell命令,来达到自动化部署的工作。

使用场景

第一步:创建一个负责编译的Jenkins项目,

在Jenkins控制台页面,点击页面左上角的“新建”按钮。再输入项目名后,可以选择创建一个空项目,也可以在页面最下面选择copy from 其他项目。不管如何创建,我们需要Jenkins管理项目的源码,构建和构建后的操作。

docker 部署frr Docker 部署jenkins +ansible_运维


docker 部署frr Docker 部署jenkins +ansible_docker 部署frr_02

第二步:创建一个负责运行的Jenkins项目

以同样的方式创建项目,在构建触发器上,选择第一步创建的项目,构建的Shell命令是先删除之前的容器,然后在重新运行容器。若之前的容器不存在,则会构建失败。所以第一次构建的时候把第一行命令删掉。解决方案傻乎乎的,只是因为没有花时间去处理。

docker 部署frr Docker 部署jenkins +ansible_docker 部署frr_03


docker 部署frr Docker 部署jenkins +ansible_shell_04

第三步:选择编译项目,点击立即构建,当第一个项目构成成功后,会自动触发运行项目。等待两个项目都成功后,就可以访问浏览器,检查功能。

有了Jenkins,一切变得轻松很多。但他也有一个较大的弊端,就是使用前必须要先安装。特别是在客户的服务器上,也许别人就只跑这一个服务,你给别人整了一个Jenkins,似乎有点大材小用了。有没有好的解决方法?答案是肯定的。

Ansible

简介

Ansible is an IT automation tool. It can configure systems, deploy software, and orchestrate more advanced IT tasks such as continuous deployments or zero downtime rolling updates.

从接触到使用Ansible大概有一天的时间,对它的理解也是比较肤浅。我单纯的认为,他可以帮助我们在服务器之间传输文件,同时还可以执行一些shell命令。抱着这样的想法,我们可以通过Jenkins完成自动化编译,再通过Ansible传输资源文件到部署的环境中,同时执行启动Shell命令。

安装Ansible

官网地址

$ sudo apt-get update
$ sudo apt-get install software-properties-common
$ sudo apt-add-repository ppa:ansible/ansible
$ sudo apt-get update
$ sudo apt-get install ansible

使用场景

第一步:修改Jenkins运行项目的构建Shell,将之前的docker run改成

ansible-playbook ansible命令文件路径/app.yaml

第二步:创建Ansible脚本文件app.yaml,目录和第一步中设置的保存一致,模版大致如下

- hosts: '需要部署的远程服务ip'
  tasks:
   - name: "关闭旧版本的容器"
     shell: docker stop xxx
     ignore_errors: true
   - name: "删除旧版本的容器"
     shell: docker rm xxx
     ignore_errors: true
   - name: "删除之前的旧文件"
     shell: rm -rf /旧文件路径/*
   - name: "传输Dockerfile文件"
     copy:
       src=/文件目录/Dockerfile
       dest=/远程服务指定目录
   - name: "传输Jar文件"
     copy:
       src=/jar目录/xxx.jar
       dest=/远程服务指定目录
   - name: "构建docker 镜像"
     shell: chdir=/jar所在目录 nohup docker build -t 镜像名 .
   - name: "启动容器"
     shell: nohup docker run --name 容器名 -v /挂载路径/:/挂载路径/ -p 对外端口:服务端口 -d 镜像名:latest

第三步:调试是否能通过ansible连同远程服务器

sudo vim /etc/ansible/ansible.cfg
# 打开注释
inventory = /etc/ansible/hosts
host_key_checking = False

sudo vim /etc/ansible/hosts
# 添加内容
ip ansible_ssh_user=xxx ansible_ssh_pass=xxx

# 检查是否连同
$ ansible -m ping all              
ip | SUCCESS => {
    "changed": false, 
    "ping": "pong"
}

第四步:在Jenkins上构建编译项目。

前后端项目的部署

到这里,三种部署的流程就完成了。如果你熟悉Docker的方式构建,再用Jenkins和Ansible的时候,就会简单很多。我在实际开发中,项目是前后端分离的。公司做了两个方案,

第一种:前后端分开部署,即Jenkins上有四个项目。前端和后端各两个项目。这样的好处就是前后端互不影响。不会因为对方的错误而从新编译。缺点也是有的,很难保证对方部署的环境是最新的。

第二种:把前后端放在一个项目中,一次构建完成两个项目的打包部署。缺点是构建慢,优点就是保证两端的代码都是最新的,适合发布到预发布环境和正式环境。

那么,针对前后端一起部署的需求,Jenkins和Ansible同样也需要简单的修改。其思路就是Jenkins负责编译项目,将资源文件压缩,再通过Ansible上传到其他服务器上。执行解压,构建,启动的命令。

看起来视乎很简单,但有一个坑希望你们跨过去。前端打包需要npm或者其他工具,但是你的服务器上没有安装。此时请务必通过Jenkins控制台,或者用Jenkins帐号登录服务器安装这些工具。笔者就是通过root帐号登录服务器安装的npm,通过Jenkins编译时提示没有权限。