Skip to content

Latest commit

 

History

History
212 lines (137 loc) · 5 KB

README.rdoc

File metadata and controls

212 lines (137 loc) · 5 KB
Raw

Gepetto ↑

DESCRIPTION: ↑

A helper suite for Puppet projects to create, manage and help daily development

More information about Puppet: 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: ↑

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 © 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.