sunzi 1.1.2 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1bd89f4ad65038f257a87cbcdd0ea8006d574b51
-  data.tar.gz: f4db9e3e86a12dfddf1f55ce68f12203f2a1a4aa
+  metadata.gz: 4ec250a135b740f0a34196be384788cdebf33d5a
+  data.tar.gz: 27cf354835d55b8463964df7e8095c8880d3750a
 SHA512:
-  metadata.gz: df36a11715d35f8e47f161ca44047996f310431e61cb94ddc8cbf6468c11ae9d0ae705604e2f221ef94830087925bb7fecc0a31a4abc4a32c338faac89a7e3d4
-  data.tar.gz: 7ce6fc934da2816b045855621a773172ba6b1c770c59f27c1fd2eb630eb2c131ed051b73a7f871824f3bb4076f11402428f03983c6ec8bfe3e9761c9fcb92778
+  metadata.gz: 22a9585b4f2228b01509924b4c7509ca8b20b5ffd300a5a06338db32cbb12e8d1a6b23d129f9be2513d86435bb2c0c708f82b162ea708eeaefbf2cb412281414
+  data.tar.gz: d50ddebc4f553446f4c54fcec5099c7dfab232fc1e74888bdcdc1890b06506c401cac336e6c6e860806f277bd8263c31efedec045b443f715e7fdeae70dd4988

data/.gitignore

@@ -2,3 +2,4 @@
 .bundle
 Gemfile.lock
 pkg/*
+sandbox

data/README.md

@@ -18,6 +18,7 @@ Its design goals are:
 
 ### What's new:
 
+* v1.2: Evaluate everything as ERB templates by default. Added "files" folder.
 * v1.1: "set -e" by default. apt-get everywhere in place of aptitude. Linode DNS support for DigitalOcean instances.
 * v1.0: System functions are refactored into sunzi.mute() and sunzi.install().
 * v0.9: Support for [DigitalOcean](https://www.digitalocean.com) setup / teardown.
@@ -89,25 +90,24 @@ sunzi/
   roles/          # when role is specified, scripts here will be concatenated
     db.sh         # to install.sh in the compile phase
     web.sh
+  files/          # put any files to be transferred
   compiled/       # everything under this folder will be transferred to the
                   # remote server (do not edit directly)
 ```
 
-How do you pass dynamic values to a recipe?
--------------------------------------------
+How do you pass dynamic values?
+-------------------------------
 
-In the compile phase, attributes defined in `sunzi.yml` are split into multiple files in `compiled/attributes`, one per attribute. We use filesystem as a sort of key-value storage so that it's easy to use from shell scripts.
+There are two ways to pass dynamic values to the script - ruby and bash.
 
-The convention for argument passing to a recipe is to use `$1`, `$2`, etc. and put a comment line for each argument.
+**For ruby (recommended)**: Make sure `eval_erb: true` is set in `sunzi.yml`. In the compile phase, attributes defined in `sunzi.yml` are accessible from any files in the form of `<%= @attributes.ruby_version %>`.
 
-For instance, given a recipe `greeting.sh`:
+**For bash**: In the compile phase, attributes defined in `sunzi.yml` are split into multiple files in `compiled/attributes`, one per attribute. Now you can refer to it by `$(cat attributes/ruby_version)` in the script.
 
-```bash
-# Greeting
-# $1: Name for goodbye
-# $2: Name for hello
+For instance, given the following `install.sh`:
 
-echo "Goodbye $1, Hello $2!"
+```bash
+echo "Goodbye <%= @attributes.goodbye %>, Hello <%= @attributes.hello %>!"
 ```
 
 With `sunzi.yml`:
@@ -118,13 +118,7 @@ attributes:
   hello: Sunzi
 ```
 
-Then, include the recipe in `install.sh`:
-
-```bash
-source recipes/greeting.sh $(cat attributes/goodbye) $(cat attributes/hello)
-```
-
-Now, you get the following result. Isn't it awesome?
+Now, you get the following result.
 
 ```
 Goodbye Chef, Hello Sunzi!

data/lib/sunzi/cli.rb

@@ -1,4 +1,5 @@
 require 'open3'
+require 'ostruct'
 
 module Sunzi
   class Cli < Thor
@@ -43,12 +44,13 @@ module Sunzi
       end
 
       def do_create(project)
-        template 'templates/create/.gitignore',         "#{project}/.gitignore"
-        template 'templates/create/sunzi.yml',          "#{project}/sunzi.yml"
-        template 'templates/create/install.sh',         "#{project}/install.sh"
-        template 'templates/create/recipes/sunzi.sh',   "#{project}/recipes/sunzi.sh"
-        template 'templates/create/roles/db.sh',        "#{project}/roles/db.sh"
-        template 'templates/create/roles/web.sh',       "#{project}/roles/web.sh"
+        copy_file 'templates/create/.gitignore',         "#{project}/.gitignore"
+        copy_file 'templates/create/sunzi.yml',          "#{project}/sunzi.yml"
+        copy_file 'templates/create/install.sh',         "#{project}/install.sh"
+        copy_file 'templates/create/recipes/sunzi.sh',   "#{project}/recipes/sunzi.sh"
+        copy_file 'templates/create/roles/db.sh',        "#{project}/roles/db.sh"
+        copy_file 'templates/create/roles/web.sh',       "#{project}/roles/web.sh"
+        copy_file 'templates/create/files/.gitkeep',     "#{project}/files/.gitkeep"
       end
 
       def do_deploy(target, role, force_sudo)
@@ -102,7 +104,7 @@ module Sunzi
         @config = YAML.load(File.read('sunzi.yml'))
 
         # Break down attributes into individual files
-        (@config['attributes'] || []).each {|key, value| create_file "compiled/attributes/#{key}", value }
+        (@config['attributes'] || {}).each {|key, value| create_file "compiled/attributes/#{key}", value }
 
         # Retrieve remote recipes via HTTP
         cache_remote_recipes = @config['preferences'] && @config['preferences']['cache_remote_recipes']
@@ -112,15 +114,23 @@ module Sunzi
         end
 
         # Copy local files
-        Dir['recipes/*'].each         {|file| copy_file File.expand_path(file), "compiled/recipes/#{File.basename(file)}" }
-        Dir['roles/*'].each           {|file| copy_file File.expand_path(file), "compiled/roles/#{File.basename(file)}" }
-        (@config['files'] || []).each {|file| copy_file File.expand_path(file), "compiled/files/#{File.basename(file)}" }
+        @attributes = OpenStruct.new(@config['attributes'])
+        copy_or_template = (@config['preferences'] && @config['preferences']['eval_erb']) ? :template : :copy_file
+        Dir['recipes/*'].each {|file| send copy_or_template, File.expand_path(file), "compiled/recipes/#{File.basename(file)}" }
+        Dir['roles/*'].each   {|file| send copy_or_template, File.expand_path(file), "compiled/roles/#{File.basename(file)}" }
+        Dir['files/*'].each   {|file| send copy_or_template, File.expand_path(file), "compiled/files/#{File.basename(file)}" }
+        (@config['files'] || []).each {|file| send copy_or_template, File.expand_path(file), "compiled/files/#{File.basename(file)}" }
 
         # Build install.sh
         if role
-          create_file 'compiled/install.sh', File.binread('install.sh') << "\n" << File.binread("roles/#{role}.sh")
+          if copy_or_template == :template
+            template File.expand_path('install.sh'), 'compiled/_install.sh'
+            create_file 'compiled/install.sh', File.binread('compiled/_install.sh') << "\n" << File.binread("compiled/roles/#{role}.sh")
+          else
+            create_file 'compiled/install.sh', File.binread('install.sh') << "\n" << File.binread("roles/#{role}.sh")
+          end
         else
-          copy_file File.expand_path('install.sh'), 'compiled/install.sh'
+          send copy_or_template, File.expand_path('install.sh'), 'compiled/install.sh'
         end
       end
 

data/lib/templates/create/install.sh

@@ -25,7 +25,7 @@ if sunzi.install "sysstat"; then
 fi
 
 # Set RAILS_ENV
-environment=$(cat attributes/environment)
+environment=<%= @attributes.environment %>
 
 if ! grep -Fq "RAILS_ENV" ~/.bash_profile; then
   echo 'Setting up RAILS_ENV...'
@@ -35,7 +35,7 @@ fi
 
 # Install Ruby using RVM
 source recipes/rvm.sh
-ruby_version=$(cat attributes/ruby_version)
+ruby_version=<%= @attributes.ruby_version %>
 
 if [[ "$(which ruby)" != /usr/local/rvm/rubies/ruby-$ruby_version* ]]; then
   echo "Installing ruby-$ruby_version"

data/lib/templates/create/sunzi.yml

@@ -23,3 +23,7 @@ preferences:
   # Skip retrieving remote recipes when local copies already exist. This setting helps
   # iterative deploy testing considerably faster, when you have a lot of remote recipes.
   cache_remote_recipes: false
+
+  # Evaluate files as ERB templates. When enabled, you can pass dynamic values in the form
+  # of <%= @attributes.environment %> in recipes, roles, files and install.sh.
+  eval_erb: true

data/sunzi.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name          = 'sunzi'
-  spec.version       = '1.1.2' # retrieve this value by: Gem.loaded_specs['sunzi'].version.to_s
+  spec.version       = '1.2.0' # retrieve this value by: Gem.loaded_specs['sunzi'].version.to_s
   spec.authors       = ['Kenn Ejima']
   spec.email         = ['kenn.ejima@gmail.com']
   spec.homepage      = 'http://github.com/kenn/sunzi'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sunzi
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.2.0
 platform: ruby
 authors:
 - Kenn Ejima
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-04-12 00:00:00.000000000 Z
+date: 2013-04-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -79,6 +79,7 @@ files:
 - lib/sunzi/logger.rb
 - lib/sunzi/utility.rb
 - lib/templates/create/.gitignore
+- lib/templates/create/files/.gitkeep
 - lib/templates/create/install.sh
 - lib/templates/create/recipes/sunzi.sh
 - lib/templates/create/roles/db.sh
@@ -108,9 +109,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.2
+rubygems_version: 2.0.3
 signing_key: 
 specification_version: 4
 summary: Server provisioning utility for minimalists
 test_files:
 - test/test_cli.rb
+has_rdoc: