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默认创建admin用户,初始密码通过jenkins容器log中查看,或者直接查看问题:/var/jenkins_home/secrets/initialAdminPassword
docker logs jenkins
接下来一步步进去安装推荐的插件,创建第一个管理员用户,进入主页面:
在插件管理中安装Manage Jenkins-> Manage Plugin中安装:Locale,Localization: Chinese (Simplified)
配置为中文:Manage Jenkins-> Configure System中Locale配置成: zh_CN,通过如下方式重启jenkins:
http://serverip:8080/restart
4. 新建任务
上面有6个菜单选项,接下来分别配置源码路径(github,gitlab,svn等),触发条件(定时触发,代码提交触发,循环触发等),
注意以下几点:
- 默认用户名为容器启动的用户名,我这里用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
把生成的token保存起来,后续需要把token设置到jenkins中。
- jenkins配置github server
在Manage Jenkins-> Configure System中配置github server
把生成的token贴到Secret输入框中,jenkins默认的github hook URL为:http://serverip:8080/github-webhook/,serverip是jenkins宿主机ip,这里我们不改动它,github上有commit提供时就通过对该URL发post请求通知jenkins触发构建。 - github配置hook
在仓库Settins->webhook中设置jenkins的webhook URL,这里填写:http://serverip:8080/github-webhook/
Secret输入账户密码,到这里一切都设置完成了。github仓库上有代码提交->通过webhook通知jenkins->jenkins携带token访问github仓库->pull代码->构建
6. 测试
上传代码,查看是否能触发自动构建:
可以看到立马触发了一次构建,有几个小问题需要注意:
- 容器中需要有go环境,可以把go解压到/var/jenkins_home目录下去,并jenkins中设置go路径加到环境变量
- 或者以root用户启动容器,进入容器的交互终端通过apt安装go环境,建议第一种,最好不要用root用户启动容器
- 构建命令可以做成一个脚本,做到同时构建和部署,这里只是简单go build下项目