service¶

Generic Node base class for all workers that run on hosts.

class oslo_service.service.Launcher(conf, restart_method='reload')¶

Bases: object

Launch one or more services and wait for them to complete.

launch_service(service, workers=1)¶

Load and start the given service.

Parameters:	service – The service you would like to start, must be an instance of oslo_service.service.ServiceBase workers – This param makes this method compatible with ProcessLauncher.launch_service. It must be None, 1 or omitted.
Returns:	None

restart()¶

Reload config files and restart service.

Returns:	The return value from reload_config_files or mutate_config_files, according to the restart_method.

stop()¶

Stop all services which are currently running.

Returns:	None

wait()¶

Wait until all services have been stopped, and then return.

Returns:	None

class oslo_service.service.ProcessLauncher(conf, wait_interval=0.01, restart_method='reload')¶

Bases: object

Launch a service with a given number of workers.

handle_signal()¶

Add instance’s signal handlers to class handlers.

launch_service(service, workers=1)¶

Launch a service with a given number of workers.

Parameters:	service – a service to launch, must be an instance of oslo_service.service.ServiceBase workers – a number of processes in which a service will be running

stop()¶

Terminate child processes and wait on each.

wait()¶

Loop waiting on children to die and respawning as necessary.

class oslo_service.service.Service(threads=1000)¶

Bases: oslo_service.service.ServiceBase

Service object for binaries running on hosts.

reset()¶

Reset a service in case it received a SIGHUP.

start()¶

Start a service.

stop(graceful=False)¶

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 oslo_service.service.ServiceBase¶

Bases: object

Base class for all services.

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.

class oslo_service.service.ServiceLauncher(conf, restart_method='reload')¶

Bases: oslo_service.service.Launcher

Runs one or more service in a parent process.

handle_signal()¶

Set self._handle_signal as a signal handler.

wait()¶

Wait for a service to terminate and restart it on SIGHUP.

Returns:	termination status

exception oslo_service.service.SignalExit(signo, exccode=1)¶

Bases: SystemExit

oslo_service.service.launch(conf, service, workers=1, restart_method='reload')¶

Launch a service with a given number of workers.

Parameters:	conf – an instance of ConfigOpts service – a service to launch, must be an instance of oslo_service.service.ServiceBase workers – a number of processes in which a service will be running restart_method – Passed to the constructed launcher. If ‘reload’, the launcher will call reload_config_files on SIGHUP. If ‘mutate’, it will call mutate_config_files on SIGHUP. Other values produce a ValueError.
Returns:	instance of a launcher that was used to launch the service

oslo_service.service.list_opts()¶

Entry point for oslo-config-generator.