Guia rápido de configuração do Capistrano com o GitHub

Esse é um guia rápido de configuração do Capistrano com o GitHub.

Os passos desses post foram utilizados no projeto [click-anywhere-to-leave-a-message.com](http://click-anywhere-to-leave-a-message.com), disponível para download no [GitHub](http://github.com/phstc/click-anywhere-to-leave-a-message.com).

Após logado no GitHub, no seu dashboard aparecerá seus repositórios e um botão para criar um novo repositório.

GitHub - Your Repositories - New Repository

Após criado o repositório, o GitHub mostrará as instruções para o seu primeiro commit.

 cd click-anywhere-to-leave-a-message.com
 git init
 touch README
 git add README
 git commit -m 'first commit'
 git remote add origin git@github.com:phstc/click-anywhere-to-leave-a-message.com.git
 git push origin master

.gitignore

Para não compartilhar alguns arquivos no repositório, como credenciais do banco de dados, logs, arquivos temporários etc, basta criar um arquivo .gitignore na raiz do projeto.

cat .gitignore
.DS_Store
*~
*.swp
tmp/*
log/*
backup/*
config/database.yml
Capfile
config/deploy.rb
db/*.sqlite3
mkmf.log
db/schema.rb

Instalando e adicionando o Capistrano

cd click-anywhere-to-leave-a-message.com
gem install capistrano
capify .

Configurando o deploy.rb

Após adicionar o Capistrano, bastará configurar o arquivo deploy.rb.

set :application, 'sua aplicacao'
set :user, 'seu usuario ssh'
set :password, 'sua senha shh'
set :domain, 'seu dominio'
set :mongrel_port, 'sua porta'
set :mongrel_nodes, "4"
set :rails_env,     "production"
set :server_hostname, 'seu hostname'
set :git_account, 'seu usuario do github'
set :scm_passphrase,  Proc.new { Capistrano::CLI.password_prompt('sua senha') }
role :web, 'seu dominio'
role :app, 'seu dominio'
role :db, 'seu dominio', :primary => true
default_run_options[:pty] = true
set :repository,  "git@github.com:#{git_account}/#{application}.git"
set :scm, "git"
set :user, user
ssh_options[:forward_agent] = true
set :branch, "master"
set :deploy_via, :checkout
set :git_shallow_clone, 1
set :git_enable_submodules, 1
set :use_sudo, false
set :deploy_to, "/home/#{user}/rails_apps/#{application}"

Adicionado sua public key no GitHub

Se aparecerem problemas como Permission denied (publickey).

servers: ["click-anywhere-to-leave-a-message.com"]
 [click-anywhere-to-leave-a-message.com] executing command
 ** [click-anywhere-to-leave-a-message.com :: out] Permission denied (publickey).
 ** [click-anywhere-to-leave-a-message.com :: out] fatal: The remote end hung up unexpectedly

Você deverá seguir o tutorial do próprio GitHub: linux, mac e windows para configurar sua chave pública.

Fazendo o deploy com o Capistrano

Para fazer o deploy basta executar a instrução cap deploy.

cd click-anywhere-to-leave-a-message.com
cap deploy

Se não aparecer nenhum erro (será???), seu Capistrano estará funcionando perfeitamente, no meu caso apareceu o seguinte erro:

current/script/process/reaper: No such file or directory

Para corrigi-lo eu tive que adicionar as tasks de start, stop e restart no deploy.rb.

namespace :deploy do
 task :start, :roles => :app do
 run "cd #{current_path} && mongrel_rails start -e production -p #{mongrel_port} -d"
 end
 task :restart, :roles => :app do
 run "cd #{current_path} && mongrel_rails restart"
 end
 task :stop, :roles => :app do
 run "cd #{current_path} && mongrel_rails stop"
 end
end

Meu database.yml e outros arquivos estão somente no servidor e não no repositório, portanto sempre após o deploy com o Capistrano eu crio um link simbólico para esses arquivos.

after "deploy:finalize_update", "deploy:symlink2"
#...
namespace :deploy do
#...
desc "Make symlink for config files"
 task :symlink2 do
 run "ln -nsf /home/#{user}/rails_apps/#{application}/database.yml #{release_path}/config/database.yml"
 end
end

Diretório log

O Capistrano cria automáticamente um link simbólico para o diretório de log do projeto apontando para /home/#{user}/rails_apps/#{application}/shared/log. Como ele não cria automáticamente o diretório só o link simbólico, precisamos cria-lo manualmente.

mkdir /home/#{user}/rails_apps/#{application}/shared/
mkdir /home/#{user}/rails_apps/#{application}/shared/log

Principais referências