README

感谢jonaswouters使它保持最新

简而言之

###描述

• 使用rsync（必须安装）在ssh模式下部署项目。
• 在多台服务器上设置部署。
• 轻松创建rsync（忽略/强制文件）规则。
• 通过ssh（需要SSH2 PHP扩展）在远程服务器上调度命令执行。

###链接

• 稳定版本: https://github.com/besimple/DeploymentBundle
• 夜间构建: https://github.com/jfsimon/DeploymentBundle
• REST文档: 稍后提供

###要求

• Rsync包: http://samba.anu.edu.au/rsync/
• SSH2扩展: http://fr.php.net/manual/en/book.ssh2.php

如何安装

1. 通过GIT获取源代码

   • 如果你的项目不使用GIT，请使用clone方法

     git clone git://github.com/besimple/DeploymentBundle.git vendor/BeSimple/DeploymentBundle

   • 如果适用，请使用submodule方法

     git submodule add git://github.com/besimple/DeploymentBundle.git vendor/BeSimple/DeploymentBundle

2. 在AppKernel类中注册bundle

   // app/AppKernel.php
   
   $bundles = array(
       // ...
       new BeSimple\DeploymentBundle\BeSimpleDeploymentBundle(),
       // ...
   );
   

3. 将besimple_deployment条目添加到你的配置文件中

   # app/config.yml
   
   be_simple_deployment:
       rsync:    ~
       ssh:      ~
       rules:    ~
       commands: ~
       servers:  ~
   

4. 将BeSimple命名空间添加到autoload

   // app/autoload.php
   
   $loader->registerNamespaces(array(
       // ...
       'BeSimple' => __DIR__.'/../vendor',
       // ...
   ));
   

###配置方法

###示例

be_simple_deployment:
  rsync:
    delete:     true
  rules:
    eclipse:
      ignore:   [.settings, .buildpath, .project]
    netbeans:
      ignore:   [nbproject]
    phpstorm:
      ignore:   [.idea]
    git:
      ignore:   [.git, .git*]
    svn:
      ignore:   [.svn]
    symfony:
      ignore:   [/app/cache/*, /app/logs/*, /app/config/parameters.yml, /web/bundles/*, /web/uploads/*, /web/js/*, /web/css/*]
    hosting:
      ignore:   [/.htaccess, /.htpasswd, /web/.htaccess, /web/.user.ini, /web/manage.php, /web/phpinfo.php, /web/ntunnel_mysql.php]
    system:
      ignore:   [._*, .DS_Store]
  commands:
    cache_clear:
      type:     symfony
      command:  cache:clear
    assetic_dump:
      type:     symfony
      command:  assetic:dump
    assets_install:
      type:     symfony
      command:  assets:install
  ssh:
    connect_methods:
      server_to_client:
         crypt: rijndael-cbc@lysator.liu.se, aes256-cbc, aes192-cbc, aes128-cbc, 3des-cbc, blowfish-cbc, cast128-cbc, arcfour
      client_to_server:
         crypt: rijndael-cbc@lysator.liu.se, aes256-cbc, aes192-cbc, aes128-cbc, 3des-cbc, blowfish-cbc, cast128-cbc, arcfour
  servers:
    dev:
      host:         dev.server.ch
      username:     username

      pubkey_file:  %deploy_dev_pubkey_file%
      privkey_file: %deploy_dev_privkey_file%
      passphrase:   %deploy_dev_passphrase%

      path:         /home/user/www/dev.project.com/
      rules:        [eclipse, netbeans, phpstorm, git, svn, symfony, hosting, system]
      commands:     [cache_clear, assetic_dump, assets_install]

      symfony_command: php -c web/.user.ini app/console --env=dev
    prod:
      host:         prod.server.ch
      username:     username

      pubkey_file:  %deploy_prod_pubkey_file%
      privkey_file: %deploy_prod_privkey_file%
      passphrase:   %deploy_prod_passphrase%

      path:         /home/user/www/prod.project.com/
      rules:        [eclipse, netbeans, phpstorm, git, svn, symfony, hosting, system]
      commands:     [cache_clear_dev, assetic_dump, assets_install]

      symfony_command: php -c web/.user.ini app/console --env=prod

如何使用

###使用命令

部署你的应用程序最简单的方法是使用命令行，进入你的项目根目录并输入以下命令

# Test your deployment :
./app/console deployment:test [server]

# Launch your deployment :
./app/console deployment:launch [server]

你可以使用详细选项（-v）来获取rsync和远程ssh命令的所有反馈。

###使用服务

你也可以通过调用'deployment'服务在你的控制器中使用部署功能

// Test your deployment :
$this->get('besimple_deployment')->test([$server]);

// Launch your deployment :
$this->get('besimple_deployment')->launch([$server]);

你可以连接多个事件来了解发生了什么。

###部署者事件

• onDeploymentStart : 在部署开始时触发。
• onDeploymentSuccess : 在部署成功时触发。

###Rsync事件

• onDeploymentRsyncStart : 在rsync启动时触发。
• onDeploymentRsyncFeedback : 在每次rsync stdout或stderr行时触发。
• onDeploymentRsyncSuccess : 在rsync成功时触发。

###SSH事件

• onDeploymentSshStart : 当SSH命令运行时触发。
• onDeploymentSshFeedback : 在每次SSH stdout或stderr行时触发。
• onDeploymentSshSuccess : 在SSH命令成功时触发。