部署 php 项目,使用deployer 来部署PHP项目

部署项目是一件比较繁琐的事情，不仅要配置目录权限，更新依赖库等，也要考虑到原子性操作，回滚等．而代码部署工具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