前言

docker一直很火热,一直想把原本的jenkins自动部署工具搬到docker上面,无奈今年一直忙于各种事情,迟迟未实施这个事情,正好迎来了dotnet core 2.0 的正式发布,升级项目的同时,顺便直接将jenkins搬到docker上。为什么要写这篇文章呢?因为找过相关的资料,大多数文章都是基于ubuntu 安装.net core 又或者 gitlab 进行持续集成 自动部署等等等,并未有人尝试过centos7.3 上部署 jenkins 并且 构建 asp.net core 2.0 的应用。当然笔者表示并不知道为什么ubuntu有这么多人青睐。

接下来,笔者将从本片博文中,粗略的教大家怎么安装docker 和 jenkins 并且使用visual studio 2017 新建demo 并实现自动部署,下面话不多说了,来一起看看详细的介绍吧。

环境准备

硬件配置: 1核1g 1m带宽。50g硬盘。

系统环境:centos 7.3(64位)

其实用的就是腾讯云

安装docker

其实安装docker的过程,大家可以到docker找到自己相对应的安装文档进行安装,docker区分ce和ee的两个版本,具体这两个版本有什么区别,大家自行查阅相关资料,这里不再概述。教程用的是ce那么就找到对应的官方文档进行,以下是教程安装的步骤

1.更新一下包吧,多更无害

# sudo yum -y update

2.安装所需的软件包 (其实这些腾讯云都具备了,只不过怕有些阉割版的系统缺少,所以贴上命令,安装过的使用该命令不会造成伤害)

# sudo yum install -y yum-utils \
 device-mapper-persistent-data \
 lvm2

3.使用稳定版的仓库(当然可以使用最新版或测试版的仓库,这个需要官方的说明)

# sudo yum-config-manager \
 --add-repo \
 https://download.docker.com/linux/centos/docker-ce.repo

4.安装docker ce

# sudo yum install docker-ce

tips:在生产系统上,您应该安装特定版本的docker ce,而不是始终使用最新版本。

5.启动docker

# sudo systemctl start docker

6.docker通过运行hello-world映像验证是否正确安装。

# docker run hello-world

如果出现以下的界面,就代表安装成功

配置docker加速器

此步骤不是必须的,前提是你的环境有梯子或者网速可以的,那么可以忽略这个步骤。

$ curl -ssl https://get.daocloud.io/daotools/set_mirror.sh | sh -s https://mirror.ccs.tencentyun.com

使用https://mirror.ccs.tencentyun.com这个加速地址的前提是你必须要使用腾讯云,该地址外部无法访问,只有腾讯云才能使用此镜像地址。你可以使用daocloud加速地址,具体另行查阅相关资料。

安装jenkins

首先不直接从docker store上直接pull jenkins 的 image 文件,因为待会需要进行dotnet core 的 docker自动部署,需要对宿主机上的docker进行直接操作,那么需要挂载 docker 给 jenkins image,所以现在需要自己动手编写 dockerfile 构建自定义的jenkins。

# touch dockerfile
# vim dockerfile

插入以下内容:

from jenkins

user root
#清除了基础镜像设置的源,切换成腾讯云的jessie源
#使用非腾讯云环境的需要将 tencentyun 改为 aliyun
run echo '' > /etc/apt/sources.list.d/jessie-backports.list \
 && echo "deb http://mirrors.tencentyun.com/debian jessie main contrib non-free" > /etc/apt/sources.list \
 && echo "deb http://mirrors.tencentyun.com/debian jessie-updates main contrib non-free" >> /etc/apt/sources.list \
 && echo "deb http://mirrors.tencentyun.com/debian-security jessie/updates main contrib non-free" >> /etc/apt/sources.list
#更新源并安装缺少的包
run apt-get update && apt-get install -y libltdl7 && apt-get update

arg dockergid=999

run echo "docker:x:${dockergid}:jenkins" >> /etc/group 

# 安装 docker-compose 因为等下构建环境的需要
run curl -l https://github.com/docker/compose/releases/download/1.16.1/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose

run chmod +x /usr/local/bin/docker-compose

