caphub 0.0.1

data/README.md

@@ -0,0 +1,98 @@
+## Caphub
+
+Generate centralized capistrano skeleton for multiple deployment.
+
+## Caphub Concept
+
+Main idea of caphub is separate deployment and application code. So instead of `capify` your each project create **one** caphub repository and put **all** configurations/recipes there.
+
+Benefits:
+
+* no deployment/application code mix.
+* all deployment located in place.
+* ability to deploy multiple projects
+* deployment is not limited application deployment - deploy your system configurations too! (nginx/haproxy/etc configs)
+* easy to share configurations/recipes among multiple deployment.
+* uptodate synchronizing with remote repository (with capistrano-uptodate).
+* generate layout with caphub or write it yourself from scratch with your own recipes
+
+## Description
+
+Caphub is simple generation tool that follows *caphub concept*.
+
+Caphub generates similar layout that does usual `capify` command.
+Core of caphub skeleton is [capistrano-multiconfig](https://github.com/railsware/capistrano-multiconfig) gem that allows to recursively build multiple configurations. 
+
+Another included gems are optional but might be useful:
+
+* [capistrano_colors](https://github.com/stjernstrom/capistrano_colors)
+* [capistrano-uptodate](https://github.com/railsware/capistrano-uptodate/README.md)
+* [capistrano-patch](https://github.com/railsware/capistrano-patch/README.md)
+* [capistrano-calendar](https://github.com/railsware/capistrano-calendar/README.md)
+
+## Installation
+
+    $ gem install caphub
+
+## Usage
+
+Generate caphub layout:
+
+    $ cuphub my-deploy
+
+    Creating directory my-deploy
+    Creating capistrano skeleton in my-deploy
+    Initializating git repository in my-deploy
+
+Layout example:
+
+    $ tree --dirsfirst my-deploy
+    my-deploy
+    ├── config
+    │   ├── deploy
+    │   └── deploy.rb
+    ├── recipes
+    ├── Capfile
+    ├── Gemfile
+    └── Gemfile.lock
+
+Review gems into `Gemfile` and initialize gems:
+
+    $ bundle install
+
+Push repository remote server:
+
+    git remote add origin your/remote/git/repo/url
+    git push -u origin master
+
+### Configurations
+
+Put own configuration in `config/deploy`. 
+
+E.g create `config/deploy/blog/production.rb` and it will be automatically available:
+
+    $ bundle exec cap -T
+    cap blog:production      # Load blog:production configuration
+
+Use any recipe with configuration task (similar to multistage extension). E.g:
+
+    $ bundle exec cap blog:production deploy:setup
+
+### Recipes
+
+Add gems that contains capistrano recipes to `Gemfile`.
+
+Configure and require recipes into `Capfile`.
+
+Put own recipes to `recipes` directory.
+
+## References
+
+* [capistrano](https://github.com/capistrano/capistrano)
+* [capistrano-ext](https://github.com/capistrano/capistrano-ext)
+* [capistrano_colors](https://github.com/stjernstrom/capistrano_colors)
+* [capistrano-multiconfig](https://github.com/railsware/capistrano-multiconfig)
+* [capistrano-uptodate](https://github.com/railsware/capistrano-uptodate/README.md)
+* [capistrano-patch](https://github.com/railsware/capistrano-patch/README.md)
+* [capistrano-calendar](https://github.com/railsware/capistrano-calendar/README.md)
+

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/caphub

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+require 'caphub'
+Caphub::Runner.run

data/caphup.gemspec

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "caphub/version"
+
+Gem::Specification.new do |s|
+  s.name        = "caphub"
+  s.version     = Caphub::VERSION
+  s.authors     = ["Andriy Yanko"]
+  s.email       = ["andriy.yanko@gmail.com"]
+  s.homepage    = "https://github.com/railsware/caphub"
+  s.summary     = %q{Generate centralized capistrano skeleton for multiple deployment}
+  s.description = %q{Generate centralized capistrano skeleton for multiple deployment}
+
+  s.rubyforge_project = "caphub"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/caphub/runner.rb

@@ -0,0 +1,59 @@
+require 'optparse'
+require 'fileutils'
+
+module Caphub
+  class Runner
+    class << self
+      def run
+        runner = new(ARGV)
+        runner.parse_options!
+        runner.run!
+      end
+    end
+
+    def initialize(args)
+      @args = args.dup
+      @options = {}
+    end
+
+    attr_reader :options
+
+    def parse_options!
+      OptionParser.new do |opts|
+        opts.banner = "Usage: #{File.basename($0)} [path]"
+        opts.on_tail("-h", "--help", "Show this message") { puts opts; exit }
+        opts.on_tail('-v', '--version', "Show version")   { puts Caphub::VERSION; exit }
+
+        begin
+          opts.parse!(ARGV)
+        rescue OptionParser::ParseError => e
+          warn e.message
+          puts opts
+          exit 1
+        end
+      end
+
+      abort "Please specify the directory for capistrano hub" if @args.empty?
+      abort "'#{@args.first}' exists." if File.exists?(@args.first)
+
+      @options[:target] = @args.first
+    end
+
+    def skeleton_dir
+      File.expand_path('../../../skeleton', __FILE__)
+    end
+
+    def run!
+      target = options[:target]
+
+      puts "Creating directory #{target}"
+      FileUtils.mkdir(target)
+
+      puts "Creating capistrano skeleton in #{target}"
+      FileUtils.cp_r("#{skeleton_dir}/.", target)
+
+      puts "Initializating git repository in #{target}"
+      Dir.chdir(target) { `git init`;  `git add .` }
+    end
+  end
+end

data/lib/caphub/version.rb

@@ -0,0 +1,3 @@
+module Caphub
+  VERSION = "0.0.1"
+end

data/lib/caphub.rb

@@ -0,0 +1,2 @@
+require "caphub/version"
+require "caphub/runner"

data/skeleton/.rvmrc

@@ -0,0 +1 @@
+rvm ruby-1.8.7

data/skeleton/Capfile

@@ -0,0 +1,33 @@
+#
+# Load deploy capistrano recipe
+#
+load 'deploy'
+
+#
+# Configure libraries/recipes from Gemfile
+#
+
+# https://github.com/stjernstrom/capistrano_colors/README.rdoc
+require 'capistrano_colors'
+
+# https://github.com/railsware/capistrano-multiconfig/README.md
+require 'capistrano/multiconfig'
+
+# https://github.com/railsware/capistrano-uptodate/README.md
+require 'capistrano/uptodate'
+
+# https://github.com/railsware/capistrano-patch/README.md
+require 'capistrano/patch'
+
+# https://github.com/railsware/capistrano-calendar/README.md
+require 'capistrano/calendar'
+
+#
+# Load all custom recipes
+#
+Dir['recipes/**/*.rb'].each { |recipe| load(recipe) }
+
+# Load main configuration
+load 'config/deploy'
+
+# vim syntax=ruby

data/skeleton/Gemfile

@@ -0,0 +1,10 @@
+source "http://rubygems.org"
+
+gem "capistrano"
+
+gem "capistrano_colors"
+
+gem "capistrano-multiconfig"
+gem "capistrano-uptodate"
+gem "capistrano-patch"
+gem "capistrano-calendar"

data/skeleton/config/deploy.rb

@@ -0,0 +1,39 @@
+#
+# Put here shared configuration shared among all children
+#
+# Read more about configurations:
+# https://github.com/railsware/capistrano-multiconfig/README.md
+
+# Configuration example for layout like:
+# config/deploy/{NAMESPACE}/.../#{PROJECT_NAME}/{STAGE_NAME}.rb
+
+set :scm, :git
+
+set :git_shallow_clone, 1
+
+set :deploy_via, :export
+
+set :branch, lambda { Capistrano::CLI.ui.ask "SCM branch: " }
+
+set(:application) { config_name.split(':').reverse[1] }
+
+set(:stage) { config_name.split(':').last }
+
+set(:rails_env) { stage }
+
+set(:rake) { use_bundle ? "bundle exec rake" : "rake" }
+
+set(:repository) { "git://scm.mycompany.com/#{application}.git" }
+
+set(:deploy_to) { "/var/www/#{application}" }
+
+set :calendar_username, 'vasya.pupkin@gmail.com'
+
+set :calendar_password, 'qwery123456'
+
+set(:calendar_name) { "mycompany-#{stage}" }
+
+after 'deploy' do
+  set :calendar_event_title, "[DEPLOYED] #{application} #{branch}: #{real_revision}"
+  top.calendar.create_event
+end

metadata

@@ -0,0 +1,79 @@
+--- !ruby/object:Gem::Specification 
+name: caphub
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Andriy Yanko
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-11-04 00:00:00 Z
+dependencies: []
+
+description: Generate centralized capistrano skeleton for multiple deployment
+email: 
+- andriy.yanko@gmail.com
+executables: 
+- caphub
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.md
+- Rakefile
+- bin/caphub
+- caphup.gemspec
+- lib/caphub.rb
+- lib/caphub/runner.rb
+- lib/caphub/version.rb
+- skeleton/.rvmrc
+- skeleton/Capfile
+- skeleton/Gemfile
+- skeleton/Gemfile.lock
+- skeleton/config/deploy.rb
+- skeleton/config/deploy/.gitkeep
+- skeleton/recipes/.gitkeep
+homepage: https://github.com/railsware/caphub
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: caphub
+rubygems_version: 1.8.6
+signing_key: 
+specification_version: 3
+summary: Generate centralized capistrano skeleton for multiple deployment
+test_files: []
+