CentOS安装 Jenkins, 并自动部署maven微服务项目

jenkins 介绍

Jenkins是开源CI&CD软件领导者, 提供超过1000个插件来支持构建、部署、自动化, 满足任何项目的需要。

CI&CD介绍

continuous integration & continuous delivery (持续集成与持续交付), 与字面意思相同, 指在软件工程中, 一种项目实践, 其生命周期为


编码 > 构建 > 测试 > 发布 > 部署 > 运行 > 监测 > 迭代 > 编码 .....

jenkins 安装

1.进入 https://jenkins.io/zh/download/ 选择对应的操作系统, 下载具体的 jenkins 包, 本文以 CentOS 为例, 使用 yum 进行安装(无需下载 rpm 包)

2.输入以下内容(为 jenkins yum 源仓库文件)


$ sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
$ sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key

3.确保当前服务器有jdk, 一般来说 jdk8 满足大部分版本的 jenkins 运行时要求

4.使用 yum 安装

$ yum -y install jenkins

5.进入 jenkins 运行文件目录, 运行 jenkins war 包

# 进入应用程序根目录
$ cd /usr/lib/jenkins
# 启动 jenkins
$ nohup java -jar jenkins.war --httpPort=8088 >gomyck.log 2>&1 &
# 查看运行情况
$ tail -f ck.log

6.使用浏览器访问: http://host:8088 来访问 jenkins

7.按照 jenkins 提示, 进行初始化安装, 并在提示指定位置(服务器磁盘位置, 使用 cat 命令查看该文件即可)找到初始化管理员秘钥, 输入后, 进入重置密码界面, 重置管理员密码

8.安装 jdk 工具, 进入主页面后, 点击左侧导航栏 > Manage jenkins > Global Tool Configuration > 找到 JDK 配置

添加别名(随意): jdk_gomyck
JAVA_HOME(不能是 jre): /usr/share/java-1.8.0/jdk1.8.0_191

9.在同级页面 > 找到 maven 配置 > 点击新增安装

选择从 apache 安装, 选择版本: 3.6.2 (根据自己的项目 maven 版本选择)
添加别名(随意): maven-gomyck
勾选自动安装

10.点击保存

配置简单的 CI&CD 环境

配置好构建工具后, 点击左侧菜单 > 新建 item > 输入一个构建项目名称: gomyck-demo(名字最好统一前缀, 按照项目名起后缀), 项目类型选择: freestyle project, 点击确定

进入配置界面, 按照以下操作顺序配置

1.通用模块> 勾选: 丢弃旧的构建, 策略为log rotation, 保持构建的天数为: 1, 保持构建的最大个数: 2 (以实际项目需求为准, 确保无回滚风险即可)

2.源码管理模块> 勾选 subversion
  --|Repository URL 为代码仓库绝对路径 exp: http://192.168.1.1/svn/repo/xxxx/my_demo
  --|Credentials 点击添加, 输入对此仓库具有读权限的 svn 账号密码
  --|Local module directory 在~/.jenkins/workspace 下, 会同步创建 item 名称的文件夹, 这个选项会在 item 文件夹下再建立一层文件夹
  --|Repository depth 选择 infinity 即可, 即下载仓库的所有文件
  --|Check-out Strategy 根据自己实际需求选择, 我选的最后一个, 每次更新都还原本地的版本, 然后在更新, 避免冲突
  --|勾选 Quiet check-out
  --|源码库浏览器选择自动
  
3.构建触发器(如果需要)> 在身份令牌里输入你自己生成的令牌, 然后输入JENKINS_URL/job/holystar/build?token=TOKEN_NAME 即可触发构建

4.构建环境> 勾选 Delete workspace before build starts

5.构建> 添加调用 maven 顶层目标, maven 版本里选择: maven-gomyck, 目标: install

6.构建> 添加执行shell, 在命令中填入: 
  echo '开始部署...'
  cp -f -r ./xxxx/target/xxxx.jar /usr/share/gomyck/xxxx
  cd /usr/share/gomyck/xxxx
  sudo ./startup 
  echo '部署结束...'

starup 为启动脚本

点击保存后, 即可在 my views 中找到刚才添加的 item, 点击构建, 然后在左侧执行状态中可以查看构建日志

检查服务可用性, 如有疑问, 请在右下角给我留言

2020-05-08更新

jenkins 与 gitlab 集成使用

1.点击gitlab右上角头像, 选择 setting > access Tokens > 生成一个可用的授权 token, 留着给 jenkins 用

2.安装 jenkins, 安装时一并安装 git 插件, gitlab 插件, 后面要用

3.这里默认 jenkins 环境已经安装完毕, 具体可参照本篇文章环境配置部分

4.选择manage jenkins > configure system > 找到 gitlab 配置, 按照下述配置填写, 并点击 test connection 测试是否成功

Connection name	 随便写

Gitlab host URL	你的 gitlab 仓库位置

Credentials	点击添加, 添加一个 token 类型的 key, 这个 token, 就是第一步生成的

5.新建 ITEM > name: gomyck-demo > 选择 freestyle project

GENERAL :
  gitlab connection : 选中配置的连接
  
源码管理: 
  选择 git, 按照提示, 输入即可, 一定要指定分支
  
构建触发器: 
  选择 gitlab webhook
    1. 所有默认选项都不要动, 只点高级: 在 Allowed branches 中选择 Filter branches by name
    2. 在 include 中输入你想要过滤的分支, 也就是说, 只有这个分支提交代码时, 才会触发构建
    (所有分支提交都会触发钩子, 但是 jenkins 要判断这个钩子是哪个分支触发的, gitlab 在调用 jenkins 时, 会传个参数, 告诉 jenkins 是哪个分支触发的钩子)
    3. 在 Secret token 这项后面点 generate, 生成个 secret token, 后面要用
    
构建环境:
  勾选第一项: 删除工作空间 before starts
  
构建:
  选 maven 构建, 目标是 install
  新增 shell, 具体看下面
  
构建后操作:
  Publish build status to GitLab (此操作会把构建结果同步到 gitlab, 具体去 gitlab 工程分支下, 看 commit 记录, 后面会有 对号 或者 叉叉)

构建的 shell

$ cp -f $WORKSPACE/target/xx.jar /usr/share/gomyck/xx/
$ sshpass -p xxxx ssh root@xx.xx.xx.xx "mv -f /usr/share/gomyck/xx/xx.jar /usr/share/gomyck/xx/backup/xx.jar.`date "+%Y-%m-%d-%l-%M-%s"`"
$ sshpass -p xxxx scp /usr/share/gomyck/xx/xx.jar  root@xx.xx.xx.xx:/usr/share/gomyck/xx/
$ mv /usr/share/gomyck/xx/xx.jar /usr/share/gomyck/xx/xx.jar.`date "+%Y-%m-%d-%l-%M-%s"`
$ sshpass -p xxxx ssh root@xx.xx.xx.xx "cd /usr/share/gomyck/xx/; sh startup"

6.回到 gitlab 选择工程, 点击左侧 setting > integration > 在 url 中填写 构建触发器 时, jenkins 提示的通知地址, 在 secret token 中填写, 在 jenkins 中生成的 secret token

7.保存之后, 点击 test 测试一下, 如果 200, 说明调用成功 (这里有个坑, test 通知传输的分支是 master, 如果与 jenkins filter 的分支不一致是不会触发构建的, 必须使用 git 提交对应的分支才会触发)



相关文章:
⤧  上一篇 Linux修改包管理镜像 ⤧  下一篇 zsh 安装使用