capifony 2.1.6 → 2.1.7

data/CHANGELOG

@@ -1,3 +1,19 @@
+== 2.1.7 / June 21, 2012
+
+* added maintenance page feature for Symfony2, use symfony 1.4 tasks
+  (project:disable, project:enable) to do the same.
+* added `interactive_mode` variable. Allows to avoid the need to confirm
+  task executions, useful for fully automated deployments.
+* fixed propel regression.
+* added new `symfony_version` variable automatically guessed.
+* the `build_bootstrap` script to use is now configurable thanks to the
+  `:build_bootstrap` variable.
+* composer can be used with the `update_vendors` parameter, so that you can
+  update composer dependencies.
+* composer support updated, it downloads the `phar` if not available in the
+  working directory.
+* bugfixes.
+
 == 2.1.6 / April 12, 2012
 
 * bugfixes

data/LICENSE

@@ -1,4 +1,5 @@
-Copyright (c) 2010 Konstantin Kudryashov <ever.zet@gmail.com>
+Copyright (c) 2010-2012 Konstantin Kudryashov <ever.zet@gmail.com>,
+William Durand <william.durand1@gmail.com>
 
 Permission is hereby granted, free of charge, to any person
 obtaining a copy of this software and associated documentation
@@ -19,4 +20,4 @@ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
 HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
 WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
-OTHER DEALINGS IN THE SOFTWARE.
+OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -1,13 +1,21 @@
 Deploying symfony Applications with Capistrano
 ==============================================
 
-Capistrano is an open source tool for running scripts on multiple servers. Its primary use is for easily deploying applications. While it was built specifically for deploying Rails apps, it’s pretty simple to customize it to deploy other types of applications. We’ve been working on creating a deployment “recipe” to work with symfony applications to make our job a lot easier.
+Capistrano is an open source tool for running scripts on multiple servers.
+Its primary use is for easily deploying applications. While it was built
+specifically for deploying Rails apps, it’s pretty simple to customize it
+to deploy other types of applications. We’ve been working on creating a
+deployment “recipe” to work with symfony applications to make our job a
+lot easier.
+
 
 ## Prerequisites ##
 
 - Symfony 1.4+ OR Symfony2
 - Must have SSH access to the server you are deploying to.
-- Must have Ruby and RubyGems installed on your machine (not required for deployment server)
+- Must have Ruby and RubyGems installed on your machine (not required
+  for deployment server)
+
 
 ## Installing Capifony ##
 
@@ -22,135 +30,23 @@ Capistrano is an open source tool for running scripts on multiple servers. Its p
 	gem build capifony.gemspec
 	sudo gem install capifony-{version}.gem
 
-## Setup your project to use Capifony ##
-
-CD to your project directory & run:
-
-	capifony .
-
-This will create a `Capfile` in your project root & a `deploy.rb` config file in your `config` (for symfony)
-or `app/config` (for Symfony2) directory.
-
-Fill up your `config/deploy.rb` with your server connection data.
-
-## Server Setup ##
-
-Now, you can start the deployment process! To get your server setup with the directory structure that Capistrano expects, CD to your local project directory and run:
-
-	cap deploy:setup
-
-Running this command locally will create the following directory structure on your server:
-
-	`-- /var/www/demo.everzet.com
-	  |-- current → /var/www/demo.everzet.com/releases/20100512131539
-	  |-- releases
-	    |-- 20100512131539
-	    |-- 20100509150741
-	    `-- 20100509145325
-	  `-- shared
-	    |-- log
-	    |-- config
-	      `-- databases.yml
-	    `-- web
-	      `-- uploads
-
-The folders in the releases directory will be the actual deployed code, timestamped. Capistrano symlinks your log & web/uploads directories from your app to the directories in the shared folder so that it doesn’t get erased when you deploy a new version of your code.
-
-## Deployment ##
-
-To deploy your application, simply run:
-
-	cap deploy
-
-To specify the username/password to use over SSH, add the following configuration to your `config/deploy.rb` file:
-
-    set :user, 'username'
-    set :password, 'password'
-
-To configure database on production environment, run:
-
-	cap symfony:configure:database
-
-To deploy your application for the first time, you can run:
-
-	cap deploy:cold
-
-This will deploy your application, configures databases.yml (will ask you about DSN, user, pass), create the db, models, forms, filters, and run all of your migrations.
-
-Now, whenever you need to deploy a new version of your code, just run:
-
-	cap deploy
-
-## Databases ##
-
-If you need to dump remote database & download this dump to local `backups/` folder, run:
-
-	cap database:dump:remote
-
-If you need to dump local database & put this dump to local `backups/` folder, run:
 
-	cap database:dump:local
+## What's next? ##
 
