SaltStack Formula to set up and configure the lifecycle management tool Foreman
Please refer to https://github.com/bechtoldt/formula-docs to learn how to use this formula, how it is built and how you can add your changes.
NOTICE: This formula might uses the formhelper module which is a very useful Salt execution module that isn't available in upstream yet. Please consider retrieving it manually from https://github.com/bechtoldt/salt-modules and make it available to your Salt installation. Read SaltStack documentation to see how this can be achieved.
Take a look at older releases (branches) to get a version that isn't using the formhelper yet (if any).
Contributions are welcome! All development guidelines we ask you to follow can be found at https://github.com/bechtoldt/formula-docs.
In general:
- Fork this repo on Github
- Add changes, test them, update docs (README.rst) if possible
- Submit your pull request (PR) on Github, wait for feedback
But it’s better to file an issue with your idea first.
- add instructions how to use formhelper, add information about it in the formula-docs (dependency), show up alternative?
- table/ matrix: os/salt compatibility (dedicated file)
- add list of available states
- add tests
- do initial Foreman setup (domains, proxies, OSs, etc.) with hammer CLI (WIP)
- show full example/ demonstration/ screencast of how to use this and other formulas
- plugins require internet access, configure http(s) proxy env var?
- add EL support
- Arnold Bechtoldt <mail@arnoldbechtoldt.com>
Recommended formulas:
- Bind DNS utilities: binddns-formula
- ISC dhcp server: iscdhcp-formula
- host network management: network-formula
- tftp setup: tftp-formula
- libvirt mgmt: libvirt-formula
- PostgreSQL DB: postgresql-formula
- Apache httpd: httpd-formula
Further reading:
- Documentation and Standardisation of SaltStack formulas: https://github.com/bechtoldt/formula-docs