如果不安装libltdl7 会导致如下这个问题,原因是jenkins容器内部没有这个包

docker: error while loading shared libraries: libltdl.so.7: cannot open shared object file: no such file or directory
build step 'execute shell' marked build as failure

在jenkins操作宿主的docker的时候会出现拒绝访问的问题,其实就是容器的jenkins用户没有权限访问容器外的docker命令,所以 run命令 需要把jenkins用户加入到docker用户组

构建image

# docker build . -t auto-jenkins

出现以上 successfully 内容代表安装jenkins成功

在启动jenkins时,需要先创建一个jenkins的配置目录,并且挂载到docker 里的jenkins目录下

# mkdir -p /var/jenkins_home

运行 jenkins

# docker run --name jenkins -p 8080:8080 -p 50000:50000 \
 -v /var/run/docker.sock:/var/run/docker.sock \
 -v $(which docker):/bin/docker \
 -v /var/jenkins_home :/var/jenkins_home \
 -d auto-jenkins

  第一行:构建一个名称为jenkins的容器 -p 是容器运行开放端口

  第二行 和第三行: -v 是将宿主机的docker文件挂载进容器里

  第四行:建立宿主机的配置目录,挂载进docker容器里,这样容器里的jenkins配置目录文件就会映射出来

第五行:使用auto-jenkins image 并且后台启动

这个时候 run jenkins 会提示成功

执行 docker ps 命令后,发现什么都没有

执行 docker ps -a 命令看看

执行 docker start -a jenkins 让容器前台输出运行信息的方式运行

不难看出其实 jenkins 启动已经是可以了,只是权限问题导致这个错误的信息。

现在需要看一下jenkins官方的dockerfile

知道问题原因,贴上代码了。

##修改 /var/jenkins 文件夹权限
# chown -r 1000 /var/jenkins_home

继续执行运行jenkins 代码

# docker run --name jenkins -p 8080:8080 -p 50000:50000 \
 -v /var/run/docker.sock:/var/run/docker.sock \
 -v $(which docker):/bin/docker \
 -v /var/jenkins_home:/var/jenkins_home \
 -d auto-jenkins

这时你会看到悲催的信息

容器之前已经运行过了,所以会有一个容器已经存在了。哥来给你搽眼泪。执行以下命令,删除原本 run 出来的容器

# docker rm -f jenkins

删除完容器后,继续执行运行命令

# docker run --name jenkins -p 8080:8080 -p 50000:50000 \
 -v /var/run/docker.sock:/var/run/docker.sock \
 -v $(which docker):/bin/docker \
 -v /var/jenkins_home:/var/jenkins_home \
 -d auto-jenkins

出现一串字符后,执行 docker ps 会发现容器已经启动了,正常了。这个时候是不是可以使用了?别着急,还有很长的路。

配置jenkins

打开浏览器输入地址 your ip:8080 进行访问,你会开心的看到这个界面,看到这个界面代表你的jenkins 已经安装成功了,但是需要进行配置,现在就教大家怎么去配置

首先,进入容器内

# docker exec -it jenkins /bin/bash

查看/var/jenkins_home/secrets/initialadminpassword 文件内的密码

# cat /var/jenkins_home/secrets/initialadminpassword

其实不一定要进入容器内查看密码,可以直接在宿主机的环境下,查看 /var/jenkins//secrets/initialadminpassword 的内容,因为之前笔者已经将这个目录挂载进docker里面了

复制输出的内容,粘贴到administrator password,输入 exit 退出容器,此时进行下一步你会看到此界面,点击 install suggested plugins

等待初始化完毕

到了这一步,自己随缘去填吧。

使用vs2017创建一个asp.net core 2.0 web应用程序,并将代码上传到git。这里笔者就不演示上传代码的过程步骤了。

为你们准备了一个地址,方便你们完成本教程:http://git.oschina.net/wenalu/mvctest

新建一个自由风格的软件项目,并填名称 点击 ok

填写源代码管理

勾选 poll scm 设置拉取git 上代码的间隔,笔者这里是两分钟拉取一次

勾上 delete workspace before build start 是设置构建前删除工作区

