Sane set of utility methods to provision remote servers over SSH and SCP
Ruby
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
lib
spec
.gitignore
.rvmrc
Gemfile
LICENSE
README.md
Rakefile
doorway.gemspec

README.md

Doorway

Sane set of utility methods to provision remote servers over SSH and SCP.

Installation

Add this line to your application's Gemfile:

gem 'doorway'

And then execute:

$ bundle

Or install it yourself as:

$ gem install doorway

Usage

doorway = Doorway.connect(:root, "10.0.1.20", :ssh_key => "~/.keys/somekey.pem")
doorway.exec "ls -la"

# -or-

Doorway.connect(:deployer, "10.0.1.20", :ssh_key => "~/.keys/deployer.pem") do |conn|

	# Raw command execution

	conn.exec    "whoami"
	conn.exec_as :root, "REALLY_GEM_UPDATE_SYSTEM=y gem update --system"

	# Script execution

	conn.exec_script <<-EOS.strip_heredoc
	
		#!/bin/bash
		apt-get install -y some-package
	
	EOS
	
	conn.exec_script_as :git, "scripts/add-public-ip"
	
	# Remote files

	conn.remote_file "/etc/nginx/nginx.conf", "nginx/nginx.conf"
	conn.remote_file "/etc/init.d/nginx", "nginx/nginx.init.d"
	conn.append_from "/etc/nginx/nginx.conf", "nginx/include"

	# ERB templates 
	
	conn.remote_file "/etc/nginx/conf.d/site.conf",
		:template => "nginx/vhost.conf.erb",
		:server   => "www.example.org",
		:root     => "/var/www/example"
		
	conn.append_from "/etc/sudoers.d/my_sudoers",
		:template => "sudoers/god.erb",
		:user     => "fcoury",
		:allow    => "/var/bin/all_your_base"
		
	# Download a file to server
	
	conn.get "https://webbynode_packages.s3.amazonaws.com/icecream-8.30.tar.gz", "/usr/local/src"
	  
	# Ubuntu specific package management

	conn.add_ppa "chris-lea/node.js"
	conn.install "nodejs"

	# Advanced commands
	
	conn.sed "/home/git/repo/.git/config", 
		/remote "github"/, 'remote "bitbucket"'
end

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request