Guia rápido de configuração do Capistrano com o GitHub
23 Jul 2010Esse é 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, disponível para download no GitHub.
Após logado no GitHub, no seu dashboard aparecerá seus repositórios e um botão para criar um novo repositório.
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 [email protected]: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, "[email protected]:#{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
Criando link simbólico para arquivos não compartilhados no repositório
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