-If you need to dump remote database & populate this dump on local machine, run:
+Read the [capifony documentation](http://everzet.github.com/capifony/)
 
-	cap database:move:to_local
-
-If you need to dump local database & populate this dump on remote server, run:
-
-	cap database:move:to_remote
-
-## Shared folders ##
-
-If you need to download some shared folders from remote server, run:
-
-	cap shared:{databases OR log OR uploads]:to_local
-
-If you need to upload some shared folders to remote server, run:
-
-	cap shared:{databases OR log OR uploads]:to_remote
-
-## Host Permissions ##
-
-If you are not allowed sudo ability on your host you can add the following configuration to your `config/deploy.rb` file:
-
-    set :use_sudo, false
-    
-If your host complains about the entire project being group-writable you can add the following configuration to your `config/deploy.rb` file:
-
-    set :group_writable, false
-
-## Git Specific Options ##
-
-If you are using Git submoduleis you'll want to add the following to your `config/deploy.rb` file or the submodule files won't be brought down with your project:
-
-    set :git_enable_submodules, 1
-
-## Other tasks ##
-
-If you need to deploy and run your migrations you can call:
-
-	cap deploy:migrations
-
-We’ve also added a custom task to run your test suite on the production server. You can invoke this by calling:
-
-	cap deploy:tests:all
-
-This will deploy the application, rebuild the test database, then run all of the tests.
-
-Also, you have command to run your custom symfony tasks:
-
-	cap symfony
-
-If you want to see all of the Capistrano tasks available, you can run:
-
-	cap -T
-
-We’ve been using this setup for a little while now, and it’s saved us a ton of time when we need to push changes for a site to the production server.
 
 ## Contributors ##
 
 * everzet (owner): [http://github.com/everzet](http://github.com/everzet)
-* Arlo (contributor): [http://github.com/arlo](http://github.com/arlo)
+* Arlo Borras (contributor): [http://github.com/arlo](http://github.com/arlo)
 * Xavier Gorse (contributor): [http://github.com/xgorse](http://github.com/xgorse)
 * Travis Roberts (creator of improved version): [http://blog.centresource.com/author/troberts/](http://blog.centresource.com/author/troberts/)
 * Brent Shaffer (contributor): [http://github.com/bshaffer](http://github.com/bshaffer)
+* William Durand (maintainer): [http://github.com/willdurand](http://github.com/willdurand)
+* And, [All contributors](https://github.com/everzet/capifony/contributors)
+
+
+## License ##
+
+Capifony is released under the MIT License. See the bundled LICENSE file for details.

data/lib/capifony.rb

@@ -23,4 +23,22 @@ namespace :deploy do
 
   desc "Overwrite the stop task because symfony doesn't need it."
   task :stop do ; end
+
+  desc <<-DESC
+    Prepares one or more servers for deployment. Before you can use any \
+    of the Capistrano deployment tasks with your project, you will need to \
+    make sure all of your servers have been prepared with `cap deploy:setup'. When \
+    you add a new server to your cluster, you can easily run the setup task \
+    on just that server by specifying the HOSTS environment variable:
+
+      $ cap HOSTS=new.server.com deploy:setup
+
+    It is safe to run this task on servers that have already been set up; it \
+    will not destroy any deployed revisions or data.
+  DESC
+  task :setup, :except => { :no_release => true } do
+    dirs = [deploy_to, releases_path, shared_path]
+    run "#{try_sudo} mkdir -p #{dirs.join(' ')}"
+    run "#{try_sudo} chmod g+w #{dirs.join(' ')}" if fetch(:group_writable, true)
+  end
 end

data/lib/symfony1.rb

@@ -21,7 +21,7 @@ set(:symfony_lib)     { guess_symfony_lib }
 
 # Shared symfony lib
 set :use_shared_symfony, false
-set :symfony_version, "1.4.11"
+set :symfony_version, "1.4.18"
 
 def guess_symfony_orm
   databases = YAML::load(IO.read('config/databases.yml'))
@@ -111,6 +111,18 @@ namespace :deploy do
     symfony.orm.build_db_and_load
     symfony.tests.all
   end
+
+  namespace :web do
+    desc "Use symfony 1.4 task to disable the application"
+    task :disable, :roles => :web, :except => { :no_release => true } do
+      symfony.project.disable
+    end
+
+    desc "Use symfony 1.4 task to enable the application"
+    task :enable, :roles => :web, :except => { :no_release => true } do
+      symfony.project.enable
+    end
+  end
 end
 
 namespace :symfony do
@@ -137,7 +149,7 @@ namespace :symfony do
   end
 
   desc "Creates symbolic link to symfony lib in shared"
-  task :create_lib_symlink do 
+  task :create_lib_symlink do
     prompt_with_default(:version, symfony_version)
     symlink_path = "#{latest_release}/lib/vendor/symfony"
 
@@ -156,7 +168,7 @@ namespace :symfony do
       current_logger_level = self.logger.level
       if current_logger_level >= Capistrano::Logger::DEBUG
         logger.debug %(executing "cd #{latest_release} && #{php_bin} ./symfony configure:database '#{dsn}' '#{db_username}' ***")
-        self.logger.level = Capistrano::Logger::INFO 
+        self.logger.level = Capistrano::Logger::INFO
       end
 
       stream "cd #{latest_release} && #{php_bin} ./symfony configure:database '#{dsn}' '#{db_username}' '#{db_password}'"
@@ -201,7 +213,7 @@ namespace :symfony do
 
       stream "cd #{latest_release} && #{php_bin} ./symfony project:send-emails --message-limit=#{message_limit} --time-limit=#{time_limit} --env=#{symfony_env_prod}"
     end
-    
+
     desc 'Task to set all front controllers to a specific environment'
     task :set_environment do
       if (env = fetch(:symfony_env_prod, nil)) && env != 'prod'
@@ -212,12 +224,12 @@ namespace :symfony do
         if app = apps.shift
           cmd << "cp #{release_path}/web/#{app}_#{env}.php #{release_path}/web/index.php"
         end
-        
+
         # All other apps are copied to their default controllers
         for app in apps
           cmd << "cp #{release_path}/web/#{app}_#{env}.php #{release_path}/web/#{app}.php"
         end
-    
+
         run cmd.join(';') if cmd.join(';')
       end
     end
@@ -268,7 +280,7 @@ namespace :symfony do
     task :setup do
       find_and_execute_task("symfony:#{symfony_orm}:setup")
     end
-  
+
     desc "Migrates database to current version"
     task :migrate do
       find_and_execute_task("symfony:#{symfony_orm}:migrate")
@@ -307,7 +319,7 @@ namespace :symfony do
     end
 
     desc "Ensure Doctrine is correctly configured"
-    task :setup do 
+    task :setup do
       conf_files_exists = capture("if test -s #{shared_path}/config/databases.yml ; then echo 'exists' ; fi").strip
       if (!conf_files_exists.eql?("exists"))
         symfony.configure.database
@@ -451,7 +463,7 @@ namespace :database do
           puts data
         end
       when 'pgsql'
-        run "pg_dump -U #{config['user']} --password='#{config['pass']}' #{config['db']} | gzip -c > #{file}" do |ch, stream, data|
+        run "pg_dump -U #{config['user']} #{config['db']} | gzip -c > #{file}" do |ch, stream, data|
           puts data
         end
       end
@@ -481,7 +493,7 @@ namespace :database do
       when 'mysql'
         `mysqldump -u#{config['user']} --password=\"#{config['pass']}\" #{config['db']} > #{tmpfile}`
       when 'pgsql'
-        `pg_dump -U #{config['user']} --password=\"#{config['pass']}\" #{config['db']} > #{tmpfile}`
+        `pg_dump -U #{config['user']} #{config['db']} > #{tmpfile}`
       end
       File.open(tmpfile, "r+") do |f|
         gz = Zlib::GzipWriter.open(file)
@@ -516,7 +528,7 @@ namespace :database do
       gz = Zlib::GzipReader.new(File.open("backups/#{filename}", "r"))
       f << gz.read
       f.close
-      
+
       case config['type']
       when 'mysql'
         `mysql -u#{config['user']} --password=\"#{config['pass']}\" #{config['db']} < backups/#{sqlfile}`
@@ -598,9 +610,9 @@ namespace :shared do
 
   namespace :symfony do
     desc "Downloads symfony framework to shared directory"
-    task :download do 
+    task :download do
       prompt_with_default(:version, symfony_version)
-  
+
       run <<-CMD
         if [ ! -d #{shared_path}/symfony-#{version} ]; then
           wget -q http://www.symfony-project.org/get/symfony-#{version}.tgz -O- | tar -zxf - -C #{shared_path};

data/lib/symfony2.rb

@@ -1,53 +1,63 @@
 load Gem.find_files('capifony.rb').last.to_s
 
 # Symfony application path
-set :app_path,            "app"
+set :app_path,              "app"
 
 # Symfony web path
-set :web_path,            "web"
+set :web_path,              "web"
 
 # Symfony console bin
-set :symfony_console,     app_path + "/console"
-
-# Symfony bin vendors
-set :symfony_vendors,     "bin/vendors"
+set :symfony_console,       app_path + "/console"
 
 # Symfony log path
-set :log_path,            app_path + "/logs"
+set :log_path,              app_path + "/logs"
 
 # Symfony cache path
-set :cache_path,          app_path + "/cache"
+set :cache_path,            app_path + "/cache"
 
-# Use AsseticBundle
-set :dump_assetic_assets, false
+# Symfony bin vendors
+set :symfony_vendors,       "bin/vendors"
 
-# Whether to run the bin/vendors script to update vendors
-set :update_vendors, false
+# Symfony build_bootstrap script
+set :build_bootstrap,       "bin/build_bootstrap"
 
-# Whether to use composer to install vendors. This needs :update_vendors to false
-set :use_composer, false
+# Whether to use composer to install vendors.
+# If set to false, it will use the bin/vendors script
+set :use_composer,          false
+
+# Whether to update vendors using the configured dependency manager (composer or bin/vendors)
+set :update_vendors,        false
 
 # run bin/vendors script in mode (upgrade, install (faster if shared /vendor folder) or reinstall)
-set :vendors_mode, "reinstall"
+set :vendors_mode,          "reinstall"
 
-# Whether to run cache warmup 
-set :cache_warmup, true 
+# Whether to run cache warmup
+set :cache_warmup,          true
 
-# Assets install
-set :assets_install, true 
+# Use AsseticBundle
+set :dump_assetic_assets,   false
 
-# Dirs that need to remain the same between deploys (shared dirs)
-set :shared_children,     [log_path, web_path + "/uploads"]
+# Assets install
+set :assets_install,        true
 
 # Files that need to remain the same between deploys
-set :shared_files,        false
+set :shared_files,          false
+
+# Dirs that need to remain the same between deploys (shared dirs)
+set :shared_children,       [log_path, web_path + "/uploads"]
 
 # Asset folders (that need to be timestamped)
-set :asset_children,      [web_path + "/css", web_path + "/images", web_path + "/js"]
+set :asset_children,        [web_path + "/css", web_path + "/images", web_path + "/js"]
 
-set :model_manager, "doctrine"
-# Or: `propel`
+# Model manager: (doctrine, propel)
+set :model_manager,         "doctrine"
 
+# Symfony2 version
+set(:symfony_version)       { guess_symfony_version }
+
+# If set to false, it will never ask for confirmations (migrations task for instance)
+# Use it carefully, really!
+set :interactive_mode,      true
 
 def load_database_config(data, env)
   parameters = YAML::load(data)
@@ -55,9 +65,13 @@ def load_database_config(data, env)
   parameters['parameters']
 end
 
+def guess_symfony_version
+  capture("cd #{latest_release} && #{php_bin} #{symfony_console} --version |cut -d \" \" -f 3")
+end
+
 namespace :database do
   namespace :dump do
-    desc "Dump remote database"
+    desc "Dumps remote database"
     task :remote do
       filename  = "#{application}.remote_dump.#{Time.now.to_i}.sql.gz"
       file      = "/tmp/#{filename}"
@@ -69,12 +83,12 @@ namespace :database do
       end
 
       case config['database_driver']
-      when 'pdo_mysql'
+      when "pdo_mysql", "mysql"
         run "mysqldump -u#{config['database_user']} --password='#{config['database_password']}' #{config['database_name']} | gzip -c > #{file}" do |ch, stream, data|
           puts data
         end
-      when 'pdo_pgsql'
-        run "pg_dump -U #{config['database_user']} --password='#{config['database_password']}' #{config['database_name']} | gzip -c > #{file}" do |ch, stream, data|
+      when "pdo_pgsql", "pgsql"
+        run "pg_dump -U #{config['database_user']} #{config['database_name']} | gzip -c > #{file}" do |ch, stream, data|
           puts data
         end
       end
@@ -90,7 +104,7 @@ namespace :database do
       run "rm #{file}"
     end
 
-    desc "Dump local database"
+    desc "Dumps local database"
     task :local do
       filename  = "#{application}.local_dump.#{Time.now.to_i}.sql.gz"
       tmpfile   = "backups/#{application}_dump_tmp.sql"
@@ -101,11 +115,12 @@ namespace :database do
       require "fileutils"
       FileUtils::mkdir_p("backups")
       case config['database_driver']
-      when 'pdo_mysql'
+      when "pdo_mysql", "mysql"
         `mysqldump -u#{config['database_user']} --password=\"#{config['database_password']}\" #{config['database_name']} > #{tmpfile}`
-      when 'pdo_pgsql'
-        `pg_dump -U #{config['database_user']} --password=\"#{config['database_password']}\" #{config['database_name']} > #{tmpfile}`
+      when "pdo_pgsql", "pgsql"
+        `pg_dump -U #{config['database_user']} #{config['database_name']} > #{tmpfile}`
       end
+
       File.open(tmpfile, "r+") do |f|
         gz = Zlib::GzipWriter.open(file)
         while (line = f.gets)
@@ -125,7 +140,7 @@ namespace :database do
   end
 
   namespace :move do
-    desc "Dump remote database, download it to local & populate here"
+    desc "Dumps remote database, downloads it to local, and populates here"
     task :to_local do
       filename  = "#{application}.remote_dump.latest.sql.gz"
       config    = load_database_config IO.read('app/config/parameters.yml'), symfony_env_local
@@ -141,15 +156,15 @@ namespace :database do
       f.close
 
       case config['database_driver']
-      when 'pdo_mysql'
+      when "pdo_mysql", "mysql"
         `mysql -u#{config['database_user']} --password=\"#{config['database_password']}\" #{config['database_name']} < backups/#{sqlfile}`
-      when 'pdo_pgsql'
+      when "pdo_pgsql", "pgsql"
         `psql -U #{config['database_user']} --password=\"#{config['database_password']}\" #{config['database_name']} < backups/#{sqlfile}`
       end
       FileUtils.rm("backups/#{sqlfile}")
     end
 
-    desc "Dump local database, load it to remote & populate there"
+    desc "Dumps local database, loads it to remote, and populates there"
     task :to_remote do
       filename  = "#{application}.local_dump.latest.sql.gz"
       file      = "backups/#{filename}"
@@ -166,11 +181,11 @@ namespace :database do
       end
 
       case config['database_driver']
-      when 'pdo_mysql'
+      when "pdo_mysql", "mysql"
         run "mysql -u#{config['database_user']} --password='#{config['database_password']}' #{config['database_name']} < /tmp/#{sqlfile}" do |ch, stream, data|
           puts data
         end
-      when 'pdo_pgsql'
+      when "pdo_pgsql", "pgsql"
         run "psql -U #{config['database_user']} --password='#{config['database_password']}' #{config['database_name']} < /tmp/#{sqlfile}" do |ch, stream, data|
           puts data
         end
@@ -183,7 +198,7 @@ namespace :database do
 end
 
 namespace :deploy do
-  desc "Symlink static directories and static files that need to remain between deployments."
+  desc "Symlinks static directories and static files that need to remain between deployments"
   task :share_childs do
     if shared_children
       shared_children.each do |link|
@@ -202,7 +217,7 @@ namespace :deploy do
     end
   end
 
-  desc "Update latest release source path."
+  desc "Updates latest release source path"
   task :finalize_update, :except => { :no_release => true } do
     run "chmod -R g+w #{latest_release}" if fetch(:group_writable, true)
     run "if [ -d #{latest_release}/#{cache_path} ] ; then rm -rf #{latest_release}/#{cache_path}; fi"
@@ -214,54 +229,110 @@ namespace :deploy do
     if fetch(:normalize_asset_timestamps, true)
       stamp = Time.now.utc.strftime("%Y%m%d%H%M.%S")
       asset_paths = asset_children.map { |p| "#{latest_release}/#{p}" }.join(" ")
-      run "find #{asset_paths} -exec touch -t #{stamp} {} ';'; true", :env => { "TZ" => "UTC" }
+
+      if asset_paths.chomp.empty?
+        puts "    No asset paths found, skipped"
+      else
+        run "find #{asset_paths} -exec touch -t #{stamp} {} ';'; true", :env => { "TZ" => "UTC" }
+      end
     end
   end
 
-  desc "Deploy the application and start it."
+  desc "Deploys the application and starts it"
   task :cold do
     update
     start
   end
 
-  desc "Deploy the application and run the test suite."
+  desc "Deploys the application and runs the test suite"
   task :testall do
     update_code
     symlink
     run "cd #{latest_release} && phpunit -c #{app_path} src"
   end
 
-  desc "Migrate Symfony2 Doctrine ORM database."
+  desc "Runs the Symfony2 migrations"
   task :migrate do
-    currentVersion = nil
-    run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:migrations:status --env=#{symfony_env_prod}" do |ch, stream, out|
-      if stream == :out and out =~ /Current Version:[^$]+\(([\w]+)\)/
-        currentVersion = Regexp.last_match(1)
-      end
-      if stream == :out and out =~ /Current Version:\s*0\s*$/
-        currentVersion = 0
+    if model_manager == "doctrine"
+      symfony.doctrine.migrations.migrate
+    else
+      if model_manager == "propel"
+        puts "    Propel doesn't have built-in migration for now"
       end
     end
+  end
 
-    if currentVersion == nil
-      raise "Could not find current database migration version"
+  namespace :web do
+    desc <<-DESC
+      Present a maintenance page to visitors. Disables your application's web \
+      interface by writing a "#{maintenance_basename}.html" file to each web server. The \
+      servers must be configured to detect the presence of this file, and if \
+      it is present, always display it instead of performing the request.
+
+      By default, the maintenance page will just say the site is down for \
+      "maintenance", and will be back "shortly", but you can customize the \
+      page by specifying the REASON and UNTIL environment variables:
+
+        $ cap deploy:web:disable \\
+              REASON="hardware upgrade" \\
+              UNTIL="12pm Central Time"
+
+      You can use a different template for the maintenance page by setting the \
+      :maintenance_template_path variable in your deploy.rb file. The template file \
+      should either be a plaintext or an erb file.
+
+      Further customization will require that you write your own task.
+    DESC
+    task :disable, :roles => :web, :except => { :no_release => true } do
+      require 'erb'
+      on_rollback { run "rm #{latest_release}/#{web_path}/#{maintenance_basename}.html" }
+
+      warn <<-EOHTACCESS
+
+        # Please add something like this to your site's Apache htaccess to redirect users to the maintenance page.
+        # More Info: http://www.shiftcommathree.com/articles/make-your-rails-maintenance-page-respond-with-a-503
+
+        ErrorDocument 503 /#{maintenance_basename}.html
+        RewriteEngine On
+        RewriteCond %{REQUEST_URI} !\.(css|gif|jpg|png)$
+        RewriteCond %{DOCUMENT_ROOT}/#{maintenance_basename}.html -f
+        RewriteCond %{SCRIPT_FILENAME} !#{maintenance_basename}.html
+        RewriteRule ^.*$  -  [redirect=503,last]
+
+        # Or if you are using Nginx add this to your server config:
+
+        if (-f $document_root/maintenance.html) {
+          return 503;
+        }
+        error_page 503 @maintenance;
+        location @maintenance {
+          rewrite  ^(.*)$  /maintenance.html last;
+          break;
+        }
+      EOHTACCESS
+
+      reason   = ENV['REASON']
+      deadline = ENV['UNTIL']
+      template = File.read(maintenance_template_path)
+      result   = ERB.new(template).result(binding)
+
+      put result, "#{latest_release}/#{web_path}/#{maintenance_basename}.html", :mode => 0644
     end
-    puts "Current database version: #{currentVersion}"
-
-    on_rollback {
-      if Capistrano::CLI.ui.agree("Do you really want to migrate #{symfony_env_prod}'s database back to version #{currentVersion}? (y/N)")
-        run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:migrations:migrate #{currentVersion} --env=#{symfony_env_prod} --no-interaction"
-      end
-    }
 
-    if Capistrano::CLI.ui.agree("Do you really want to migrate #{symfony_env_prod}'s database? (y/N)")
-      run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:migrations:migrate --env=#{symfony_env_prod} --no-interaction"
+    desc <<-DESC
+      Makes the application web-accessible again. Removes the \
+      "#{maintenance_basename}.html" page generated by deploy:web:disable, which (if your \
+      web servers are configured correctly) will make your application \
+      web-accessible again.
+    DESC
+    task :enable, :roles => :web, :except => { :no_release => true } do
+      run "rm #{latest_release}/#{web_path}/#{maintenance_basename}.html"
     end
   end
 end
 
 namespace :symfony do
-  desc "Runs custom symfony task"
+  desc "Runs custom symfony command"
   task :default do
     prompt_with_default(:task_arguments, "cache:clear")
 
@@ -269,7 +340,7 @@ namespace :symfony do
   end
 
   namespace :assets do
-    desc "Install bundle's assets"
+    desc "Installs bundle's assets"
     task :install do
       run "cd #{latest_release} && #{php_bin} #{symfony_console} assets:install #{web_path} --env=#{symfony_env_prod}"
     end
@@ -278,7 +349,7 @@ namespace :symfony do
   namespace :assetic do
     desc "Dumps all assets to the filesystem"
     task :dump do
-      run "cd #{latest_release} && #{php_bin} #{symfony_console} assetic:dump #{web_path} --env=#{symfony_env_prod} --no-debug"
+      run "cd #{latest_release} && #{php_bin} #{symfony_console} assetic:dump --env=#{symfony_env_prod} --no-debug"
     end
   end
 
@@ -298,29 +369,47 @@ namespace :symfony do
       run "cd #{latest_release} && #{php_bin} #{symfony_vendors} update"
     end
   end
-    
+
   namespace :bootstrap do
-    desc "Runs the bin/build_bootstrap whithout upgrade the vendors"
+    desc "Runs the bin/build_bootstrap script"
     task :build do
-      run "cd #{latest_release} && #{php_bin} bin/build_bootstrap"
+      run "cd #{latest_release} && test -f #{build_bootstrap} && #{php_bin} #{build_bootstrap} || echo '#{build_bootstrap} not found, skipped'"
     end
   end
 
   namespace :composer do
-    desc "Runs composer install to install vendors from composer.lock file"
+    desc "Gets composer and installs it"
+    task :get do
+        run "cd #{latest_release} && curl -s http://getcomposer.org/installer | #{php_bin}"
+    end
+
+    desc "Runs composer to install vendors from composer.lock file"
     task :install do
+      if !File.exist?("#{latest_release}/composer.phar")
+        symfony.composer.get
+      end
+
       run "cd #{latest_release} && #{php_bin} composer.phar install"
     end
+
+    desc "Runs composer to update vendors, and composer.lock file"
+    task :update do
+      if !File.exist?("#{latest_release}/composer.phar")
+        symfony.composer.get
+      end
+
+      run "cd #{latest_release} && #{php_bin} composer.phar update"
+    end
   end
 
   namespace :cache do
-    desc "Clears project cache."
+    desc "Clears project cache"
     task :clear do
       run "cd #{latest_release} && #{php_bin} #{symfony_console} cache:clear --env=#{symfony_env_prod}"
       run "chmod -R g+w #{latest_release}/#{cache_path}"
     end
 
-    desc "Warms up an empty cache."
+    desc "Warms up an empty cache"
     task :warmup do
       run "cd #{latest_release} && #{php_bin} #{symfony_console} cache:warmup --env=#{symfony_env_prod}"
       run "chmod -R g+w #{latest_release}/#{cache_path}"
@@ -329,67 +418,88 @@ namespace :symfony do
 
   namespace :doctrine do
     namespace :cache do
-      desc "Clear all metadata cache for a entity manager."
+      desc "Clears all metadata cache for a entity manager"
       task :clear_metadata do
         run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:cache:clear-metadata --env=#{symfony_env_prod}"
       end
 
-      desc "Clear all query cache for a entity manager."
+      desc "Clears all query cache for a entity manager"
       task :clear_query do
         run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:cache:clear-query --env=#{symfony_env_prod}"
       end
 
-      desc "Clear result cache for a entity manager."
+      desc "Clears result cache for a entity manager"
       task :clear_result do
         run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:cache:clear-result --env=#{symfony_env_prod}"
       end
     end
 
     namespace :database do
-      desc "Create the configured databases."
+      desc "Creates the configured databases"
       task :create do
         run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:database:create --env=#{symfony_env_prod}"
       end
 
-      desc "Drop the configured databases."
+      desc "Drops the configured databases"
       task :drop do
         run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:database:drop --env=#{symfony_env_prod}"
       end
     end
 
     namespace :generate do
-      desc "Generates proxy classes for entity classes."
+      desc "Generates proxy classes for entity classes"
       task :hydrators do
         run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:generate:proxies --env=#{symfony_env_prod}"
       end
 
-      desc "Generate repository classes from your mapping information."
+      desc "Generates repository classes from your mapping information"
       task :hydrators do
         run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:generate:repositories --env=#{symfony_env_prod}"
       end
     end
 
     namespace :schema do
-      desc "Processes the schema and either create it directly on EntityManager Storage Connection or generate the SQL output."
+      desc "Processes the schema and either create it directly on EntityManager Storage Connection or generate the SQL output"
       task :create do
         run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:schema:create --env=#{symfony_env_prod}"
       end
 
-      desc "Drop the complete database schema of EntityManager Storage Connection or generate the corresponding SQL output."
+      desc "Drops the complete database schema of EntityManager Storage Connection or generate the corresponding SQL output"
       task :drop do
         run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:schema:drop --env=#{symfony_env_prod}"
       end
     end
 
     namespace :migrations do
-      desc "Execute a migration to a specified version or the latest available version."
+      desc "Executes a migration to a specified version or the latest available version"
       task :migrate do
-        if Capistrano::CLI.ui.agree("Do you really want to migrate #{symfony_env_prod}'s database? (y/N)")
+        currentVersion = nil
+        run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:migrations:status --env=#{symfony_env_prod}" do |ch, stream, out|
+          if stream == :out and out =~ /Current Version:[^$]+\(([\w]+)\)/
+            currentVersion = Regexp.last_match(1)
+          end
+          if stream == :out and out =~ /Current Version:\s*0\s*$/
+            currentVersion = 0
+          end
+        end
+
+        if currentVersion == nil
+          raise "Could not find current database migration version"
+        end
+        puts "    Current database version: #{currentVersion}"
+
+        on_rollback {
+          if !interactive_mode || Capistrano::CLI.ui.agree("Do you really want to migrate #{symfony_env_prod}'s database back to version #{currentVersion}? (y/N)")
+            run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:migrations:migrate #{currentVersion} --env=#{symfony_env_prod} --no-interaction"
+          end
+        }
+
+        if !interactive_mode || Capistrano::CLI.ui.agree("Do you really want to migrate #{symfony_env_prod}'s database? (y/N)")
           run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:migrations:migrate --env=#{symfony_env_prod} --no-interaction"
         end
       end
 
-      desc "View the status of a set of migrations."
+      desc "Views the status of a set of migrations"
       task :status do
         run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:migrations:status --env=#{symfony_env_prod}"
       end
@@ -397,29 +507,29 @@ namespace :symfony do
 
     namespace :mongodb do
       namespace :generate do
-        desc "Generates hydrator classes for document classes."
+        desc "Generates hydrator classes for document classes"
         task :hydrators do
           run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:mongodb:generate:hydrators --env=#{symfony_env_prod}"
         end
 
-        desc "Generates proxy classes for document classes."
+        desc "Generates proxy classes for document classes"
         task :hydrators do
           run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:mongodb:generate:proxies --env=#{symfony_env_prod}"
         end
 
-        desc "Generates repository classes for document classes."
+        desc "Generates repository classes for document classes"
         task :hydrators do
           run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:mongodb:generate:repositories --env=#{symfony_env_prod}"
         end
       end
 
       namespace :schema do
-        desc "Allows you to create databases, collections and indexes for your documents."
+        desc "Allows you to create databases, collections and indexes for your documents"
         task :create do
           run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:mongodb:schema:create --env=#{symfony_env_prod}"
         end
 
-        desc "Allows you to drop databases, collections and indexes for your documents."
+        desc "Allows you to drop databases, collections and indexes for your documents"
         task :drop do
           run "cd #{latest_release} && #{php_bin} #{symfony_console} doctrine:mongodb:schema:drop --env=#{symfony_env_prod}"
         end
@@ -434,57 +544,81 @@ namespace :symfony do
     end
   end
 
-    
   namespace :propel do
     namespace :database do
-      desc "Create the configured databases."
+      desc "Creates the configured databases"
       task :create do
         run "cd #{latest_release} && #{php_bin} #{symfony_console} propel:database:create --env=#{symfony_env_prod}"
       end
 
-      desc "Drop the configured databases."
+      desc "Drops the configured databases"
       task :drop do
         run "cd #{latest_release} && #{php_bin} #{symfony_console} propel:database:drop --env=#{symfony_env_prod}"
       end
     end
 
     namespace :build do
-      desc "Build the Model classes."
+      desc "Builds the Model classes"
       task :model do
-        run "cd #{latest_release} && #{php_bin} #{symfony_console} propel:build-model --env=#{symfony_env_prod}"
+        command = "propel:model:build"
+        if /2\.0\.[0-9]+.*/ =~ symfony_version
+          command = "propel:build-model"
+        end
+
+        run "cd #{latest_release} && #{php_bin} #{symfony_console} #{command} --env=#{symfony_env_prod}"
       end
 
-      desc "Build SQL statements."
+      desc "Builds SQL statements"
       task :sql do
-        run "cd #{latest_release} && #{php_bin} #{symfony_console} propel:build-sql --env=#{symfony_env_prod}"
+        command = "propel:sql:build"
+        if /2\.0\.[0-9]+.*/ =~ symfony_version
+          command = "propel:build-sql"
+        end
+
+        run "cd #{latest_release} && #{php_bin} #{symfony_console} #{command} --env=#{symfony_env_prod}"
       end
 
-      desc "Build the Model classes, SQL statements and insert SQL."
+      desc "Builds the Model classes, SQL statements and insert SQL"
       task :all_and_load do
         run "cd #{latest_release} && #{php_bin} #{symfony_console} propel:build --insert-sql --env=#{symfony_env_prod}"
       end
+
+      desc "Generates ACLs models"
+      task :acl do
+        run "cd #{latest_release} && #{php_bin} #{symfony_console} propel:acl:init --env=#{symfony_env_prod}"
+      end
+
+      desc "Inserts propel ACL tables"
+      task :acl_load do
+        run "cd #{latest_release} && #{php_bin} #{symfony_console} propel:acl:init --env=#{symfony_env_prod} --force"
+      end
     end
   end
 end
 
 # After finalizing update:
 after "deploy:finalize_update" do
-  if update_vendors
-    # share the children first (to get the vendor symlink)
-    deploy.share_childs
-    vendors_mode.chomp # To remove trailing whiteline
-    case vendors_mode
-     when "upgrade" then symfony.vendors.upgrade
-     when "install" then symfony.vendors.install
-     when "reinstall" then symfony.vendors.reinstall
-    end
-  elsif use_composer
-    symfony.composer.install
+  if use_composer
+    if update_vendors
+      symfony.composer.update
+    else
+      symfony.composer.install
+    end
   else
-    # share the children first (to get the vendor symlink)
-    deploy.share_childs
-    vendors_mode.chomp # To remove trailing whiteline
-    symfony.bootstrap.build
+    if update_vendors
+      vendors_mode.chomp # To remove trailing whiteline
+      case vendors_mode
+        when "upgrade" then symfony.vendors.upgrade
+        when "install" then symfony.vendors.install
+        when "reinstall" then symfony.vendors.reinstall
+      end
+    else
+      symfony.bootstrap.build
+    end
+  end
+
+  if model_manager == "propel"
+    symfony.propel.build.model
   end
 
   if assets_install
@@ -498,8 +632,4 @@ after "deploy:finalize_update" do
   if dump_assetic_assets
     symfony.assetic.dump    # 4. Dump assetic assets
   end
-
-  if model_manager == "propel"
-    symfony.propel.build.model
-  end
 end

metadata

@@ -1,29 +1,32 @@
 --- !ruby/object:Gem::Specification 
 name: capifony
 version: !ruby/object:Gem::Version 
-  prerelease: false
+  hash: 5
+  prerelease: 
   segments: 
   - 2
   - 1
-  - 6
-  version: 2.1.6
+  - 7
+  version: 2.1.7
 platform: ruby
 authors: 
 - Konstantin Kudryashov
+- William Durand
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2012-04-12 00:00:00 +02:00
-default_executable: 
+date: 2012-06-21 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: capistrano
   prerelease: false
   requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 15
         segments: 
         - 2
         - 5
@@ -31,8 +34,10 @@ dependencies:
         version: 2.5.10
   type: :runtime
   version_requirements: *id001
-description: "    Capistrano is an open source tool for running scripts on multiple servers. It\xE2\x80\x99s primary use is for easily deploying applications. While it was built specifically for deploying Rails apps, it\xE2\x80\x99s pretty simple to customize it to deploy other types of applications. This package is a deployment \xE2\x80\x9Crecipe\xE2\x80\x9D to work with symfony (both 1 and 2) applications.\n"
-email: ever.zet@gmail.com
+description: "    Capistrano is an open source tool for running scripts on multiple servers. It\xE2\x80\x99s primary use is for easily deploying applications. While it was built specifically for deploying Rails apps, it\xE2\x80\x99s pretty simple to customize it to deploy other types of applications. This package is a deployment \"recipe\" to work with symfony (both 1 and 2) applications.\n"
+email: 
+- ever.zet@gmail.com
+- william.durand1@gmail.com
 executables: 
 - capifony
 extensions: []
@@ -47,8 +52,7 @@ files:
 - README.md
 - LICENSE
 - CHANGELOG
-has_rdoc: true
-homepage: http://capifony.info
+homepage: http://capifony.org
 licenses: []
 
 post_install_message: 
@@ -57,23 +61,27 @@ rdoc_options: []
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
 requirements: []
 
 rubyforge_project: capifony
-rubygems_version: 1.3.6
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: Deploying symfony PHP applications with Capistrano.