Jenkins初体验-安装与部署服务

时间:2019-10-28
本文章向大家介绍Jenkins初体验-安装与部署服务,主要包括Jenkins初体验-安装与部署服务使用实例、应用技巧、基本知识点总结和需要注意事项,具有一定的参考价值,需要的朋友可以参考一下。

一、概述

1.简介

  在工作中接触到CD/CI,Devops相关的技术,本文记录Jenkins的基本使用。Jenkins是一款开源的持续集成工具,能够集成一套自动化部署任务。

  目标

  1. 通过jenkins从github拉取代码(web应用)
  2. 通过jenkins进行maven编译打包
  3. jenkins发送打好的jar包,发送到另一台需要部署的虚拟机上(已安装docker)
  4. 通过dockerfile打新镜像
  5. 停掉已运行的容器,并启动新的容器

2.环境准备

  两台虚拟机 (实现利用Jenkins从github拉取代码,并通过maven打包,部署到另一台服务器的docker容器中)

    a.一台安装了docker (用于部署程序)

    b.一台安装了maven jdk8 git (用于安装jenkins,并拉取代码,编译打包)

二、安装、启动、配置Jenkins

1.下载Jenkins

  本文采用部署war包的方式安装Jenkins,首先下载jenkins war包。

  

$ wget http://mirrors.jenkins.io/war-stable/latest/jenkins.war

  官方链接:

  1.安装向导: https://jenkins.io/zh/doc/book/installing/#setup-wizard

  2.war包下载: http://mirrors.jenkins.io/war-stable/

2.启动Jenkins

  通过war包的方式启动Jenkins的方式很简单,直接使用java -jar命令就可以启动了,Jenkins默认端口是8080 如果需要指定端口可以修改启动参数

$ java -jar jenkins.war --httpPort=9090

   启动成功后会自动生成admin账号以及密码,第一次登录时需要用到

 3.初次登录Jenkins

  访问部署Jenkins那台服务器的9090端口,输入初始密码

  进入安装向导,选择【安装推荐插件】,当然也可以自定义需要安装的插件

  推荐的安装的插件如下图,等待下载安装。

  

  插件下载安装后,创建管理员账号

  接下来配置Jenkins实例绝对地址(本文采用默认URL),这个值会和Jenkins参数BUILD_URL有关

  保存后,开始使用Jenkins,使用刚配置的管理员账号登录即可

 

  补充安装插件:

  由于我们会将jenkins打好的包发送到另外一台服务器进行部署,因此需要再安装【Publish Over SSH】【Publish Over FTP】插件。

  使用admin账号登录jenkins,点击【系统管理】-【插件管理】-【可选插件】,搜索"publish over",选择【Publish Over SSH】【Publish Over FTP】插件,并直接安装。

  

 

 

   配置ssh,点击【系统管理】-【系统设置】,新增,输入远程服务器ip,以及用户名和密码,并填写远程服务器的访问路径(这里是根目录) 点击test查看是否连接成功,成功后保存配置即可

  

  

 三、任务创建与执行

1.【方式1】创建自由风格的任务

  下面将创建一个基于上下游自由风格的任务,实现我们的目标

  创建好后,在配置界面,可以看到自由风格的任务包含下面几点内容

  1.在【General】中,选择参数化构建过程,使用文本参数,定义参数为branch,即在构建任务前,可以传递的参数。

  

  2.【源码管理】选择git,输入仓库地址,并添加凭据,类型选择【Username with password】,用户名、密码分别填写github账号和密码。

   3.【构建】,添加两个构架步骤,1.执行shell,2.Send files or execute commands over SSH

  shell命令步骤用于使用maven打包

  Send files or execute commands over SSH 用户发送打好的包到部署服务器

  这里补充说一下,jenkins自带了很多环境变量可以直接使用,例如工作目录 WORKSPACE等,访问jenkins这个路径可以查看 http://192.168.152.133:9090/env-vars.html/

  shell命令步骤:通过maven打包

cd eureka    # 进入项目工程
mvn clean package -Dmaven.test.skip=true    # maven 打包

   

   Send files or execute commands over SSH 步骤

  这个步骤会指定需要被发送的jar包,以及发送到远程服务器的指定路径,并构建一个新的镜像进行部署。

  补充:基础镜像Dockerfile(基础镜像安装openjdk 1.8),基础镜像可以安装配置一些软件、环境,之后需要部署的程序都可以FROM这个基础镜像

FROM centos:7

RUN yum -y install java-1.8.0-openjdk java-1.8.0-openjdk-devel
View Code 基础镜像Dockerfile
$ docker build -t base_image .
View Code 构建基础镜像

  具体配置:

  • Name:选择之前配置的需要远程部署的主机
  • Source files:需要发送到远程主机的文件(注意路径,这里使用相对路径,相对于在jenkins workspace这个任务的路径 这里是相对于这个路径: /root/.jenkins/workspace/Job1 )
  • Remove prefix:删除路径前缀(发送的文件名会受【Source files】配置的影响,这里需要删除路径前缀)
  • Remote directory:远程主机需要接收包的路径(这个路径是相对路径,相对于之前配置远程服务器信息的Remote Directory,由于之前配置的是根路径,因此这里可以使用绝对路径)
  • Exec command:包发送成功后,执行的命令

    # 在远程服务器上
    cd /data/deploy
    docker build -t eureka_image:${branch} .
    docker run -dit -p 18080:8761 eureka_image:${branch} /bin/bash #暴露端口 宿主机18080端口与容器8761端口映射

   附上需要部署程序的Dockerfile

