akitaonrails-locarails 1.0.0

data/LICENSE

@@ -0,0 +1,18 @@
+Copyright (c) 2008 Chris Wanstrath
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of 
+this software and associated documentation files (the "Software"), to deal in 
+the Software without restriction, including without limitation the rights to 
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of 
+the Software, and to permit persons to whom the Software is furnished to do so, 
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all 
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS 
+FOR A PARTICULAR PURPOSE AND 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.

data/Manifest

@@ -0,0 +1,11 @@
+bin/locarails
+bin/locarails.cmd
+LICENSE
+Manifest
+README
+locarails.gemspec
+lib/locarails.rb
+lib/locarails/version.rb
+templates/database.locaweb.yml
+templates/deploy.rb
+templates/locaweb_backup.rb

data/README

@@ -0,0 +1,65 @@
+= locarails
+
+* http://www.locaweb.com.br/rails
+
+== DESCRICAO:
+
+Facilitar a instalacao de aplicacoes Rails na hospedagem Linux da
+Locaweb. Configura receita de Capistrano padrao que deve funcionar
+na maioria dos cenarios
+
+== SINOPSE:
+
+  cd seu_projeto_rails
+  locarails .
+  cap deploy:setup
+  cap deploy
+
+== AVISOS:
+
+* Não use o locarails se voce ja tem Capistrano instalado no seu
+  projeto. Este programa tem como objetivo ajudar quem nao conhece
+  nada a respeito de Capistrano
+* Tenha em maos as seguintes informacoes:
+  - seu usuario de hospedagem (o usuario da conta linux, nao o 
+    usuario de cliente)
+  - seus dados de MySQL (usuario, senha, servidor, nome do banco)
+* Crie o apontamento do seu dominio via o Painel da Locaweb em
+  painel.locaweb.com.br e aponte para o diretorio /public_html/app
+  sendo 'app' o nome da sua aplicacao
+
+== REQUERIMENTOS:
+
+* Estar em Linux (Ubuntu ou outros) ou Mac OS X
+* Ter Ruby instalado (sudo apt-get install ruby1.8 ruby1.8-dev)
+* Ter Rails instalado (sudo gem install rails)
+* Ter Capistrano instalado (sudo gem install capistrano)
+
+== INSTALL:
+
+* gem install akitaonrails-locarails --source=http://gems.github.com
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 Fabio Akita
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 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.

data/bin/locarails

