OpenNebula Linux VM Contextualization.

Go to file

Petr Ospalý 45a8bdb39b B #231 : Workaround the mawk issue on Debian The default 'awk' _alternative_ on the Debian is an old mawk of version 1.3.3 with plenty of bugs and problems. One of them is the lack of support for POSIX regex character classes which old mawk does not know despite the fact that it does advertise a support for extended regex (as egrep for example). This was reported and fixed in 2009 with version of 1.3.4 but Debian is still using the old unfixed version 1.3.3: https://bugs.launchpad.net/ubuntu/+source/mawk/+bug/69724 This commit workaround this issue by simple test and possible abort if the usage of an incompatible awk implementation is unreasonable - user choice. Note: Currently just only two optional (non-default) tests are skipped due to this issue. Signed-off-by: Petr Ospalý <pospaly@opennebula.io>		4 years ago
.github	Revert "M #-: GHA ignore growpart script"	4 years ago
pkg	B #83 : Fix RH postinstall	4 years ago
src	B #231 : Workaround the mawk issue on Debian	4 years ago
.gitignore	Import of the Alpine scripts	7 years ago
LICENSE	Move context packages to its own repository	11 years ago
PKGBUILD	Restructure, logging, initial systemd support, pre/post network scripts	8 years ago
README.md	M #-: Updated tested platforms	4 years ago
generate-all.sh	M #-: Bump version to 6.1.80, drop ec2 targets	4 years ago
generate.sh	M #-: Bump version to 6.1.80, drop ec2 targets	4 years ago
one-context.install	Remove Arch from postinstall and added PKGBUILD and one-context.install	9 years ago
targets.sh	F #-: debian: add ifupdown2 support	4 years ago

README.md

OpenNebula Linux VM Contextualization

Description

This addon provides contextualization packages for the Linux (and, other Unix-like) guest virtual machines running in the OpenNebula cloud. Based on the provided contextualization parameters, the packages prepare the networking in the running guest virt. machine, configure SSH keys, set passwords, run custom start scripts, and many others.

Download

Latest versions can be downloaded from the release page. Check the supported OpenNebula versions for each release.

Install

Documentation on packages installation and guest contextualization can be found in the latest stable OpenNebula Operation Guide. For beta releases, refer to the latest development documentation.

Tested platforms

List of tested platforms only:

Platform	Versions
AlmaLinux	8
Alpine Linux	3.10, 3.11, 3.12, 3.13
ALT Linux	p9, Sisyphus
Amazon Linux	2
CentOS	7, 8, 8 Stream
Debian	8, 9, 10
Devuan	2
Fedora	32, 33
FreeBSD	11, 12
openSUSE	15, Tumbleweed
Oracle Linux	7, 8
Red Hat Enterprise Linux	7, 8
Ubuntu	14.04, 16.04, 18.04, 20.04, 20.10

(the packages might work on other versions or flavours, but those aren't tested)

Build own package

Packages for each release for supported guests are available in the release page. Also, any version can be built by the scripts provided in this repository.

Requirements

Linux host
Ruby >= 1.9
gem fpm >= 1.10.0
dpkg utils for deb package creation
rpm utils for rpm package creation

Steps

The script generate.sh is able to create all package types and can be configured to include more files in the package or change some of its parameters. Package type and content are configured by the env. variable TARGET, the corresponding target must be defined in target.sh. Target describes the package format, name, dependencies, and files. Files are selected by the tags. Set of required tags is defined for the target (in targets.sh), each file has a list of corresponding tags right in its filename (divided by the regular name by 2 hashes ##, dot-separated).

Package name or version can be overridden by env. variables NAME and VERSION.

Examples:

$ TARGET=deb ./generate.sh
$ TARGET=el7 NAME=my-one-context ./generate.sh
$ TARGET=alpine ./generate.sh
$ TARGET=freebsd VERSION=5.7.85 ./generate.sh

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

Check generate.sh for general package metadata and targets.sh for the list of targets and their metadata. Most of the parameters can be overriden by the appropriate environment variable.

Development

To contribute bug patches or new features, you can use the github Pull Request model. It is assumed that code and documentation are contributed under the Apache License 2.0.

More info:

How to Contribute
Support: OpenNebula user forum
Development: OpenNebula developers forum
Issues Tracking: Github issues (https://github.com/OpenNebula/addon-context-linux/issues)

Repository structure

All code is located under src/ and structure follows the installation directory structure. Files for different environments/targets are picked by the tag, tags are part of the filename separated from the installation name by 2 hashes (##). Tags are dot-separated.

Examples:

script - non-tagged file for all targets
script##systemd - file tagged with systemd
script##systemd.rpm - file tagged with systemd and rpm

Contextualization scripts

Contextualization scripts, which are executed on every boot and during the reconfiguration, are located in src/etc/one-context.d/. Scripts are divided into following 2 parts:

local - pre-networking, prefixed with loc-
post-networking, prefixed with net-

All other scripts, which are not prefixed with loc- or net-, are executed as a first during the post-networking contextualization stage.

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.