kameleon-builder 2.0.0.dev → 2.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0da2c2ced91eb366f1c84e507b387531e6a71036
+  data.tar.gz: bb947d9be606eca0d2f5dc4e38d31fa985b7b866
+SHA512:
+  metadata.gz: affe277bd4a073060f4e3f26a41df509f31a41d92e58e1bc6dfa1e068d619be240a52a426139c0165c507081a07fd2f0971218b97afd7a202f6407849d291772
+  data.tar.gz: 2d4dd5d871d9a7d9f3d64a991adae10fe04e47388a98b491b6fb7cdfb015dbe5b180b60350dd45501dc86c1dc7fa0b9d915ce7055f867b615ceb91afe00f9309

data/README.rst

@@ -0,0 +1,95 @@
+Kameleon appliance builder
+==========================
+
+Kameleon should be seen as a simple but powerful tool to generate customized
+appliances. With Kameleon, you make your recipe that describes how to create
+step by step your own distribution. At start Kameleon is used to create custom
+kvm, LXC, VirtualBox, iso images, ..., but as it is designed to be very generic
+you can probably do a lot more than that.
+
+------------
+Installation
+------------
+
+To install the latest release from `RubyGems`_:
+
+.. _RubyGems: https://rubygems.org/gems/kameleon-builder
+
+::
+
+    gem install kameleon-builder --pre
+
+Or from source:
+
+::
+
+    git clone https://github.com/oar-team/kameleon.git
+    cd kameleon
+    gem build kameleon-builder.gemspec
+    gem install kameleon-builder-<version>.gem
+
+
+-----
+Usage
+-----
+
+Just type
+
+::
+
+    kameleon
+
+...to see the cli help :
+
+::
+
+    Commands:
+      kameleon build [RECIPE_NAME]                        # Builds the appliance from the recipe
+      kameleon checkpoints [RECIPE_NAME]                  # Lists all availables checkpoints
+      kameleon clear [RECIPE_NAME]                        # Cleaning out context and removing all checkpoints
+      kameleon help [COMMAND]                             # Describe available commands or one specific command
+      kameleon new [RECIPE_NAME] -t, --template=TEMPLATE  # Creates a new recipe
+      kameleon templates                                  # Lists all defined templates
+      kameleon version                                    # Prints the Kameleon's version information
+
+    Options:
+          [--no-color]             # Disable colorization in output
+          [--debug]                # Enable debug output
+      -w, [--workspace=WORKSPACE]  # Change the kameleon current work directory. (The folder containing your
+                                   # recipes folder). Default : ./
+
+First, you should select a template. To see the available templates use:
+
+::
+
+    kameleon templates
+
+Then, create a new recipe from the template you've just choose. This will
+create a `recipes` folder in the current directory. (use `-w` option to set a
+different workspace).
+
+::
+
+    kameleon new my_test_recipe -t template_name
+
+Then build your new recipe with the build command:
+
+::
+
+    kameleon build my_test_recipe
+
+A `builds` directory was created and contains your new image!
+
+To go further, it is highly recommended you start with the :doc:`getting_started`
+guide.
+
+------------
+Contributing
+------------
+
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Vagrantfile

@@ -1,15 +1,14 @@
 # -*- mode: ruby -*-
 # vi: set ft=ruby :
 
-ENV['VAGRANT_DEFAULT_PROVIDER'] = 'libvirt'
 
 Vagrant.configure("2") do |config|
   config.vm.box = "debian7-dev"
-  config.vm.box_url = "http://cdn.quicker.fr/vagrant/libvirt/debian7-dev.box"
+  config.vm.box_url = "http://cdn.quicker.fr/vagrant/virtualbox/debian7-dev.box"
   config.vm.hostname = "kameleon-devel"
 
   # Config provider
-  config.vm.provider :libvirt do |vm|
+  config.vm.provider :virtualbox do |vm|
     vm.memory = 2024
     vm.cpus = 2
   end

data/docs/source/conf.py

@@ -50,9 +50,11 @@ copyright = u'%s, Inria.fr' % datetime.datetime.now().year
 # built documents.
 #
 # The short X.Y version.
-version = '2.0.0b1'
-# The full version, including alpha/beta/rc tags.
-release = '2.0.0b1'
+with open(os.path.join(os.path.dirname(__file__), '..', '..',
+          'version.txt')) as init_py:
+    release = init_py.read().strip()
+# The short X.Y version.
+version = release.rstrip('.dev')
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

data/docs/source/faq.rst

@@ -1,3 +1,5 @@
 ---
 FAQ
 ---
+
+Work in progress...

data/docs/source/getting_started.rst

@@ -1,3 +1,6 @@
 ---------------
 Getting Started
 ---------------
+
+
+Work in progress...

data/docs/source/index.rst

@@ -6,6 +6,14 @@
 Welcome to Kameleon's documentation!
 ====================================
 
+
+.. note::
+    This documentation is currently being written...
+
+-----
+About
+-----
+
 Kameleon should be seen as a simple but powerful tool to generate customized
 appliances. With Kameleon, you make your recipe that describes how to create
 step by step your own distribution. At start Kameleon is used to create custom
@@ -13,13 +21,16 @@ kvm, LXC, VirtualBox, iso images, ..., but as it is designed to be very generic
 you can probably do a lot more than that.
 
 
+------------------
+User Documentation
+------------------
+
+
 .. toctree::
     :maxdepth: 2
 
-    why.rst
     installation.rst
     getting_started.rst
-    cli.rst
     recipe.rst
     context.rst
     commands.rst
@@ -28,7 +39,6 @@ you can probably do a lot more than that.
     aliases.rst
     faq.rst
 
-
 Indices and tables
 ==================
 

data/docs/source/installation.rst

@@ -1,3 +1,21 @@
 ------------
 Installation
 ------------
+
+
+To install the latest release from `RubyGems`_:
+
+.. _RubyGems: https://rubygems.org/gems/kameleon-builder
+
+::
+
+    gem install kameleon-builder --pre
+
+Or from source:
+
+::
+
+    git clone https://github.com/oar-team/kameleon.git
+    cd kameleon
+    gem build kameleon-builder.gemspec
+    gem install kameleon-builder-<version>.gem

data/docs/source/recipe.rst

@@ -34,31 +34,31 @@ This is an example of a recipe:
       rootfs: $$kameleon_cwd/rootfs
       user_name: kameleon
       arch: amd64
-    
+
       nbd_device: /dev/nbd10
       container: "$${kameleon_recipe_name}_temp.qcow2"
-    
+
       distrib: debian
       release: wheezy
-    
+
       ## System variables. Required by kameleon engine
       # Include specific steps
       include_steps: [$$distrib/$$release, $$distrib]
-    
+
       # Shell session from where we launch exec_out commands. There is often a
       # local bash session, but it can be a remote shell on other machines or on
       # any shell. (eg. bash, chroot, fakechroot, ssh, tmux, lxc...)
       out_context:
         cmd: bash
         workdir: $$kameleon_cwd
-    
+
       # Shell session that allows us to connect to the building machine in order to
       # configure it and setup additional programs
       default_env: "USER=root HOME=/root LC_ALL=POSIX"
       in_context:
         cmd: $$default_env chroot $$rootfs bash
         workdir: /
-    
+
     #== Bootstrap the new system and create the 'in_context'
     bootstrap:
       - debootstrap:
@@ -73,8 +73,8 @@ This is an example of a recipe:
         - rootfs_archive: $$cachedir/$$distrib/$$release/$$arch/debootstrap.tar.gz
       - start_chroot:
         - rootfs: $$rootfs
-    
-    
+
+
     #== Install and configuration steps
     # WARNING: this part should be independante from the build context (whenever
     # possible...)
@@ -98,7 +98,7 @@ This is an example of a recipe:
         - name: $$user_name
         - group: admin
         - password: $$user_name
-        
+
     #== Export the generated appliance in the format of your choice
     export:
       - save_appliance_from_nbd:

data/lib/kameleon/shell.rb

@@ -167,8 +167,7 @@ module Kameleon
     end
 
     def fork_and_wait
-      process, = fork("inherit")
-      process.wait
+      system(@shell_cmd)
     end
 
     protected

data/lib/kameleon/version.rb

@@ -1,3 +1,4 @@
 module Kameleon
-  VERSION = "2.0.0.dev" unless defined?(::Kameleon::VERSION)
+  VERSION = File.read(
+    File.expand_path("../../../version.txt", __FILE__)).chomp
 end

data/version.txt

@@ -0,0 +1 @@
+2.0.0

metadata

@@ -1,8 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kameleon-builder
 version: !ruby/object:Gem::Version
-  version: 2.0.0.dev
-  prerelease: 6
+  version: 2.0.0
 platform: ruby
 authors:
 - Salem Harrache
@@ -12,12 +11,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-02-14 00:00:00.000000000 Z
+date: 2014-02-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: childprocess
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -25,7 +23,6 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -33,7 +30,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -41,7 +37,6 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -49,7 +44,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: table_print
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -57,7 +51,6 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -65,7 +58,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: log4r-color
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -73,7 +65,6 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -81,7 +72,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -89,7 +79,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -97,7 +86,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: pry-debugger
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -105,7 +93,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -113,7 +100,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -121,7 +107,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -129,7 +114,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -137,7 +121,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -145,7 +128,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: coveralls
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -153,7 +135,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -173,10 +154,9 @@ files:
 - .env
 - .gitignore
 - AUTHORS
-- CHANGELOG
 - COPYING
 - Gemfile
-- README.md
+- README.rst
 - Rakefile
 - Vagrantfile
 - bin/kameleon
@@ -205,7 +185,6 @@ files:
 - docs/source/_static/.gitignore
 - docs/source/aliases.rst
 - docs/source/checkpoint.rst
-- docs/source/cli.rst
 - docs/source/commands.rst
 - docs/source/conf.py
 - docs/source/context.rst
@@ -214,7 +193,6 @@ files:
 - docs/source/index.rst
 - docs/source/installation.rst
 - docs/source/recipe.rst
-- docs/source/why.rst
 - docs/source/workspace.rst
 - kameleon-builder.gemspec
 - lib/kameleon.rb
@@ -263,30 +241,30 @@ files:
 - tests/test_context.rb
 - tests/test_recipe.rb
 - tests/test_version.rb
+- version.txt
 homepage: http://kameleon.readthedocs.org/
 licenses:
 - GPL-2
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>'
+  - - '>='
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.22
+rubygems_version: 2.1.11
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Kameleon is a tool to build virtual machines from scratch
 test_files:
 - tests/helper.rb

data/CHANGELOG

@@ -1,36 +0,0 @@
-KAMELEON CHANGELOG
-==================
-
-1.2.9: (unreleased)
-------
-  - debian/system_config: the keyboard layout is now defined by the one used on
-    the build system.
-
-1.2.8:
-------
-  - Closes the bash session and wait 1 second before starting the cleaning
-    script even if not interrupted.
-  - Some modifications in the kameleon appliance recipe.
-
-1.2.7:
-------
-  - Add a new step 'build_appliance_kpartx' for build appliance that use kpartx
-    instead of kvm-nbd (speed up the copy)
-  - 'build_appliance_kpartx': the rsync *never* copy /proc
-  - Add a new step 'chroot_in_tmpfs' to put the chroot in tmpfs at the beginning
-  - Fix a bug in the path searching for the recipes/steps
-  - Closes the bash session and wait 1 second before starting the cleaning script.
-
-1.2.6:
-------
-  - Add the possibility to include steps/recipes path with the option '-i'
-  - "checkpoint_resume" copy the resolv.conf
-
-1.2.4:
-------
-  - Remove the rubygem dependency (the package ruby-session exist now in debian)
-
-1.2.2:
-------
-  - Now support contexts (see example into debian.yaml recipe)
-  - New "exec_on_clean" microstep command to ease cleaning (reverse order execution)

data/README.md

@@ -1,53 +0,0 @@
-# Kameleon
-
-Kameleon should be seen as a simple but powerful tool to generate customized
-appliances. With Kameleon, you make your recipe that describes how to create
-step by step your own distribution. At start Kameleon is used to create custom
-kvm, LXC, VirtualBox, iso images, ..., but as it is designed to be very
-generic you can probably do a lot more than that.
-
-## Installation
-Simply install it from the Gem repository (not working yet):
-
-    gem install kameleon
-
-Or from source:
-
-    git clone git://scm.gforge.inria.fr/kameleon/kameleon.git
-    cd kameleon
-    gem build kameleon.gemspec
-    gem install kameleon-<version>.gem
-
-## Usage
-
-Just type:
-
-    kameleon
-
-## Quick start
-
-First, you should select a template. To see the available templates use:
-
-    kameleon templates
-
-Then, create a new recipe from the template you've just choose. This will
-create a `recipes` folder in the current directory. (use `-w` option to set a
-different workspace).
-
-    kameleon new my_test_recipe -t template_name
-
-Then build your new recipe with the build command:
-
-    kameleon build my_test_recipe
-
-A `builds` directory was created and contains your new image!
-
-To go further, get more documentation in the docs folder.
-
-## Contributing
-
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request

data/docs/source/cli.rst

@@ -1,3 +0,0 @@
-----------------------
-Command-line interface
-----------------------

data/docs/source/why.rst

@@ -1,3 +0,0 @@
---------------
-Why Kameleon ?
---------------