FROM base_image:latest

ADD eureka-0.0.1-SNAPSHOT.jar /data/eureka.jar

WORKDIR /data

ENTRYPOINT ["java","-jar","eureka.jar"]

EXPOSE 8761

  执行

  配置完成后点击保存,Build with Parameters,输入参数(需要部署的分支),点击开始构建

  

  点击正在进行的任务,【控制台输出】可以看到构建日志

  可以看到最后是SUCCESS,说明构建成功。如果构建失败可以根据日志提示进行排查。

  访问服务器18080端口,看到Eureka界面,说明部署成功。

2.【方式2(推荐)】创建Pipeline任务

  创建以及配置

    新建一个【流水线】任务,创建好后直接编写Pipeline script

 

  

pipeline{
    agent any    //代理
    options {   // 针对流水线的控制选项
        timeout(time: 10, unit: 'MINUTES') 
    }
    parameters {    //    1.构建构建参数 
            string(name: 'BRANCH', defaultValue: 'dev', description: '分支')    
    }
    stages {    //    2.包含以系列stage
        stage('Pull Code') {        //    3.stage 定义代码拉取阶段
            steps{        //    6.步骤  
                git branch: '$BRANCH', credentialsId: 'your credentials', url: 'https://github.com/SherryXRJ/test.git'     //    9.选择git仓库
            }
        }
        
        stage('Build') {            //    4.stage    定义构建阶段
            environment {       //    10.环境变量定义
                skipTest = 'true'
            }
            
            input {                //    11.pipeline用户输入框
                id "Deploy" // 默认与stage一致
                message "Should we Build now?"
                ok "Yes, we should."
                submitter "admin"  // 可以提点击确认的用户 
                parameters {    //    14.参数定义
                    string(name: 'MSG', defaultValue: 'admin', description: 'Who should I say hello to?')
                }
            }
            steps{        //    7.步骤
                sh 'printenv'
                sh 'echo msg: ${MSG}'
                sh ''' cd eureka  
                mvn clean package -Dmaven.test.skip=$skipTest '''
            }
        }
        
        
        stage('Deploy'){            //    5.stage 定义部署阶段
            when {        //    12.pipeline scripe 条件分支
                allOf {  // allOf not anyOf
                    expression { return params.BRANCH == 'dev' }    // 只有dev分支才部署
                    
                    // other conditions ...
                }
                  
            }
            
            steps{        //    8.步骤
                sh ''' echo ${PERSON} '''
                //    15.ssh脚本
                sshPublisher(publishers: [sshPublisherDesc(configName: 'remote_server', transfers: [sshTransfer(cleanRemote: false, excludes: '', execCommand: '''cd /data/deploy
docker build -t eureka_image:${branch} .
docker run -dit -p 18080:8761 eureka_image:${branch} /bin/bash''', execTimeout: 120000, flatten: false, makeEmptyDirs: false, noDefaultExcludes: false, patternSeparator: '[, ]+', remoteDirectory: '/data/deploy', remoteDirectorySDF: false, removePrefix: 'eureka/target/', sourceFiles: 'eureka/target/eureka-0.0.1-SNAPSHOT.jar')], usePromotionTimestamp: false, useWorkspaceInPromotion: false, verbose: false)])
            }
        }
    }
    post {        //13.post步骤
        success {   //  always changed failure success unstable aborted
            echo "success"
        }
        
    }
}

  这里对上面的pipeline script进行说明:

  • parameters: 注释1 14
    •   构建参数,定义任务参数。在自由风格的任务中,参数化构建是在界面上进行的新增,这里通过脚本定义,参数为需要拉取的分支
  • stages:注释2
    •    需要在stages中定义一系列的stage
  • stage:注释3.4.5
    •   可以定义阶段名称
  • steps: 注释6.7.8  
    •   具体执行步骤,可以为shell脚本、流水线脚本等
  • 流水线脚本:注释9.15
    •   可以通过Jenkins界面操作生成流水线脚本
  • environment:注释10   
    •   环境变量,在本任务中定义环境变量,该环境变量仅在每次执行的任务中生效
  • input:注释11                 
    •   用户输入框,例如这里配置,当任务执行到‘Build’阶段时,需要admin用户点击确认,才能继续执行
  • when:注释12
    •   条件判断,满足了这些条件才能执行之后的步骤(上面的脚本中只有当构建的分支为dev时,才进行Deploy步骤)
  • post:  注释13
    •   当该任务状态发生改变时,会触发post里对应阶段的内容(状态包括:always, changed,failure,success,unstable,aborted)

  

  补充说明通过Jenkins界面生成流水线脚本,以git脚本为例(ssh脚本同理)

  

  可以参考官网语法:Jenkins官方语法介绍

  启动

  

  可以看到【阶段视图】

  

   

  外部访问成功(由于虚拟机重启,ip地址变更,这里的ip地址与之前的ip地址不同,请读者忽略这个问题)

 

原文地址:https://www.cnblogs.com/Sherry-XRJ/p/10966660.html