@@ -0,0 +1,117 @@
+#!/usr/bin/env ruby
+#
+#  Created on 2008-8-19.
+#  Copyright (c) 2008. All rights reserved.
+
+begin
+  require 'rubygems'
+rescue LoadError
+  # no rubygems to load, so we fail silently
+end
+
+require 'ostruct'
+require 'optparse'
+
+OptionParser.new do |opts|
+  opts.banner = "Uso: #{File.basename($0)} [caminho]"
+
+  opts.on("-h", "--help", "Mostra esta tela de ajuda") do
+    puts opts
+    exit 0
+  end
+
+  begin
+    opts.parse!(ARGV)
+  rescue OptionParser::ParseError => e
+    warn e.message
+    puts opts
+    exit 1
+  end
+end
+
+if ARGV.empty?
+  abort "Por favor, especifique o diretorio do seu projeto Rails, e.g. `#{File.basename($0)} .'"
+elsif !File.exists?(ARGV.first)
+  abort "`#{ARGV.first}' nao existe. Tente novamente."
+elsif !File.directory?(ARGV.first)
+  abort "`#{ARGV.first}' nao eh um diretorio. Tente novamente."
+elsif ARGV.length > 1
+  abort "Argumentos demais; por favor especifique somente o diretorio da aplicacao Rails.."
+end
+
+def get_input(message)
+  print "* #{message} > "
+  gets.strip
+end
+
+# configuracoes da sua hospedagem
+config   = OpenStruct.new
+mysqlcfg = OpenStruct.new
+
+# configuracoes locais da sua maquina
+config.bin_path   = File.dirname(File.expand_path(__FILE__))
+config.local_path = File.expand_path(ARGV.shift)
+config.app_name   = config.local_path.split('/').last
+
+if File.exists?(File.join(config.local_path, 'config/deploy.rb'))
+  abort "Voce ja tem capistrano configurado em config/deploy.rb. Configuracao abortada."
+end
+
+puts <<-STR
+==================================================
+Bem Vindos ao configurador de projetos da Locaweb
+Vamos configurar seu projeto Rails para melhor se
+Adequar nas nossas hospedagens Linux compartilhada
+Para tanto precisaremos de algumas informacoes:
+==================================================
+
+Garanta que a seguinte pasta contem sua aplicacao
+Rails: #{config.local_path}
+
+STR
+
+# configuracoes inseridas manualmente pelo usuario
+config.app_name = get_input( "O nome da sua aplicacao" ) if config.app_name.nil? || config.app_name.empty?
+config.dominio  = get_input "O dominio do seu site (ex. teste.tempsite.ws)"
+config.usuario  = get_input "Seu usuario de hospedagem"
+mysqlcfg.db     = get_input "O nome do seu banco mysql"
+mysqlcfg.user   = get_input "Seu usuario de mysql"
+mysqlcfg.pass   = get_input "Sua senha de mysql"
+mysqlcfg.host   = get_input "Seu servidor mysql (ex. mysqlxxx.locaweb.com.br)"
+
+# forca rodar capistrano
+unless File.exists?("#{config.local_path}/Capfile")
+  puts "- Executando Capistrano no seu projeto ..."
+  `capify .`
+end
+
+FileUtils.copy_file("#{config.bin_path}/../templates/locaweb_backup.rb", 
+  "#{config.local_path}/config/locaweb_backup.rb")
+  
+File.open("#{config.local_path}/config/deploy.rb", 'w+') do |out| 
+  buffer = File.open("#{config.bin_path}/../templates/deploy.rb", 'r') do | f | 
+    f.read.gsub('seu.usuario', config.usuario).
+      gsub('seu.dominio',      config.dominio).
+      gsub('sua.aplicacao',    config.app_name).
+      gsub('seu.projeto',      config.local_path)
+  end
+  out.puts buffer
+end
+
+File.open("#{config.local_path}/config/database.locaweb.yml", 'w+') do |out| 
+  buffer = File.open("#{config.bin_path}/../templates/database.locaweb.yml", 'r') do | f | 
+    f.read.gsub('mysql.database', mysqlcfg.db).
+      gsub('mysql.username', mysqlcfg.user).
+      gsub('mysql.password', mysqlcfg.pass).
+      gsub('mysql.hostname', mysqlcfg.host)
+  end
+  out.puts buffer
+end
+
+puts <<-STR
+
+# Parabéns, voce terminou de configurar sua aplicacao Rails!
+# Para configurar sua hospedagem execute 'cap deploy:setup'.
+# Para subir seu projeto execute 'cap deploy'
+[finalizado!]
+STR

data/bin/locarails.cmd

@@ -0,0 +1 @@
+@ruby "C:/ruby/bin/locarails" %*

data/lib/locarails.rb

@@ -0,0 +1,6 @@
+$:.unshift(File.dirname(__FILE__)) unless
+  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+module Locarails
+  
+end

data/lib/locarails/version.rb

@@ -0,0 +1,9 @@
+module Locarails
+  module VERSION #:nodoc:
+    MAJOR = 1
+    MINOR = 0
+    TINY  = 0
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end

data/locarails.gemspec

