Deployment automatizado de aplicaÃ§Ã£o PHP com Capistrano

29 ago 2009

Os que me conhecem sabe quanto o Rails Summit 2008 mudou a minha vida profissionalmente. Eu jÃ¡ sabia que as coisas haviam evoluÃdo mas sinceramente nunca tinha dado muita bola, pois os meus processos sempre funcionaram bem. LÃ¡ eu pude ver que muita coisa legal estava sendo feita e eu que nÃ£o podia ficar de fora. Uma delas foi o deployment automatizado.

Capistrano

O Capistrano Ã© uma RubyGem que permite que vocÃª escreva receitas para publicaÃ§Ã£o em servidores web. Ã‰ possÃvel usa-la integrada com o seu repositÃ³rio (centralizado ou distribuÃdo) ou mesmo copiar-tudo-compactar-e-enviar automaticamente. Ele permite manter vÃ¡rias versÃµes da aplicaÃ§Ã£o no servidor (e fazer rollback se necessÃ¡rio) e utiliza links simbÃ³licos para dizer qual delas Ã© a atual.

A instalaÃ§Ã£o Ã© mais facil que fazer miojo:

$ sudo gem install capistrano

Ã‰ necessÃ¡rio ter o Ruby e o RubyGems instalado no seu sistema. Se vocÃª usa Ubuntu, eu posso ajudar.

Configurando o seu projeto

Dentro do diretÃ³rio do seu projeto, crie a estrutura basica do capistrano:

$ capify .
# [add] writing `./Capfile'
# [skip] `./Capfile' already exists
# [add] writing `./config/deploy.rb'
# [done] capified!

Notem que o arquivo config/deploy.rb foi criado. Ã‰ nele que vocÃª irÃ¡ escrever a sua receita.

Exemplo de receita usando estratÃ©gia de cÃ³pia

role :web, "dominio.com.br"
role :app, "dominio.com.br"

set :application, "aplicacao"
set :repository, "."
set :scm, :none
set :deploy_via, :copy
set :copy_compression, :bz2
set :copy_exclude, ["lixo", "config"]
set :user, "usuario"
set :use_sudo, false
set :keep_releases, 5
set :app_symlinks, ["f"]
set :normalize_asset_timestamps, false
set :deploy_to, "~/php_apps/#{application}"
set :public_path, "~/public_html"

ssh_options[:keys] = ["#{ENV['HOME']}/.ssh/id_rsa"]

namespace :deploy do
# Anula o restart do servidor
desc "Fake restart"
task :restart, :roles => :app do
run "exit"
end
end

task :define_conf_files, :roles => [:app] do
run "rm -rfd #{release_path}/conf.php"
run "ln -nfs #{release_path}/conf-online.php #{release_path}/conf.php"
end

desc "Setup application symlinks in the public"
task :symlinks_setup, :roles => [:web] do
if app_symlinks
app_symlinks.each { |link| run "mkdir -p #{shared_path}/public/#{link}" }
end
end

desc "Link public directories to shared location."
task :symlinks_update, :roles => [:web] do
if app_symlinks
app_symlinks.each { |link| run "ln -nfs #{shared_path}/public/#{link} #{current_path}/#{link}" }
end
run "ln -nfs #{current_path} #{public_path}"
end

after "deploy:update_code", :define_conf_files
after "deploy:symlink", "symlinks_update"

Usando o Capistrano

ApÃ³s estar com a receita devidamente escrita, Ã© hora de configurar o servidor online para a estrutura do Capistrano.

$ cap deploy:setup

O setup sÃ³ precisa ser rodado uma Ãºnica vez.

Depois de configurado, para publicar a sua aplicaÃ§Ã£o basta fazer isso:

$ cap deploy

MÃ¡gico nÃ©?

Fez merda e publicou alguma coisa que nÃ£o devia? FaÃ§a um rollback!

$ cap deploy:rollback

Algumas consideraÃ§Ãµes sobre essa receita:

FAÃ‡A BACKUP! Antes de comeÃ§ar a testar o capistrano, tenha certeza que os arquivos da sua aplicaÃ§Ã£o estÃ£o protegidos e vocÃª nÃ£o irÃ¡ fazer cagada.
Por se tratar de uma aplicaÃ§Ã£o em PHP, nÃ£o Ã© necessÃ¡rio reiniciar o servidor como em aplicaÃ§Ãµes Rails. Por isso reescrevi a tarefa restart para que ele nÃ£o faÃ§a nada.
A aplicaÃ§Ã£o em questÃ£o permite o upload de arquivos pelos usuÃ¡rios, sendo necessÃ¡rio criar links simbÃ³licos para manter esses dados fisicamente fora da estrutura da aplicaÃ§Ã£o que serÃ¡ enviada pelo Capistrano. Nesse caso, todos os arquivos que serÃ£o enviados pelos usuÃ¡rios ficam no diretÃ³rio /f/.
Como os ambientes de desenvolvimento e produÃ§Ã£o sÃ£o sensivelmente diferentes, optei por manter dois arquivos de configuraÃ§Ãµes separados: conf.php e conf-online.php. A aplicaÃ§Ã£o faz referÃªncia ao conf.php e durante a publicaÃ§Ã£o, o Capistrano se encarrega de apagar o arquivo de desenvolvimento e faz um link simbÃ³lico para o arquivo de produÃ§Ã£o.
Essa receita resolve O MEU PROBLEMA. Espero que possa ser Ãºtil para vocÃª.

Se ficou interessado em usar o Capistrano para publicar a sua aplicaÃ§Ã£o, sugiro fortemente que leia a documentaÃ§Ã£o para maiores detalhes.

Tags: bash, linux, php, ruby, ubuntu

Venicios Ribeiro: Ã‰ uma excelente forma de ativar o cache. Existem tbm outras tecnicas muito simples, como o Gzip. Ã [...]

Andre Ferraro: Muito bom!! Estou fazendo o meu e vou postar no meu blog. Vlw!! [...]

paulo henrique: Bom dia! existe algum app para usar o twitter no e71, que seja free [...]

Ricardo: Bruno, Aplicativo para IM com vÃdeo eu nÃ£o conheÃ§o, mas para Ã¡udio vocÃª pode usar o Nimbuzz [...]

Bruno: OlÃ¡ boa tarde. Gostaria de saber qual software IM pro E71 suporta conversaÃ§Ã£o com Ã¡udio e video. [...]

ricardo duarte

Deployment automatizado de aplicaÃ§Ã£o PHP com Capistrano

Capistrano

Configurando o seu projeto

Exemplo de receita usando estratÃ©gia de cÃ³pia

Usando o Capistrano

Comment Form

Sobre

rduarte's tweets

rduarte's photos

Categorias

Arquivos