Ansible roles and playbooks to support the Freifunk Dortmund Infrastructure

Till Klocke c9ecd30734 Added new vars for bird configs and added new tests		преди 9 години
galaxy-roles	2214502c0e Relading radvd caused problems on Debian-jessie. Instead we restart now	преди 9 години
roles	a41f5cb419 Role ff-supernode doesn't depend on bird role anymore directly since supernode-interfaces now depends on bird	преди 9 години
test	c9ecd30734 Added new vars for bird configs and added new tests	преди 9 години
.gitignore	aaee961897 git will now ignore files containing secrets	преди 9 години
.kitchen.yml	b1ca2a87f8 Now using more 'official' vagrant boxes for testing	преди 9 години
README.md	6d238e7590 Added smal getting started guide to ease others into the development here	преди 9 години
Vagrantfile	495fff799b The Vagrantfile can now easily create multiple machines	преди 9 години
ansible.cfg	3cc0f37f0c Added ansible.cfg which can be found by vagrant so galaxy roles should be found by ansible when doing vagrant up/provision	преди 9 години
playbook.yml	3727e147c1 Test playbook now uses the ff-supernode role for testing	преди 9 години
requirements.yml	538e896e80 Added role to manage radvd	преди 9 години
update-third-party-roles.sh	76e5ef8c47 Added very small script to make updating third party roles more abvious	преди 9 години

Ansible roles for Freifunk Dortmund

This repo contains roles which should ease the creation of supernodes and other services for Freifunk Dortmund (and eventually for other Communities)

Since some software components like fastd and B.A.T.M.A.N. are not always easily available via a packet manager on all platforms, the basic idea in this repo is to create roles for this software and eventually fall back to building from source.

Getting started

This project is based on ansible, vagrant, VirtualBox and test kitchen. Although it is possible to get all this working on windows, it is easier to do on Linux or Mac OS

Prerequesites

Install ansible for your operating system
Install VirtualBox for your operating system (Version 5 seems to work)
Also install the extension pack for USB support etc. in VirtualBox. Some machines depend on this.
Install vagrant for your operating system
Install test kitchen for your operating system
Install ansible for test kitchen: sudo gem install kitchen-ansiblepush kitchen-ansible
Install vagrant driver for test kitchen: sudo gem install kitchen-vagrant

First steps

After you installed all necessary tools and gems you change in the checked out directory of this project and simply type kitchen test. This will create multiple virtual machines execute the ansible roles and test everything via serverspec. After all tests are successfull the machines are destroyed again.

Simple development workflow

Since creating the machines can take some time (several minutes) is doesn't make sense to destroy them after each run. You can call kitchen setup to create all defined machines and keep them running. Then you can start editing roles or creating roles and if you want to check your changes you can execute kitchen converge && kitchen verify to execute the roles on all machines and run the serverspec tests on all machines. All commands can be combined with the machine name (available via kitchen list) if you want to manipulate only one machine. If you need to analyse problems on one machine you can login with kitchen login [machine name]

The Vagrantfile

The Vagrantfile and the host and group vars in this repo should be used to quickly create a "test community" in the future.

TODO

batman role needs to enable build from source
we need a way to get batman compatibility mode as a fact and be able to configure it
Add support for more platforms (don't force a linux distro to others)
Everything else I forgot
Add CI via travis:

README.md