部署项目是一件比较繁琐的事情，不仅要配置目录权限，更新依赖库等，也要考虑到原子性操作，回滚等．而代码部署工具deployer.org提供了简化这些的方法，可以轻松编写PHP程序指导部署．

介绍

deploy是在客户端调用，它会自己登录到服务器执行相关操作．比如创建目录，重启fpm，只要给它sudo (NOPASSWORD)权限就可以．

它的思路是每次部署创建一个新目录，之前的几个版本目录还会保留下来，方便回滚，默认保存5个版本．

再通过软链接，用一个固定的目录比如 current指向线上版本，nginx只管读current，这样就不用改动网站配置．

安装

首先需要安装deployer，将它装在composer global下，方便部署多个项目

$ composer global require deployer/deployer:^3.0

程序就安装在 ~/.composer/vendor/bin/dep

编写部署逻辑

我的项目使用的是Yii2框架，它的部署主要分三步：

下载项目源代码

更新 composer库

调用 ./init 脚本设置目录权限

deployer默认针对的是symfony项目的部署，与Yii2有差别．因此我需要禁用它的一些功能，比如目录权限配置，Yii2会自己完成这些配置．

在项目代码根目录下创建一个部署程序

vi deploy.php
// 包含必要的库
require 'recipe/symfony.php';
// 预定的安装目录
$path = '/srv/www/myproject';
// 要部署到的机器
server('prod', 'localhost', 22)
->user('name') // 登录主机的用户
->password(null) // 如果是null，会在安装前询问你密码
->stage('production')
// 需要先在这台机器上创建这个目录
->env('deploy_path', $path);
// 指定git仓库的位置，如果是私有的，可以根据HTTP协议设置登录用户
set('repository', 'https://[username]:[password]@github.com/my/project.git');
// 要执行的部署任务，deploy自带了一些逻辑比如更新代码和依赖库
task('deploy', [
'deploy:prepare', // 登录服务器
'deploy:release', // 创建发布目录
'deploy:update_code', // 下载源代码
'deploy:vendors', // 更新composer
]);
// 我们也可以自定义部署的逻辑，比如调用Yii的init脚本初始化目录权限
task('init', function() {
// {{release_path}} 是deployer定义的变量，指程序部署到的目录位置
run("{{release_path}}/init --env='Production' --overwrite=All");
});
// 更新线上目录current的源目录指向
task('push', function() {
// {{deploy_path}} 是指整个项目的位置，等于 $path
run("ln -sfn {{release_path}} {{deploy_path}}/current");
});
// 更新opcache对文件的缓存，因为nginx传入的document_root是虚拟链接，所以不会改变，需要手动清空缓存
task('cache', function() {
run('/usr/bin/env php -r "opcache_reset();"');
});
// 在自带的部署任务完成后，执行自定义的逻辑
// 更新yii2目录权限为线上配置
after('deploy', 'init');
// 更新指向线上目录的位置，这里才正式发布了
after('deploy', 'push');
// 更新opcache缓存，否则程序更改不会生效
after('deploy', 'cache');

目录说明

/srv/www/myproject

设定的项目部署位置

{{release_path}}

它是为了方便而自动创建的一个软链接目录，总是指向正在部署中的那个目录(releases 下)

{{deploy_path}}/current

线上目录，它也是一个软链接．不过在部署完成后，它才会更新．因此它是原子性的，不会影响线上访问．

开始部署

参数 deploy 就是刚才创建的部署程序文件名，production就是按线上生产环境部署

$ ~/.composer/vendor/bin/dep deploy production
✔ Executing task deploy:prepare
✔ Executing task deploy:release
✔ Executing task deploy:update_code
✔ Executing task deploy:clear_controllers
✔ Executing task deploy:vendors
✔ Executing task init
✔ Executing task push
✔ Executing task cache

部署后可以看到这样的目录结构

$ tree -L 2 /srv/www/myproject
.
|-- current -> /srv/www/myproject/releases/20150617163027
|-- release -> /srv/www/myproject/releases/20150617163027
|-- releases
| |-- 20150617160840
| |-- 20150617161024
| |-- 20150617161702
| |-- 20150617162823
| `-- 20150617163027

nginx的配置

server {
root /srv/www/myproject/current;
......
}

至此可以实现不影响线上访问，原子性的部署．更多文档参见  http://deployer.org/docs

VIA：https://xiaoai.me/?p=96