microwave 0.1006.33 → 1.0.0

data/README.rdoc

@@ -24,6 +24,12 @@ You will also need to set up the repository with the appropriate branches. We do
 
 Once your repository is set up, you can start working on the code. We do use BDD/TDD with RSpec and Cucumber, so you'll need to get a development environment running.
 
+== REQUIREMENTS:
+
+Ruby 1.8.7+ [1]
+
+[1] As of 2012-05-25 Ruby 1.8.6 should still work, except for CHEF-2329.
+
 == ENVIRONMENT:
 
 In order to have a development environment where changes to the Chef code can be tested, we'll need to install a few things after setting up the Git repository.
@@ -33,11 +39,15 @@ In order to have a development environment where changes to the Chef code can be
 Install these via your platform's preferred method; for example apt, yum, ports, emerge, etc.
 
 * Git[http://git-scm.com/]
+* Erlang/OTP[http://www.erlang.org/]
+* CouchDB[http://couchdb.apache.org/]
+* RabbitMQ[http://www.rabbitmq.com/]
 * GCC and C Standard Libraries, header files, etc. (i.e., build-essential on debian/ubuntu)
 * Ruby development package
 
 === Runtime Rubygem Dependencies
 ==== Chef Client and Solo
+* ohai
 * bunny
 * erubis
 * highline
@@ -53,9 +63,60 @@ Install these via your platform's preferred method; for example apt, yum, ports,
 * net-ssh
 * fog
 
+==== Chef Server, WebUI and Solr
+All of the above, plus the following:
+* coderay
+* haml
+* merb-assets
+* merb-core
+* merb-haml
+* merb-helpers
+* merb-param-protection
+* ruby-openid
+* thin
+
 === Development Rubygem Dependencies
 * rake[http://rake.rubyforge.org/]
 * rspec[http://rspec.info/]
+* cucumber[http://cukes.info/]
+
+Ohai is also by Opscode and available on GitHub, http://github.com/opscode/ohai/tree/master.
+
+== Starting the Environment:
+
+=== On Mac OS X:
+For ease of debugging, Chef includes a script to start each of the required
+daemons in a separate Terminal.app tab via applescript:
+
+  scripts/mac-dev-start features
+
+=== On Linux and BSD
+
+run the dev:features rake task. You may need to run it as root depending on how
+your system is configured.
+
+  rake dev:features
+
+=== Daemons
+After starting the environment, you should have the following processes running:
+* couchdb             listening on port 5984
+* rabbitmq            listening on port 5672
+* solr                listening on port 8983
+* chef-solr-indexer   connected as a client to rabbitmq
+* chef-server         listening on port 4000
+* chef-server-webui   listening on port 4040
+
+You'll know its running when you see:
+
+    merb : chef-server (api) : worker (port 4000) ~ Starting Thin at port 4000
+    merb : chef-server (api) : worker (port 4000) ~ Using Thin adapter on host 0.0.0.0 and port 4000.
+    merb : chef-server (api) : worker (port 4000) ~ Successfully bound to port 4000
+
+You'll want to leave this terminal running the dev environment.
+
+=== Web Interface:
+
+With the dev environment running, you can now access the web interface via http://localhost:4040/.
 
 == Spec testing:
 
@@ -64,6 +125,23 @@ environment to run the specs--they are completely standalone.
 
   rake spec
 
+== Integration testing:
+
+We test integration with Cucumber. To run the full suite, run the rake task:
+
+  rake features
+
+Subsets of the integration tests can be run with the various tasks in the
+features namespace. To see the full list, run
+
+  rake -T
+
+To run individual feature tests, you can take advantage of cucumber's tagging
+support. Tag the feature you wish to run (tags are denoted with a leading `@'
+sign), then use the cucumber command:
+
+  cucumber -t @my_tag
+
 == LINKS:
 
 Source:
@@ -83,7 +161,7 @@ Documentation:
 Chef - A configuration management system
 
 Author:: Adam Jacob (<adam@opscode.com>)
-Copyright:: Copyright (c) 2008, 2009 Opscode, Inc.
+Copyright:: Copyright (c) 2008-2012 Opscode, Inc.
 License:: Apache License, Version 2.0
 
 Licensed under the Apache License, Version 2.0 (the "License");

data/Rakefile

@@ -0,0 +1,120 @@
+#
+# Author:: Adam Jacob (<adam@opscode.com>)
+# Author:: Daniel DeLeo (<dan@opscode.com>)
+# Copyright:: Copyright (c) 2008, 2010 Opscode, Inc.
+# License:: Apache License, Version 2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+require File.dirname(__FILE__) + '/lib/chef/version'
+
+require 'rubygems'
+require 'rubygems/package_task'
+require 'rake/rdoctask'
+require './tasks/rspec.rb'
+
+GEM_NAME = "chef"
+
+spec = eval(File.read("chef.gemspec"))
+
+# This has to be here or else the docs get generated *after* the gem is created
+task :gem => 'docs:all'
+
+Gem::PackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+begin
+  require 'sdoc'
+
+  Rake::RDocTask.new do |rdoc|
+    rdoc.title = "Chef Ruby API Documentation"
+    rdoc.main = "README.rdoc"
+    rdoc.options << '--fmt' << 'shtml' # explictly set shtml generator
+    rdoc.template = 'direct' # lighter template
+    rdoc.rdoc_files.include("README.rdoc", "LICENSE", "spec/tiny_server.rb", "lib/**/*.rb")
+    rdoc.rdoc_dir = "rdoc"
+  end
+rescue LoadError
+  puts "sdoc is not available. (sudo) gem install sdoc to generate rdoc documentation."
+end
+
+task :install => :package do
+  sh %{gem install pkg/#{GEM_NAME}-#{Chef::VERSION} --no-rdoc --no-ri}
+end
+
+task :uninstall do
+  sh %{gem uninstall #{GEM_NAME} -x -v #{Chef::VERSION} }
+end
+
+RONN_OPTS = "--manual='Chef Manual' --organization='Chef #{Chef::VERSION}' --date='#{Time.new.strftime('%Y-%m-%d')}'"
+
+namespace :docs do
+  desc "Regenerate manpages from markdown"
+  task :man
+
+  desc "Regenerate HTML manual from markdown"
+  task :html
+
+  desc "Regenerate help topics from man pages"
+  task :list => :man do
+    topics = Array.new
+
+    Dir['distro/common/man/man1/*.1'].each do |man|
+      topics << File.basename(man, '.1')
+    end
+
+    File.open('lib/chef/knife/help_topics.rb', 'w') do |f|
+      f.puts "# Do not edit this file by hand"
+      f.puts "# This file is autogenerated by the docs:list rake task from the available manpages\n\n"
+
+      f.puts "HELP_TOPICS = #{topics.inspect}"
+    end
+  end
+
+  if system('which ronn > /dev/null')
+    ['distro/common/markdown/man1/*.mkd', 'distro/common/markdown/man8/*.mkd'].each do |dir|
+      Dir[dir].each do |mkd|
+        basename = File.basename(mkd, '.mkd')
+        if dir =~ /man1/
+          manfile = "distro/common/man/man1/#{basename}.1"
+          htmlfile = "distro/common/html/#{basename}.1.html"
+        elsif dir =~ /man8/
+          manfile = "distro/common/man/man8/#{basename}.8"
+          htmlfile = "distro/common/html/#{basename}.8.html"
+        end
+
+        file(manfile => [mkd, 'lib/chef/version.rb']) do
+           sh "ronn -r #{RONN_OPTS} #{mkd} --pipe > #{manfile}"
+         end
+         task :man => manfile
+
+         file(htmlfile => [mkd, 'lib/chef/version.rb']) do
+           sh "ronn -5 #{RONN_OPTS} --style=toc #{mkd} --pipe > #{htmlfile}"
+         end
+         task :html => htmlfile
+
+      end
+    end
+  else
+    puts "get with the program and install ronn"
+  end
+
+  task :all => [:man, :html]
+end
+
+task :docs => "docs:all"
+
+
+

data/bin/chef-client

@@ -0,0 +1,26 @@
+#!/usr/bin/env ruby
+#
+# ./chef-client - Run the chef client
+#
+# Author:: AJ Christensen (<aj@opscode.com>)
+# Copyright:: Copyright (c) 2008 Opscode, Inc.
+# License:: Apache License, Version 2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'rubygems'
+$:.unshift(File.join(File.dirname(__FILE__), "..", "lib"))
+require 'chef'
+require 'chef/application/client'
+
+Chef::Application::Client.new.run

data/bin/knife

@@ -0,0 +1,26 @@
+#!/usr/bin/env ruby
+#
+# ./knife - Chef CLI interface 
+#
+# Author:: Adam Jacob (<adam@opscode.com>)
+# Copyright:: Copyright (c) 2009 Opscode, Inc.
+# License:: Apache License, Version 2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'rubygems'
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__), "..", "lib")))
+require 'chef/application/knife'
+
+Chef::Application::Knife.new.run
+

data/{lib/chef/resources.rb → bin/shef}

@@ -1,26 +1,34 @@
+#!/usr/bin/env ruby
 #
-# Author:: Daniel DeLeo (<dan@opscode.com>)
-# Copyright:: Copyright (c) 2010 Opscode, Inc.
+# ./shef - Run the shef REPL
+#
+# Author:: Daniel DeLeo (<dan@kallistec.com>)
+# Copyright:: Copyright (c) 2009
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
-#
+# 
 #     http://www.apache.org/licenses/LICENSE-2.0
-#
+# 
 # Unless required by applicable law or agreed to in writing, software
 # distributed under the License is distributed on an "AS IS" BASIS,
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-#
 
-require 'chef/resource/cookbook_file'
-require 'chef/resource/directory'
-require 'chef/resource/env'
-require 'chef/resource/execute'
-require 'chef/resource/file'
-require 'chef/resource/link'
-require 'chef/resource/remote_directory'
-require 'chef/resource/template'
+begin
+  require "rubygems"
+rescue LoadError
+end
+
+require "irb"
+require "irb/completion"
+require 'irb/ext/save-history'
+
+$:.unshift(File.expand_path(File.join(File.dirname(__FILE__), "..", "lib")))
+
+require "chef/shef"
+
+Shef.start

data/distro/README

@@ -0,0 +1,2 @@
+Init scripts meant to be used with a gem installation via the bootstrap
+cookbook.

data/distro/arch/etc/conf.d/chef-client.conf

@@ -0,0 +1,5 @@
+LOGFILE=/var/log/chef/client.log
+CONFIG=/etc/chef/client.rb
+INTERVAL=1800
+SPLAY=20
+CHEF_CLIENT_ARGS="-L $LOGFILE -d -c $CONFIG -i $INTERVAL -s $SPLAY"

data/distro/arch/etc/conf.d/chef-expander.conf

@@ -0,0 +1,8 @@
+LOGFILE=/var/log/chef/expander.log
+CONFIG=/etc/chef/solr.rb
+USER=chef
+GROUP=chef
+# Sleep to give daemon enough time to fully start or stop.
+DIETIME=5
+STARTTIME=5
+CHEF_EXPANDER_ARGS="-d -c $CONFIG -L $LOGFILE -n 1 -i 1"

data/distro/arch/etc/conf.d/chef-server-webui.conf

@@ -0,0 +1,10 @@
+LOGFILE=/var/log/chef/server-webui.log
+CONFIG=/etc/chef/webui.rb
+ADAPTER=thin
+PORT=4040
+USER=chef
+GROUP=chef
+# Sleep to give daemon enough time to fully start or stop.
+STARTTIME=10
+DIETIME=5
+CHEF_SERVER_WEBUI_ARGS="-p $PORT -e production -d -a $ADAPTER -L $LOGFILE -C $CONFIG -u $USER -G $GROUP"

data/distro/arch/etc/conf.d/chef-server.conf

@@ -0,0 +1,10 @@
+LOGFILE=/var/log/chef/server.log
+CONFIG=/etc/chef/server.rb
+ADAPTER=thin
+PORT=4000
+USER=chef
+GROUP=chef
+# Sleep to give daemon enough time to fully start or stop.
+STARTTIME=10
+DIETIME=5
+CHEF_SERVER_ARGS="-p $PORT -e production -d -a $ADAPTER -L $LOGFILE -C $CONFIG -u $USER -G $GROUP"

data/distro/arch/etc/conf.d/chef-solr.conf

@@ -0,0 +1,8 @@
+LOGFILE=/var/log/chef/solr.log
+CONFIG=/etc/chef/solr.rb
+USER=chef
+GROUP=chef
+# Sleep to give daemon enough time to fully start or stop.
+DIETIME=5
+STARTTIME=5
+CHEF_SOLR_ARGS="-d -c $CONFIG -L $LOGFILE -u $USER -g $GROUP"

data/distro/arch/etc/rc.d/chef-client

@@ -0,0 +1,90 @@
+#!/bin/bash
+#
+# Copyright (c) 2009-2010 Opscode, Inc <legal@opscode.com>
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+daemon_bin="/usr/bin/chef-client"
+daemon_name=$(basename $daemon_bin)
+PIDF="/var/run/$daemon_name.pid"
+
+. /etc/rc.conf
+. /etc/rc.d/functions
+. /etc/conf.d/$daemon_name.conf
+
+get_pid() {
+  pidof -o %PPID $daemon_name
+}
+
+case "$1" in
+  start)
+    stat_busy "Starting $daemon_name"
+    PID=$(get_pid)
+    if [ -z "$PID" ]; then
+      [ -f $PIDF ] && rm -f $PIDF
+      $daemon_bin --pid $PIDF $CHEF_CLIENT_ARGS
+      if [ $? -gt 0 ]; then
+        stat_fail
+        exit 1
+      else
+        echo $(get_pid) > $PIDF
+        add_daemon $daemon_name
+        stat_done
+      fi
+    else
+      stat_fail
+      exit 1
+    fi
+    ;;
+
+  stop)
+    stat_busy "Stopping $daemon_name daemon"
+    PID=$(get_pid)
+    [ ! -z "$PID" ] && kill $PID &> /dev/null
+    if [ $? -gt 0 ]; then
+      stat_fail
+      exit 1
+    else
+      rm -f $PIDF &>/dev/null
+      rm_daemon $daemon_name
+      stat_done
+    fi
+    ;;
+
+  restart)
+    $0 stop
+    sleep 3
+    $0 start
+    ;;
+
+  status)
+    stat_busy "Checking $daemon_name status";
+    ck_status $daemon_name
+    ;;
+
+  run)
+    stat_busy "Triggering new run of $daemon_name daemon"
+    PID=$(get_pid)
+    [ ! -z "$PID" ] && kill -SIGUSR1 $PID &> /dev/null
+    if [ $? -gt 0 ]; then
+      stat_fail
+      exit 1
+    else
+      stat_done
+    fi
+    ;;
+
+  *)
+    echo "usage: $) {start|stop|restart|status|run}"
+esac