Oopss' SaltStack formulas
This is a collection of SaltStack formulas.
They are used by the Oopss.org system team to manage the server infrastructure of various projects.
It aims to be reusable !
Each formula is provided with a
README.rst file and a
Feel free to use them directly or as a way to learn SaltStack.
These Salt formulas are currently tested only on Debian 7.0 Wheezy. and Salt 2014.7.
Warning : Using these formulas can break or lower the security of your system (files will be modified (even removed in some cases), services will be started, ...). Please read the doc and know what you do !
Install Salt master and minion.
Clone this repository under
/srv/salt/oopss (or wherever your Salt root is).
Create top file
/srv/salt/top.sls and call formulas you want to use. Example :
base: '*': - oopss.base - oopss.postfix - oopss.nginx
Read the README.sls file of each included formula to know what they do, and to know what pillar data can be used. However, each formula should run without any pillar data.
Bind the minions to the master and execute
Guidelines for creating/maintaining formulas
- The project is sub-divised in formulas
- Formulas can be configured using Pillar
- Each formula must have a pillar.example file
- Optionally, a map.jinja file can be used for handling various OS configuration
5. Every root-level state (e.g. oopss.munin) should be able to execute independently of others. 7. Each state file must have the standard header 8. Each managed template file must have the header : "Managed by Salt" 9. Templates should not reference pillar directly. Contexts should be used.