Annotation of wikisrc/projects/project/pkgsrc_config_vcs.mdwn, revision 1.2
1.1 jmmv 1: [[!template id=project
3: title="Version control config files"
10: [Thomas Klausner](mailto:wiz@NetBSD.org)
1.2 ! jmmv 13: category="pkgsrc"
! 14: difficulty="easy"
1.1 jmmv 15: duration="3 months"
18: Put config files (etc/) installed by pkgsrc into some version control system to help keeping track of changes and updating them.
20: The basic setup might look like this:
22: * There is a repository containing the config files installed by pkgsrc, starting out empty.
23: * During package installation, pkgsrc imports the package's config files into the repository onto a branch tagged with the name and version of the package (if available, on a vendor branch). (e.g.: digest-20080510)
24: * After installation, there are two cases:
26: 1. the package was not installed before: the package's config files get installed into the live configuration directory and committed to the head of the config repository
27: 2. the package was installed before: a configuration update tool should display changes between the new and the previous original version as well as changes between the previous original and installed config file, for each config file the package uses, and support merging the changes made necessary by the package update into the installed config file. Commit the changes to head when the merge is done.
29: * Regular automated check-ins of the entire live pkgsrc configuration should be easy to set up, but also manual check-ins of singular files so the local admin can use meaningful commit messages when they change their config, even if they are not experienced users of version control systems
31: The actual commands to the version control system should be hidden behind an abstraction layer, and the vcs operations should be kept simple, so that other compatibility layers can be written, and eventually the user can pick their vcs of choice (and also a vcs location of choice, in case e.g. the enterprise configuration repository is on a central subversion server).
35: [[!tag gsoc]]
CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb