rails_pwnerer 0.5.6 → 0.5.7

data/CHANGELOG

@@ -1,3 +1,5 @@
+v0.5.7. Better procedure for removing an instance.
+
 v0.5.6. Replaced mongrel_cluster startup script with our own. Now mongrels survive reboots.
 
 v0.5.5. Stronger database passwords, better mySQL configuration.

data/README

@@ -19,11 +19,13 @@ Read a couple more 20-page guides, and learn to push newer versions
 of your application. You'll become lazy, and take shortcuts, like having 
 production passwords in the repository, or insecure file permissions, or
 you'll forget to delete cached javascripts and stylesheets from public/.
-I won't even mention backups. 
+I won't even mention backups. Or scripts to recover your mongrels
+properly from power outages. Or a staging server of your application.
 
 Life with +rails_pwnerer+:
 
-1) Install ruby and rubygems (one command should be enough, but the rubygems in Ubuntu 8.04 doesn't work):
+1) Install a bootstrap version of ruby and rubygems
+(one command should be enough, but rubygems doesn't work in Ubuntu 8.04):
 
 sudo apt-get -y install rubygems
 
@@ -42,7 +44,7 @@ sudo rpwn install svn+ssh://your.repository.host/path/to/your_application
 
 5) Reboot, or start the services right away:
 sudo rpwn go live
-
+ 
 6) Maintain your application
 
 * Push the updates in the SVN repository:
@@ -66,5 +68,55 @@ sudo rpwn scaffold ddns full_host_name ddns_user ddns_password
 * Bring down all the applications (panic mode):
 sudo rpwn go down
 
-7) Uninstall your application
+* Uninstall your application
 sudo rpwn uninstall your_application
+
+
+In love with +rails_pwnerer+:
+
+Got your first Rails app up with +rails_pwnerer+? Want more than
+one site on the production box? Want multiple instances of the same
+app (e.g. running a staging server on the same box)?
+
+Instances let you do that. Creating an instance:
+sudo rpwn install svn+ssh://whatever instance_name
+
+All the commands that take an application name take an optional
+instance name. If no name is given, the default is used (usually
+your host name, see below for finding it out). Use * to mean
+"every instance of that application". For instance:
+sudo rpwn update your_application *
+
++rails_pwnerer+ has a configuration repository (a bunch of YAML
+files) that you can see with:
+sudo rpwn showconfig
+
+Installing an application creates a default configuration
+database for the application. You can override defaults by
+creating some files in your application directory (so the
+overrides will be version-controlled). In your Rails directory
+(on your devbox), use rpwndev as follows:
+
+* Set the DNS name that your app responds to:
+rpwndev set dns-name your.dns.name
+
+* Tweak the number of mongrels for an instance:
+rpwndev setnum mongrels 8 your_instance
+
+* Delete the previous tweak and apply it to all instances:
+rpwndev del mongrels your_instance;
+rpwndev setnum mongrels
+
+The overrides are YAML files in +config/rails_pwnage+, so you
+can view and edit them by hand. rpwndev is just a handy tool,
+because YAML files are easy to tweak, but hard to code from
+scratch without learning the format :)
+
+Once the overrides are pushed to your SVN repository, updating
+your app will apply the changes to the configuration repository.
+Use +rpwn showconfig+ on the server to see all the variables
+that you can tweak.
+
+Before I forget: don't dots (.) in instance names. Think
+underscores (_) instead. You can use dots in application names,
+though.

data/lib/pwnage/app/cluster_config.rb

@@ -11,8 +11,13 @@ class RailsPwnage::App::ClusterConfig
     pwnerer_uid = uid_for_username(pwnerer_user)
     pwnerer_group = group_for_username(pwnerer_user)
     
+    writable_dirs = %w(log tmp public)
+    if app_config[:writable_dirs]
+      writable_dirs += app_config[:writable_dirs].split ','
+    end
+    
     Dir.chdir app_config[:app_path] do
-      %w(log tmp public).each do |writable_dir|
+      writable_dirs.each do |writable_dir|
         FileUtils.chown_R(pwnerer_uid, pwnerer_group, writable_dir)
       end
     end
@@ -144,6 +149,7 @@ class RailsPwnage::App::ClusterConfig
   end
   
   def remove(app_name, instance_name)
+    stop_mongrels app_name, instance_name
     remove_mongrels app_name, instance_name
     manage_ports app_name, instance_name, :free
   end

data/lib/pwnage/app/config.rb

@@ -33,6 +33,8 @@ class RailsPwnage::App::Config
     app_db[:dns_name] = ''
     # the maximum request size (megabytes) to be accepted by an application
     app_db[:max_request_mb] = 48
+    # comma-separated directories that should be writable by the application user
+    app_db[:writable_dirs] = ''
     
     RailsPwnage::Config.flush_db app_db    
     return app_path

data/lib/pwnage/app/nginx_config.rb

@@ -71,6 +71,7 @@ NGINX_CONFIG
   
   def remove(app_name, instance_name)
     remove_nginx_config app_name, instance_name
+    control_boot_script('nginx', :reload)
   end
   
   def control_all(action)

data/lib/pwnage/executor.rb

@@ -80,7 +80,7 @@ class RailsPwnage::Executor
       instance_name = args[2] || '.'
       RailsPwnage::App.manage app_name, instance_name, :db_console
      
-    when 'showconfig', 'configshow', 'show_config', 'config_show'
+    when 'showconfig', 'configshow', 'show_config', 'config_show', 'showconf'
       if args.length < 2
         # dump all databases
         RailsPwnage::Config.databases.each do |db|

data/rails_pwnerer.gemspec

@@ -1,11 +1,11 @@
 
-# Gem::Specification for Rails_pwnerer-0.5.6
+# Gem::Specification for Rails_pwnerer-0.5.7
 # Originally generated by Echoe
 
 --- !ruby/object:Gem::Specification 
 name: rails_pwnerer
 version: !ruby/object:Gem::Version 
-  version: 0.5.6
+  version: 0.5.7
 platform: ruby
 authors: 
 - Victor Costan

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: rails_pwnerer
 version: !ruby/object:Gem::Version 
-  version: 0.5.6
+  version: 0.5.7
 platform: ruby
 authors: 
 - Victor Costan