gepetto 0.0.8

data/History.txt

@@ -0,0 +1,4 @@
+== 0.0.8 2009-11-02
+
+* Fix a problem with network interface renaming performed by udev
+* Choose installed kernel according to a new Sandbox#attribute attribute

data/Manifest.txt

@@ -0,0 +1,35 @@
+History.txt
+Manifest.txt
+README.rdoc
+Rakefile
+app_generators/gepetto/USAGE
+app_generators/gepetto/gepetto_generator.rb
+app_generators/gepetto/templates/Rakefile
+app_generators/gepetto/templates/config/fileserver.conf
+app_generators/gepetto/templates/config/puppet.conf
+app_generators/gepetto/templates/manifests/classes/empty.pp
+app_generators/gepetto/templates/manifests/defaults.pp
+app_generators/gepetto/templates/manifests/nodes.pp
+app_generators/gepetto/templates/manifests/site.pp
+app_generators/gepetto/templates/manifests/templates.pp
+app_generators/gepetto/templates/script/module
+app_generators/gepetto/templates/script/puppetca
+app_generators/gepetto/templates/script/puppetmasterd
+app_generators/gepetto/templates/script/puppetrun
+bin/gepetto
+gepetto.gemspec
+lib/gepetto.rb
+lib/gepetto/tasks.rb
+puppet_generators/module/USAGE
+puppet_generators/module/module_generator.rb
+puppet_generators/module/templates/README
+puppet_generators/module/templates/manifests/init.pp
+script/destroy
+script/generate
+tasks/host.pp
+tasks/log.rake
+tasks/puppet.rake
+tasks/sandbox.pp
+tasks/sandbox.rake
+tasks/tmp.rake
+tasks/utils.rake

data/README.rdoc

