docker部署jenkins

1. 简介

在软件开发过程中经常会提到CI/CD的概念，CI(Continuous Integration)持续集成，开发人员每天通过git等向仓库提交代码更新，代码提交后实现自动化构建，测试，部署，方便开发人员尽早发现和解决问题。
jenkins是一款开源持续集成软件工具，常用于代码自动构建，测试，部署。

2. 安装

在docker中部署jenkins，安装docker，平台为ubuntu20.04 server版。

安装docker

sudo apt install docker.io  // 安装docker
sudo usermod -a $(whoami) -G docker    // 把当前用户添加到docker用户组，否则非root用户没有权限使用docker命令

pull jenkins镜像

docker search jenkins    // 查找jenkins镜像
docker pull jenkins/jenkins  // pull jenkins最新镜像，注意jenkins镜像已经过时了，不要pull错了

启动jenkins容器

sudo mkdir /var/jenkins_home/
sudo chmod 777  /var/jenkins_home/
docker run -u root -it --name jenkins -p 8080:8080 -p 50000:50000 -v /var/jenkins_home:/var/jenkins_home -d jenkins/jenkins

-v把宿主机的/var/jenkins_home目录挂载到容器的/var/jenkins_home，该目录是jenkins的工作目录，主要方便在本地查看容器的文件。

查看容器

docker ps -a  // 查看jenkins容器
docker inspect jenkins   // 查看jenkins容器的完整信息,可通过容器ID或容器名字查看，这里通过名字

3. 访问jenkins

在浏览器中输入:http://serverip:8080/访问jenkins，serverip为docker宿主机的ip，我这里是在腾讯云服务器上搭建的环境，所以serverip即为云服务器ip，页面如下:

jenkins起始页面

jenkins默认创建admin用户，初始密码通过jenkins容器log中查看，或者直接查看问题:/var/jenkins_home/secrets/initialAdminPassword

docker logs jenkins

jenkins初始密码

接下来一步步进去安装推荐的插件，创建第一个管理员用户，进入主页面:

jenkins主页面

在插件管理中安装Manage Jenkins-> Manage Plugin中安装：Locale,Localization: Chinese (Simplified)
配置为中文:Manage Jenkins-> Configure System中Locale配置成: zh_CN，通过如下方式重启jenkins:
http://serverip:8080/restart

4. 新建任务

新建任务.png

上面有6个菜单选项，接下来分别配置源码路径(github，gitlab，svn等)，触发条件(定时触发，代码提交触发，循环触发等)，

image.png

注意以下几点:

默认用户名为容器启动的用户名，我这里用root启动，所以默认为root

github主分支不从master换成main分支

项目URL从https协议换成git协议路径，最后如果jenkins能访问项目路径的话就不会有红色报错了

设置构建条件

设置github hook触发构建，构建方式为执行shell命令: go build .

5. 配置github触发构建

jenkins需要访问github上的仓库，首先github上生成token给jenkins
登录github账户，在Settings-> Developer settings ->Personal access tokens->Generate new token

image.png

把生成的token保存起来，后续需要把token设置到jenkins中。
jenkins配置github server
在Manage Jenkins-> Configure System中配置github server

image.png

image.png

把生成的token贴到Secret输入框中，jenkins默认的github hook URL为:http://serverip:8080/github-webhook/，serverip是jenkins宿主机ip，这里我们不改动它，github上有commit提供时就通过对该URL发post请求通知jenkins触发构建。
github配置hook

image.png

在仓库Settins->webhook中设置jenkins的webhook URL，这里填写：http://serverip:8080/github-webhook/
Secret输入账户密码，到这里一切都设置完成了。github仓库上有代码提交->通过webhook通知jenkins->jenkins携带token访问github仓库->pull代码->构建

6. 测试

上传代码，查看是否能触发自动构建: