jenkins代码部署服务器技术文档

• jenkins安装

1. windows操作系统

Jenkins是由Java开发的，所以需要提前准备Java环境，安装Jenkins之前，还需要先安装Tomcat，因为Tomcat是针对Java的一个开源中间件服务器（容器），基于Java Web的项目需要借助Tomcat 才能运行起来。

Tomcat的官网是： http://tomcat.apache.org/

打开之后，找到最新的版本安装即可，如下图：

下载后解压，其目录如下图所示：

然后进入bin文件夹，执行startup.bat即可安装启动Tomcat服务器，如下图：

3.安装Jenkins

 

进入Jenkins官网： https://jenkins.io/zh/

我们选择针对Windows的稳定版本，如下图：

大概一百多兆，下载有点慢，下载完成后直接点击安装，一路next，但是选择目标路径的时候，记得一定要把Jenkins安装到Tomcat的Webapps路径下（这样才能用浏览器打开Jenkins），如下图：

4. 配置Jenkins

 

Jenkins 安装完成会自动启动 TomCat , 并通过默认浏览器打开：http://localhost:8080/

（你也可以手动进Tomcat的bin/目录下启动startup.bat ，通过浏览器访问：http://localhost:8080/） 如下图：

根据提示，打开： D:\Java\apache-tomcat-9.0.0.M26\webapps\Jenkins\secrets\initialAdminPassword 文件查看密码。将密码填写到输入框中，点击 “Continue” 按钮。

接下来根据提示进行安装，如下图：

安装完插件后，创建管理员账号，如下图：

整个 Jenkins 安装配置完成。操作界面如下：

 

• jenkins安装插件

需要用到的插件有Maven Integration、NodeJS、Publish Over SSH、Git

 

选择系统管理-插件管理

 

点击可选插件，search查询框输入插件名称，勾选插件名，点击Install without restart，等待插件安装完成，在更新中心中可以查看插件安装的进度。

 

• 全局配置

1. 系统配置

点击系统管理-系统配置

 

找到Publish Over SSH

 

点击新增SSH Server

 

随机输入Name，HostName为服务器的ip地址，Username用户名，Remote Directory选择登陆ssh server后进入的地址，如果不指定的话进入的是用户所在家目录

 

点击高级

 

勾选Use password authentication, or use a different key，填入Passphrase / Password，用户密码,最后点击Test Configuration按钮，测试能否链接成功

 

1. 全局工具配置

点击系统管理-全局工作配置

 

配置JDK,给JDK工具取一个别名,JAVA_HOME写JDK所在目录

 

配置Git,给Git取一个Name,Pato Git executable填git应用程序的全路径

 

配置Maven,Name填Maven的名字，随便起,MAVEN_HOME填MAVEN安装的目录

 

配置NodeJS

别名填NodeJS的名字，随便起，勾选自动安装，版本按照前端项目要求选择。

 

1. 管理证书

点击系统管理-Manage Credentials

 

点击凭据-系统

 

选择全局凭据

 

点击添加凭据

 

用户名、密码填写git登陆的用户名、密码，ID随机取一个，描述描写凭证的用途，填写完毕后点确定

 

 

四、maven项目配置

点击新建任务

 

选择构建一个maven项目，输入任务名称，点击确定。

 

选择丢弃旧的构建，保持结构的天数1，保持构建的最大个数据1

 

源码管理选择git,RepositroyURL输入git地址，Credentials选择建好的凭据，指定分支选择需要构建的分支

 

构建环境勾选Send files or execute commands over SSH before the build starts，SSH Server Name选择需要上传的服务器（下拉框是在系统配置中添加的SSH Server,根据需要选择），Source file上传文件名填target/*.jar,Remove Prefix需删除的前缀目录填target/,Remote directory远程连接目录不选就是Ssh Server中配置的目录,Exec command 上传成功后执行的shell命令如下:

#!/bin/sh -1

ps -ef | grep bcp-reconciliation-0.0.1-SNAPSHOT | grep -v grep | awk '{print $2}' | xargs kill -9

cd  /

cp  /home/isoftstone/bcp_finarp_service/bcp-reconciliation-0.0.1-SNAPSHOT.jar /home/isoftstone/app_bak/

chown -R isoftstone:isoftstone /home/isoftstone/app_bak/

cd  home/isoftstone/bcp_finarp_service

rm -rf   bcp-reconciliation-0.0.1-SNAPSHOT.jar

勾选Send files or execute commands over SSH after the build runs，填写内容和上面一致，Exec Command不同，命令如下:

#!/bin/sh -1

source /etc/profile

cd /

cd home/isoftstone/bcp_finarp_service

 

nohup java -jar bcp-reconciliation-0.0.1-SNAPSHOT.jar >../logs/bcp-reconciliation-0.0.1-SNAPSHOT.log  2>&1 &

Build这里Root POM选择pom.xml,Goals and options填

clean package -Dmaven.test.skip=true，Post Steps选择 Run only if build succeeds只有在构建成功以后才运行，最后点击应用按钮

 

在Dashboard这里可以看到刚刚增加的Maven项目构建，选择改行对应的构建图标，这样就可以开始构建此项目。

 

五、VUE项目构建

点击新建任务

 

选择构建一个自由风格的软件项目项目，输入任务名称，点击确定。

 

选择丢弃旧的构建，保持结构的天数1，保持构建的最大个数据1

 

源码管理勾选git,Repository URL选择拉取git代码的地址(只能选https的地址，不能选ssh的地址)，Credentials选择管理证书中新增的与Repository对应的证书，指定分支选择需要构建的分支

 

构建环境选择Send files or execute commands over SSH before the build starts,Name选择指定服务器对应的名字，在系统配置中已经配置好，Source files选择dist/*,Exec Command执行命令如下:

#!/bin/bash

cd /

cp -r /home/isoftstone/bcp_finarp_web/dist /home/isoftstone/bcp_finarp_web/backup

rm -rf /home/isoftstone/bcp_finarp_web/dist

 

勾选Send files or execute commands over SSH after the build runs,配置和上图基本一致，一共添加5个Transfer set，Source file分别填写dist/*,dist/css/,dist/fonts/,dist/img/,dist/js/,最后一个transfer set添加Exec Command，命令如下:

chown -R isoftstone:isoftstone /home/isoftstone/bcp_finarp_web

cd /home/isoftstone/software/nginx/nginx_install/sbin

./nginx -s reload

 

 

 

 

勾选Provide Node & npm bin/ folder to PATH,NodeJS Installation选择项目指定的NodeJs,这里的NodeJs可选范围是全局工具配置中添加的NodeJs,其余配置不动

 

构建选择增加构建步骤-执行shell

 

Shell命令如下：

#!/bin/bash

npm install

npm run build

配置完成后，点击应用。

 

在Dashboard这里可以看到刚刚增加的Maven项目构建，选择改行对应的构建图标，这样就可以开始构建此项目。