hostnet 0.1.1

data/tasks/deployment.rake

@@ -0,0 +1,34 @@
+desc 'Release the website and new gem version'
+task :deploy => [:check_version, :website, :release] do
+  puts "Remember to create SVN tag:"
+  puts "svn copy svn+ssh://#{rubyforge_username}@rubyforge.org/var/svn/#{PATH}/trunk " +
+    "svn+ssh://#{rubyforge_username}@rubyforge.org/var/svn/#{PATH}/tags/REL-#{VERS} "
+  puts "Suggested comment:"
+  puts "Tagging release #{CHANGES}"
+end
+
+desc 'Runs tasks website_generate and install_gem as a local deployment of the gem'
+task :local_deploy => [:website_generate, :install_gem]
+
+task :check_version do
+  unless ENV['VERSION']
+    puts 'Must pass a VERSION=x.y.z release version'
+    exit
+  end
+  unless ENV['VERSION'] == VERS
+    puts "Please update your version.rb to match the release version, currently #{VERS}"
+    exit
+  end
+end
+
+desc 'Install the package as a gem, without generating documentation(ri/rdoc)'
+task :install_gem_no_doc => [:clean, :package] do
+  sh "#{'sudo ' unless Hoe::WINDOZE }gem install pkg/*.gem --no-rdoc --no-ri"
+end
+
+namespace :manifest do
+  desc 'Recreate Manifest.txt to include ALL files'
+  task :refresh do
+    `rake check_manifest | patch -p0 > Manifest.txt`
+  end
+end

data/tasks/environment.rake

@@ -0,0 +1,7 @@
+task :ruby_env do
+  RUBY_APP = if RUBY_PLATFORM =~ /java/
+    "jruby"
+  else
+    "ruby"
+  end unless defined? RUBY_APP
+end

data/tasks/website.rake

@@ -0,0 +1,9 @@
+# stubs for the website generation
+# To install the website framework:
+#   script/generate website
+
+task :website_generate
+
+task :website_upload
+
+task :website => :publish_docs

data/test/test_generator_helper.rb

@@ -0,0 +1,29 @@
+begin
+  require File.dirname(__FILE__) + '/test_helper'
+rescue LoadError
+  require 'test/unit'
+end
+require 'fileutils'
+
+# Must set before requiring generator libs.
+TMP_ROOT = File.dirname(__FILE__) + "/tmp" unless defined?(TMP_ROOT)
+PROJECT_NAME = "myproject" unless defined?(PROJECT_NAME)
+app_root = File.join(TMP_ROOT, PROJECT_NAME)
+if defined?(APP_ROOT)
+  APP_ROOT.replace(app_root)
+else
+  APP_ROOT = app_root
+end
+if defined?(RAILS_ROOT)
+  RAILS_ROOT.replace(app_root)
+else
+  RAILS_ROOT = app_root
+end
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/helpers/generator_test_helper'

data/test/test_helper.rb

@@ -0,0 +1,2 @@
+require 'test/unit'
+require File.dirname(__FILE__) + '/../lib/hostnet'

data/test/test_hostnet.rb

@@ -0,0 +1,11 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class TestHostnet < Test::Unit::TestCase
+
+  def setup
+  end
+  
+  def test_truth
+    assert true
+  end
+end

data/test/test_hostnet_deploy_generator.rb

@@ -0,0 +1,45 @@
+require File.join(File.dirname(__FILE__), "test_generator_helper.rb")
+
+require 'rails_generator'
+
+class TestHostnetDeployGenerator < Test::Unit::TestCase
+  include RubiGen::GeneratorTestHelper
+
+  def setup
+    bare_setup
+  end
+
+  def teardown
+    bare_teardown
+  end
+
+  # Some generator-related assertions:
+  #   assert_generated_file(name, &block) # block passed the file contents
+  #   assert_directory_exists(name)
+  #   assert_generated_class(name, &block)
+  #   assert_generated_module(name, &block)
+  #   assert_generated_test_for(name, &block)
+  # The assert_generated_(class|module|test_for) &block is passed the body of the class/module within the file
+  #   assert_has_method(body, *methods) # check that the body has a list of methods (methods with parentheses not supported yet)
+  #
+  # Other helper methods are:
+  #   app_root_files - put this in teardown to show files generated by the test method (e.g. p app_root_files)
+  #   bare_setup - place this in setup method to create the APP_ROOT folder for each test
+  #   bare_teardown - place this in teardown method to destroy the TMP_ROOT or APP_ROOT folder after each test
+
+  def test_generator_without_options
+    name = "myapp"
+    run_generator('hostnet_deploy', [name], sources)
+    assert_generated_file("some_file")
+  end
+
+  private
+  def sources
+    [RubiGen::PathSource.new(:test, File.join(File.dirname(__FILE__),"..", generator_path))
+    ]
+  end
+
+  def generator_path
+    "rails_generators"
+  end
+end

data/test/test_hostnet_email_generator.rb

