magic_recipes 0.0.19 → 0.0.20

data/lib/generators/magic_recipes/templates/deploy.rb.tt

@@ -54,9 +54,20 @@ set :rails_env,     "production"                            #=> Rails environmen
 # => # set :git_enable_submodules, 1                            #=> Git submodules
 
 
+# PostgreSQL
+# => set :postgresql_host,      "localhost"                     #=> postgres host
+# => set :postgresql_user,      "#{ app_name }"                 #=> postgres user
+# => set :postgresql_password,  "password"                      #=> postgres user password, if not set prompt will follow
+# => set :postgresql_database,  "#{ app_name }_#{ rails_env }"  #=> postgres db name
+# => set :postgresql_pool,      5                               #=> postgres pool
+
+
 # SqLite3 ... this is more for test & try pupose (save .sqlite and copy to current after deploy)
 # => set :sqlite_path,     "#{ deploy_to }/shared/db/"          #=> shared path for db
 # => set :sqlite_db,       "#{ rails_env }"                     #=> sqlite name
+# SqLite3-callbacks
+# => before  "deploy", "sqlite:save_db"
+# => after   "deploy", "sqlite:copy_db"
 
 
 # if you want to clean up old releases on each deploy uncomment this:
@@ -66,15 +77,14 @@ set :rails_env,     "production"                            #=> Rails environmen
 
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 #   Usage:
-#   magic_recipes :rvm, :nginx, :private_pub, :thin
+#   magic_recipes :nginx, :private_pub, :rvm, :thin
 #   available:
-#   :rvm, :rbenv, :nginx, :private_pub, :thin, :passenger, :unicorn, :assets, :gems, :sqlite, :db
+#   :assets, :db, :gems, :nginx, :passenger, :postgresql, :private_pub, :rbenv, :rvm, :sqlite, :thin, :unicorn
+#   works great:
+#   :assets, :db, :nginx, :postgresql, :private_pub, :rvm, :sqlite, :thin
 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
 
-magic_recipes :rvm, :nginx, :private_pub, :thin
+magic_recipes :assets, :nginx, :rvm, :thin
 
 
-# SqLite3-callbacks ... this is more for test & try pupose (save .sqlite and copy to current after deploy)
-# => before  "deploy", "sqlite:save_db"
-# => after   "deploy", "sqlite:copy_db"
 

data/lib/magic_recipes/assets.rb

@@ -1,5 +1,23 @@
 # encoding: utf-8
 module MagicRecipes
+  # = Assets - Deploy-Recipes
+  # 
+  # changed asset deployment .. include chmod 777 for public folder (my server need this)
+  # 
+  # [Tasks:]
+  #   :symlink          # => set up a symlink to the shared directory
+  # 
+  #   :precompile       # => Run the asset precompilation rake task
+  # 
+  #   :chmod            # => make the public folder public for all (777)
+  # 
+  #   :clean            # => Run the asset clean rake task
+  # 
+  # [Callbacks:]
+  #   before 'deploy:finalize_update', 'deploy:assets:symlink'
+  # 
+  #   after 'deploy:update_code', 'deploy:assets:precompile'
+  # 
   module Assets
     def self.load_into(configuration)
       configuration.load do

data/lib/magic_recipes/db.rb

@@ -1,5 +1,21 @@
 # encoding: utf-8
 module MagicRecipes
+  # = Db - Deploy-Recipes
+  # 
+  # Some recipes to work with databases, especialy when you have an server, where you can't delete or create db's.
+  # 
+  # [Tasks:]
+  #   :seed           # => seed the database
+  # 
+  #   :migrate        # => migrate the database
+  # 
+  #   :delete_tables  # => delete all Tables of the Database!
+  # 
+  #   :save_reset     # => DB-Reset for user without dbcreate permission (deletes all tables than migrates again)
+  # 
+  # [Callbacks:]
+  #   - - -
+  # 
   module Db
     def self.load_into(configuration)
       configuration.load do

data/lib/magic_recipes/gems.rb

@@ -1,5 +1,9 @@
 # encoding: utf-8
 module MagicRecipes
+  # = Gems - Deploy-Recipes
+  # 
+  # == Useless .. take the capistrano task
+  # 
   module Gems
     def self.load_into(configuration)
       configuration.load do

data/lib/magic_recipes/git.rb

