The apmec.service Module¶

class apmec.service.ApmecApiService(app_name)¶

Bases: apmec.service.WsgiService

Class for apmec-api service.

classmethod create(app_name='apmec')¶

class apmec.service.Service(host, binary, topic, manager, report_interval=None, periodic_interval=None, periodic_fuzzy_delay=None, *args, **kwargs)¶

Bases: apmec.common.rpc.Service

Service object for binaries running on hosts.

A service takes a manager and enables rpc by listening to queues based on topic. It also periodically runs tasks on the manager.

classmethod create(host=None, binary=None, topic=None, manager=None, report_interval=None, periodic_interval=None, periodic_fuzzy_delay=None)¶

Instantiates class and passes back application object.

Parameters:	host – defaults to cfg.CONF.host binary – defaults to basename of executable topic – defaults to bin_name - ‘apmec-‘ part manager – defaults to cfg.CONF.<topic>_manager report_interval – defaults to cfg.CONF.report_interval periodic_interval – defaults to cfg.CONF.periodic_interval periodic_fuzzy_delay – defaults to cfg.CONF.periodic_fuzzy_delay

kill()¶

Destroy the service object.

periodic_tasks(raise_on_error=False)¶

Tasks to be run at a periodic interval.

report_state()¶

Update the state of this service.

reset()¶

Reset a service in case it received a SIGHUP.

start()¶

Start a service.

stop()¶

Stop a service.

Parameters:	graceful – indicates whether to wait for all threads to finish or terminate them instantly

wait()¶

Wait for a service to shut down.

class apmec.service.WsgiService(app_name)¶

Bases: oslo_service.service.ServiceBase

Base class for WSGI based services.

For each api you define, you must also define these flags: :<api>_listen: The address on which to listen :<api>_listen_port: The port on which to listen

reset()¶

Reset service.

Called in case service running in daemon mode receives SIGHUP.

start()¶

Start service.

stop()¶

Stop service.

wait()¶

Wait for service to complete.

apmec.service.config_opts()¶

apmec.service.serve_wsgi(cls)¶