POST
这篇文章是讲解从无到有的 JENKINS+GITHUB
持续集成环境的搭建。JENKINS
和其他平台的结合搭建,比如码云
啥的配合,操作过程大同小异。下面,我们 STEP BY STEP
地讲解一下,如有不合理的地方,还请指出☞
购买一个服务器
为什么要购买服务器呢?
因为如果你本地搭建 jenkins
环境之后,跟 github
联通不了--需要 ip
来设置 github
webhooks
的。当然,有什么其他操作可以联通 github
的,还望指出:)
注意:如果你在本地运行
jenkins
,那么你的webhooks
可能是https://localhost:8080/github-webhook/
,这不会起作用的,因为webhooks
只在网络中起作用。你可以参考文章Adding a GitHub Webhook in Your Jenkins Pipeline来了解一下。
这里,我购买了阿里云的低配服务器,操作系统是 centos7
。购买好服务器之后,我简单通过 NGINX
来代理,展示一个简单的静态页面。当然,这里并不是我们的重点,所以就不展开来说了。
需要注意的是,你要配置安全组,才能看到静态的站点。我自己配置如图:
在上传资源之后,这时你打开阿里云上相关的ip地址,如果你没有看到期望的页面,请检查一下安全组的设置。
准备一款终端
为什么要准备呢?
我们不可能总是登录自己的阿里云账号,然后切换到自己的服务器那里连接它,然后再屁颠屁颠地操作程序吧~
如果你喜欢,那你就保留那种操作习惯吧。只能说你时间真多~
这里,自己在 mac pro
和 dell
电脑上都安装了 SecureCRT【一款支持SSH(SSH1和SSH2)的终端仿真程序】,远程控制自己的服务器。我觉得挺好用的,喜欢!❤
搭建 JENKINS 环境
服务器和远程控制的仿真程序都已经准备完成了,接下来,我们在服务器上面搭建所需的环境。
安装 java 环境
先在服务器上安装 java
环境,可参考这篇文章操作。安装好java sdk
后,配置好环境。
之后,你可以通过java -version
等命令查看或验证,下面是自己服务器上java
的安装信息和相关路径的设置:
1、路径/usr/lib/java
是本机下载好jdk-8u231-linux-x64.tar.gz
压缩文件上传到服务器的存放文件路径,解压后可以将其压缩包删除。
2、/usr/java/java8
是自己在服务器上解压文件路径。
安装 jenkins
按照下面的命令行进行操作:
$ yum install yum-fastestmirror -y #安装自动选择最快源的插件
#添加Jenkins源:
$ sudo wget -O /etc/yum.repos.d/jenkins.repo http://jenkins-ci.org/redhat/jenkins.repo
$ sudo rpm --import http://pkg.jenkins-ci.org/redhat/jenkins-ci.org.key
$ yum install jenkins #安装jenkins
安装完毕后,你就可以启动 jenkins
了:
sudo service jenkins start
当然,启动之后,它可能出现下面的问题:
图上表明是你 java
的引入路径有问题了~
上图意思是:启动程序找不到 java
。
那么,你需要执行 vim /etc/init.d/jenkins
命令进入文件,修改其路径就行了,如下:
备注:
linux
使用find .|xargs grep -ri "要查找的字符串"
命令查找包含某字符串的文件
顺利启动后,控制台有个 success
的提醒。这时,你在浏览器上输入 http://your server ip:8080
就可以打开了,呈现信息如下图。jenkins
的默认端口号是 8080
,当然,你可以执行 vim /etc/sysconfig/jenkins
进入文件修改端口号等。
同上,如果网页不能打开,请查看下自己在阿里云那里有没有设置好安全组了~
嗯,接下来就是一步步解锁 Jenkins
了。
Jenkins 的使用
我们能在自己的服务上面成功安装并运行了 jenkins
,下面我们来升级打怪,使用下 jenkins
。
解锁
根据提示,我们执行 cat /var/lib/jenkins/secrets/initialAdminPassword
命令得到 Administrator password
,然后点击继续按钮,往下走。
我们选择安装推荐的插件
,等待安装完毕。如果有安装失败的插件可以跳过,之后可以根据需求安装。【安装过程请保持网络的顺畅】
初始化账号和密码
你可以创建自己的管理员用户信息,当然也可以点击使用 admin 账号继续
链接跳过。
设置完成之后,进入界面:
关联 github
我们的目的是要将github和jenkins结合起来,进行自动化发布。现在来关联下 github
。以我自己的 github
账号为例,进行配置。
生成 secret text
secret text
在 github
上被称为 token
。
进入
github
-->Settings
-->Developer settings
-->Personal access tokens
->Generate new token
之后生成一个新的 token
:
填写好 token
的名称,勾选完上面的两个选项,之后按 Generate token
按钮进行确认:
自己先保存此 token
,如果丢失,之后再也无法找到这个 token
了。
设置 github webhooks
接着,选择自己的一个 github
项目,这里我拿自己的博客仓库https://github.com/reng99/blogs
作为例子:
进入
github
上指定的项目 -->Settings
-->Webhooks
-->Add Webhook
--> 输入刚刚部署jenkins
的服务器的IP
Payload URL
的内容就是http://your ip:8080/github-webhook/
。
jenkins 的 github 配置
正确安装之后,接着,我们来配置Github Plugin,如果你还没安装 github plugin
,那就进入系统管理 --> 插件管理 --> 可选插件
进行安装。(新版本的Jenkins)中已经帮你做了这一步。
这里默认已经安装了 github plugin
,下面来配置~
配置 GitHub Plugin
系统管理 --> 系统设置 --> GitHub --> 添加Github服务器
如下图所示:
API URL
输入 https://api.github.com
,凭证 Credentials
点击添加,类型选择 Secret Text
,具体如下图所示:
点击添加
按钮后,下拉选择凭证,选择你新增的那个凭证,然后点击连接测试
按钮,提示 Credentials verified for user xxx, rate limit: xxx
信息,则表明有效。
创建一个 freestyle 任务
进入主页 --> 新建任务
General设置
填写 GitHub project URL
,也就是你的主页 https://github.com/your_name/your_repo_name
,我这里使用我的博客仓库进行尝试 https://github.com/reng99/blogs
配置源码管理
勾选 Git
选项之后,就会出现相关的填写项,根据下图的指引来填写就行了~
- 填写项目的
git
地址, eg:https://github.com/your_name/your_repo_name.git
- 添加
github
用户和密码(要是一个有写权限的github
账号,此步骤见下图) - 选择
githubweb
源码库浏览器,并填上你的项目URL
,这样每次构建都会生成对应的changes
,可直接链到github
上看变更详情
点击添加
增加 Credentials
:
构建触发器
勾选 GitHub hook trigger for GITScm polling
即可~
构建环境配置
勾选Use secret test(s) or file(s)
即可~
设置绑定
选择绑定 --> 点击新增按钮 --> 选择Secret text --> 下拉选择你之前设置的secret token --> 之后应用
设置构建
我这里基本没怎么操作,你可以根据自己的需求来编写构建的脚本了。
构建后操作
你可以根据需求更改构建后的操作,我这里都默认。
验证构建
上面的工作都完成之后,修改下我的 blogs 仓库的代码,提交后,刷新下自己的 jenkins 地址
,出现下面的现象说明成功了~(ps: 第一次构建的时候比较耗时,请耐心等待,时不时刷新下页面了)
错误处理
在进行集成的过程中,你可能会遇到下面的这些问题~
重新安插插件
在进行初始化的时候,一些插件我们可能会安装失败。不过,不要在意,你可以进来之后再针对需要的插件进行安装。
安装成功之后,进入 /restart/
路径对 jenkins
重启。
再次进入就正常了,美滋滋~
git command 错误
进入服务器查看是否安装了 git
# git version
没有git,此时需要安装git。
# yum install git
构建触发器找不到github选项
在构建触发器的时候,找不到选项 Build when a change is pushed to Github
那是因为新版的 jenkins
将其修改为 GitHub hook trigger for GITScm polling
了。