Jenkins 部署 PHP 应用

时间:2022-11-19 22:59:08

安装 Jenkins

方式一:docker方式安装

拉取jenkins官方镜像,按照镜像文档启动镜像就可以了

方式二:手动安装

以下所有操作都使用 root 用户进行操作。

在各项目官网,下载 Java、Tomcat、Jenkins

Java: http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html Tomcat: http://tomcat.apache.org/download-90.cgi jen Jenkins: https://jenkins.io/

所用环境: jdk1.8.0_121 tomcat-9.0.0.M17 jenkins 2.32.2

我把所用的 tar.gz 压缩包都放在 /opt/ 目录中,然后解压到 /usr/local/src 中。

安装 Java

解压后的 Java 包默认为 jdk1.8.0_121

配置 Java 环境变量 vim /etc/profile,在其中加入:

#java
JAVA_HOME=/usr/local/src/jdk1.8.0_121 #这行根据实际情况修改
PATH=$JAVA_HOME/bin:$PATH
CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

修改完成后使用 source /etc/profile 让新配置生效。

安装 Tomcat

解压后的 Tomcat 包默认为 apache-tomcat-9.0.0.M17

使用 chmod a+x apache-tomcat-9.0.0.M17/bin/*.sh 命令给予 Tomcat 启动关闭 shell 脚本可执行权限。

执行 bin/catalina.sh run 可以从控制台看到tomcat启动,以确保 Tomcat 可以正确启动。

要让 Tomcat 在后台运行使用 bin/startup.sh

安装 Jenkins

将 jenkins 的 .war 包放到 Tomcat 的 webapps 目录中,运行 bin/startup.sh

然后就可以通过 http://<你的ip地址>/jenkins/ 访问安装完毕的 jenkins

然后按照页面指引完成最后的安装

Jenkins 插件

  • Subversion/Git:用于集成项目版本控制软件,根据需要选择(在上篇博文已安装使用)
  • Phing/Ant:使用Phing或Apache Ant 对PHP项目做自动化构建
  • CheckStyle:使用PHP CodeSniffer进行代码风格检查的工具。用于检查PHP代码是否有违反一组预先设置好的编码标准的一个PEAR包,内置了ZEND,PEAR的编码风格规则
  • Clover PHP:使用phpunit进行单元测试的工具,可以被xdebug扩展用来生成代码覆盖率报告,并且可以与phing集成来自动测试,还可以和Selenium整合来完成大型自动化集成测试
  • DRY:使用PHPCPD(php copy paste detector)来发现项目中的重复代码
  • HTML Publisher:用来发布phpunit代码覆盖率报告
  • JDepend:使用PHP Depend分析php中静态代码,用来检查项目中的代码规模和复杂程度
  • Plot:使用phploc来统计php项目规模大小的工具,可以统计php的项目代码行数
  • PMD:使用phpmd(php mess dector),对基于pdepend的结果进行分析,一旦项目超过了pdepend中各具体指标的规定,将发出警告信息.
  • Violations:按照代码缺陷严重性集中显示pwd静态代码分析的结果
  • xUnit:使用JUnit的格式来输出phpunit的日志文件

Jenkins 部署 PHP 步骤

代码拉取 - 执行检查(非必须)- 打包 - 远程或本地部署

部署的方式很多种,jenkins 也提供很多插件优化部署流程

本文档主要说一下远程部署

远程部署首先拉取代码,我们使用 git 管理代码。

用 ssh-keygen 生成公钥和私钥,git 和 登录远程服务器都会用到。

git 仓库上每个项目都有一个部署公钥,将生成的公钥添加到 git 仓库。

然后创建一个*风格的 jenkins 部署项目,进入配置。

拉取代码

Jenkins 部署 PHP 应用

选择 git ,默认会拉取仓库的 master 分支,点击 add 添加一个拉取代码的凭证。

Jenkins 部署 PHP 应用

Kind 选 SSH Username with private key Private key 选择 From the Jenkins master ~/.ssh (已经使用 ssh-keygen 生成公私钥)

创建完成后选择凭证,输入 git 仓库的地址,然后就可以保存后点击立即构建,测试代码能不能正确拉取,拉取正确后点击工作空间就可以看见你的代码库中的代码了。

构建

Jenkins 部署 PHP 应用

默认有这些构建选项,本地构建简单使用 Execute shell 执行 shell 指令。

远程构建需要新安装一个插件,在 系统管理-管理插件-可选插件 中搜索 Publish Over SSH 插件并安装,重启 Jenkins 以启用插件。

将本机的公钥复制到远程服务器root用户的 /root/.ssh/authorized_keys 文件中。

然后在 系统管理-系统设置-Publish over SSH Jenkins 部署 PHP 应用

填入私钥文件地址

Jenkins 部署 PHP 应用

增加一个 ssh 服务器配置

Jenkins 部署 PHP 应用

构建中选择 Send files or execute commands over SSH

Jenkins 部署 PHP 应用

简单点可以直接执行 shell 指令,到想要部署的项目目录用 git 直接拉取远程代码,但这样用 Jenkins 意义真的不是特别大,可以在本机将代码打包,然后传输到远程机器,再解压开到项目目录。

cd /var/www/web
tar -czf project_`date +%F-%H-%M-%S`.bak.tar.gz --exclude='project/runtime' --exclude='project/.git' /home/www/web/project
tar xzf /var/www/web/project-tar/project.${BUILD_NUMBER}.${BUILD_ID}.tar.gz -C /home/www/web/project
chmod -R 755 /home/www/web/project/
chmod 777 /home/www/web/project/web/assets/
tail -n100 /home/www/web/project/runtime/logs/error.log

以上是一个示例,进行了线上代码备份打包、解包新部署包,修改权限、打印错误日志一系列操作。

构建打包操作是使用的 Phing 这个工具,有兴趣可以去了解一下这个工具