云效（原RDC）如何构建一个基于Composer的PHP项目

最近在将公司的持续集成架构做一个系统的调整，调整过程中受到了RDC团队大量的帮助，所以利用国庆时间写了几篇RDC的分享，希望能让更多的人了解和用好RDC这个产品。

我会把我最近3个月的使用体会分成5个部分：使用RDC的动机、PHP项目集成、JS项目集成、JAVA项目集成、Docker类项目集成这5个分支来写

因为近期RDC的迭代比较频繁，所以我的分享会比较的浅，点到为止，仅供参考，目录：

1、RDC如何耦合进我们的业务

2、如何构建一个基于Composer的PHP项目

3、如何构建一个基于NodeJS的前后端项目

4、如何构建一个基于Maven的Java项目

5、RDC + 容器服务完成持续集成

一、RDC基础操作

在开始一切之前您需要熟悉RDC的一些基础操作，创建一个项目，然后在这个项目中创建一个应用，然后让这个应用关联某个代码分支。这样基础工作就完成了，我这里不再赘述了，因为比较简单，只需要注册个阿里云账号，然后去 rdc.aliyun.com 创建/加入个企业就行了。

本文所有的体验均基于【自由模式】的应用。

值得一提的是，应用代码源目前支持的是阿里云的代码仓库，基于gitlab，地址是 code.aliyun.com，从我2年的使用经验来看，还算好用，也不收费，较为靠谱。

在创建应用时，我们需要选择对应的配置，如下图：

创建完应用后，进入【项目】--》【流水线】，找到刚才创建应用的【同名流水线】

点击流水线名称可以看到具体的流水线运行情况和对应节点，如下图：

可以看到有4个面板：构建、日常、预发、正式。

分别对应的是：构建打包、发布到日常环境、发布到预发环境、发布到正式环境。

RDC在创建应用时自动的为你生成了一个标准模板流水线，但是我们一般用不着，所以需要对流水线进行修改，去除无用的节点，添加我们自己的配置。点击界面上的【编辑流水线】按钮就可以进入修改界面。

我们先从构建开始，所以先暂时删除日常、预发、正式这3个部署节点，仅保留构建这一个节点即可。下面的配置暂时不进行调整。删除完毕后保存流水线即可，效果如下：

至此我们已经完成了基础的准备工作，下一步就开始进行PHP代码的构建工作了。

在开始下一步工作之前，请重新git pull一下您的代码到本地，会看到一个由RDC服务自动生成的配置文件：==xxx.release== 这个文件相当重要，请注意，下面将会说明如何通过此文件完成个性化构建。

二、基于Composer的PHP项目构建

有人可能会问，PHP不是动态脚本语言吗，为什么需要构建？

这是因为PHP的一些第三方类、开源框架等代码需要通过Composer包管理来进行安装及维护，如果你的代码里没有使用到Composer，请跳过本章节。

因为Composer并不推荐将vendor文件夹上传到代码仓库，所以我们通常只在本地保留vendor文件夹用于开发和调试。

但是这个文件夹里的代码是线上运行必须的，所以我们需要通过一个构建的过程来安装所有PHP项目依赖库，也就是生成vendor文件夹。

这里需要找到我们上一章节中提到的：==xxx.release== 文件，xxx代表你的应用名，所以我这里看到的文件名是：ms-autotags.release

这个文件的配置规范可以参考：==https=//help.aliyun.com/document_detail/59293.html==

打开这个文件可以看到，已经有一些预先定义好的配置：

# 构建源码语言类型
code.language=scripts

# 应用部署脚本
deploy.appctl.path=deploy.sh

# Docker镜像构建之后push的仓库地址
docker.repo=registry.cn-hangzhou.aliyuncs.com/xxx/abced

上面的配置是不能用的，我们需要将其修改为如下内容：

# 语言类型，需要改为PHP，否则无法调用对应的构建环境
code.language=php7.0

# 代码构建基础镜像
build.image=registry.cn-hangzhou.aliyuncs.com/lxepoo/php-autobuild:php7.1

#构建命令
build.command=sh build.sh

# 应用部署脚本，先注释掉，暂时用不上
# deploy.appctl.path=deploy.sh

↓↓↓↓ 配置说明：

code.language=php7.0

代表使用的是php7作为代码语言类型。支持以下枚举：

php5.6，php7.0，node6.x，node7.x，node8.x，oracle-jdk1.7，oracle-jdk1.8， oracle-jdk1.9，scripts

如果有使用过jenkins的同学，那么应该比较好理解，RDC的构建是通过Docker容器技术实现的，类似于配置好环境的jenkins构建机，RDC团队针对各种语言准备了不同的镜像作为构建宿主。

build.image=registry.cn-hangzhou.aliyuncs.com/lxepoo/php-autobuild:php7.1

# 可根据你的需要切换使用下面这个构建环境

# build.image=registry.cn-hangzhou.aliyuncs.com/lxepoo/php-autobuild:php5.6

