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

2022-05-21 10:45:36 浏览数 (2)

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

代码语言:javascript复制
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/

小案例测试:

代码语言:javascript复制
// 写流水线的脚本(声明式、脚本式)
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有问题导致,所以大家测试一定要注意细节

0 人点赞