saltstack-network-formula
SaltStack Formula to set up and configure a host's network configuration
Instructions
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).
Contributing
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.
TODO
- 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
- Use more of the available options in interfaces.sls of network.managed
- interfaces: configure broadcast if set
- rewrite using #!py renderer
Authors
- Alan Pearce <[email protected]>
- Arnold Bechtoldt <[email protected]>
- Krzysztof Pawłowski <[email protected]>
- René Jochum <[email protected]>
- Simon Lloyd <[email protected]>
- root <root@saltmaster01.(none)>
Miscellaneous
Recommended formulas:
- SaltStack management: saltstack-salt-formula
Further reading:
- Documentation and Standardisation of SaltStack formulas: https://github.com/bechtoldt/formula-docs