capistrano-rbenv-install 0.0.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 477d02c69f8a561b6dbfddc756be0563d18e4abb
-  data.tar.gz: 4a9bc69e20fdf1c876a86abf8e74e8caffe77b82
+  metadata.gz: afdb932ae318230056e5634b199d619b18e1eefd
+  data.tar.gz: 9cc4770b5547475e981a478abc709ed9e88448b7
 SHA512:
-  metadata.gz: 90039fb826fcce0dbefc60d1e349a57757332632ac864bac9b51029e4047fe2586a9186898ad51f904f763d05bdeab1f67969bec8d89ab165c5597fba95002e6
-  data.tar.gz: 2697b4532a4ff979f236ab312e1e517304ff259e7823d8968db397102655c82069965a189d7dd7dfd98bb5e5962e8b3071b45c66540146070a8dce13643b1792
+  metadata.gz: 9eda8b1fd55349c806c86259cc246088bdef2f74fdfdf24a65dab5400a146988bd23bbe6c1f15b0425079b269236bade7895be5189d4bd09b2f84a59f3ba1d41
+  data.tar.gz: db9217e6149e8b22053e718cf1e1ea51f7896f4a06465a8fcf15d831b7d3f269cf8bcda3c8eb01f98a56e2d56eea4db51b8d8a4804aadbd96d35992b14a6c723

data/CHANGELOG.md

@@ -0,0 +1,2 @@
+### v1.0.0, 2014-03-39
+- @bruno- all the v1.0.0 features

data/README.md

@@ -1,23 +1,116 @@
 # Capistrano::Rbenv::Install
 
