Usar Capistrano con DreamHost

Estaba teniendo problemas con Capistrano 1.4 para hacerlo funcionar con Dreamhost y he tenido que actualizarlo a la nueva versión 2.0, que trae algunos cambios que me han desorientado al principio, más que nada porque en el manual mítico oficial no han actualizado nada. Luego descubrí que la nueva web oficial es otra, aunque apenas tiene documentación.

Los pasos que he seguido son:

Desde el panel de control de Dreamhost:

1. Añadir un nuevo subdominio, como myapp.jesuscarrera.info, dándole soporte para FCGI, y añadiendo /current/public al directorio sugerido.

   Más tarde, en cuanto se propaguen las DNS y podamos acceder a http://myapp.jesuscarrera.info/current/public, y antes de ejecutar cap deploy, deberemos borrar manualmente estos dos directorios, porque cap deploy creará un symlink para que Capistrano y Subversion funcionen bien juntos.

2. Añadimos la base de datos que vallamos a utilizar.
3. Creamos el repositorio de Subversion. Yo tengo creado un subdominio para acceder a esos repositorios. Su URL quedaría así: http://svn.jesuscarrera.info/myapp

En nuestra aplicación (máquina local en desarrollo).

1. Editar el config/database.yml para que en :production tenga los datos de Dreamhost.
2. En config/environment.rb descomentar la línea: ENV['RAILS_ENV'] ||= 'production'
3. En public/dispatch.* cambiarle la primera línea por ésta: #!/usr/bin/env ruby
4. En public/.htaccess asegurarnos de que ésta línea tenga .fcgi y no .cgi RewriteRule ^(.*)$ dispatch.fcgi [QSA,L]
5. Añadir después de RewriteEngine On lo siguiente, para que muestre una página de mantenimiento si existe (cuando ejecutamos cap deploy:web:disable). RewriteCond %{DOCUMENT_ROOT}/system/maintenance.html -f RewriteCond %{SCRIPT_FILENAME} !maintenance.html RewriteRule ^.*$ /system/maintenance.html [L]
6. Instalar Capistrano 2.0
   sudo gem install capistrano
7. Añadimos los archivos de Capistrano a nuestra app. Ejecutamos desde el directorio myapp:
   capify .

   Ésto crea dos archivos: Capfile y config/deploy.rb.

8. Editamos config/deploy.rb para que quede algo así: set :user, 'jesuscarrera' set :application, "myapp.jesuscarrera.info" set :repository, "svn+ssh://jesuscarrera@svn.jesuscarrera.info/home/#{user}/svn/myapp" # ============== # ============== # ============== role :web, application role :app, application role :db, application, :primary => true set :deploy_to, "/home/#{user}/#{application}" set :use_sudo, false

   A mi me ha funcionado sin estas últimas líneas, pero puede que en algunos casos sean necesarias:

   ################################################################# set :checkout, "export" # TASKS # desc "Tasks to execute after code update" task :after_update_code, :roles => [:app, :db, :web] do # fix permissions run "chmod +x #{release_path}/script/process/reaper" run "chmod +x #{release_path}/script/process/spawner" run "chmod 755 #{release_path}/public/dispatch.*" end desc "Restarting after deployment" task :after_deploy, :roles => [:app, :db, :web] do run "touch /home/jesuscarrera/depot.jesuscarrera.info/current/public/dispatch.fcgi" end desc "Restarting after rollback" task :after_rollback, :roles => [:app, :db, :web] do run "touch /home/jesuscarrera/depot.jesuscarrera.info/current/public/dispatch.fcgi" end ########## task :restart, :roles => :app do run "ruby #{current_path}/script/process/reaper --dispatcher=dispatch.fcgi" end # In config/deploy.rb task :after_symlink, :roles => [:web, :app] do # Make dispatcher executable run "chmod a+x #{current_path}/public/dispatch.fcgi" end #################################################################
   Recuerda que para que no pida las claves todo el rato podemos autorizar nuestro equipo para SSH.
9. Realizamos nuestra primera importación al repositorio

   svn import myapp svn+ssh://[email protected]/home/jesuscarrera/svn/myapp -m "Initial import"

10. Renombramos el original (o si eres valiente también lo puedes borrar), y nos descargamos la primera versión del repositorio:
    mv depot depot.imported
    svn co svn+ssh://[email protected]/home/jesuscarrera/svn/myapp myapp
11. Preparamos el servidor para recibir nuestra app:
    cap deploy:setup
12. Enviamos nuestra aplicación aplicando migraciones:
    cap deploy:cold
13. A partir de ahora cada vez que realicemos cambios en nuestra máquina local en desarrollo deberemos en primer lugar enviarlos al repositorio, y luego actualizarla en producción:

    svn commit -m "Change description"
    cap deploy

    Si hemos añadido migraciones sería con:
    cap deploy:migrations

    Si algo va mal podemos volver a la anterior versión con:
    cap deploy:rollback

    Si vamos a realizar un mantenimiento importante podemos deshabilitar y habilitar la web con:
    cap deploy:web:disable
    cap deploy:web:enable

    Para ver otras tareas:
    cap -T

Yo lo he probado con la aplicación que te enseña a hacer el fantástico libro Agile Web Development With Rails. La podéis ver en depot.jesuscarrera.info/store. Ha funcionado tan bien y a la primera que hasta me ha sorprendido!