代表使用一个特定的镜像作为构建环境，用户暂时无法自定义镜像并在RDC中使用。目前你看到的这个配置值是因为RDC团队在迭代更重要的功能没有精力维护PHP版本的打包环境，所以我代为生成并提交了2个PHP版本作为临时构建环境，相对官方的构建环境我的更全面些，支持git、php的大部分扩展、mongo扩展、composer、phpunit等。

因为有些第三方库安装时，需要检测php扩展的，所以必须开启，否则没办法安装第三方库。

build.command=sh build.sh

这一行的意思是，使用一个特定的脚本来进行自定义构建，因为构建有时候需要处理的东西很多，一行命令解决不了，所以需要一个自定义构建脚本，此处我设置的脚本在代码根目录下，创建一个build.sh脚本。如果你的构建只有1句话，可以直接写在“=”号后面，使用自定义脚本是为了更清晰和更灵活。

↓↓↓↓ build.sh脚本内容：

echo "##### delete vendor dir"
rm -rf ./vendor

echo "##### composer to china"
composer config -g repo.packagist composer https://packagist.phpcomposer.com

echo "##### php composr install"
composer install --no-dev

逐句解释：

rm -rf ./vendor

先删除掉目录中已有的vendor文件夹，主要原因是：

1.防止你不小心向git提交了这个文件夹，先删掉防止冲突和污染。

2.防止RDC的构建有缓存，强行删除后每次构建重新生成。

composer config -g repo.packagist composer https://packagist.phpcomposer.com

让composer使用中国区镜像，目的就是为了构建快一些，按个人喜好，你用美国和日本镜像也没事，就是会很慢，因为RDC目前暂时不支持海外构建。

composer install

最核心的一句话，安装所有php第三方库依赖，这一句执行后如果正确，就会生成vendor文件夹了。也意味着如果你使用开源PHP框架，你的tp5、yii2、lumen、laravel等框架就安装成功了。

提一下，如果你需要构建更快，可以尝试使用 composer install --no-dev，不安装开发依赖。

可以看到执行时间、版本号、日志、操作人等信息。

如果构建失败了，可以通过构建流程----日志详情面板看到具体的错误原因，有日志排查起来不太难，但是RDC的构建还是偏向黑盒，所以尽量熟练或在本地先把相关命令跑通后再上传到==xxx.release==文件里去进行RDC构建。

可以看到初始的版本号是：v0.0.1-1，如果你的构建一直失败，版本号会变成v0.0.1-3、v0.0.1-8、v0.0.1-18、v0.0.1-N。

如果你的流水线全流程跑完了，则会自动叠加一个小版本号变为v0.0.2-1，所以这种构建方式清晰明了，还算好用。

三、如何输出为一个Docker镜像

我们已经完成了PHP依赖的安装，下一步我们需要把完整的代码封装成一个Docker镜像，我们需要对==xxx.release==文件做如下改动：

# 语言类型，需要改为PHP，否则无法调用对应的构建环境
code.language=php7.0

# 代码构建基础镜像
build.image=registry.cn-hangzhou.aliyuncs.com/lxepoo/php-autobuild:php7.1

#构建命令
build.command=sh build.sh

# Docker 构建配置
docker.file=Dockerfile

# Docker镜像构建之后push的仓库地址
docker.repo=registry.cn-hangzhou.aliyuncs.com/xxx/abced

docker.tag=ci-${PACKAGE_LABEL} 

# 应用部署脚本，先注释掉，暂时用不上
# deploy.appctl.path=deploy.sh

相对于单纯的构建，如果需要生成Docker镜像则需要补充几个配置项，拆解说明如下：

docker.file=Dockerfile

指明dockerfile文件的位置和文件名，默认就是根目录下的Dockerfile文件。

docker.repo=registry.cn-hangzhou.aliyuncs.com/xxx/abced

指定你的docker镜像仓库，建议使用阿里云提供的仓库，免费，速度快，可以加速docker hub的内容，无缝对接RDC服务，地址是 dev.aliyun.com ，此处的xxx对应的是你的名称空间，abced对应的是你的镜像名称。

docker.tag=ci-${PACKAGE_LABEL}-${TIMESTAMP}

这里指定你的docker镜像的tag名，使用了环境变量进行拼接。

${PACKAGE_LABEL}代表的是包名，这个参数在流水线配置里可以改，默认是default。

${TIMESTAMP}代表的是当前时间戳，格式是：20171008224350 这种样子。

有的项目一份代码可能产生多个docker镜像就需要通过这种方式来动态生成tag名，防止覆盖，也便于回滚。

关于构建传参，可以参考这个文章： https://help.aliyun.com/document_detail/59297.html

那么此处最终生成的tag名是这样的： ci-default-20171008224350

结合仓库名和镜像名，最终会生成镜像tag地址为：

registry.cn-hangzhou.aliyuncs.com/xxx/abced:ci-default-20171008224350

四、后记

PHP构建 + Docker构建就说到这里，因为主要是为了介绍RDC，所以Docker部分就挑重点讲了，如何编写Dockerfile文件请自行学习。

输出成Docker镜像后，如何使用RDC部署到容器相关问题我会单独开一个文章来分享。