ungleich-public/cdist-contrib
ungleich-public/cdist-contrib
8
2
Fork 3
Code Issues 2 Pull requests 3 Projects Releases Wiki Activity
Community maintained cdist types.
399 commits 7 branches 0 tags 2.3 MiB
Shell 97.6%
Awk 1.9%
Makefile 0.4%
Find a file
Evilham 116acebd10
[__opendkim] Deprecate --userid 
The parameter could produce inconsistencies permissions-wise.

Users of the type that need this functionality can still use:
--custom-config 'UserId $USERID'

Closes #17
2024-05-15 13:48:38 +02:00
docs/src Generate documentation homepage from README 2021-01-11 11:34:54 +01:00
scripts Fix run-shellcheck.sh following 'conflict resolution' from gitlab web ui 2021-01-12 07:14:24 +01:00
type [__opendkim] Deprecate --userid 2024-05-15 13:48:38 +02:00
.gitignore Add basic CI configuration 2020-05-07 09:37:30 +02:00
.gitlab-ci.yml ci: do not run docs job in forks 2021-02-16 13:47:09 +01:00
LICENSE Initial project structure, README 2020-04-21 08:02:51 +02:00
Makefile Import html/man doc generation logic from upstream cdist 2021-01-04 11:08:55 +01:00
README.md Update cdist-recycledcloud URL in README 2021-02-16 13:36:29 +01:00

README.md

cdist-contrib

This project extends the cdist configuration management 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.

This project does not have releases and is continously updated: see git history for change log. You will find HTML documentation at contrib.cdi.st.

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.

An example of this would be:

# contents of cdist.cfg next to cdist-contrib
[GLOBAL]
# 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 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 community

Join us on #cdist:ungleich.ch on matrix!

Contributing

The preferred way to submit patches is by opening Merge Requests against the cdist-contrib project on code.ungleich.ch (you can make an account on account.ungleich.ch.

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: