chake 0.9.1 → 0.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a7c5efab47798dbdf129aea6f12ef220e89d8d36
-  data.tar.gz: 4c9b53a0d25c692ed7e2e96d607a24b19bfb5b2a
+  metadata.gz: f77ef7f899b9ce537667051750f06a7477a0fa79
+  data.tar.gz: 6a34e5a9df879a762fc76de59ee1b0d931813c03
 SHA512:
-  metadata.gz: ab138e93a951b69c5a19a322668ef01a673095cfeb474c2733e3eaecaa7a4e0f88c1ea40238af9c51d5d102de9e1069eb841651736041ea37a78c12c065c02b9
-  data.tar.gz: 81e6fc9f572bd42cd8e81a39e357c5f16c2a83aa7a93390adc180bb37323cda9ceb3c394a65e56721e8761a42eb7dc159e6b2cf11173e49e28469711695b9408
+  metadata.gz: 55237a960ac4ae67d3f0f173582b615b8306767ed16bda793828170965472356da69749b3597260e9be61ba29dd1072dd61c015fcba33e6ebc66585c7a565313
+  data.tar.gz: 2fcf4ef7b8edb50beb1c18b87bd5e03c30dded4477ef4e1cf3e8ac53d52454497afe3b91a17692d78cd379b37670f2688ac854ac5879b7b979b0d7190ef57a42

data/ChangeLog.md

@@ -1,3 +1,8 @@
+# 0.10
+
+* Add hook functionality. See README/manpage for documentation.
+* README.md: a few reviews
+
 # 0.9.1
 
 * fix manpage installation path

data/README.md

@@ -77,24 +77,23 @@ host2.mycompany.com                      ssh
 
 ## Preparings nodes to be managed
 
-Nodes has very few requirements to be managed with `chake`:
+Nodes have very few initial requirements to be managed with `chake`:
 
 - The node must be accessible via SSH.
-- The node must have `sudo` installed.
 - The user you connect to the node must either be `root`, or be allowed to run
-  `sudo`.
+  `sudo` (in which case `sudo` must be installed).
 
 **A note on password prompts:** every time chake calls ssh on a node, you may
 be required to type in your password; every time chake calls sudo on the node,
-you may be require to type in your password. For managaing one or two nodes
-this is probably fine, but for larger numbers it is not practical. To avoid
+you may be require to type in your password. For managing one or two nodes this
+is probably fine, but for larger numbers of nodes it is not practical. To avoid
 password prompts, you can:
 
-- configure SSH key authentication.
-    - this is more secure than using passwords, anyway.
-    - bonus points: disable password authentication completely, and only allow
-      key-based authentication
-- configure passwordless `sudo` access for your user on the server
+- Configure SSH key-based authentication. This is more secure than using passwords.
+  While you are at it, you also probably want disable password authentication
+  completely, and only allow key-based authentication
+- Configure passwordless `sudo` access for the user you use to connect to your
+  nodes.
 
 ## Applying cookbooks
 
@@ -147,6 +146,25 @@ the node URLs:
 
 ## Extra features
 
+### Hooks
+
+You can define rake tasks that will be executed before bootstrapping nodes,
+before uploading configuration management content to nodes, and before
+converging. To do this, you just need to enhance the corresponding tasks:
+
+* `bootstrap_common`: executed before bootstrapping nodes (even if nodes have
+  already been bootstrapped)
+* `upload_common`: executed before uploading content to the node
+* `converge_common`: executed before converging (i.e. running chef)
+
+Example:
+
+```
+task :bootstrap_common do
+  sh './scripts/pre-bootstrap-checks'
+end
+```
+
 ### Encrypted files
 
 Any files ending matching `*.gpg` and `*.asc` will be decrypted with GnuPG

data/Rakefile

@@ -107,6 +107,7 @@ task :check_changelog do
   end
 end
 
+desc 'Makes a release'
 task :release => [:check_tag, :check_changelog, :test, 'bundler:release', :obs]
 
 task :default => :test

data/lib/chake.rb

@@ -120,6 +120,15 @@ end
 
 bootstrap_steps = Dir.glob(File.expand_path('chake/bootstrap/*.sh', File.dirname(__FILE__))).sort
 
+desc 'Executed before bootstrapping'
+task :bootstrap_common
+
+desc 'Executed before uploading'
+task :upload_common
+
+desc 'Executed before uploading'
+task :converge_common
+
 $nodes.each do |node|
 
   hostname = node.hostname
@@ -138,7 +147,7 @@ $nodes.each do |node|
   end
 
   desc "bootstrap #{hostname}"
-  task "bootstrap:#{hostname}" => bootstrap_script do
+  task "bootstrap:#{hostname}" => [:bootstrap_common, bootstrap_script] do
     config = File.join($chake_tmpdir, hostname + '.json')
 
     if File.exists?(config)
@@ -161,7 +170,7 @@ $nodes.each do |node|
   end
 
   desc "upload data to #{hostname}"
-  task "upload:#{hostname}" do
+  task "upload:#{hostname}" => :upload_common do
     encrypted = encrypted_for(hostname)
     rsync_excludes = (encrypted.values + encrypted.keys).map { |f| ["--exclude", f] }.flatten
     rsync_excludes << "--exclude" << ".git/"
@@ -188,7 +197,7 @@ $nodes.each do |node|
   end
 
   desc "converge #{hostname}"
-  task "converge:#{hostname}" => ["bootstrap:#{hostname}", "upload:#{hostname}"] do
+  task "converge:#{hostname}" => [:converge_common, "bootstrap:#{hostname}", "upload:#{hostname}"] do
     chef_logging = Rake.application.options.silent && '-l fatal' || ''
     node.run_as_root "chef-solo -c #{node.path}/config.rb #{chef_logging} -j #{node.path}/#{$chake_tmpdir}/#{hostname}.json"
   end
@@ -223,7 +232,7 @@ task :bootstrap => $nodes.map { |node| "bootstrap:#{node.hostname}" }
 desc "converge all nodes (default)"
 task "converge" => $nodes.map { |node| "converge:#{node.hostname}" }
 
-task "run a command on all nodes"
+desc "run a command on all nodes"
 task :run => $nodes.map { |node| "run:#{node.hostname}" }
 
 task :default => :converge

data/lib/chake/version.rb

@@ -1,3 +1,3 @@
 module Chake
-  VERSION = "0.9.1"
+  VERSION = "0.10"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chake
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: '0.10'
 platform: ruby
 authors:
 - Antonio Terceiro
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-09-04 00:00:00.000000000 Z
+date: 2015-10-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler