65 lines
2.2 KiB
Raw Normal View History

2020-04-21 06:02:51 +00:00
# cdist-contrib
2020-04-26 17:19:31 +00:00
This project extends the [cdist][cdist] configuration management
2020-04-21 06:02:51 +00:00
tool with community-maitained types which are either too specific to fit/be
maintained in cdist itself or were not accepted in code cdist but could still
be useful.
2020-07-28 12:23:30 +00:00
This project does not have releases and is continously updated: see git history
for change log. You will find HTML documentation at
2020-04-26 17:19:31 +00:00
## Using cdist-contrib
We would recommend that you clone this repository next to your regular cdist
config directory, then setup `conf_dir` with relative paths in
[cdist configuration][cdistconfig].
An example of this would be:
# contents of cdist.cfg next to cdist-contrib
# Notice that types defined in last dir win and can override native types.
# Consider using a prefix for your own types to avoid collisions.
conf_dir = cdist-contrib:cdist-private
And you would run [cdist][cdist] from the same directory as follows:
cdist config -g cdist.cfg
# Or setup your CDIST_CONFIG_FILE environment variable and run as usual
## Participating in the [cdist][cdist] community
Join us on [][cdistmatrix] on matrix or on
[#cdist over mattermost][cdistmattermost].
2020-05-07 06:45:21 +00:00
## Contributing
The preferred way to submit patches is by opening Merge Requests against the
[cdist-contrib project on]( (you
can make an account on
2020-05-07 06:45:21 +00:00
Every type in cdist-contrib must:
* Have a `man.rst` documentation page.
* Pass [shellcheck]( without errors.
## Other resources
Some people/organizations are known to keep some cdist types that might be of
interest to others:
* [cdist-evilham]( Evilham's cdist-types
* [cdist-recycledcloud]( e-Durable SA / Recycled Cloud public types