History

Corey Bryant 13211f092c Add Kinetic and Zed support * sync charm-helpers to classic charms * change openstack-origin/source default to zed * align testing with zed * add new zed bundles * add zed bundles to tests.yaml * add zed tests to osci.yaml and .zuul.yaml * update build-on and run-on bases * add bindep.txt for py310 * sync tox.ini and requirements.txt for ruamel * use charmcraft_channel 2.0/stable * drop reactive plugin overrides * move interface/layer env vars to charmcraft.yaml Change-Id: I2c98ab0f82aa6d6d0a43365cee04d6da34a39ce4		2022-08-31 19:57:31 +01:00
..
files	Sync charm/ceph helpers, tox, and requirements	2019-10-01 12:57:32 -05:00
lib/charm	Add NRPE service checks for upstream DNS	2022-04-15 15:25:57 -04:00
reactive	Disable designate-mdns service until the configuration has been rendered	2022-07-18 13:35:00 +00:00
templates	Merge "Allow Set managed_resource_email on designate config."	2021-09-04 03:02:53 +00:00
tests	Add Kinetic and Zed support	2022-08-31 19:57:31 +01:00
README.md	Streamline README for policy overrides	2020-01-09 12:11:34 -05:00
config.yaml	Add Kinetic and Zed support	2022-08-31 19:57:31 +01:00
icon.svg	Update charm icon	2017-08-02 18:36:38 +01:00
layer.yaml	Add NRPE checks for services	2021-08-26 11:18:24 +02:00
metadata.yaml	Add Kinetic and Zed support	2022-08-31 19:57:31 +01:00
test-requirements.txt	Update to build using charmcraft	2022-02-01 19:55:42 +00:00
tox.ini	Add xena bundles	2021-09-28 18:18:17 +00:00
wheelhouse.txt	Updates to flip all libraries back to master	2021-05-03 16:04:20 +01:00

README.md

Overview

This charm provides Designate (DNSaaS) for an OpenStack Cloud.

Usage

Designate relies on services from the mysql, rabbitmq-server and keystone charms:

juju deploy designate
juju deploy mysql
juju deploy rabbitmq-server
juju deploy keystone
juju deploy memcached
juju add-relation designate memcached
juju add-relation designate mysql
juju add-relation designate rabbitmq-server
juju add-relation designate keystone

To add support for DNS record auto-generation when Neutron ports and floating IPs are created the charm needs a relation with neutron-api charm:

juju deploy neutron-api
juju add-relation designate neutron-api

The charm needs to store DNS records. This can be achieved by setting the dns-slave config option or by relating to the designate-bind charm:

juju deploy designate-bind
juju add-relation designate designate-bind

For Queens and later, the nameservers config value must be set:

juju config designate nameservers="ns1.example.com. ns2.example.com."

Policy Overrides

Policy overrides is an advanced feature that allows an operator to override the default policy of an OpenStack service. The policies that the service supports, the defaults it implements in its code, and the defaults that a charm may include should all be clearly understood before proceeding.

Caution: It is possible to break the system (for tenants and other services) if policies are incorrectly applied to the service.

Policy statements are placed in a YAML file. This file (or files) is then (ZIP) compressed into a single file and used as an application resource. The override is then enabled via a Boolean charm option.

Here are the essential commands (filenames are arbitrary):

zip overrides.zip override-file.yaml
juju attach-resource designate policyd-override=overrides.zip
juju config designate use-policyd-override=true

See appendix Policy Overrides in the OpenStack Charms Deployment Guide for a thorough treatment of this feature.

Bugs

Please report bugs on Launchpad.

For general charm questions refer to the OpenStack Charm Guide.