Ansible roles and playbooks to support the Freifunk Dortmund Infrastructure

Till Klocke 611c8a3e7d Restart network handler now excludes the default interface to not cause problems with the ssh connection il y a 9 ans
galaxy-roles 2b49769673 Added third party role to install and configure unbound il y a 9 ans
group_vars fff2a57224 Fixed small typos in group vars il y a 9 ans
host_vars afba644b09 Made configuration of multiple nodes a little bit easier with introduction of local_node variable il y a 9 ans
roles 611c8a3e7d Restart network handler now excludes the default interface to not cause problems with the ssh connection il y a 9 ans
test dde00061e7 Added group vars for testing il y a 9 ans
.gitignore 8ddc629e3c Better hide all custom kitchen configs il y a 9 ans
.kitchen.yml 16d8b675f0 We decide now in the kitchen config if ansible uses sudo or not il y a 9 ans
Gemfile 16405ad501 Added Gemfile so test-kitchen all necessary gems can easily be installed via bundler il y a 9 ans
Gemfile.lock 16405ad501 Added Gemfile so test-kitchen all necessary gems can easily be installed via bundler il y a 9 ans
README.md 380b1841b5 Added warning that the debian wheezy machine currently breaks kitchen test il y a 9 ans
Vagrantfile 6cf332b6c8 Now provisioning all machines il y a 9 ans
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 il y a 9 ans
playbook.yml 5419c8a490 Added example to provision two supernodes il y a 9 ans
requirements.yml 2b49769673 Added third party role to install and configure unbound il y a 9 ans
update-third-party-roles.sh 76e5ef8c47 Added very small script to make updating third party roles more abvious il y a 9 ans

README.md

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

Alternative to the last three steps you can also just use bundler to bundle install all necessary ruby gems.

First steps

Important On Debian wheezy we need to install a new kernel from wheezy-backports. For this a reboot is necessary and executed via an ansible handler. Unfortunately this breaks the kitchen test run. You can do do kitchen setup && kitchen verify && kitchen destroy instead. It does the same as kitchen test but doesn't break because of the reboot.

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. Ideally if you type vagrant up you should get a working test community, but currently without uplinks.

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: