README.md

# hshbase

Basic server configuration used for most unix based servers at HsH.

## States

* **apt** proxy, sources.list and sources.list.d
* **openvmtools** use them for vmware
* **locale** setup your servers locales
* **python-packages** we are using for salt grains or modules.
 * **netifaces** useful information in grains about net cfg
 * **psutil** who needs that?!


## Configuration

The states of this formula should be configurable using one central pillar
for all configurations. Have a look at pillar.example for details.

## Development

**All features should be as configurable as necessary.
Keep it simple, stupid ([KISS](https://de.wikipedia.org/wiki/KISS-Prinzip)).**

Working on this formula requires virtualbox and vagrant installed.
It comes with an vagrant box you can instantly set up to get a machine where all states will apply against.

```bash
git clone ssh://git@lab.it.hs-hannover.de:2222/salt/hshbase-formula.git
cd hshbase-formula
vagrant up
vagrant ssh
sudo salt-call state.highstate
```

### Default values when developing the formula

If you introduce a new feature and want to make it configurable you might need
default values. Just add them to defauls.yaml and they are magically available.

Consult map.jinja for details on this topic.