勾上 abort the build if it’s stuck 是设定构建的超时时间,如果构建使用的时间超过设定的时间,那么就认为这次的构建是失败的。笔者这里超时设置的是10分钟

增加一个execute shell 脚本,并填写以下脚本内容

#!/bin/bash
# 获取短版本号

githash=`git rev-parse --short head`
echo ---------------remove-orphans------------------
docker-compose -f ./docker-compose.yml -f ./docker-compose.override.yml -p dockercompose4255153253317384266 down --rmi local --remove-orphans
echo ------------------config-----------------------
docker-compose -f ./docker-compose.ci.build.yml -p dockercompose4255153253317384266 config
echo ------------------build------------------------
docker-compose -f ./docker-compose.ci.build.yml -p dockercompose4255153253317384266 up --build
echo ---------------publishing...------------------
docker-compose -f "./docker-compose.yml" -f "./docker-compose.override.yml" -p dockercompose4255153253317384266 up -d --build

应用保存,回到项目界面上。点击立即构建进行部署工作 success

打开浏览器,地址输入 your ip:8088/

遇到的问题

其实上面的篇幅为了大家能尽快的实现部署,只是简要的介绍了途中一些常犯的错误。其实在搭建这个ci环境的时候遇到不止这些问题,比如说一开始的 dockerfile 内容并不像教程中的一样。一开始是这样的:

from jenkins

user root
#清除了基础镜像设置的源,切换成阿里云的jessie源
run echo '' > /etc/apt/sources.list.d/jessie-backports.list \
 && echo "deb http://mirrors.tencentyun.com/debian jessie main contrib non-free" > /etc/apt/sources.list \
 && echo "deb http://mirrors.tencentyun.com/debian jessie-updates main contrib non-free" >> /etc/apt/sources.list \
 && echo "deb http://mirrors.tencentyun.com/debian-security jessie/updates main contrib non-free" >> /etc/apt/sources.list
#更新源并安装缺少的包
run apt-get update && apt-get install -y libltdl7 && apt-get update

arg dockergid=999

run echo "docker:x:${dockergid}:jenkins" >> /etc/group 

user jenkins

当你如果在网上找到其他教程,教你如何安装jenkins,而你使用了类似于这个内容的dockerfile,那么会在jenkins构建编译的时候产生如下两个错误:

第一:缺少 docker-compose

出现这个状况,当然是可以解决的。首先进入容器,然后找到官方的安装docker-compose进行安装,jenkins使用的是linux直接找到对应的linux安装资料即可。

第二:权限问题

从容器内手动安装 docker-compose 会出现无法安装的情况,原因是jenkins 用户没有安装docker-compose 的权限

解决上述问题,当然可以切换 root 用户,但是笔者使用最笨最直接的方式,从构建镜像的时候就直接不使用 jenkins 用户,所以教程中并没有最后一句 user jenkins 。这样做目的是让教程步骤更顺利

tips:正式生产环境不建议直接切换到 root 用户运行

运行 jenkins 命令一开始是这样的:

# docker run --name jenkins -p 8080:8080 -p 50000:50000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v $(which docker):/bin/docker \
  -v /var/jenkins:/var/jenkins_home \
  -d auto-jenkins

这样会造成构建的时候找到一个根本不存在的目录上

其实就是第三句 将/var/jenkins 改成 /var/jenkins_home 就解决这个问题了。

此时此刻,如果你曾经遇到过这样的问题,哥现在已经给你擦眼泪了。

当然这里不仅仅有这些问题的存在,只是有一部分在做这个教程的时候没有截图,就不再阐述了。

写在最后

其实笔者曾google过这些教程,但是一无所获,发觉挺多人使用ubuntu的,就是找不到一个centos的案例。当然笔者也不知道他们为什么喜欢使用ubuntu。这里把实施过程的心得分享给大家,是因为怕很多人跟笔者一样重滔覆辙,没有人帮助的日子挺惨的,也就算这么久以来为社区做些贡献吧。

好了,以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,如果有疑问大家可以留言交流,谢谢大家对www.887551.com的支持。