Jenkins CI CD

Docker 安装 Jenkins

docker方式安装jenkins命令：

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

命令参数解释：

docker run \
 -u root \  # 使用rooty用户
 -d \  # 以后台运行容器
 -p 8080:8080 \ # 端口映射，主机(宿主)端口:容器端口
 -p 50000:50000 \ # 端口映射，主机(宿主)端口:容器端口
  # 卷挂载，将容器中的/var/jenkins_home目录挂载到docker卷名为jenkins-data（可以通过docker命令查询卷在宿主机哪个位置）
 -v jenkins-data:/var/jenkins_home \
 # 卷挂载，将宿主机的时间配置和容器进行映射（时区映射）
 -v /etc/localtime:/etc/localtime:ro \
 # 卷挂载，将宿主机的docker.sock映射到容器中，容器里面也可以使用docker命令
 -v /var/run/docker.sock:/var/run/docker.sock \
 ## 开启启动，
 --restart=always \
 # jenkins 镜像名，支持流水线的镜像
jenkinsci/blueocean

• /var/run/docker.sock 表示Docker守护程序通过其监听的基于Unix的套接字。 该映射允许
  jenkinsci/blueocean 容器与Docker守护进程通信， 如果 jenkinsci/blueocean 容器需要实例化
  其他Docker容器，则该守护进程是必需的。 如果运行声明式管道，其语法包含agent部分用 docker；例
  如， agent { docker { … } } 此选项是必需的

登录Jenkins

Jenkins访问地址：

http://119.91.146.113:8080

获取管理员密码：
可以通过docker logs Jenkins容器id 获取密码：

1. docker ps # 查询jenkis容器id
2. docker logs jenkins容器id

安装推荐的插件 ----> 创建第一个管理员用户

Jenkins 实战

准备一个git项目推送到gitee进行测试

Jenkins的工作流程

• 新建任务 —> 输入任务名称 ----> 选中流水线 —> 确定。

• 进行任务配置 —> 流水线 —定义(选SCM) -->SCM(选git) —> 添加git仓库地址 --> 有git仓库密码配密码 ----> 脚本路径(Jenkinsfile)

• 回到Dashboard --> Blue Ocean --> 运行（该步骤需要提前在项目的根目录写好Jenkinsfile脚步）

注意： 项目根目录下要配置一个Jenkinsfile文件，用来编写Jenkins流水线脚本

• 流水线启动
  1、先去git位置自动拉取代码
  2、解析拉取代码里面的Jenkinsfile文件
  3、按照Jenkinsfile指定的流水线开始加工项目

流水线Jenkinsfile文件内容脚步demo:

注意：Jenkins上一定要装Docker Pipeline插件，才能使用docker 代理

Jenkinsfile流水线

1. 语法如下示例，内容都要详细注释，记得要装Docker Pipeline插件。
2. 在生成镜像步骤，项目根目录下要有/docker/Dockerfile 文件写好Dockerfile(内容示例看下面)

