安装 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 部署项目,进入配置。

拉取代码

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

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

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

构建

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

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

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

然后在 系统管理-系统设置-Publish over SSH

填入私钥文件地址

增加一个 ssh 服务器配置

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

简单点可以直接执行 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 这个工具,有兴趣可以去了解一下这个工具。