@@ -0,0 +1,45 @@
+require File.join(File.dirname(__FILE__), "test_generator_helper.rb")
+
+require 'rails_generator'
+
+class TestHostnetEmailGenerator < Test::Unit::TestCase
+  include RubiGen::GeneratorTestHelper
+
+  def setup
+    bare_setup
+  end
+
+  def teardown
+    bare_teardown
+  end
+
+  # Some generator-related assertions:
+  #   assert_generated_file(name, &block) # block passed the file contents
+  #   assert_directory_exists(name)
+  #   assert_generated_class(name, &block)
+  #   assert_generated_module(name, &block)
+  #   assert_generated_test_for(name, &block)
+  # The assert_generated_(class|module|test_for) &block is passed the body of the class/module within the file
+  #   assert_has_method(body, *methods) # check that the body has a list of methods (methods with parentheses not supported yet)
+  #
+  # Other helper methods are:
+  #   app_root_files - put this in teardown to show files generated by the test method (e.g. p app_root_files)
+  #   bare_setup - place this in setup method to create the APP_ROOT folder for each test
+  #   bare_teardown - place this in teardown method to destroy the TMP_ROOT or APP_ROOT folder after each test
+
+  def test_generator_without_options
+    name = "myapp"
+    run_generator('hostnet_email', [name], sources)
+    assert_generated_file("some_file")
+  end
+
+  private
+  def sources
+    [RubiGen::PathSource.new(:test, File.join(File.dirname(__FILE__),"..", generator_path))
+    ]
+  end
+
+  def generator_path
+    "rails_generators"
+  end
+end

data/tutoriais/001-meu-primeiro-deploy-de-aplicacao-rails-para-a-hostnet/tutorial.mkdn

@@ -0,0 +1,94 @@
+Meu primeiro deploy de aplicação Rails para a Hostnet
+=====================================================
+
+Este tutorial apresenta um passo-a-passo do seu primeiro deploy de uma aplicação Rails sem utilizar controle de versão. Assumimos aqui que você já possui uma conta Rails na Hostnet e uma aplicação que você desejar colocar no ar. Todos os comandos são executados no diretório raiz do seu projeto.
+
+1. Você deve possuir a gem da Hostnet instalada. Se você não possui, execute:
+
+        gem install mergulhao-hostnet --source=http://gems.github.com
+
+2. Configure a seção production do seu database.yml com os dados da sua conta Mysql. Exemplo:
+
+        production:
+          adapter: mysql
+          database: seu_database
+          username: usuario
+          password: senha
+          host: mysql.dominio.com
+
+3. Agora é necessário criar a receita de deploy através do utilitário da Hostnet. Isso significa executar:
+
+        hostnet seu_usuario seu_dominio.com
+
+4. É necessário preparar o terreno no servidor para o primeiro deploy. Basta executar:
+
+        cap deploy:setup
+
+5. Para finalizar:
+
+        cap deploy
+
+Se tudo deu certo a sua aplicação estará no ar.
+
+Realizando um novo deploy, após correção de um bug
+==================================================
+
+Supondo que você corrigiu um bug e deseja atualizar a versão no servidor basta executar novamente:
+
+    cap deploy
+
+E as novas modificações estarão no ar!
+
+Solução de problemas
+====================
+
+Versão do Rails
+---------------
+
+Se ocorrer durante o deploy um erro como esse:
+
+    *** [err :: dominio.com] Missing the Rails 2.1.0 gem. Please `gem install 
+    -v=2.1.0 rails`, update your RAILS_GEM_VERSION setting in 
+    config/environment.rb for the Rails version you do have installed, or 
+    comment out RAILS_GEM_VERSION to use the latest version installed.
+
+ou esse:
+
+    *** [err :: dominio.com] Missing the Rails 2.0.2 gem. Please `gem install 
+    -v=2.0.2 rails`, update your RAILS_GEM_VERSION setting in 
+    config/environment.rb for the Rails version you do have installed, or 
+    comment out RAILS_GEM_VERSION to use the latest version installed.
+
+Você deve editar o seu arquivo config/enviroment.rb e alterar a linha que diz:
+
+    RAILS_GEM_VERSION = '2.1.0' unless defined? RAILS_GEM_VERSION
+
+ou 
+
+    RAILS_GEM_VERSION = '2.0.2' unless defined? RAILS_GEM_VERSION
+
+Para:
+
+    RAILS_GEM_VERSION = '2.1.1' unless defined? RAILS_GEM_VERSION
+
+ou
+
+    RAILS_GEM_VERSION = '2.0.4' unless defined? RAILS_GEM_VERSION
+
+Respectivamente.
+
+Erro de acesso ao banco de dados
+--------------------------------
+
+Se ocorrer durante o deploy um erro como esse:
+
+      * executing "cd /home/usuario/www/releases/20080916192611 && rake db:migrate RAILS_ENV=production"
+        servers: ["dominio.com"]
+        [dominio.com] executing command
+    *** [err :: dominio.com] rake aborted!
+    *** [err :: dominio.com] Access denied for user: 'user@dominio.com' (Using password: YES)
+    *** [err :: dominio.com] 
+    *** [err :: dominio.com] (See full trace by running task with --trace)
+     ** [out :: dominio.com] (in /home/usuario/www/releases/20080916192611)
+
+Você deve verificar o arquivo config/database.yml e configurar com os dados da sua conta Mysql, como indicado no passo 2.

