Jenkins自动发布php项目 -- jenkins宿主机为linux系统

本文链接：https://blog.csdn.net/weixin_40459875/article/details/115367235

写在前面：

本文所用php项目是禅道开源版，源码在gitlab管理，项目运行环境为linux。

jenkins宿主机为linux。

php项目发布不需要编译，如果有代码修改，在服务器上替换文件即可。

在此前提下，我们希望实现，当我们提交代码到gitlab上之后，不用手工打包发给运维，由运维替换代码文件，而是我们直接在jenkins上点击构建，由jenkins拉取代码，再自动发布新代码到php所在的服务器。

php项目所在的服务器以下简称目标机。

对宿主机要求：安装git，安装Jenkins，生成ssh-key。

对目标机要求：配置宿主机的ssh-key。

一、 jenkins配置

1-1、jenkins和gitlab交互配置：凭据

1-2、jenkins及其宿主机和目标机交互配置

1-2-1、jenkins宿主机生成ssh-key

1-2-2、jenkins宿主机连接目标机

1-2-3、jenkins配置 Publish over SSH

二、jenkins新建Item及配置

三、构建

一、 jenkins配置

jenkins在这里充当一个中间商的作用，既要和gitlab交互，又要和php项目所在的服务器交互，所以存在这两个联系。

我们选择jenkins和gitlab交互：使用用户名密码。

jenkins和目标机交互：使用ssh连接。

1-1、jenkins和gitlab交互配置：凭据

入口：【Manage Jenkins】- 【Security】 - 【Manage Credentials】-【Jenkins】- 【全局凭据(unrestricted)】- 【添加凭据】

1-2、jenkins及其宿主机和目标机交互配置

1-2-1、jenkins宿主机生成ssh-key

第一步：查看jenkins宿主机是否已有ssh-key

进入/root/.ssh目录，查看是否有id_rsa,id_rsa.pub文件。如果有，则直接看【1-2-2、jenkins宿主机连接目标机】。

第二步：生成ssh-key

输入命令：ssh-keygen -t rsa -b 4096，回车，会遇到询问【输入Passphrase密码：】，这里我们不输入。

[root@iZ2ze1u5un7bz1scr79p3fZ ~]# ssh-keygen -t rsa -b 4096

查看/root/.ssh 目录下，会发现已经生成了id_rsa和id_rsa.pub两个文件。（known_hosts是因为我用宿主机连接过其他机器，所以生成了known_hosts，记录连接信息。）

1-2-2、jenkins宿主机连接目标机

第一步：查看jenkins宿主机的公钥id_rsa.pub信息，并复制下来。

[root@iZ2ze1u5un7bz1scr79p3fZ .ssh]# cat id_rsa.pub

第二步：把宿主机的公钥信息粘贴到目标机的authorized_keys文件中

1、先确认目标机是否有authorized_keys文件，进入/root/.ssh查看。如果没有则新建一个空文件，命名为authorized_keys

2、编辑目标机的authorized_keys，把宿主机公钥信息粘贴到authorized_keys中，第3个就是刚刚复制的jenkins宿主机的公钥信息。

3、启动目标机的sshd服务：

[root@iZ2zehwkjw59e9rjfkie2mZ .ssh]# service sshd start

第三步：测试jenkins宿主机是否可以用ssh连接目标机

在宿主机输入命令：

[root@iZ2ze1u5un7bz1scr79p3fZ ~]# ssh root@目标机ip

可以看到，已经成功连接到目标机：

1-2-3、jenkins配置 Publish over SSH

第一步：查看是否有Publish over SSH插件

【Manage Jenkins】- 【System Configuration】- 【Manage Plugins】- 【已安装】-搜索 Publish over SSH，如过已经有此插件，则直接看第三步。

第二步：安装Publish over SSH插件

方法一：在【可选插件】中搜索 Publish over SSH，如果有，则直接勾选，点击【install without restart】。等待一会，安装成功，可以在【已安装】中搜到 Publish over SSH。

方法二：http://updates.jenkins-ci.org/download/plugins/ 搜索publish-over-ssh/ 进行下载.hpi文件。

下载成功之后，在【高级】- 【上传插件】上传下载下来的.hpi文件。

第三步：jenkins配置Publish over SSH

【Manage Jenkins】- 【System Configuration】 - 【Configure System 】- 【Publish over SSH】

点击【保存】， Publish over SSH就配置好了。

备注：其中 Publish over SSH中的Key不一定要是宿主机的私钥，只要是有一对私钥公钥，私钥配置在Key里，公钥给目标机authorized_keys，就可以连接。与公钥私钥是哪个机器的没关系。

二、jenkins新建Item及配置

第一步：新建Item - 【输入一个任务名称】：phptest - 选择【Freestyle project】-【确定】

【General】:没有特殊需求的话可以不配置。

【源码管理】

【构建触发器】：即触发构建的时机，如果不选择这里的配置，即采用手工点击【立即构建】来构建。因为我们的php项目不常修改，所以就采用手动触发【立即构建】，这里不做配置。

【构建环境】：我这里配置了Delete workspace before build starts，即构建之前删除工作空间。可以不配置。

【构建】：即构建时的一些操作，这里的思路是：从gitlab拉取代码 - 把最新的代码文件在jenkins宿主机上压缩 - 把压缩包传输给目标机 - 目标机进行解压，替换老代码。

[增加构建步骤]选择[执行shell]，即在宿主机执行shell，需要的命令如下：

cd /var/lib/jenkins/workspace
tar -zcf zentaopms.tar.gz phptest
mv zentaopms.tar.gz phptest

[增加构建步骤]选择[Send files or execute commands over SSH]：

对命令的解释：

cd /usr                                        #切到传来的文件所在的目录
rm -rf zentaopms1                              
cp -rf /opt/lampp/htdocs/zentaopms zentaopms1  #备份老代码文件
tar -xzvf zentaopms.tar.gz                     #解压新代码压缩包
mv phptest zentaopms                           #新代码压缩包解压后文件名是Item名字，这步更改名字
/opt/lampp/lampp stop                          #停止禅道项目
cp -rf zentaopms /opt/lampp/htdocs/            #把解压后的新代码文件拷贝到禅道运行的目录下
rm -rf zentaopms                               #删除/usr下的新代码文件和新代码压缩文件
rm -rf zentaopms.tar.gz
cd /opt/lampp/htdocs/zentaopms                 #切到禅道运行目录下
chmod -R 777 tmp                               #给tmp文件赋值为777，因为有发现之前解压之后tmp权限不够，而禅道项目对tmp权限有要求
/opt/lampp/lampp start                         #启动禅道项目

现在我们【保存】，这样所有的配置就完成了。