@@ -1,6 +1,10 @@
 # encoding: utf-8
 module MagicRecipes
-  module Rvm
+  # = Git - Deploy-Recipes
+  # 
+  # == NEED FIX .. doesnt work now !!!
+  # 
+  module Git
     def self.load_into(configuration)
       configuration.load do
         

data/lib/magic_recipes/nginx.rb

@@ -1,18 +1,26 @@
 # encoding: utf-8
 module MagicRecipes
-  # Nginx - Deploy-Recipes
+  # = Nginx - Deploy-Recipes
   # 
-  # Tasks:
-  # :install    # => Install latest stable release of nginx
-  # :setup      # => Setup nginx configuration for this application
-  # :start      # => start nginx-server
-  # :stop       # => stop nginx-server
-  # :restart    # => setup, stop, start nginx-server
+  # Deploy Recipes for nginx.
   # 
-  # Callbacks:
-  # after "deploy:install", "nginx:install"
-  # after "deploy:setup", "nginx:setup"
-  # after "deploy", "nginx:restart"
+  # [Tasks:]
+  #   :install    # => Install latest stable release of nginx
+  # 
+  #   :setup      # => Setup nginx configuration for this application
+  # 
+  #   :start      # => start nginx-server
+  # 
+  #   :stop       # => stop nginx-server
+  # 
+  #   :restart    # => setup, stop, start nginx-server
+  # 
+  # [Callbacks:]
+  #   after "deploy:install", "nginx:install"
+  # 
+  #   after "deploy:setup", "nginx:setup"
+  # 
+  #   after "deploy", "nginx:restart"
   # 
   module Nginx
     def self.load_into(configuration)

data/lib/magic_recipes/nodejs.rb

@@ -1,5 +1,15 @@
 # encoding: utf-8
 module MagicRecipes
+  # = RVM - Deploy-Recipes
+  # 
+  # == unused for now
+  # 
+  # [Tasks:]
+  #   
+  # 
+  # [Callbacks:]
+  #   
+  # 
   module Nodejs
     def self.load_into(configuration)
       configuration.load do

data/lib/magic_recipes/passenger.rb

@@ -1,15 +1,17 @@
 # encoding: utf-8
 module MagicRecipes
+  # = Passenger - Deploy
+  # 
+  # Simple recipe to restart passenger
+  # 
+  # [Tasks:]
+  #   task :restart   # => Restart Phusion-Passenger
+  # 
+  # [Callbacks:]
+  #   after "deploy:restart", "passenger:restart"
+  # 
   module Passenger
     
-    # Passenger - Deploy
-    # 
-    # Tasks:
-    # task :restart   # => Restart Phusion-Passenger
-    # 
-    # Callbacks:
-    # after "deploy:restart", "passenger:restart"
-    # 
     def self.load_into(configuration)
       configuration.load do
         

data/lib/magic_recipes/postgresql.rb

@@ -1,6 +1,32 @@
 # encoding: utf-8
 module MagicRecipes
-  module Assets
+  # = Postgresql - Deploy-Recipes
+  # 
+  # Some simple recipes for PostgreSQL
+  # 
+  # [Tasks:]
+  #   :install                      # => Install the latest stable release of PostgreSQL.
+  # 
+  #   :create_database              # => Create a database for this application.
+  # 
+  #   :setup                        # => Generate the database.yml configuration file.
+  # 
+  #   :symlink                      # => Symlink the database.yml file into latest release
+  # 
+  #   :kill_postgres_connections    # => kill pgsql users so database can be dropped
+  # 
+  #   :drop_public_shema            # => drop public shema so db is empty and not dropped
+  # 
+  # [Callbacks:]
+  #   after "deploy:install", "postgresql:install"
+  # 
+  #   after "deploy:setup", "postgresql:create_database"
+  # 
+  #   after "deploy:setup", "postgresql:setup"
+  # 
+  #   after "deploy:finalize_update", "postgresql:symlink"
+  # 
+  module Postgresql
     def self.load_into(configuration)
       configuration.load do
         
@@ -9,7 +35,8 @@ module MagicRecipes
         set_default(:postgresql_host, "localhost")
         set_default(:postgresql_user) { application }
         set_default(:postgresql_password) { Capistrano::CLI.password_prompt "PostgreSQL Password: " }
