Package buildbot :: Module libvirtbuildslave :: Class LibVirtSlave

Class LibVirtSlave

       config.ReconfigurableServiceMixin --+        
                                           |        
                twisted.spread.pb.Avatar --+        
                                           |        
 twisted.application.service.Service --+   |        
                                       |   |        
twisted.application.service.MultiService --+        
                                           |        
               buildslave.AbstractBuildSlave --+    
                                               |    
             buildslave.AbstractLatentBuildSlave --+
                                                   |
                                                  LibVirtSlave

Instance Methods

__init__(self, name, password, connection, hd_image, base_image=None, xml=None, max_builds=None, notify_on_missing=[], missing_timeout=1200, build_wait_timeout=600, properties={}, locks=None) source code

canStartBuild(self)
I am called when a build is requested to see if this buildslave can start a build.

source code

start_instance(*args, **kwargs)
I start a new instance of a VM.

source code

stop_instance(self, fast=False)
I attempt to stop a running VM.

source code

Inherited from buildslave.AbstractLatentBuildSlave: __provides__, attached, buildFinished, buildStarted, detached, disconnect, insubstantiate, sendBuilderList, stopService, substantiate, updateSlave

Inherited from buildslave.AbstractBuildSlave: __repr__, acquireLocks, addSlaveBuilder, doKeepalive, findNewSlaveInstance, getPerspective, isConnected, locksAvailable, maybeShutdown, messageReceivedFromSlave, perspective_keepalive, perspective_shutdown, reconfigService, releaseLocks, removeSlaveBuilder, setServiceParent, shutdown, startKeepaliveTimer, startMissingTimer, startService, stopKeepaliveTimer, stopMissingTimer, subscribeToDetach, updateLocks, updateSlaveStatus

Inherited from config.ReconfigurableServiceMixin: __providedBy__

Inherited from twisted.spread.pb.Avatar: perspectiveMessageReceived

Inherited from twisted.application.service.MultiService: __iter__, addService, getServiceNamed, privilegedStartService, removeService

Inherited from twisted.application.service.Service: __getstate__, disownServiceParent, setName

Class Variables

Inherited from buildslave.AbstractLatentBuildSlave: __implemented__, build_wait_timer, insubstantiating, substantiated, substantiation_build, substantiation_deferred

Inherited from buildslave.AbstractBuildSlave: keepalive_interval, keepalive_timer, reconfig_priority

Inherited from twisted.application.service.Service: name, parent, running

Method Details

init(self, name, password, connection, hd_image, base_image=None, xml=None, max_builds=None, notify_on_missing=`[]`, missing_timeout=1200, build_wait_timeout=600, properties=`{}`, locks=None)
(Constructor)

source code

Parameters:

name - botname this machine will supply when it connects
password - password this machine will supply when it connects
max_builds - maximum number of simultaneous builds that will be run concurrently on this buildslave (the default is None for no limit)
properties - properties that will be applied to builds run on this slave
locks - A list of locks that must be acquired before this slave can be used

Overrides: twisted.application.service.MultiService.__init__

canStartBuild(self)

source code

I am called when a build is requested to see if this buildslave can start a build. This function can be used to limit overall concurrency on the buildslave.

Note for subclassers: if a slave can become willing to start a build without any action on that slave (for example, by a resource in use on another slave becoming available), then you must arrange for maybeStartBuildsForSlave to be called at that time, or builds on this slave will not start.

Overrides: buildslave.AbstractBuildSlave.canStartBuild: (inherited documentation)

start_instance(*args, **kwargs)

source code

I start a new instance of a VM.

If a base_image is specified, I will make a clone of that otherwise i will use image directly.

If i'm not given libvirt domain definition XML, I will look for my name in the list of defined virtual machines and start that.

Decorators:

@defer.inlineCallbacks

Overrides: buildslave.AbstractLatentBuildSlave.start_instance

stop_instance(self, fast=False)

source code

I attempt to stop a running VM. I make sure any connection to the slave is removed. If the VM was using a cloned image, I remove the clone When everything is tidied up, I ask that bbot looks for work to do

Overrides: buildslave.AbstractLatentBuildSlave.stop_instance

Class LibVirtSlave

__init__(self, name, password, connection, hd_image, base_image=None, xml=None, max_builds=None, notify_on_missing=[], missing_timeout=1200, build_wait_timeout=600, properties={}, locks=None) (Constructor)

canStartBuild(self)

start_instance(*args, **kwargs)

stop_instance(self, fast=False)

init(self, name, password, connection, hd_image, base_image=None, xml=None, max_builds=None, notify_on_missing=`[]`, missing_timeout=1200, build_wait_timeout=600, properties=`{}`, locks=None)
(Constructor)