ninja-deploy 0.1.0 → 1.0.0

data/README.rdoc

@@ -2,6 +2,135 @@
 
 Common shared deployment recipes.
 
+
+== Assumptions
+
+* The user has local tasks to set up variables specfic to the deploying environment (ie. staging, production, etc.).
+
+
+== Database Recipes
+
+Require the database recipes in your deploy.rb file:
+
+  require 'ninja_deploy/recipes/database'
+
+=== dump
+
+Dependencies:
+
+* The user acting during the deployment must have permissions to dump the MySQL database.
+
+==== To Local File
+
+Dumps the contents of a remote database to a MySQL dump file, scp's the file to /tmp directory.
+
+  cap production db:dump:to_local_file
+
+==== To Local Database
+
+Dumps the contents of a remote database to a MySQL dump file, scp's the file to /tmp directory, loads the locally configured
+development database and deletes the local and remote dump files.
+
+  cap production db:dump:to_local_db
+
+Dependencies:
+
+* The configured local development user must have permission to load the database form a MySQL dump file.
+
+
+== Log Recipes
+
+Require the database recipes in your deploy.rb file:
+
+  require 'ninja_deploy/recipes/log'
+
+=== tail
+
+Tails the remote server's log for the current environment.
+
+  cap production log:tail
+
+
+== Passenger Recipes
+
+Require the database recipes in your deploy.rb file:
+
+  require 'ninja_deploy/recipes/passenger'
+
+=== restart
+
+Restarts Passenger.
+
+As Callback:
+
+  after "deploy:update_code", "passenger:restart"
+
+From Command-Line:
+
+  cap production passenger:restart
+
+
+== Sass Recipes
+
+Require the database recipes in your deploy.rb file:
+
+  require 'ninja_deploy/recipes/sass'
+
+=== update
+
+Generates the CSS files from the Sass files.
+
+As Callback:
+
+  before "deploy:restart", "sass:update"
+
+From Command-Line:
+
+  cap production sass:update
+
+
+== Version Recipes
+
+Require the database recipes in your deploy.rb file:
+
+  require 'ninja_deploy/recipes/version'
+
+=== write
+
+Writes a public/VERSION file to the remote server.
+
+As Callback:
+
+  after "deploy:update_code", "version:write"
+
+Dependencies:
+
+* branch_tag_or_sha_to_deploy variable
+
+
+== Whenever Recipes
+
+Require the database recipes in your deploy.rb file:
+
+  require 'ninja_deploy/recipes/whenever'
+
+=== update_crontab
+
+Updates the crontab file using whenever.
+
+As Callback:
+
+  after "deploy:update_code", "whenever:update_crontab"
+
+From Command-Line:
+
+  cap production whenever:update_crontab
+
+Dependencies:
+
+* application variable
+
+
 == Note on Patches/Pull Requests
 
 * Fork the project.

data/VERSION

@@ -1 +1 @@
-0.1.0
+1.0.0

data/lib/ninja_deploy/recipes/log.rb

@@ -0,0 +1,7 @@
+Capistrano::Configuration.instance( :must_exist ).load do
+  namespace :log do
+    task :tail, :roles => :app do
+      invoke_command "tail -f #{shared_path}/log/#{rails_env}.log"
+    end
+  end
+end

data/lib/ninja_deploy/recipes/passenger.rb

@@ -0,0 +1,8 @@
+Capistrano::Configuration.instance(:must_exist).load do
+  namespace :passenger do
+    desc "Restart the passenger module to reload the application after deploying."
+    task :restart, :roles => :app, :except => {:no_release => true} do
+      sudo "touch #{current_path}/tmp/restart.txt"
+    end
+  end
+end

data/lib/ninja_deploy/recipes/sass.rb

@@ -0,0 +1,8 @@
+Capistrano::Configuration.instance( :must_exist ).load do
+  namespace :sass do
+    desc 'Updates the stylesheets generated by Sass'
+    task :update, :roles => :app do
+      invoke_command "cd #{latest_release}; rake app:sass:update RAILS_ENV=#{rails_env}"
+    end
+  end
+end

data/lib/ninja_deploy/recipes/version.rb

@@ -0,0 +1,8 @@
+Capistrano::Configuration.instance( :must_exist ).load do
+  namespace :version do
+    desc 'Writes a VERSION file to the public directory of the application'
+    task :write do
+      run "echo #{branch_tag_or_sha_to_deploy} > #{release_path}/public/VERSION"
+    end
+  end
+end

data/lib/ninja_deploy/recipes/whenever.rb

@@ -0,0 +1,8 @@
+Capistrano::Configuration.instance( :must_exist ).load do
+  namespace :whenever do
+    desc "Update the crontab file using whenever"
+    task :update_crontab, :roles => :db do
+      run "cd #{release_path} && bundle exec whenever --set environment=#{rails_env} --update-crontab #{application}"
+    end
+  end
+end

data/ninja-deploy.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{ninja-deploy}
-  s.version = "0.1.0"
+  s.version = "1.0.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Ninja Loss"]
@@ -26,6 +26,11 @@ Gem::Specification.new do |s|
      "VERSION",
      "lib/ninja_deploy.rb",
      "lib/ninja_deploy/recipes/database.rb",
+     "lib/ninja_deploy/recipes/log.rb",
+     "lib/ninja_deploy/recipes/passenger.rb",
+     "lib/ninja_deploy/recipes/sass.rb",
+     "lib/ninja_deploy/recipes/version.rb",
+     "lib/ninja_deploy/recipes/whenever.rb",
      "ninja-deploy.gemspec",
      "spec/ninja-deploy_spec.rb",
      "spec/spec.opts",

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: ninja-deploy
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 23
   prerelease: false
   segments: 
-  - 0
   - 1
   - 0
-  version: 0.1.0
+  - 0
+  version: 1.0.0
 platform: ruby
 authors: 
 - Ninja Loss
@@ -67,6 +67,11 @@ files:
 - VERSION
 - lib/ninja_deploy.rb
 - lib/ninja_deploy/recipes/database.rb
+- lib/ninja_deploy/recipes/log.rb
+- lib/ninja_deploy/recipes/passenger.rb
+- lib/ninja_deploy/recipes/sass.rb
+- lib/ninja_deploy/recipes/version.rb
+- lib/ninja_deploy/recipes/whenever.rb
 - ninja-deploy.gemspec
 - spec/ninja-deploy_spec.rb
 - spec/spec.opts