-### About
+Capistrano plugin for **lightweight** rubies management with rbenv.
+
+Works with Capistrano 3 (only). For Capistrano 2 support check
+[this repository](https://github.com/yyuu/capistrano-rbenv)
+(version 1.x of `capistrano-rbenv` gem).
 
 ### Installation
 
-### Standard usage
+Install by adding the following to the `Gemfile`:
+
+    gem 'capistrano', '~> 3.1'
+    gem 'capistrano-rbenv', '~> 2.0' # required
+    gem 'capistrano-rbenv-install'
+
+then:
+
+    $ bundle install
+
+### Configuration and usage
+
+The following goes to `Capfile`:
+
+    require 'capistrano/rbenv_install'
+
+This plugin heavily relies on
+[capistrano-rbenv config options](https://github.com/capistrano/rbenv#usage).
+So make sure to properly setup `capistrano-rbenv` and you'll be good.
+
+For example, in `config/deploy.rb`:
+
+    set :rbenv_ruby, '2.0.0-p247'
+
+Other than that, this plugin does not need any setup.
+
+Run:
+
+    $ bundle exec production deploy
+
+And watch ruby being installed.
 
-### How it works
+### Purpose
 
-### Gotchas
+Installing software packages on servers is called
+[provisioning](http://en.wikipedia.org/wiki/Provisioning#Server_provisioning).
+Installing and managing rubies falls into that domain, and is best done with a
+proper tool like chef, puppet, ansible or something else.
 
-### Debugging
+Why this plugin then?
 
-### Configuration
+- Capistrano is a great tool (written in ruby btw) so, when there's a need,
+installing rubies with it should be easy too
+- not everyone knows (or has time to learn) how to use provisioning tools
+mentioned above
+- sometimes installing ruby manually is just easier than fiddling with your
+chef cookbooks. Instead of manually, you can do it with this plugin now
 
-### Contributing and bug reports
+Imagine you want to quickly deploy a ruby `1.9.2` app to a server that already
+has one or more ruby `2.0.0` apps.
+"Oh, let's just quickly update our cookbooks" - yea right! I'd rather manually
+`ssh` to the server directly and run `rbenv install 1.9.2-p320`. But I don't
+want to manually `ssh` to the server too. In that case I just can install
+`capistrano-rbenv-install` and forget about it altogether.
+
+### What it does
+
+It only does the bare minimum that's required for Capistrano to work. That's
+why it's a plugin for *lightweight* ruby management.
+
+It makes sure that:
+
+- `rbenv` and `ruby build` are installed (installs them using `git`)
+- ruby specified with `:rbenv_ruby` option is installed
+- `bundler` gem is installed
+
+### What it does NOT do
+
+It **does not**:
+
+- manage ruby gems<br/>
+`bundler` is installed by default and that's pretty much it.
+
+- does not install ruby dependency packages<br/>
+(git-core build-essential libreadline6-dev etc ...). You should probably
+install/provision those some other way.
+
+- does not manage `rbenv` plugins<br/>
+It only installs `ruby build` for the purpose of installing ruby.
+
+- does not setup rbenv for direct use on the server via the command line<br/>
+Example: `ssh`ing to the server and manually running ruby commands is not
+supported.
+
+### More Capistrano automation?
+
+If you'd like to streamline your Capistrano deploys, you might want to check
+these zero-configuration, plug-n-play plugins:
+
+- [capistrano-postgresql](https://github.com/bruno-/capistrano-postgresql)<br/>
+plugin that automates postgresql configuration and setup
+- [capistrano-unicorn-nginx](https://github.com/bruno-/capistrano-unicorn-nginx)<br/>
+no-configuration unicorn and nginx setup with sensible defaults
+- [capistrano-safe-deploy-to](https://github.com/bruno-/capistrano-safe-deploy-to)<br/>
+if you're annoyed that Capistrano does **not** create a deployment path for the
+app on the server (default `/var/www/myapp`), this is what you need!
 
 ### Thanks
 
+@yyuu and the original
+[capistrano-rbenv](https://github.com/yyuu/capistrano-rbenv) project for
+inspiration
+
 ### License
 
 [MIT](LICENSE.md)

data/lib/capistrano/rbenv_install/version.rb

@@ -1,5 +1,5 @@
 module Capistrano
   module RbenvInstall
-    VERSION = "0.0.1"
+    VERSION = "1.0.0"
   end
 end

data/lib/capistrano/tasks/rbenv_install.rake

@@ -17,7 +17,7 @@ namespace :rbenv do
   task :install_rbenv do
     on roles fetch(:rbenv_roles) do
       next if test "[ -d #{fetch(:rbenv_path)} ]"
-      execute :git, "clone https://github.com/sstephenson/rbenv.git #{fetch(:rbenv_path)}"
+      execute :git, :clone, 'https://github.com/sstephenson/rbenv.git', fetch(:rbenv_path)
     end
   end
 
@@ -25,7 +25,7 @@ namespace :rbenv do
   task :install_ruby_build do
     on roles fetch(:rbenv_roles) do
       next if test "[ -d #{fetch(:rbenv_ruby_build_path)} ]"
-      execute :git, "clone https://github.com/sstephenson/ruby-build.git #{fetch(:rbenv_ruby_build_path)}"
+      execute :git, :clone, 'https://github.com/sstephenson/ruby-build.git', fetch(:rbenv_ruby_build_path)
     end
   end
 
@@ -33,23 +33,23 @@ namespace :rbenv do
   task :install_ruby do
     on roles fetch(:rbenv_roles) do
       next if test "[ -d #{fetch(:rbenv_ruby_dir)} ]"
-      execute "#{fetch(:rbenv_path)}/bin/rbenv install #{fetch(:rbenv_ruby)}"
+      execute "#{fetch(:rbenv_path)}/bin/rbenv", :install, fetch(:rbenv_ruby)
     end
   end
 
   desc 'Install bundler gem'
   task :install_bundler do
     on roles fetch(:rbenv_roles) do
-      next if test :gem, "query --quiet --installed --name-matches ^bundler$"
-      execute :gem, "install bundler --quiet --no-rdoc --no-ri"
+      next if test :gem, :query, '--quiet --installed --name-matches ^bundler$'
+      execute :gem, :install, :bundler, '--quiet --no-rdoc --no-ri'
     end
   end
 
   desc 'Install rbenv, ruby build and ruby version'
   task :install do
-    invoke "rbenv:install_rbenv"
-    invoke "rbenv:install_ruby_build"
-    invoke "rbenv:install_ruby"
+    invoke 'rbenv:install_rbenv'
+    invoke 'rbenv:install_ruby_build'
+    invoke 'rbenv:install_ruby'
   end
 
   before 'rbenv:validate', 'rbenv:install'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: capistrano-rbenv-install
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 1.0.0
 platform: ruby
 authors:
 - Bruno Sutic
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-03-22 00:00:00.000000000 Z
+date: 2014-03-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: capistrano
@@ -62,6 +62,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
 - Gemfile
 - LICENSE.md
 - README.md