jenkins + GitHub 实现项目自动化部署
服务器配置:
- 操作系统:CentOS 7.6 64位
- CPU:1核
- 内存:2GB
- 公网带宽:1Mbps
一、安装 Java SDK
1、进入根目录,查看是否有 Java
环境
cd /
java -version
有环境:
无环境:
2、若已经有环境,则直接去安装 nginx
,若无环境,这里我们安装 java-1.8.0
// 检索 `yum` 中有没有 `java1.8` 的包
yum list java-1.8*
// 开始安装
yum install java-1.8.0-openjdk* -y
// 查看版本
java -version
二、安装 nginx
1、通过 rpm
安装 nginx
rpm -Uvh http://nginx.org/packages/centos/7/noarch/RPMS/nginx-release-centos-7-0.el7.ngx.noarch.rpm
sudo yum install -y nginx
2、安装完成后一些文件夹位置和操作如下
// 启动 nginx
nginx -c nginx.conf
// 网站文件存放默认目录
/usr/share/nginx/html
// 网站默认站点配置
/etc/nginx/conf.d/default.conf
// 自定义Nginx站点配置文件存放目录
/etc/nginx/conf.d/
// Nginx 全局配置文件
/etc/nginx/nginx.conf
// 重启 nginx
nginx -s reload
// 基于 nginx 的静态部署
server {
listen 80;
server_name _;
root /usr/share/nginx/html;
index Home.html;
}
3、安装完毕之后,我们需要启动 nginx
,启动成功后,访问服务器的 ip
地址,如下图即成功
三、安装及启动 jenkins
1、下载安装 jenkins
wget http://mirrors.jenkins-ci.org/redhat/jenkins-2.244-1.1.noarch.rpm
yum -y localinstall jenkins-2.244-1.1.noarch.rpm
2、jenkins
主要目录
// jenkins 安装目录,WAR 包会放在这里
/usr/lib/jenkins/
// jenkins 配置文件,端口,JENKINS_HOME 等都可以在这里配置
/etc/sysconfig/jenkins
// 默认的 JENKINS_HOME
/var/lib/jenkins/
// Jenkins 日志文件
/var/log/jenkins/jenkins.log
3、启动并配置 jenkins
进入配置文件将启动用户修改为 root
,默认是 Jenkins
。
vim /etc/sysconfig/jenkins
...
JENKINS USER = "root"
...
// 启动Jenkins
systemctl start jenkins
// 关闭 jenkins
$ systemctl enable jenkins
在浏览器输入 http://你的ip地址:8080
,进入以下界面即成功
注意:这里需要开放
8080
端口
4、根据界面提示信息去查看密码
cat /var/lib/jenkins/secrets/initialAdminPassword
5、将查到的密码粘贴到输入框,点击继续
6、出现如下安装插件的界面,选择安装推荐的插件,等待安装完毕
7、创建第一个用户,实例配置保持默认即可,这样我们就可以开始使用 jenkins
了
8、出现如下界面,那么 jenkins
就安装成功了
四、github
生成 Personal Access Token
1、github --> 头像 --> Settings --> Developer settings --> Personal access tokens --> Generate new token
2、勾选如下图所示,最后点击 generate token 生成令牌即可。
3、注意!生成令牌之后一点要记录下来,因为只显示一次
五、github
设置 GitHub webhooks
(具体需要持续集成的项目),新建或者设置现有项目的 webhooks
选项,url
:部署的服务器的 IP
+ 端口 + github-webhook
六、设置 jenkins
的 github
配置
1、jenkins
创建一个新任务,填写你的任务名称,并选择构建自由风格项目(很奇怪为什么第一条没有汉化 -.-)
2、Manage Jenkins --> Configure System
3、找到 GitHub
选项 --> 添加 Github
服务器 --> GitHub Server
4、勾选 “管理 Hook
”,添加 --> Jenkins
5、在弹出的窗口中,如下图配置,这里需要用到之前生成的令牌
6、选择生成的凭证,测试 jenkins
连接 github
服务器,如下图所示则配置成功,记得在页面底部保存配置。
七、设置 jenkins
的项目配置
1、进入该项目的配置项
2、选择 github
项目,并填入项目 URL
(复制你浏览器上的地址即可)
3、在 源码管理下选择 git
,并输入 Repository URL
(克隆下载你项目的地址)
4、出现上图中的错误,是我们没有安装 git
的原因。
// 监测是否安装了 git
rpm -qa | grep git
// 安装 git
yum install git -y
5、重新刷新 jenkins
页面,重新填入 url
,可以看到错误已经消失。
接着我们选择 Credentials
,若下拉选项中有,则直接选择即可。
若没有,点击添加 --> jenkins,添加一个 Username with passwrod
类型的权限用户,直接用 github
的登陆名称和密码创建。
添加完之后会出现下拉选项,最终配置如下图所示。
6、构建触发器 + 构建环境 + 绑定配置
点击新增并选择 secret text
选项,在新出现的选项中选择添加的权限用户
7、构建配置,添加执行 shell
。
既然可以执行 shell
命令,我们先来执行 pwd
,看下默认的工作目录是在哪里。
保存后,我们点击立即构建,就会在 build history
下面看到本次构建的 ID
(蓝色即构建成功,红色即失败)
点击构建 ID
右边的小三角,选择控制台输出。
可以看到 jenkins
的默认工作目录在 /var/lib/jenkins/workspace/ceshi
。
8、编写 shell
命令。
不同的前端所用的技术框架是不一样的,所以这里需要根据你自己的项目来进行配置。
这里我以打包一个简单的 h5
页面为例,构建打包代码文件并解压到 nginx
的指定目录,命令如下:
// 当前目录
pwd
// 压缩所有文件
tar -zcvf ceshi.tar.gz *
// 将打包的压缩文件解压到 nginx 映射目录
tar -zxvf /var/lib/jenkins/workspace/ceshi/ceshi.tar.gz -C /usr/share/nginx/html
cd /var/lib/jenkins/workspace/ceshi
// 删除项目打包后的残留
rm -f *
八、测试配置结果
还记得我们之前配置 nginx
成功后的页面吗,就是下面这个,现在我们随便写一个页面来替换掉他。
将改动的代码提交到 master
分支,可以看到 Jenkins
会自动构建并新增一条构建记录,然后我们访问你的服务器 IP
,可以看到页面已经改变
参考文献:
部署Jenkins
一套真实前端开发环境搭建+可持续集成+自动化部署实践(第一篇环境搭建配置)
一套真实前端开发环境搭建+可持续集成+自动化部署实践(第二篇 jenkins关联 GitHub自动打包部署)
jenkins 的参数化构建
GitLab+Jenkins实现持续集成+自动化部署