@@ -0,0 +1,212 @@
+= Gepetto
+
+* http://github.com/albanpeignier/gepetto/
+
+== DESCRIPTION:
+
+A helper suite for Puppet projects to create, manage and help daily development
+
+More information about Puppet: http://reductivelabs.com/trac/puppet/
+
+== FEATURES:
+
+Creates base project:
+
+* create Puppet File Hierarchy
+* create default manifests files
+
+Provides helper tools:
+
+* script/puppetmasterd: to start a local puppetmasterd
+* script/puppetca: to manage local ssl directory
+* script/puppetrun: request a puppet run
+* script/module: to install external module
+
+* script/generate: generate puppet code (for module, ...)
+
+Provides rake tasks:
+
+* sandbox tasks: to create, start and control sandbox for development
+* puppet tasks: to check syntax
+* clean temporary or log files
+
+== SYNOPSIS:
+
+Create a new puppet project
+
+  gepetto /path/to/new/puppet/project
+
+      create  
+      create  script
+      create  config
+      create  manifests
+      create  files
+      create  templates
+      create  tasks
+      create  Rakefile
+      create  manifests/site.pp
+      create  manifests/templates.pp
+      create  manifests/nodes.pp
+      create  config/puppet.conf
+      create  config/fileserver.conf
+      create  script/puppetmasterd
+      create  script/puppetca
+      create  script/puppetrun
+      create  script/module
+  dependency  install_rubigen_scripts
+      exists    script
+      create    script/generate
+      create    script/destroy
+
+Start a puppetmasterd with project files:
+
+  ./script/puppetmasterd &
+
+   notice: Starting Puppet server version 0.24.5
+
+Create and start a sandbox:
+
+  rake sandbox:setup sandbox:create sandbox:start
+
+Follow sandbox console/syslog:
+
+  tail -f log/sandbox.log
+
+List waiting client certificates:
+
+  ./script/puppetca --list
+  sandbox
+
+Sign the sandbox certificate:
+
+  rake sandbox:puppet:sign
+
+Request a puppet run in sandbox:
+
+  rake sandbox:puppet:run
+
+Install an external module:
+
+  ./script/module install git://git.black.co.at/module-common  
+
+  install module common in modules/common
+ 
+  Initialized empty Git repository in modules/common/.git/
+  remote: Counting objects: 322, done.
+  remote: Compressing objects: 100% (217/217), done.
+  remote: Total 322 (delta 110), reused 210 (delta 70)
+  Receiving objects: 100% (322/322), 37.75 KiB, done.
+  Resolving deltas: 100% (110/110), done.
+
+Create a new Puppet module
+
+  ./script/generate module private
+
+      create  
+      create  manifests
+      create  files
+      create  templates
+      create  README
+      create  manifests/init.pp
+
+== SANDBOX
+
+For the moment, the sandbox tasks use qemu to create and run a virtual machine
+with a ready puppetd.
+
+Define a sandbox in your rakefile:
+
+  Sandbox.new do |s|
+    s.bootstraper = DebianBoostraper.new do |d|
+      d.version = 'lenny'
+      d.mirror = 'http://ftp.fr.debian.org/debian'
+    end
+
+    s.disk_size = '1G'
+    s.memory_size = '128M'
+  end
+
+Setup your host to create and start sandbox:
+
+  rake sandbox:setup
+
+It installs qemu, kqemu module and uml-utilities
+
+Create a fresh image for sandbox:
+
+  rake sandbox:create
+
+By default, it will create a disk of 512M with a debian lenny.
+
+Start a qemu instance with the sandbox image:
+
+  rake sandbox:start
+
+Follow the console (and syslog) output of the sandbox:
+
+  tail -f log/sandbox.log
+ 
+  [...]
+  Starting puppet configuration management tool
+
+  Debian GNU/Linux 5.0 sandbox ttyS0
+  sandbox login:
+
+  Jan 31 14:22:30 sandbox puppetd[1430]: Reopening log files.
+  Jan 31 14:22:32 sandbox puppetd[1430]: Could not request certificate
+
+
+Sign the new sandbox certificat:
+            
+  rake sandbox:puppet:sign
+
+Request a puppet run in the sandbox:
+
+  rake sandbox:puppet:run
+
+Stop the sandbox vm:
+
+  rake sandbox:stop
+
+Destroy sandbox files:
+
+  rake sandbox:destroy
+
+== REQUIREMENTS:
+
+* puppet and puppetmaster: http://reductivelabs.com/trac/puppet/
+* rubigen: http://rubigen.rubyforge.org/
+
+== INSTALL:
+
+  sudo gem install gepetto
+
+or to use the development release:
+
+  gem sources -a http://gems.github.com
+  sudo gem install albanpeignier-gepetto
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2009 Alban Peignier
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,28 @@
+require 'rubygems'
+gem 'hoe', '>= 2.1.0'
+require 'hoe'
+require 'fileutils'
+
+require File.dirname(__FILE__) + '/lib/gepetto'
+
+Hoe.plugin :newgem
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.spec 'gepetto' do 
+  self.version = Gepetto::VERSION
+  self.developer('Alban Peignier', 'alban.peignier@free.fr')
+  self.changes              = self.paragraphs_of("History.txt", 0..1).join("\n\n")
+  self.rubyforge_name       = self.name # TODO this is default value
+
+  self.clean_globs |= %w[**/.DS_Store tmp *.log]
+  path = (self.rubyforge_name == self.name) ? self.rubyforge_name : "\#{self.rubyforge_name}/\#{self.name}"
+  self.remote_rdoc_dir = File.join(path.gsub(/^#{self.rubyforge_name}\/?/,''), 'rdoc')
+  self.rsync_args = '-av --delete --ignore-errors'
+end
+
+require 'newgem/tasks' # load /tasks/*.rake
+Dir['tasks/**/*.rake'].each { |t| load t }
+
+# TODO - want other tests/tasks run by default? Add them to the list
+# task :default => [:spec, :features]

data/app_generators/gepetto/gepetto_generator.rb

@@ -0,0 +1,35 @@
+require 'rbconfig'
+
+class GepettoGenerator < RubiGen::Base
+
+  def initialize(runtime_args, runtime_options = {})
+    super
+
+    usage if args.empty?
+    @destination_root = File.expand_path(args.shift)
+  end
+
+  def manifest
+    script_options = { :chmod => 0755 }
+    
+    record do |m|
+      # Root directory and all subdirectories.
+      m.directory ''
+
+      %w{script config manifests manifests/classes files templates log tasks}.each { |path| m.directory path }
+
+      m.template_copy_each %w( Rakefile )
+
+      m.template_copy_each %w( defaults.pp site.pp templates.pp nodes.pp ), 'manifests'
+
+      m.template_copy_each %w( empty.pp ), 'manifests/classes'
+
+      m.template_copy_each %w( puppet.conf fileserver.conf ), 'config'
+
+      m.template_copy_each %w( puppetmasterd puppetca puppetrun module ), 'script', script_options
+
+      m.dependency "install_rubigen_scripts", [destination_root, "puppet"]
+    end
+  end
+
+end

data/app_generators/gepetto/templates/Rakefile

@@ -0,0 +1,24 @@
+%w[rubygems rake rake/clean fileutils].each { |f| require f }
+
+require 'gepetto/tasks' # load /tasks/*.rake
+Dir['tasks/**/*.rake'].each { |t| load t }
+
+# Change the sandbox storage directory
+# Sandbox.images_directory = '/disks/sandbox'
+
+Sandbox.new do |s|
+  s.bootstraper = DebianBoostraper.new do |d|
+    # Specify the wanted debian distribution
+    # d.version = 'lenny'
+
+    # Use a local debian mirror
+    # d.mirror = 'http://ftp.fr.debian.org/debian'
+
+    # Use a local apt-proxy
+    # d.mirror = 'http://127.0.0.1:9999/debian'
+  end
+
+  # s.disk_size = '1G'
+  # s.memory_size = '128M'
+end
+

data/app_generators/gepetto/templates/config/fileserver.conf

@@ -0,0 +1,7 @@
+[files]
+  path <%= File.expand_path destination_root, 'files' %>
+  allow *
+
+[plugins]
+  path <%= File.expand_path destination_root, 'plugins' %>
+  allow *

data/app_generators/gepetto/templates/config/puppet.conf

@@ -0,0 +1,11 @@
+[main]
+factpath=$vardir/lib/facter
+pluginsync=true
+color=false
+
+# To unable storeconfigs (requires gems sqlite3)
+#
+#[puppetmaster]
+#storeconfigs = true
+#dbadapter = sqlite3
+#dblocation = $vardir/storeconfigs.sqlite

data/app_generators/gepetto/templates/manifests/classes/empty.pp

@@ -0,0 +1 @@
+# Remove me when your first classes are defined

data/app_generators/gepetto/templates/manifests/defaults.pp

@@ -0,0 +1,12 @@
+# Some useful defaults
+
+Exec { path => "/usr/bin:/usr/sbin/:/bin:/sbin:/usr/local/bin:/usr/local/sbin" }
+
+File { 
+  ignore => ['.svn', '.git', 'CVS' ], 
+  checksum => md5, 
+  owner => root, group => root, 
+  backup => server 
+}
+
+filebucket { server: server => puppet }

data/app_generators/gepetto/templates/manifests/nodes.pp

@@ -0,0 +1,5 @@
+# Node Definitions
+
+# node 'sandbox' {
+#   notice("sandbox is ready")    
+# }

data/app_generators/gepetto/templates/manifests/site.pp

@@ -0,0 +1,9 @@
+# Site Manifest
+
+# For more details, see Puppet Best Practices 2.0 :
+# http://reductivelabs.com/trac/puppet/wiki/PuppetBestPractice
+
+import "defaults"
+import "classes/*"
+import "templates"
+import "nodes"

data/app_generators/gepetto/templates/script/module

@@ -0,0 +1,67 @@
+#!/bin/bash -e
+
+# TODO just a POC, make a real implementation
+
+function usage() {
+    cat - <<EOF
+Usage: module [OPTIONS] command
+Puppet module manager.
+GENERAL OPTIONS
+  -h, --help                       Show this help message.
+COMMANDS
+  install    Install module from an URL.
+EXAMPLES
+  Install a module from a git URL:
+    module install git://github.com/lak/puppet-puppet.git
+  Install a module from a git URL and a specified name:
+    module install git://github.com/lak/puppet-puppet.git lak-puppet
+EOF
+    exit 0
+}
+
+command=$1
+[  -z "$command" ] && usage
+
+shift
+
+modules_dir=modules
+[ -d $modules_dir ] || mkdir $modules_dir
+cd $modules_dir
+
+case $command in
+    install)
+        if [ ! -x "/usr/bin/git" ]; then
+	   echo "You must install git to retrieve modules managed with it (apt-get install git-core)"
+	   exit 1
+        fi
+
+        module_url=$1
+        [  -z "$module_url" ] && usage
+            
+        shift
+
+        if [ $# -gt 0 ]; then
+            module_name=$1
+            shift
+        else
+            module_name=`echo $module_url | sed 's@.*/\(.*\)$@\1@'`
+            # remove .git suffix
+            module_name=`echo $module_name | sed 's/\.git$//'`
+            # remove puppet- or module- prefix
+            module_name=`echo $module_name | sed -e 's/^puppet-//' -e 's/^module-//'`
+        fi
+            
+        if [ -d $module_name ]; then
+            echo "module $module_name already installed"
+            exit 1
+        fi
+
+        echo "install module $module_name in $modules_dir/$module_name"
+        
+        git clone $module_url $module_name
+        rm -rf $module_name/.git
+        ;;
+    *)
+        usage
+        ;;
+esac