Charm Interface - Service Control

Go to file

Liam Young bf401a2a27 Update README		2016-08-31 11:00:53 +00:00
README.md	Update README	2016-08-31 11:00:53 +00:00
__init__.py	Initial commit	2016-08-31 07:25:48 +00:00
copyright	Switch to service-control	2016-08-31 10:42:05 +00:00
interface.yaml	Switch to service-control	2016-08-31 10:42:05 +00:00
requires.py	Switch to service-control	2016-08-31 10:42:05 +00:00

Overview

This interface is used for a charm to request a restart of a service managed by another charm.

Usage

The interface provides the service-control.connected state.

Requesting a restart of all remote services:

@reactive.when('service-control.connected')
def configure(service_control):
    ...
    service_control.request_restart()

Requesting a restart of a specific type of remote services:

@reactive.when('service-control.connected')
def configure(service_control):
    ...
    service_control.request_restart(service_type='neutron')

To consume this interface in your charm or layer, add the following to layer.yaml:

includes: ['interface:service-control']

and add a provides interface of type service-control to your charm or layers metadata.yaml eg:

requires:
  neutron-control:
    interface: service-control

Please report bugs on Launchpad.

For development questions please refer to the OpenStack Charm Guide.