-        set_default(:postgresql_database) { "#{application}_production" }
+        set_default(:postgresql_database) { "#{application}_#{rails_env}" }
+        set_default(:postgresql_pool, 5)
         
         namespace :postgresql do
           desc "Install the latest stable release of PostgreSQL."
@@ -22,7 +49,8 @@ module MagicRecipes
           
           desc "Create a database for this application."
           task :create_database, roles: :db, only: {primary: true} do
-            run %Q{#{sudo} -u postgres psql -c "create user #{postgresql_user} with password '#{postgresql_password}';"}
+            # with --createdb for rake commands
+            run %Q{#{sudo} -u postgres psql -c "create user --createdb #{postgresql_user} with password '#{postgresql_password}';"}
             run %Q{#{sudo} -u postgres psql -c "create database #{postgresql_database} owner #{postgresql_user};"}
           end
           after "deploy:setup", "postgresql:create_database"
@@ -30,15 +58,30 @@ module MagicRecipes
           desc "Generate the database.yml configuration file."
           task :setup, roles: :app do
             run "mkdir -p #{shared_path}/config"
-            template "postgresql.yml.erb", "#{shared_path}/config/database.yml"
+            template "postgresql.yml.erb", "#{shared_path}/config/postgres_#{rails_env}.yml"
           end
           after "deploy:setup", "postgresql:setup"
           
           desc "Symlink the database.yml file into latest release"
           task :symlink, roles: :app do
-            run "ln -nfs #{shared_path}/config/database.yml #{release_path}/config/database.yml"
+            run "ln -nfs #{shared_path}/config/postgres_#{rails_env}.yml #{release_path}/config/database.yml"
           end
           after "deploy:finalize_update", "postgresql:symlink"
+          
+          # http://stackoverflow.com/a/12939218/1470996
+          desc 'kill pgsql users so database can be dropped'
+          task :kill_postgres_connections do
+            # run "echo 'SELECT pg_terminate_backend(procpid) FROM pg_stat_activity WHERE datname=\'#{postgresql_database}\';' | psql -U postgres"
+            run %Q{#{sudo} -u postgres psql -c "SELECT pg_terminate_backend(procpid) FROM pg_stat_activity WHERE datname='#{postgresql_database}';"}
+          end
+          
+          
+          
+          desc 'drop public shema so db is empty and not dropped'
+          task :drop_public_shema do
+            run %Q{#{sudo} -u postgres psql -c "drop schema public cascade on #{postgresql_database};';"}
+          end
+          
         end
         
         # eof

data/lib/magic_recipes/private_pub.rb

@@ -1,5 +1,33 @@
 # encoding: utf-8
 module MagicRecipes
+  # = PrivatePub - Deploy-Recipes
+  # 
+  # Easy deployment of private_pub .. which can be frustrating on nginx because of the tcp server
+  # 
+  # [Tasks:]
+  #   :reconf       # => Generate the thin yml configuration file.
+  # 
+  #   :setup        # => Generate the nginx configuration file.
+  # 
+  #   :yml_file     # => Generate the private_pup yml configuration file.
+  # 
+  #   :start        # => Start the private_pup server
+  # 
+  #   :stop         # => Start the private_pup server
+  # 
+  #   :restart      # => Restart the private_pup server
+  # 
+  # [Callbacks:]
+  #   before "thin:start", "private_pub:yml_file"
+  # 
+  #   after "thin:start", "private_pub:start"
+  # 
+  #   after "thin:stop", "private_pub:stop"
+  # 
+  #   after "nginx:setup", "private_pub:setup"
+  # 
+  #   after "thin:reconf", "private_pub:reconf"
+  # 
   module PrivatePub
     def self.load_into(configuration)
       configuration.load do

data/lib/magic_recipes/rbenv.rb

@@ -1,5 +1,15 @@
 # encoding: utf-8
 module MagicRecipes
+  # = RVM - Deploy-Recipes
+  # 
+  # == unused for now
+  # 
+  # [Tasks:]
+  #   
+  # 
+  # [Callbacks:]
+  #   
+  # 
   module Rbenv
     def self.load_into(configuration)
       configuration.load do

data/lib/magic_recipes/rvm.rb

@@ -1,5 +1,15 @@
 # encoding: utf-8
 module MagicRecipes
+  # = RVM - Deploy-Recipes
+  # 
+  # little helper to work on crazy rvm mashine ... mine dont accept the standard rvm handling
+  # 
+  # [Tasks:]
+  #   - - -
+  # 
+  # [Callbacks:]
+  #   - - -
+  # 
   module Rvm
     def self.load_into(configuration)
       configuration.load do

data/lib/magic_recipes/sqlite.rb

@@ -1,5 +1,21 @@
 # encoding: utf-8
 module MagicRecipes
+  # = RVM - Deploy-Recipes
+  # 
+  # This is more for test & try pupose. Save .sqlite and copy to current after deploy.
+  # 
+  # [Tasks:]
+  #   :setup_db       # => Create shared folder.
+  # 
+  #   :save_db        # => Copy current DB to shared folder.
+  # 
+  #   :copy_db        # => Copy saved DB from shared folder to current_release
+  # 
+  # [Callbacks:]
+  #   after "deploy:setup", "sqlite:setup_db"
+  # 
+  #   more in deploy.rb ! .. becasuse ist just in case you need it .. and only works after second deploy !
+  # 
   module Sqlite
     def self.load_into(configuration)
       configuration.load do

data/lib/magic_recipes/templates/postgresql.yml.erb

@@ -1,8 +1,8 @@
-production:
+<%= rails_env %>:
   adapter: postgresql
   encoding: unicode
   database: <%= postgresql_database %>
-  pool: 5
+  pool: <%= postgresql_pool %>
   username: <%= postgresql_user %>
   password: <%= postgresql_password %>
   host: <%= postgresql_host %>

data/lib/magic_recipes/thin.rb

@@ -1,5 +1,23 @@
 # encoding: utf-8
 module MagicRecipes
+  # = Thin - Deploy-Recipes
+  # 
+  # Simple recipe to work with thin, and app configurstion / registration.
+  # 
+  # [Tasks:]
+  #   :reconf       # => Create or Update the thin yml configuration files
+  # 
+  #   :start        # => Start the private_pup server
+  # 
+  #   :stop         # => Start the private_pup server
+  # 
+  #   :restart      # => Restart the private_pup server
+  # 
+  # [Callbacks:]
+  #   before "nginx:start", "thin:start"
+  # 
+  #   before "nginx:stop", "thin:stop"
+  # 
   module Thin
     def self.load_into(configuration)
       configuration.load do

data/lib/magic_recipes/unicorn.rb

@@ -1,5 +1,15 @@
 # encoding: utf-8
 module MagicRecipes
+  # = RVM - Deploy-Recipes
+  # 
+  # == unused for now
+  # 
+  # [Tasks:]
+  #   
+  # 
+  # [Callbacks:]
+  #   
+  # 
   module Unicorn
     def self.load_into(configuration)
       configuration.load do

data/lib/magic_recipes.rb

@@ -1,6 +1,45 @@
 require 'capistrano'
 
 module MagicRecipes
+  # = MagicRecipes
+  # 
+  # Some capistrano-recipes for our deployment .. still in development!
+  # 
+  # [Methods:]
+  #   template(from, to)                  # => write erb template to path
+  # 
+  #   set_default(name, *args, &block)    # => set default value
+  # 
+  #   random_string(length=42)            # => generate a random string
+  # 
+  #   use_recipe(recipe_name)             # => load one recipe
+  # 
+  #   magic_recipes(*recipes)             # => load several recipes
+  # 
+  # [Usage:]
+  #   add magic_recipes to your Gemfile
+  #     gem 'magic_recipes', :require => nil
+  # 
+  #   install the gem
+  #     bundle install
+  # 
+  #   run the generator
+  #     rails g magic_recipes:capify
+  # 
+  #   edit 'config/deploy'
+  # 
+  #   enjoy some magic!
+  # 
+  # [config/deploy.rb:]
+  # 
+  #   uncomment and edit all needed vars
+  # 
+  #   add all recipes
+  #     magic_recipes :assets, :db, :nginx, :postgresql, :private_pub, :rvm, :sqlite, :thin
+  # 
+  #   add your recipes
+  #     magic_recipes :assets, :nginx, :rvm, :thin
+  # 
   def self.load_into(configuration)
     configuration.load do
       

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: magic_recipes
 version: !ruby/object:Gem::Version
-  version: 0.0.19
+  version: 0.0.20
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-27 00:00:00.000000000 Z
+date: 2012-11-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails