【云原生 | Devops篇】Jenkins安装与实战

Jenkins安装与实战

​一、Jenkins安装

1、背景

Jenkins，之前叫做Hudson，由SUN公司启动，2010年oracle收购SUN导致hudson商标归oracle保留，hudson的主要贡献者基于hudson更名为jenkins并持续更新。很长一段时间内lenkins和Hudson继续作为两个独立的项目，每个都认为对方是自己的分支。目前Hudson已经停止开发，最新的版本发布于2016年，而Jenkins的社区和开发却异常活跃。Jenkins是目前市场上使用最多的CICD工具。

• Jenkins是基于Java开发的一种持续集成工具。
• Jenkins作为持续集成工具，持续集成是其核心功能，在核心功能基础之上可扩展实现强大的CD功能。

2、特点

• 开源免费
• 易于安装(基本上算是所有CI工具里安装配置最简单的)
• 多平台支持(windows/linux/macos)
• 主从分布式架构
• 提供web可视化配置管理页面
• 安装配置简单
• 插件资源丰富

3、官网安装文档地址

https://www.jenkins.io/zh/doc/book/installing/

大家最好看着官网文档进行安装，好的开源软件一般官网文档都是写得很好，不然很难火起来。

这边主要演示用docker方式来安装Jenkins，没有安装docker或者不知道docker怎么安装的同学可以先看一下我这篇文章《【云原生 | Docker篇】轻松学会原理｜架构｜安装｜加速（一）》，安装完docker再接着往下看吧

4、开始安装

注意：

• jenkinsci/jenkins 是没有 blueocean插件的，得自己装
• jenkinsci/blueocean：带了的

#自己构建镜像 RUN的时候就把时区设置好 #如果是别人的镜像，docker hub，UTC； 容器运行时 ， -v /etc/localtime:/etc/localtime:ro

docker run \
-u root \
-d \
-p 8080:8080 \
-p 50000:50000 \
-v jenkins-data:/var/jenkins_home \
-v /etc/localtime:/etc/localtime:ro \
-v /var/run/docker.sock:/var/run/docker.sock \
--restart=always \
jenkinsci/blueocean

#/var/run/docker.sock 表示Docker守护程序通过其监听的基于Unix的套接字。 该映射允许jenkinsci/blueocean 容器与Docker守护进程通信， 如果 jenkinsci/blueocean 容器需要实例化其他Docker容器，则该守护进程是必需的。 如果运行声明式管道，其语法包含agent部分用 docker；例如， agent { docker { ... } } 此选项是必需的。 #如果你的jenkins 安装插件装不上。使用这个镜像【 registry.cn-qingdao.aliyuncs.com/lfy/jenkins:plugins-blueocean 】默认访问账号/密码是【admin/admin】

5、安装中

6、安装完成

7、页面访问

8、通过以下命令查找密码

方式一：

方式二：

9、安装默认推荐插件，并且配置用户

选择安装推荐的插件选项即可

出现这个等待自动安装插件完成就好

配置用户,点击右下角保存即可

安装完成

二、Jenkins实战

1、准备一个git项目进行测试

我们以gitee为例，github可能太慢了。需要idea安装gitee插件。或者自己熟悉手动命令也行。

简要说明一下，其实这里用gitee、github或者用gitcode都能实现的，具体用哪个，同学们可以自行选择

步骤：

• idea创建Spring Boot项目

• VCS - 创建git 仓库

• gitee创建一个仓库，本地上传到仓库上

• idea提交内容到gitee

• 开发项目基本功能，并在项目中创建一个jenkinsfile文件

• 创建一个名为 devops-java-demo的流水线项目，使用项目自己的流水线

Jenkins的工作流程

先定义一个流水线项目，指定项目的git位置

流水线启动

1、先去git位置自动拉取代码

2、解析拉取代码里面的Jenkinsfile文件

3、按照Jenkinsfile指定的流水线开始加工项目

不太会写流水线配置文件可以参考官方文档，非常详细的

官网流水线的说明文档：流水线

Jenkins重要的点 1、jenkins的家目录 /var/jenkins_home 已经被我们docker外部挂载了 /var/lib/docker/volumes/jenkins-data/_data 2、WORKSPACE（工作空间）=/var/jenkins_home/workspace/java-devops-demo

• 每一个流水线项目，占用一个文件夹位置
• BUILD_NUMBER=5；当前第几次构建
• WORKSPACE_TMP（临时目录）=/var/jenkins_home/workspace/java-devops-demo@tmp

JOB_URL=http://192.168.88.163:8080/job/java-devops-demo/ 3、常用的环境如果没有，jenkins配置环境一大堆操作 4、jenkins_url ： http://192.168.88.163:8080/

小案例测试：

// 写流水线的脚本（声明式、脚本式）
pipeline{
  // 全部的CICD流程都需要在这里定义

  // 任何一个代理可用就可以执行
  agent any

  // 定义一些环境信息

  // 定义流水线的加工流程
  stages {
    // 流水线的所有阶段
    // 1、编译
    stage('编译'){
        steps{
            // 要做的所有事情
            echo "编译..."
        }
    }

    // 2、测试
    stage('测试'){
        steps{
            // 要做的所有事情
            echo "测试..."
        }
    }

    // 3、打包
    stage('打包'){
        steps{
            // 要做的所有事情
            echo "打包..."
        }
    }

    // 4、部署
    stage('部署'){
        steps{
            // 要做的所有事情
            echo "部署..."
        }
    }
  }

2、远程构建触发

期望效果： 远程的github代码提交了，jenkins流水线自动触发构建。

实现流程：

1、保证jenkins所在主机能被远程访问

可以在云平台配置一个公网IP，让gitee能远程访问

2、jenkins中远程触发需要权限，我们应该使用用户进行授权

3、配置gitee/github，webhook进行触发

测试成功

前面出现两次错误是因为我的地址没有加上用的API Token，下图是生成Token的设置

#远程构建即使配置了github 的webhook，默认会403.我们应该使用用户进行授权 1、创建一个用户 2、一定随便登陆激活一次 3、生成一个apitoken http://cheshi:11b713938dd63ea6dd54b322c362642a5c@192.168.88.163:8080/job/simple-java-maven-app/build?token=lansonli

远程触发：

JENKINS_URL /job/simple-java-maven-app/build?token= TOKEN_NAME 请求即可

以后直接提交push代码就会触发自动构建，不用手动执行触发了

测试官方推荐的gitcode是否也支持这个功能

我用阿里云的服务器，又重新搭了一遍Jenkins，以下就是我测试的结果，其实都能用的

1、复制上面的测试代码提交到gitcode，如果不知道如何使用gitcode可以看一下官方教程

2、配置webhook进行触发

有人说那些apitoken生成过程呢，我这边就直接跳过，因为上面都写的很详细，就不占用篇幅再写一遍了

配置原理还是一样的，这里只要写一下URL，下面勾选一下触发事件，点击提交就可以生效了

3、见证测试结果

经过多次失败后一度怀疑 gitcode是否能用，结果是我多虑了，肯定是能用的，失败是因为我复制的URL有问题导致，所以大家测试一定要注意细节。