Files
charm-interface-bind-rndc/README.md
James Page dc26f9a155 Add support for verification process
Add required configuration files and generally update the interface
after move to OpenStack git/gerrit.

Also add required copyright and README files to ensure that basic
linting in UOSCI passes.

Change-Id: Ie1a9c801844e4acd0a7e16c9dc1e251cbcd36fc5
2016-07-08 13:56:48 +01:00

1.5 KiB

Overview

This interface supports integration with BIND using RNDC keys.

Usage

No explicit handler is required to consume this interface in charms that consume this interface.

metadata

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

includes: ['interface:bind-rndc']

and add a requires interface of type bind-rndc to your charm or layers metadata.yaml:

requires:
  dns-backend:
    interface: bind-rndc

state: {relation_name}.connected

This state is set when a relation of type bind-rndc is detected, but the data may not have yet been presented by the providing charm.

state: {relation_name}.available

This state is set when the providing application unit has set all required data items on the interface.

The interface provides implicit bindings for:

  • algorithm - RNDC algorithm to use.
  • rndckey - key to use to secure RNDC commands.
  • private_address - address of providing application unit.

handler

@when('dns-backend.available')
def sync_zones(bind_interface):
    sync_all_zones(bind_interface.private_address,
                   bind_interface.algorithm,
                   bind_interface.rndckey)

In this case, sync_all_zones is a function provided by the consuming charm.

Bugs

Please report bugs on Launchpad.

For development questions please refer to the OpenStack Charm Guide.