Cross-platform instance initialization

Go to file

Alessandro Pilotti dfbf133aee Adds serial port logging support Adds serial port logging to improve troubleshooting. Serial port settings are confugurable with the option: "logging_serial_port_settings"		2014-02-09 20:41:39 +02:00
cloudbaseinit	Adds serial port logging support	2014-02-09 20:41:39 +02:00
tools	Python requirements added	2012-12-02 02:34:12 +02:00
.gitignore	Initial commit	2012-12-01 23:50:15 +02:00
LICENSE	Adds LICENSE file	2013-10-04 00:07:58 +03:00
openstack-common.conf	Initial commit	2012-12-01 23:50:15 +02:00
README.rst	Update README.rst	2013-12-19 04:27:28 +02:00
setup.py	Updates version to 0.9.5	2014-01-20 01:07:20 +02:00

README.rst

Portable OpenStack Cloud Initialization Service

The main goal of this project is to bring the benefits of cloud-init to guests running a wide range of OSs. The first release provides support for Windows OSs, but due to the modular and decoupled architecture of the service, plugins for any OS can be easily added.

The features available with the first release include HTTP and ConfigDriveV2 metadata services and plugins for: hostname, user creation, group membership, static networking, SSH user's public keys, user_data custom scripts running in various shells (CMD.exe / Powershell / bash)

There's no limitation in the type of supported Hypervisor. This service can be used on instances running on Hyper-V, KVM, Xen, ESXi, etc

Documentation, support and contacts: http://www.cloudbase.it

Metadata services

A metadata service has the role of pulling the metadata configuration information. ConfigDriveV2 and HTTP are supported out of the box, but other sources can be easily added.

Plugins

Plugins execute actions based on the metadata obtained by the service.

Currently the following plugins have been implemented for the Windows OS:

cloudbaseinit.plugins.windows.sethostname.SetHostNamePlugin

Sets the instance's hostname

cloudbaseinit.plugins.windows.createuser.CreateUserPlugin

Creates / updates a user setting the password provided in the metadata (admin_pass) if available. The user is then added to a set of provided local groups. The following configuration parameters control the behaviour of this plugin:

username default: Admin

groups Comma separated list of groups. Default: Administrators

inject_user_password Can be set to false to avoid the injection of the password provided in the metadata. Default: True

cloudbaseinit.plugins.windows.networkconfig.NetworkConfigPlugin

Configures static networking.

network_adapter Network adapter to configure. If not specified, the first available ethernet adapter will be chosen. Default: None

cloudbaseinit.plugins.windows.sshpublickeys.SetUserSSHPublicKeysPlugin

Creates an "authorized_keys" file in the user's home directory containing the SSH keys provided in the metadata. Note: on Windows a SSH service needs to be installed to take advantage of this feature.

cloudbaseinit.plugins.windows.userdata.UserDataPlugin

Executes custom scripts provided with the user_data metadata as plain text or compressed with Gzip.

Supported formats:

Windows batch

The file is executed in a cmd.exe shell (can be changed with the COMSPEC environment variable). The user_data first line must be: rem cmd

Powershell

Scripting is automatically enabled if not set (RemoteSigned). The user_data first line must be: #ps1

Bash A bash shell needs to be installed in the system and available in the PATH in order to use this feature. The user_data first line must start with: #!