1
0
mirror of https://github.com/OpenNebula/one.git synced 2024-12-22 13:33:52 +03:00
one/share/scripts/context-packages
2013-11-15 14:32:03 +01:00
..
base/etc Merge branch 'feature-2391' into one-4.4 2013-11-12 22:52:14 +01:00
base_deb/etc/one-context.d bug #2269: get IPV6 and IP6 in context packages 2013-08-21 15:29:04 +02:00
base_rpm/etc/one-context.d bug #2269: get IPV6 and IP6 in context packages 2013-08-21 15:29:04 +02:00
generate.sh Bump to version 4.3.85 2013-11-15 14:32:03 +01:00
postinstall Fix context scripts to use native commands to register services 2013-07-11 15:56:22 +02:00
README.md feature #1452: add contextualization packages generator 2012-09-10 16:48:38 +02:00
SConstruct Update copyright notice 2013-01-24 16:18:30 +01:00

Here are located the files needed to generate OpenNebula contextualization packages. The packages generated contain these files:

  • /etc/udev/rules.d/* These files disable the udev network an cdrom generation
  • /etc/init.d/vmcontext This is the startup script that will try to mount context cdrom, load contextualizaton variables, call scripts in the contextualization scripts directory and call init.sh if it exists in the context cd.
  • /etc/one-context.d/* This directory holds the scripts that will be called by vmcontext script. They should be named starting with a number so they are called in order.

By default only the network configuration context script is included in the packages. These scripts are different for rpm and deb based distributions and are located in base_<deb|rpm> directories.

The packages also have a post-install script that does this steps:

  • Delete persistent cd and net rules from /etc/udev/rules.d
  • Links vmcontext script to /etc/rc.d
  • Deletes network configuration files

GENERATOR

Requirements

  • Ruby >= 1.8.7
  • gem fpm
  • dpkg utils for deb package creation
  • rpm utils for rpm package creation

On Ubuntu/Debian you can install the package rpm and you will be able to generate both rpm and deb packages.

Description

The script generator.sh generates both deb and rpm packages and can be configured to include more files in the package or change some of its parameters.

On start it creates a temporary directory and copies there:

  • base directory
  • base_<deb|rpm> directory
  • Any file or directory from the arguments.

Then these files are included in the package

Usage

The default parameters to create a package are as follows:

VERSION=1.0.1
MAINTAINER=C12G Labs <support@c12g.com>
LICENSE=Apache
PACKAGE_NAME=one-context
VENDOR=C12G Labs
DESCRIPTION="
This package prepares a VM image for OpenNebula:
  * Disables udev net and cd persistent rules
  * Deletes udev net and cd persistent rules
  * Unconfigures the network
  * Adds OpenNebula contextualization scripts to startup

To get support use the OpenNebula mailing list:
  http://opennebula.org/community:mailinglists
"
PACKAGE_TYPE=deb
URL=http://opennebula.org

You can change any parameter setting an environment variable with the same name. For example, to generate an rpm package with a different package name:

$ PACKAGE_TYPE=rpm PACKAGE_NAME=my-context ./generate.sh

You can also include new files. This is handy to, for example, include new scripts executed to contextualize an image. For example, we can have an script that install a user ssh key. We will create the file hierarchy that will go inside the package in a directory:

$ mkdir -p ssh/etc/one-context.d
$ cp <our-ssh-script> ssh/etc/one-context.d/01-ssh-key
$ ./generate.sh ssh/etc

NOTE: The generator must be executed from the same directory it resides.