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:

1. Fork this repo on Github
2. Add changes, test them, update docs (README.rst) if possible
3. 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 <[email protected]>

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