Ansible roles and playbooks to support the Freifunk Dortmund Infrastructure

Till Klocke 9e232bd885 Added travis config 9 năm trước cách đây
galaxy-roles 4c0d7940d6 Updated version of dereulenspiegel.alfred 9 năm trước cách đây
group_vars dbe1d8b458 Now setting the fastd secrets for all supernodes. This is NOT production ready 9 năm trước cách đây
host_vars 32aea5b3ed Meshviewer v3 seems to be fine also. But still doesn't work when no node as geo infos 9 năm trước cách đây
roles 1f4c4fe9f6 Removed supervisor stuff 9 năm trước cách đây
test b1abb888a8 Removed cron test example since we are now installing a file to cron.d 9 năm trước cách đây
.gitignore 8ddc629e3c Better hide all custom kitchen configs 9 năm trước cách đây
.kitchen.yml ba319c5492 We need more RAM on Ubuntu to be able to use grunt (isn't nodejs efficient?) 9 năm trước cách đây
.travis.yml 9e232bd885 Added travis config 9 năm trước cách đây
Gemfile 16405ad501 Added Gemfile so test-kitchen all necessary gems can easily be installed via bundler 9 năm trước cách đây
Gemfile.lock 16405ad501 Added Gemfile so test-kitchen all necessary gems can easily be installed via bundler 9 năm trước cách đây
README.md 380b1841b5 Added warning that the debian wheezy machine currently breaks kitchen test 9 năm trước cách đây
Vagrantfile a283f1afab We can now set the box for all machines at once 9 năm trước cách đây
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 năm trước cách đây
playbook.yml 32ae77677a Added basic mapserver which is already at least part of the mesh 9 năm trước cách đây
requirements.yml 4c0d7940d6 Updated version of dereulenspiegel.alfred 9 năm trước cách đây
update-third-party-roles.sh 76e5ef8c47 Added very small script to make updating third party roles more abvious 9 năm trước cách đây

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: