Skip to content

Latest commit

 

History

History
65 lines (43 loc) · 2.37 KB

definition.md

File metadata and controls

65 lines (43 loc) · 2.37 KB
Raw

Veewee definition

Creating a definition

A definition is created by 'cloning' a template.

To create a definition you use the 'define' subcommand:

veewee vbox define 'myubuntu' 'ubuntu-10.10-server-amd64'

If you want to use an external repo for the definition you can specify a git-url

veewee vbox define 'myubuntu' 'git://github.com/jedi4ever/myubuntu'

Modifying a definition

Definitions are stored under a directory 'definitions' relative to the current directory.

<currentdir>
|- <definitions>
|   |--myubuntu
|      |-- definition.rb
|      |-- <preseed.cfg,kickstart.cfg,....>
       |-- base.sh
       |-- ....sh
       |-- ruby.sh
       |-- chef.sh
       |-- puppet.sh
       |-- virtualbox.sh
       |-- ...sh
       |-- cleanup.sh

The file 'definition.rb' contains all the parameters to define the machine to be build:

  • memorysize
  • number of cpus
  • user account and password
  • sudo command
  • shutdown command
  • URL and checksum to download the ISO
  • ....

When a new boots, it will typically fetch it's initial configuration file over http from a preseed.cfg, kickstart, ... file

Once the initial installation is done, veewee will log in to the sytem and starts executing the 'shell files'

The main reason for splitting up the postinstall.sh we used to have, it to make the script parts reusable for different virtualization systems: f.i. no need to install virtualbox guest additions on kvm or vmware fusion.

Changes between v0.2 -> v0.3

The 'Veewee::Session.declare' is now deprecated and you should use 'Veewee::Definition.declare'

'Postinstall_files' prefixed with an underscore are not executed but can be toggled with the --include, --exclude with the command. This allows you to insert different ruby.sh scripts, disable the installation of puppet, etc...

The default user of definitions is now 'veewee' and not 'vagrant'. This is because on other virtualizations like fusion and kvm, there is not relationship with the 'vagrant'. Users 'vagrant' are created by the 'vagrant.sh' script and not by the preseed or kickstart.

Using ERB in files

Add '.erb' to your files in a definition and they will get rendered (useful for generting kickstart,postinstall) (thx @mconigilaro)

Listing existing definitions

veewee vbox list

Removing a definition

veewee vbox undefine 'myubuntu'