Jenkins初体验-安装与部署服务
一、概述
1.简介
在工作中接触到CD/CI,Devops相关的技术,本文记录Jenkins的基本使用。Jenkins是一款开源的持续集成工具,能够集成一套自动化部署任务。
目标
- 通过jenkins从github拉取代码(web应用)
- 通过jenkins进行maven编译打包
- jenkins发送打好的jar包,发送到另一台需要部署的虚拟机上(已安装docker)
- 通过dockerfile打新镜像
- 停掉已运行的容器,并启动新的容器
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这个基础镜像
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
FROM centos:7 RUN yum -y install java-1.8.0-openjdk java-1.8.0-openjdk-devel
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
$ docker build -t base_image .
具体配置:
- 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地址不同,请读者忽略这个问题)