data/tutoriais/002-configurando-sua-aplicacao-para-enviar-e-mails/tutorial.mkdn

@@ -0,0 +1,14 @@
+Configurando sua aplicação para enviar e-mails
+==============================================
+
+1. Você deve possuir a gem da Hostnet instalada. Se você não possui, execute:
+
+        gem install mergulhao-hostnet --source=http://gems.github.com
+
+2. Crie no seu painel da Hostnet uma conta que será usada pelo ActionMailer do Rails para o envio de e-mails
+
+3. Na raiz do seu projeto execute:
+
+        hostnet --email mailer_username mailer_password seu_dominio.com
+
+Sua aplicação já está configurada para enviar e-mails utilizando smtp da Hostnet!

data/tutoriais/003-dicas-para-administracao-e-debug-de-sua-aplicacao-rails/tutorial.mkdn

@@ -0,0 +1,29 @@
+Dicas para administracao e debug de sua aplicacao rails
+=======================================================
+
+Todas as dicas supõe que você fez upload de sua aplicação utilizando o Capistrano configurado a partir da gem oficial da Hostnet.
+
+ * Logs
+
+    1. **Meu arquivo de log está ocupando muito espaço da minha hospedagem. O que fazer?**
+
+       Você deve zerar o seu arquivo de log regularmente para evitar que ele consuma todo o espaço da sua hospedagem. Basta executar o comando:
+
+        cap log:clean
+
+    2. **Como ver o log de produção da minha aplicação?**
+
+       Para facilitar essa tarefa de debug temos uma task do Capistrano. Basta executar:
+
+        cap log:tail
+
+ * Deploy
+
+    1. **Preciso fazer o restart da minha aplicação, o que fazer?**
+
+        cap deploy:restart
+
+    2. **Ao subir a minha aplicação, preciso rodar _cap deploy:migrations_ para executar as migrations?**
+
+       Não. A receita de deploy da Hostnet efetua essa tarefa automaticamente.
+

metadata

@@ -0,0 +1,133 @@
+--- !ruby/object:Gem::Specification 
+name: hostnet
+version: !ruby/object:Gem::Version 
+  version: 0.1.1
+platform: ruby
+authors: 
+- Sylvestre Mergulhao
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-10-07 00:00:00 -03:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rubigen
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.3.2
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: capistrano
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.5.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: archive-tar-minitar
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.5.2
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.7.0
+    version: 
+description: "gem oficial para suporte a deploy de aplica\xC3\xA7\xC3\xB5es"
+email: 
+- contato@mergulhao.info
+executables: 
+- hostnet
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- LICENSE
+- Manifest.txt
+- README.txt
+- Rakefile
+- TODO
+- bin/hostnet
+- config/hoe.rb
+- config/requirements.rb
+- hostnet.gemspec
+- lib/hostnet.rb
+- lib/hostnet/version.rb
+- rails_generators/hostnet_deploy/USAGE
+- rails_generators/hostnet_deploy/hostnet_deploy_generator.rb
+- rails_generators/hostnet_deploy/templates/Capfile
+- rails_generators/hostnet_deploy/templates/deploy.rb
+- rails_generators/hostnet_email/USAGE
+- rails_generators/hostnet_email/hostnet_email_generator.rb
+- rails_generators/hostnet_email/templates/mail.rb
+- script/console
+- script/destroy
+- script/generate
+- setup.rb
+- tasks/deployment.rake
+- tasks/environment.rake
+- tasks/website.rake
+- test/test_generator_helper.rb
+- test/test_helper.rb
+- test/test_hostnet.rb
+- test/test_hostnet_deploy_generator.rb
+- test/test_hostnet_email_generator.rb
+- tutoriais/001-meu-primeiro-deploy-de-aplicacao-rails-para-a-hostnet/tutorial.mkdn
+- tutoriais/002-configurando-sua-aplicacao-para-enviar-e-mails/tutorial.mkdn
+- tutoriais/003-dicas-para-administracao-e-debug-de-sua-aplicacao-rails/tutorial.mkdn
+has_rdoc: true
+homepage: http://github.com/mergulhao/hostnet
+post_install_message: ""
+rdoc_options: 
+- --main
+- README.txt
+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: hostnet
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: "gem oficial para suporte a deploy de aplica\xC3\xA7\xC3\xB5es"
+test_files: 
+- test/test_helper.rb
+- test/test_generator_helper.rb
+- test/test_hostnet.rb
+- test/test_hostnet_deploy_generator.rb
+- test/test_hostnet_email_generator.rb