cloudinstall Package¶

`cloudinstall` Package¶

Ubuntu Openstack Installer

`charms` Module¶

`config` Module¶

`ev` Module¶

`gui` Module¶

`log` Module¶

Logging interface

class cloudinstall.log.PrettyLog(obj)[source]

cloudinstall.log.setup_logger(name='cloudinstall.log', headless=False)[source]

setup logging

Overridding the default log level(debug) can be done via an environment variable UCI_LOGLEVEL

Available levels:

CRITICAL
ERROR
WARNING
INFO
DEBUG

Note

This filters only cloudinstall logging info. Set your environment var to UCI_NOFILTER to see debugging log statements from imported libraries (ie macumba)

# Running cloud-status from cli
$ UCI_LOGLEVEL=INFO openstack-status

# Disable log filtering
$ UCI_NOFILTER=1 openstack-status

Params str name:
	logger name
Returns:	a log object

`machine` Module¶

class cloudinstall.machine.Machine(machine_id, machine)[source]¶

Base machine class

arch¶

Return architecture

Returns:	architecture type
Return type:	str

container(container_id)[source]¶

Inspect a container

Parameters:	container_id (int) – lxc container id
Returns:	Returns a dictionary of the container information for specific machine and lxc id.
Return type:	dict

containers¶

Return containers for machine

Return type:	generator

cpu_cores¶

Return number of cpu-cores

Returns:	number of cpus
Return type:	str

hardware(spec)[source]¶

Get hardware information

Parameters:	spec (str) – a hardware specification
Returns:	hardware of spec
Return type:	str

instance_id¶

Returns InstanceId

Returns:	instance ID
Return type:	str

mem¶

Return memory

Returns:	memory size
Return type:	str

storage¶

Return storage

Returns:	storage size
Return type:	str

`service` Module¶

Represents a Juju service

exception cloudinstall.service.JujuUnitNotFoundException[source]¶

Bases: exceptions.Exception

Unable to find a matching Unit

class cloudinstall.service.Relation(relation_name, charms)[source]¶

Relation class

is_relation(charm)[source]¶: Is a charm already related?

class cloudinstall.service.Service(service_name, service)[source]¶

Service class

relation(name)[source]¶

Single relation entry

Params str name:
	name of relation
Returns:	a Relation entry
Return type:	Relation()

relations¶

Service relations

Returns:	iterator of relations for service
Return type:	Relation()

unit(name)[source]¶

Single unit entry

Params str name:
	name of unit
Returns:	a Unit entry
Return type:	Unit()

units¶

Service units

Returns:	iterator of associated units for service
Return type:	Unit()

class cloudinstall.service.Unit(unit_name, unit)[source]¶

Unit class

agent_state¶

Unit’s agent state

Returns:	agent state
Return type:	str

agent_state_info¶

Gets unit state info

Usually prints a error message if unit failed to deploy :returns: error :rtype: str

extended_agent_state¶

is_cloud_controller¶

Is machine housing the cloud-controller?

Returns:	True/False
Return type:	bool

is_compute¶

Is machine a compute node?

Returns:	True/False
Return type:	bool

is_horizon¶

Is machine housing the dashboard?

Returns:	True/False
Return type:	bool

is_jujugui¶

Is machine juju-gui?

Returns:	True/False
Return type:	bool

machine_id¶

Associate machine for unit

Returns:	machine id
Return type:	str

public_address¶

Public address of unit

Returns:	address of unit
Return type:	str

workload¶

workload_info¶

workload_state¶

`netutils` Module¶

`utils` Module¶

`juju` Module¶

`maas` Module¶

`task` Module¶

`state` Module¶

class cloudinstall.state.CharmState[source]

Bases: enum.Enum

Charm relation states

CONFLICTED = 2

OPTIONAL = 1

REQUIRED = 0

class cloudinstall.state.ControllerState[source]

Bases: enum.IntEnum

Names for current screen state

ADD_SERVICES = 3

INSTALL_WAIT = 0

PLACEMENT = 1

SERVICES = 2

class cloudinstall.state.InstallState[source]

Bases: enum.IntEnum

NODE_WAIT = 1

RUNNING = 0

cloudinstall Package¶