@@ -0,0 +1,21 @@
+Gem::Specification.new do |s|
+  s.name = %q{locarails}
+  s.version = "1.0.0"
+
+  s.specification_version = 2 if s.respond_to? :specification_version=
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Fabio Akita"]
+  s.date = %q{2008-08-19}
+  s.default_executable = %q{locarails}
+  s.description = %q{A maneira mais simples para instalar aplicacoes Rails na hospedagem Linux da Locaweb.}
+  s.email = %q{fabio.akita@locaweb.com.br}
+  s.executables = ["locarails"]
+  s.files = ["bin/locarails", "bin/locarails.cmd", "LICENSE", "Manifest", "README", "lib/locarails.rb", "lib/locarails/version.rb", "templates/database.locaweb.yml", "templates/deploy.rb", "templates/locaweb_backup.rb", "locarails.gemspec"]
+  s.has_rdoc = true
+  s.homepage = %q{http://www.locaweb.com.br/rails}
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{locarails}
+  s.rubygems_version = %q{1.1.1}
+  s.summary = %q{Configuracao de Capistrano automatica para hospedagens Linux Locaweb.}
+end

data/templates/database.locaweb.yml

@@ -0,0 +1,7 @@
+production:
+  adapter: mysql
+  encoding: utf8
+  database: mysql.database
+  username: mysql.username
+  password: mysql.password
+  host: mysql.hostname

data/templates/deploy.rb

@@ -0,0 +1,146 @@
+# =============================================================================
+# Receita de Capistrano 2.x para hospedagem compartilhada Linux
+# utilizando estratégia de cópia sem servidor de versionamento
+# =============================================================================
+# 
+# Para que esta receita funcione realize os seguintes passos:
+# 
+# 1. copie o arquivo backup_locaweb.rb no diretorio 'config' de sua aplicacao
+# 2. crie um arquivo 'config/database.locaweb.yml' configurando de acordo com
+#    os dados de sua hospedagem (que você recebeu por e-mail com o título de
+#    "Instrucoes - MySQL - Incluso"). Um exemplo seria assim: 
+#    
+#    production:
+#      adapter: mysql
+#      encoding: utf8
+#      database: railsdemo
+#      username: railsdemo
+#      password: xxxxxxxxx
+#      host: mysql1179.locaweb.com.br
+#    
+# 3. se você estiver utilizando subversion, git ou outro versionador, garanta
+#    que os arquivos 'config/database.yml' e o 'config/database.locaweb.yml'
+#    estão na lista de arquivos ignorados. Eh boa pratica nao mante-los num
+#    repositorio
+# 4. garanta que voce tem capistrano instalado executando 'sudo gem install
+#    capistrano'
+# 5. garanta que, a partir do diretorio do seu projeto, voce executou o comando
+#    'capify .' para que o capistrano se configure corretamente no seu projeto
+# 6. substitua o arquivo 'config/deploy.rb' gerado, por este arquivo que voce
+#    baixou da Locaweb
+# 7. altere o arquivo 'config/deploy.rb' conforme o exemplo abaixo:
+# 
+#    set :user, "railsdemo"                         
+#    set :domain, "railsdemo.tecnologia.ws"         
+#    set :application, "demo"                       
+#    set :repository, "~/Sites/rails/demo"  
+#    
+#    Note que 'application' eh o nome do diretorio que voce configurou no
+#    Painel de Controle da Locaweb, onde ele mostra /public_html/demo, por
+#    exemplo.
+# 
+# 8. Feito isso digite 'cap deploy:setup'. Isso deve ser executado apenas uma vez
+#    para que toda a configuracao necessaria seja feita na sua hospedagem
+#    
+# 9. Finalmente, para colocar sua aplicação em produção, apenas execute 
+#    'cap deploy'. Se nada der errado, já deve estar tudo no ar.
+#    
+# 10. Se em algum momento, voce notar que a instalacao atual subiu com problemas
+#    sempre podera voltar atras usando o comando 'cap deploy:rollback', garantindo
+#    que problemas inesperados nao o deixem fora do ar.
+#
+# Autor: Fabio Akita
+# E-mail: fabio.akita@locaweb.com.br
+# Locaweb Serviços de Internet S/A 
+# Todos os direitos reservados
+
+# =============================================================================
+# CONFIGURE OS VALORES DE ACORDO COM SUA HOSPEDAGEM
+# =============================================================================
+set :user, "seu.usuario"
+set :domain, "seu.dominio"
+set :application, "sua.aplicacao"
+set :repository, "seu.projeto"
+#ssh_options[:keys] = File.expand_path("~/.ssh/id_rsa") # apenas descomente se tiver chave
+
+# =============================================================================
+# NAO MEXER DAQUI PARA BAIXO
+# =============================================================================
+role :web, domain
+role :app, domain
+role :db,  domain
+
+set :deploy_to, "/home/#{user}/rails_app/#{application}" 
+set :public_html, "/home/#{user}/public_html"
+set :site_path, "#{public_html}/#{application}"
+set :runner, nil
+set :use_sudo, false
+set :no_release, true
+
+set :scm, :none # nenhum repositorio
+set :deploy_via, :copy 
+set :copy_exclude, %w(.git/* .svn/* log/* tmp/*)
+
+ssh_options[:username] = user
+ssh_options[:paranoid] = false 
+
+set :backup_rb, "#{deploy_to}/current/config/locaweb_backup.rb"
+
+# =============================================================================
+# TAREFAS - NAO MEXER A MENOS QUE SAIBA O QUE ESTA FAZENDO
+# =============================================================================
+desc "Garante que o database.yml foi corretamente configurado"
+task :before_symlink do
+  on_rollback {}
+  run "test -d #{release_path}/tmp || mkdir -m 755 #{release_path}/tmp"
+  run "cp #{deploy_to}/etc/database.yml #{release_path}/config/database.yml"
+  run "cd #{release_path} && rake db:migrate RAILS_ENV=production"
+end
+
+desc "Garante que as configuracoes estao adequadas"
+task :before_setup do
+  ts = Time.now.strftime("%y%m%d%H%M%S")
+  run "if [ -d #{deploy_to} ]; then mv #{deploy_to} #{deploy_to}-#{ts}.old ; fi"
+  run "test -d #{deploy_to} || mkdir -m 755 #{deploy_to}"
+  run "test -d #{deploy_to}/etc || mkdir -m 755 #{deploy_to}/etc"
+  run "if [ -d #{site_path} ]; then mv #{site_path} #{site_path}-#{ts}.old ; fi"
+  run "if [ -h #{site_path} ]; then mv #{site_path} #{site_path}-#{ts}.old ; fi"
+  run "ln -s #{deploy_to}/current/public #{public_html}/#{application}"
+  put File.read(File.dirname(__FILE__) + "/database.locaweb.yml"), "#{deploy_to}/etc/database.yml"
+end
+
+desc "Prepare the production database before migration"
+task :before_cold do
+end
+
+namespace :deploy do
+  desc "Pede restart ao servidor Passenger"
+  task :restart, :roles => :app do
+    run "touch #{deploy_to}/current/tmp/restart.txt"
+  end
+end
+
+[:start, :stop].each do |t|
+    desc "A tarefa #{t} nao eh necessaria num ambiente com Passenger"
+    task t, :roles => :app do ; end
+end
+
+namespace :log do
+  desc "tail production log files" 
+  task :tail, :roles => :app do
+    run "tail -f #{shared_path}/log/production.log" do |channel, stream, data|
+      puts  # para uma linha extra 
+      puts "#{channel[:host]}: #{data}" 
+      break if stream == :err    
+    end
+  end
+end
+
+namespace :db do
+  desc "Faz o backup remoto do banco de dados MySQL e ja faz o download"
+  task :backup, :roles => :db do
+    run "if [ -f #{backup_rb} ]; then ruby #{backup_rb} #{deploy_to} ; fi"
+    get "#{deploy_to}/etc/dump.tar.gz", "dump.tar.gz"
+    run "rm #{deploy_to}/etc/dump.tar.gz"
+  end
+end

data/templates/locaweb_backup.rb

@@ -0,0 +1,19 @@
+#!/usr/bin/env ruby -wKU
+require 'yaml'
+
+deploy_to    = ARGV[0]
+cfg = YAML::load(File.open("#{deploy_to}/etc/database.yml"))
+exit! unless cfg['production'] # sai se nao encontrar o arquivo de banco
+
+cfg = cfg['production']
+cmd_mysql    = "mysqldump -u #{cfg['username']} -p#{cfg['password']} -h #{cfg['host']} #{cfg['database']} > #{deploy_to}/etc/dump.sql"
+cmd_compress = "cd #{deploy_to}/etc && tar cvfz dump.tar.gz dump.sql"
+cmd_rm       = "rm #{deploy_to}/etc/dump.sql"
+
+puts "executing: #{cmd_mysql.gsub(cfg['password'], 'xxxxxxxx')}"
+`#{cmd_mysql}`
+puts "executing: #{cmd_compress}"
+`#{cmd_compress}`
+puts "executing: #{cmd_rm}"
+`#{cmd_rm}`
+puts "db backup finished."

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification 
+name: akitaonrails-locarails
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Fabio Akita
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-08-19 00:00:00 -07:00
+default_executable: locarails
+dependencies: []
+
+description: A maneira mais simples para instalar aplicacoes Rails na hospedagem Linux da Locaweb.
+email: fabio.akita@locaweb.com.br
+executables: 
+- locarails
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- bin/locarails
+- bin/locarails.cmd
+- LICENSE
+- Manifest
+- README
+- lib/locarails.rb
+- lib/locarails/version.rb
+- templates/database.locaweb.yml
+- templates/deploy.rb
+- templates/locaweb_backup.rb
+- locarails.gemspec
+has_rdoc: true
+homepage: http://www.locaweb.com.br/rails
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: locarails
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Configuracao de Capistrano automatica para hospedagens Linux Locaweb.
+test_files: []
+