--- title: Charmhub | Deploy Designate using Charmhub - The Open Operator Collection description: Deploy the latest version of Designate on any cloud. url: https://charmhub.io/designate/configurations --- # Designate [OpenStack Charmers](https://charmhub.io/publisher/openstack-charmers "View all packages from OpenStack Charmers") * [OpenStack Charmers](https://charmhub.io/publisher/openstack-charmers "View all packages from OpenStack Charmers") * [Cloud](https://charmhub.io/?filter=cloud) * [Networking](https://charmhub.io/?filter=networking) Platform: 24.04 23.10 23.04 22.10 22.04 20.04 18.04 yoga/stable 4cccfb9 ``` juju deploy designate --channel yoga/stable ``` [Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications) * [action-managed-upgrade](https://charmhub.io/designate/configurations#action-managed-upgrade) * [also-notifies](https://charmhub.io/designate/configurations#also-notifies) * [api-page-limit](https://charmhub.io/designate/configurations#api-page-limit) * [debug](https://charmhub.io/designate/configurations#debug) * [default-soa-expire](https://charmhub.io/designate/configurations#default-soa-expire) * [default-soa-minimum](https://charmhub.io/designate/configurations#default-soa-minimum) * [default-soa-refresh-max](https://charmhub.io/designate/configurations#default-soa-refresh-max) * [default-soa-refresh-min](https://charmhub.io/designate/configurations#default-soa-refresh-min) * [default-soa-retry](https://charmhub.io/designate/configurations#default-soa-retry) * [default-ttl](https://charmhub.io/designate/configurations#default-ttl) * [dns-ha](https://charmhub.io/designate/configurations#dns-ha) * [dns-slaves](https://charmhub.io/designate/configurations#dns-slaves) * [enable-admin-api](https://charmhub.io/designate/configurations#enable-admin-api) * [haproxy-client-timeout](https://charmhub.io/designate/configurations#haproxy-client-timeout) * [haproxy-connect-timeout](https://charmhub.io/designate/configurations#haproxy-connect-timeout) * [haproxy-queue-timeout](https://charmhub.io/designate/configurations#haproxy-queue-timeout) * [haproxy-server-timeout](https://charmhub.io/designate/configurations#haproxy-server-timeout) * [managed-resource-email](https://charmhub.io/designate/configurations#managed-resource-email) * [managed-resource-tenant-id](https://charmhub.io/designate/configurations#managed-resource-tenant-id) * [nagios\_context](https://charmhub.io/designate/configurations#nagios_context) * [nagios\_servicegroups](https://charmhub.io/designate/configurations#nagios_servicegroups) * [nameservers](https://charmhub.io/designate/configurations#nameservers) * [neutron-domain](https://charmhub.io/designate/configurations#neutron-domain) * [neutron-domain-email](https://charmhub.io/designate/configurations#neutron-domain-email) * [neutron-record-format](https://charmhub.io/designate/configurations#neutron-record-format) * [neutron-record-formatv6](https://charmhub.io/designate/configurations#neutron-record-formatv6) * [nova-domain](https://charmhub.io/designate/configurations#nova-domain) * [nova-domain-email](https://charmhub.io/designate/configurations#nova-domain-email) * [nova-record-format](https://charmhub.io/designate/configurations#nova-record-format) * [nova-record-formatv6](https://charmhub.io/designate/configurations#nova-record-formatv6) * [openstack-origin](https://charmhub.io/designate/configurations#openstack-origin) * [os-admin-hostname](https://charmhub.io/designate/configurations#os-admin-hostname) * [os-admin-network](https://charmhub.io/designate/configurations#os-admin-network) * [os-internal-hostname](https://charmhub.io/designate/configurations#os-internal-hostname) * [os-internal-network](https://charmhub.io/designate/configurations#os-internal-network) * [os-public-hostname](https://charmhub.io/designate/configurations#os-public-hostname) * [os-public-network](https://charmhub.io/designate/configurations#os-public-network) * [region](https://charmhub.io/designate/configurations#region) * [ssl\_ca](https://charmhub.io/designate/configurations#ssl_ca) * [ssl\_cert](https://charmhub.io/designate/configurations#ssl_cert) * [ssl\_key](https://charmhub.io/designate/configurations#ssl_key) * [use-internal-endpoints](https://charmhub.io/designate/configurations#use-internal-endpoints) * [use-policyd-override](https://charmhub.io/designate/configurations#use-policyd-override) * [use-syslog](https://charmhub.io/designate/configurations#use-syslog) * [verbose](https://charmhub.io/designate/configurations#verbose) * [vip](https://charmhub.io/designate/configurations#vip) * [vip\_cidr](https://charmhub.io/designate/configurations#vip_cidr) * [vip\_iface](https://charmhub.io/designate/configurations#vip_iface) * [worker-multiplier](https://charmhub.io/designate/configurations#worker-multiplier) * [zone-purge-time-threshold](https://charmhub.io/designate/configurations#zone-purge-time-threshold) [Learn about configurations >](https://juju.is/docs/juju/configuration#heading--application-configuration) * action-managed-upgrade | boolean If True enables openstack upgrades for this charm via juju actions. You will still need to set openstack-origin to the new repository but instead of an upgrade running automatically across all units, it will wait for you to execute the openstack-upgrade action for this charm on each unit. If False it will revert to existing behavior of upgrading all units on config change. * also-notifies | string Space delimited list of DNS servers which should be notified on every zone change in addition to the backend servers. List is of the form also\_notify\_ip:also\_notify\_port * api-page-limit | string Default: 20 Limit of per-page result retrieved by the V2 API used by the dashboard. Default is 20. An empty string value means no limit and all results shall be retrieved. * debug | boolean Enable debug logging * default-soa-expire | int Default: 86400 Default SOA expire value (in seconds) to specify how long a secondary will still treat its copy of the zone data as valid if it can't contact the primary. * default-soa-minimum | int Default SOA minimum value (in seconds) how long should cache a negative response. * default-soa-refresh-max | int SOA refresh indicates the time (in seconds) when the slave will try to refresh the zone from the master, Designate randomizes the refresh time using `default-soa-refresh-min` and `default-soa-refresh-max` as lower and upper boundaries respectively. * default-soa-refresh-min | int SOA refresh indicates the time (in seconds) when the slave will try to refresh the zone from the master, Designate randomizes the refresh time using `default-soa-refresh-min` and `default-soa-refresh-max` as lower and upper boundaries respectively. * default-soa-retry | int Defines the time (in seconds) between retries for the SOA record if the slave (secondary) fails to contact the master when refresh has expired. * default-ttl | int Default TTL (in seconds) for newly created zones. * dns-ha | boolean Use DNS HA with MAAS 2.0. Note if this is set do not set vip settings below. * dns-slaves | string List of DNS slaves which will accept addzone/delzone rndc commands from Designate. List is of the form slave\_ip:rndc\_port:rndc\_key. This should only be used if DNS servers are outside of Juju control. Using the designate-bind charm is the prefered approach. * enable-admin-api | boolean Enables experimental admin API for Designate. * haproxy-client-timeout | int Client timeout configuration in ms for haproxy, used in HA configurations. If not provided, default value of 90000ms is used. * haproxy-connect-timeout | int Connect timeout configuration in ms for haproxy, used in HA configurations. If not provided, default value of 9000ms is used. * haproxy-queue-timeout | int Queue timeout configuration in ms for haproxy, used in HA configurations. If not provided, default value of 9000ms is used. * haproxy-server-timeout | int Server timeout configuration in ms for haproxy, used in HA configurations. If not provided, default value of 90000ms is used. * managed-resource-email | string Default: hostmaster@example.com Define a email to use for managed resources like domains created by the FloatingIP. * managed-resource-tenant-id | string Set the project ID to own all managed resources like auto-created records etc. * nagios\_context | string Default: juju A string that will be prepended to instance name to set the host name in nagios. So for instance the hostname would be something like: juju-myservice-0 If you're running multiple environments with the same services in them this allows you to differentiate between them. * nagios\_servicegroups | string A comma-separated list of nagios servicegroups. If left empty, the nagios\_context will be used as the servicegroup. * nameservers | string Space delimited list of nameservers. These are the nameservers that have been provided to the domain registrar in order to delegate the domain to Designate. e.g. "ns1.example.com. ns2.example.com." This config value is required for Queens and later. * neutron-domain | string Domain to add floating IP records to. (NOTE: This option is obsolete starting from OpenStack Mitaka release) * neutron-domain-email | string Email address of the person responsible for the domain. (NOTE: This option is obsolete starting from OpenStack Mitaka release) * neutron-record-format | string Default: %(octet0)s-%(octet1)s-%(octet2)s-%(octet3)s.%(zone)s Format of floating IP global records. (NOTE: This option is obsolete starting from OpenStack Mitaka release) * neutron-record-formatv6 | string Default: %(hostname)s.%(tenant\_id)s.%(zone)s Format of floating IPv6 global records. (NOTE: This option is obsolete starting from OpenStack Mitaka release) * nova-domain | string Domain to add records for new instances to (NOTE: This option is obsolete starting from OpenStack Mitaka release) * nova-domain-email | string Email address of the person responsible for the domain. (NOTE: This option is obsolete starting from OpenStack Mitaka release) * nova-record-format | string Default: %(hostname)s.%(tenant\_id)s.%(zone)s Format of floating IP global records. (NOTE: This option is obsolete starting from OpenStack Mitaka release) * nova-record-formatv6 | string Default: %(hostname)s.%(tenant\_id)s.%(zone)s Format of floating IPv6 global records. (NOTE: This option is obsolete starting from OpenStack Mitaka release) * openstack-origin | string Default: yoga Repository from which to install OpenStack. May be one of the following: distro (default) ppa:somecustom/ppa (PPA name must include OpenStack Release) deb url sources entry|key id or a supported Ubuntu Cloud Archive pocket. Supported Ubuntu Cloud Archive pockets include: cloud:trusty-liberty cloud:trusty-juno cloud:trusty-kilo cloud:trusty-liberty cloud:trusty-mitaka Note that updating this setting to a source that is known to provide a later version of OpenStack will trigger a software upgrade. * os-admin-hostname | string The hostname or address of the admin endpoints created in the keystone identity provider. . This value will be used for admin endpoints. For example, an os-admin-hostname set to 'api-admin.example.com' with ssl enabled will create the following endpoint for neutron-api: . https://api-admin.example.com:9696/ * os-admin-network | string The IP address and netmask of the OpenStack Admin network (e.g., 192.168.0.0/24) . This network will be used for admin endpoints. * os-internal-hostname | string The hostname or address of the internal endpoints created in the keystone identity provider. . This value will be used for internal endpoints. For example, an os-internal-hostname set to 'api-internal.example.com' with ssl enabled will create the following endpoint for neutron-api: . https://api-internal.example.com:9696/ * os-internal-network | string The IP address and netmask of the OpenStack Internal network (e.g., 192.168.0.0/24) . This network will be used for internal endpoints. * os-public-hostname | string The hostname or address of the public endpoints created in the keystone identity provider. . This value will be used for public endpoints. For example, an os-public-hostname set to 'api-public.example.com' with ssl enabled will create the following endpoint for neutron-api: . https://api-public.example.com:9696/ * os-public-network | string The IP address and netmask of the OpenStack Public network (e.g., 192.168.0.0/24) . This network will be used for public endpoints. * region | string Default: RegionOne OpenStack Region * ssl\_ca | string TLS CA to use to communicate with other components in a deployment. . **NOTE**: This configuration option will take precedence over any certificates received over the `certificates` relation. * ssl\_cert | string TLS certificate to install and use for any listening services. . **NOTE**: This configuration option will take precedence over any certificates received over the `certificates` relation. * ssl\_key | string TLS key to use with certificate specified as `ssl_cert`. . **NOTE**: This configuration option will take precedence over any certificates received over the `certificates` relation. * use-internal-endpoints | boolean Openstack mostly defaults to using public endpoints for internal communication between services. If set to True this option will configure services to use internal endpoints where possible. * use-policyd-override | boolean If True then use the resource file named 'policyd-override' to install override YAML files in the service's policy.d directory. The resource file should be a ZIP file containing at least one yaml file with a .yaml or .yml extension. If False then remove the overrides. * use-syslog | boolean Setting this to True will allow supporting services to log to syslog. * verbose | boolean Enable verbose logging * vip | string Virtual IP(s) to use to front API services in HA configuration. If multiple networks are being used, a VIP should be provided for each network, separated by spaces. * vip\_cidr | int Default: 24 Default CIDR netmask to use for HA vip when it cannot be automatically determined. * vip\_iface | string Default: eth0 Default network interface to use for HA vip when it cannot be automatically determined. * worker-multiplier | float The CPU core multiplier to use when configuring worker processes. By default, the number of workers for each daemon is set to twice the number of CPU cores a service unit has. This default value will be capped to 4 workers unless this configuration option is set. * zone-purge-time-threshold | int Default: 3600 Default for how old deleted zones should be (deleted\_at) to be purged, in seconds.