metalsmith.instance_config module¶

class metalsmith.instance_config.CloudInitConfig(ssh_keys=None, user_data=None)¶

Bases: metalsmith.instance_config.GenericConfig

Configuration of the target instance using cloud-init.

Compared to GenericConfig, this adds support for managing users.

Variables:	ssh_keys – List of SSH public keys. user_data – Cloud-init script as a dictionary. users – Users to add on first boot.

add_user(name, admin=True, password_hash=None, sudo=False, **kwargs)¶

Add a user to be created on first boot.

Parameters:	name – user name. admin – whether to add the user to the admin group (wheel). password_hash – user password hash, if password authentication is expected. sudo – whether to allow the user sudo without password. kwargs – other arguments to pass.

populate_user_data()¶

Get user data for this configuration.

Takes the custom user data and appends requested users to it.

Returns:	user data as a string.

class metalsmith.instance_config.GenericConfig(ssh_keys=None, user_data=None)¶

Bases: object

Configuration of the target instance.

The information attached to this object will be passed via a configdrive to the instance’s first boot script (e.g. cloud-init).

This class represents generic configuration compatible with most first-boot implementations. Use CloudInitConfig for features specific to cloud-init.

Variables:	ssh_keys – List of SSH public keys. user_data – User data as a string.

generate(node, hostname=None)¶

Generate the config drive information.

Parameters:	node – Node object. hostname – Desired hostname (defaults to node’s name or ID).
Returns:	configdrive contents as a dictionary with keys: meta_data meta data dictionary user_data user data as a string

populate_user_data()¶

Get user data for this configuration.

Can be overridden to provide additional features.

Returns:	user data as a string.