Jenkinsfile文件内容

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

    //任何一个代理可用就可以执行
   // agent none  //以后所有stage都必须指定自己的
    agent any
    //定义一些环境信息
    environment {
      hello = "123456"
      world = "456789"

      // 当前的工作目录
      WS = "${WORKSPACE}"
      IMAGE_VERSION = "v1.0"

       // 引用Jenkins配置的全局秘钥信息
//       ALIYUN_SECRTE=credentials("aliyun-docker-repo")
    }

    //定义流水线的加工流程
    stages {
        //流水线的所有阶段
        stage('环境检查'){
            steps {
                // 输出jenkins 所有的环境变量
               sh 'printenv'
               echo "正在检测基本信息"
               sh 'java -version'
               sh 'git --version'
               sh 'docker version'
               sh 'pwd && ls -alh'
               sh "echo $hello"
               // 未来，凡是需要取变量值的时候，都用双引号
               sh 'echo ${world}'
            }
        }

        //1、编译 "abc"
        stage('maven编译') {
            // jenkins不配置任何环境的情况下， 仅适用docker 兼容所有场景
            agent {
                // jenkins 在宿主机启动一个 maven容器,
                docker {
                    // maven镜像
                    image 'maven:3-alpine'
                    // 将maven容器里面的/root/.m2目录挂载到jenkins容器里面的/var/jenkins_home目录下面，（jenkins容器里面的目录可以和jenkins启动的maven容器共享.）
                    // 因为容器jenkins_home目录挂载到了宿主机里面，所以相当于挂载到了宿主机里面
                    args '-v /var/jenkins_home/appconfig/maven/.m2:/root/.m2'
//                     args  '-v /a/settings.xml:/app/settings.xml'
                    //docker run -v /a/settings.xml:/app/settings.xml
                }
            }
            // 该步骤的所有命令会在上面的maven容器中运行
            steps {
               // git下载来的代码目录下
               sh 'pwd && ls -alh'
               sh 'mvn -v'
               //打包，jar.。默认是从maven中央仓库下载。 jenkins目录+容器目录；-s指定容器内位置
               //只要jenkins迁移，不会对我们产生任何影响
               sh "echo 默认的工作目录：${WS}"
               //workdir
               // 每一行指令都是基于当前环境信息。和上下指令无关

               // 注意maven命令 -s 参数: 指定settings.xml文件，该文件指的是在jenkins容器里面的jenkins_home目录下面,'
               // jenkins容器里面的目录可以和jenkins启动的maven容器共享.
               // 因为容器jenkins_home目录挂载到了宿主机里面，可以在宿主机的jenkins_home添加好settings.xml文件
               sh 'cd ${WS} && mvn clean package -s "/var/jenkins_home/appconfig/maven/settings.xml"  -Dmaven.test.skip=true '
               // jar包推送给maven repo ，nexus
            }
        }

        //2、测试，每一个 stage的开始，都会重置到默认的WORKSPACE位置
        stage('测试'){
            steps {
                sh 'pwd && ls -alh'
                echo "测试..."
            }
        }

        //3、打包
        stage('生成镜像'){
            steps {
                echo "生成镜像..."
                //检查Jenkins的docker命令是否能运行
                sh 'docker version'
                sh 'pwd && ls -alh'
                echo "开始构建镜像"
                sh 'docker build -t java-devops-demo -f ./docker/Dockerfile .'
                sh 'pwd && ls -alh'

                //镜像就可以进行保存
            }
        }
        //4、部署
        stage('部署') {
            steps {
                echo "部署..."
                sh 'docker rm -f java-devops-demo-dev'
                sh 'docker run -d -p 8081:8081 --name java-devops-demo-dev java-devops-demo'
            }
        }
    }
}

Dockerfile文件内容：

FROM openjdk:8-jdk
LABEL maintainer=fangyajun

#COPY --from=0 /build/target/spring-boot-cicd-test-1.0-SNAPSHOT.jar /app/target/spring-boot-cicd-test-1.0-SNAPSHOT.jar
COPY target/*.jar /app.jar

RUN  apk add -U tzdata; \
## 时区设定
ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime; \
echo 'Asia/Shanghai' >/etc/timezone; \
touch /app.jar;

EXPOSE 8081
ENTRYPOINT [ "java", "-jar", "app.jar", "--server.port=8081" ]

Jenkins parameters 动态参数

parameters 能不能在构建时候传入一些参数进去呢？

pipeline {
   agent any
   // 动态参数，看这里!!!!
   parameters {
       // Boolean值
        booleanParam(defaultValue: false,description: 'test run?', name: 'testRun')
        // 下拉列表,默认值是第一个
        choice(choices: 'Windows-1\nLinux-2', description:'Which platform?', name: 'platform')
        //file(description: 'Select the file to upload', name: 'sample')
        // 多行文本
        text(defaultValue: 'No message', description:'Enter your message', name: 'userMsg')
        // 密码
        password(defaultValue: "userpass1", description:'User password?', name: 'pass')
        // 字符串
        string(defaultValue: "Linux",description: 'What platform?', name: 'platform-noduplicate')
    }
   stages {
      stage('Build') {         
         steps {
            // Get some code from a GitHub repository
            git 'https://github.com/oneslideicywater/common.git'
            // 查看设置的参数
            echo "$params.testRun"
            echo "$params.platform"
            echo "$params.userMsg"
            echo "$params"
         }
      }
   }
}