Debhelper (and CDBS) modules for building configuration packages
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
debian
doc
examples
lib/Debian/Debhelper
.gitignore
.travis.yml
README.md
check-files.mk
config-package.mk
debconf-divert.mk
debconf-hack.sh
decode
dh_configpackage
displace.mk
displace.sh.in
encode
transform-files.mk

README.md

config-package-dev

config-package-dev is a tool for building Debian configuration packages, that is, packages that configure other Debian packages already on your system. It is an alternative to configuration-management tools (e.g., Ansible, Chef, Puppet, cfengine) that integrates cleanly with the Debian packaging system: you can apply configuration by installing a configuration package, and remove it cleanly by uninstalling it. config-package-dev uses dpkg-divert to inform the packaging system that it is changing files owned by another package, which means that your changes remain applied even when the original package is upgraded.

Configuration packages are particularly useful for sites using Debian or Ubuntu (or another dpkg-based distribution) who are already running their own internal apt repository. You can provide site defaults and configuration through your existing package-update processes, and make sure systems are up-to-date in both software and configuration by checking what versions of packages they have installed. (config-package-dev is not intended for use by packages in Debian itself.)

config-package-dev is a project of MIT SIPB, and was originally developed for the Debathena project to provide functionality to access MIT computing services (e.g., Kerberos and AFS configuration) on privately owned machines.

To get started, install config-package-dev from your package manager; we support the versions in the Debian and Ubuntu archives. Take a look at the examples, or check out the full documentation at https://debathena.mit.edu/config-package-dev. If you're using config-package-dev, please also join the config-package-dev@mit.edu mailing list.

config-package-dev itself is licensed under the GPLv2+, but the code it adds to configuration packages is released under the MIT license and automatically includes the MIT license in the added code.

Feel free to report bugs or submit patches either on GitHub or on the Debian bug tracker.

Build Status