freerange_deploy 0.1.1

data/README

@@ -0,0 +1,33 @@
+freerange/deploy
+================
+
+Allows simple, git-based deployment on freerange-compatible servers (see assumptions below)
+
+How to use
+----------
+
+In your project, create a Capfile, like this:
+
+    require 'freerange/deploy'
+
+    server "gofreerange.com", :app, :web, :db, :primary => true
+    set :application, "gofreerange.com" # defaults to the name of the repo at origin
+
+Next, prepare the server:
+
+    $ cap deploy:setup
+    
+This adds a git remote to your local repository, and creates an apache virtual host configuration on the server, and performs the initial git deploy. To deploy again, just push to 'production'
+
+    % git push production master
+
+
+
+Assumptions
+-----------
+
+1. You're deploying as 'deploy'
+2. You're deploying to /var/www/<application>
+3. Your apache is setup to read vhost files from /var/www/apache_vhost
+4. The deploy user has write access to that directory
+5. The deploy user is a sudoer

data/Rakefile

@@ -0,0 +1,67 @@
+require "rubygems"
+require "rake/gempackagetask"
+require "rake/rdoctask"
+
+
+
+task :default => :package do
+  puts "Don't forget to write some tests!"
+end
+
+# This builds the actual gem. For details of what all these options
+# mean, and other ones you can add, check the documentation here:
+#
+#   http://rubygems.org/read/chapter/20
+#
+spec = Gem::Specification.new do |s|
+
+  # Change these as appropriate
+  s.name              = "freerange_deploy"
+  s.version           = "0.1.1"
+  s.summary           = "Enables simple git-based deployments to freerange-compatible hosts"
+  s.author            = "James Adam"
+  s.email             = "james.adam@gofreerange.com"
+  s.homepage          = "http://gofreerange.com"
+
+  s.has_rdoc          = true
+  s.extra_rdoc_files  = %w(README)
+  s.rdoc_options      = %w(--main README)
+
+  # Add any extra files to include in the gem
+  s.files             = %w(freerange_deploy.gemspec Rakefile README) + Dir.glob("{lib/**/*}")
+  s.require_paths     = ["lib"]
+
+  # If you want to depend on other gems, add them here, along with any
+  # relevant versions
+  s.add_dependency("git-deploy", "~> 0.3.0")
+
+  # If your tests use any gems, include them here
+  # s.add_development_dependency("mocha") # for example
+end
+
+# This task actually builds the gem. We also regenerate a static
+# .gemspec file, which is useful if something (i.e. GitHub) will
+# be automatically building a gem for this project. If you're not
+# using GitHub, edit as appropriate.
+#
+# To publish your gem online, install the 'gemcutter' gem; Read more 
+# about that here: http://gemcutter.org/pages/gem_docs
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+
+  # Generate the gemspec file for github.
+  file = File.dirname(__FILE__) + "/#{spec.name}.gemspec"
+  File.open(file, "w") {|f| f << spec.to_ruby }
+end
+
+# Generate documentation
+Rake::RDocTask.new do |rd|
+  rd.main = "README"
+  rd.rdoc_files.include("README", "lib/**/*.rb")
+  rd.rdoc_dir = "rdoc"
+end
+
+desc 'Clear out RDoc and generated packages'
+task :clean => [:clobber_rdoc, :clobber_package] do
+  rm "#{spec.name}.gemspec"
+end

data/freerange_deploy.gemspec

@@ -0,0 +1,31 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{freerange_deploy}
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["James Adam"]
+  s.date = %q{2010-02-22}
+  s.email = %q{james.adam@gofreerange.com}
+  s.extra_rdoc_files = ["README"]
+  s.files = ["freerange_deploy.gemspec", "Rakefile", "README", "lib/freerange", "lib/freerange/deploy.rb"]
+  s.homepage = %q{http://gofreerange.com}
+  s.rdoc_options = ["--main", "README"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Enables simple git-based deployments to freerange-compatible hosts}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<git-deploy>, ["~> 0.3.0"])
+    else
+      s.add_dependency(%q<git-deploy>, ["~> 0.3.0"])
+    end
+  else
+    s.add_dependency(%q<git-deploy>, ["~> 0.3.0"])
+  end
+end

data/lib/freerange/deploy.rb

@@ -0,0 +1,60 @@
+require "git_deploy"
+
+Capistrano::Configuration.instance(:must_exist).load do
+  # User details
+  set :user,          'deploy'
+  set :group,         'admin'
+
+  # Application details
+  set(:runner)        { user }
+  set :use_sudo,      false
+
+  # SCM settings
+  set :scm,           'git'
+  # set to the name of git remote you intend to deploy to
+  set :remote,        'production' # overrides the default git-deploy setting of 'origin'
+  # specify the deployment branch
+  set :branch,        'master'
+
+  # The appliation name defaults to the name of the repository at the origin remote
+  set(:application) { File.basename(`#{source.local.scm('config', "remote.origin.url")}`, ".git") }
+  
+  # Deploy to our default location
+  set(:deploy_to)   { "/var/www/#{application}" }
+
+  # Git settings for Capistrano
+  default_run_options[:pty]     = true # needed for git password prompts
+  ssh_options[:forward_agent]   = true # use the keys for the person running the cap command to check out the app
+
+
+  before "deploy:setup", "freerange:setup_git_remote"
+  after "deploy:setup", "freerange:setup_apache"
+
+  namespace "freerange" do
+    task :setup_git_remote do
+      remote_url = "deploy@#{roles[:app].first}:/var/www/#{application}"
+      puts "Setting up git remote '#{remote}' -> #{remote_url}"
+      `git remote add #{remote} #{remote_url}`
+    end
+    task :setup_apache do
+      vhost_template =<<-EOT
+<VirtualHost *:80>
+  DocumentRoot /var/www/#{application}/public
+  ServerName #{application}
+  <Directory "/var/www/#{application}/public">
+    allow from all
+    Options +Indexes
+    </Directory>
+</VirtualHost>
+      EOT
+
+      put vhost_template.strip, "/var/www/apache_vhosts/#{application}"
+      
+      # Disable the default site, just in case; it will get in the way.
+      sudo "a2dissite default"
+      
+      # Restart apache
+      sudo "apache2ctl restart"
+    end
+  end
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification 
+name: freerange_deploy
+version: !ruby/object:Gem::Version 
+  version: 0.1.1
+platform: ruby
+authors: 
+- James Adam
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-02-22 00:00:00 +00:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: git-deploy
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.3.0
+    version: 
+description: 
+email: james.adam@gofreerange.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README
+files: 
+- freerange_deploy.gemspec
+- Rakefile
+- README
+- lib/freerange/deploy.rb
+has_rdoc: true
+homepage: http://gofreerange.com
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README
+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: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Enables simple git-based deployments to freerange-compatible hosts
+test_files: []
+