5,705
edits
Changes
Platform Team/Server Kit/Architecture (view source)
Revision as of 05:31, 26 May 2011
, 05:31, 26 May 2011no edit summary
=== Mace ===
=== Mace ===
The mace is a ma<cross>c<cross>ke
The mace is a tool to ma<strike>c</strike>ke final configuration using source templates. Sources for {{Code|mace}} are stored in GNU/Linx distribution agnostic manner in form of:
[<arbitrary-path>]/<service-name>.d/[<service-confile>]/<configuration-file>.conf
The {{Code|service-confile}} is optional and makes sense only if configured service has several of them, e.g., Bind. The {{Code|configuration-file}} are configuration files in particular service configuration syntax. All {{Code|configuration-file}} files will be merged to the singular {{Code|service-confile}} file and placed to the specific directory, depending on particular GNU/Linux distribution, by mace.
The purpose to have {{Code|arbitrary-path}} is that there might be several directories with the same {{Code|service-name}}s to make configuration more flexible, i.e., it lets having several high-level configuration components in a project that configure the same service. Subsequent configuration might:
* supplement previous configuration by adding new {{Code|configuration-file}}s,
* override previous configuration by having the same {{Code|configuration-file}} name with new content,
* hide previous configuration by having empty files with the same {{Code|arbitrary-path}} or {{Code|service-name}} name.
Such rules will be applied while walking within the root configuration directories tree when directory and file names are sorted alphabetically. The following example demonstrates virtual tree of upstream configuration with several high-level components and how downstream tunes them:
<dir> +upstrem
<dir> | +0100.base
<dir> | | +iptables.d
<config> | | +0100.conf
<dir> | +0300.proxy
<dir> | +iptables.d
<config> | | +0300.squid.conf
<dir> | +squid.d
<dir> +downstream
<dir> +0100.base
<dir> | +iptables.d
<config> | +0110.addons.conf
<empty> +0300.proxy
== Internal services ==
== Internal services ==
== Public API ==
== Public API ==