Cross-platform instance initialization
Go to file
Alessandro Pilotti 414fd1116c Adds ADSI based Windows user management
Replaces the Windows user creation and password management
implementation from "NET USER" execution to ADSI COM usage.

Change-Id: I4f95b094c95abb11762943afdb4be26541493159
Closes-Bug: #1404533
2014-12-21 23:58:02 +01:00
cloudbaseinit Adds ADSI based Windows user management 2014-12-21 23:58:02 +01:00
doc/source Fixes requirements on Linux 2014-10-05 22:20:58 +03:00
.gitattributes Normalize line endings 2014-02-09 21:41:45 +02:00
.gitignore Initial commit 2012-12-01 23:50:15 +02:00
.gitreview Adds .gireview file 2014-10-05 22:45:08 +03:00
.testr.conf Fixes requirements on Linux 2014-10-05 22:20:58 +03:00
LICENSE Adds LICENSE file 2013-10-04 00:07:58 +03:00
README.rst Update README.rst 2014-07-23 13:56:36 +03:00
openstack-common.conf Updates oslo-incubator files to the current master 2014-02-10 05:41:31 +02:00
requirements-windows.txt Updates pbr requirements 2014-12-21 23:37:53 +01:00
requirements.txt Updates pbr requirements 2014-12-21 23:37:53 +01:00
setup.cfg Updates pbr requirements 2014-12-21 23:37:53 +01:00
setup.py Updates pbr requirements 2014-12-21 23:37:53 +01:00
test-requirements.txt Fixes requirements on Linux 2014-10-05 22:20:58 +03:00
tox.ini Adds tox.ini 2014-09-10 12:57:37 +03: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

Binaries

The following x64 and x86 builds are automatically generated by a Jenkins job at every commit:

https://www.cloudbase.it/downloads/CloudbaseInitSetup_Beta_x64.msi https://www.cloudbase.it/downloads/CloudbaseInitSetup_Beta_x86.msi

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_sysnative

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: #!