docs

FFKI Ansible Documentation

This is the documentation for the automated ansible setup of Freifunk Kiel.

Documentation is split up into multiple parts:

• Site setup: site.md
• Gateway setup: gateway.md
• Developer documentation: roles/*.md

Limitations

The following limitations apply to the ansible roles in this repository:

• Multi domain setups are not supported yet
• Only setup of gateways is currently supported

preparation

1. you have to add the hostname used in the groups in the inventory file to your .ssh/config as Host.

2. On the host you have to install python3 and set your ssh key so ansible may login as root

3. call ansible, e.g.:

   ansible-playbook --become -i ffki site.yml -t gateway --limit ffki-gw4
   

(see "usage")

update this repository

This repository uses submodules which contian some global scripts ffki-scripts and the variables per host in nord-ansible-host-vars which contain confidential data. Update the repository and all submodules with:

 git pull
 git uptate submodules

configuration:

• ffki_host_vars

  in this submodule the secret keys are defined. The repository is not public, so this whole ansible config wil only work, if you define your own hosts there

• roles

  see /docs/roles/README.md

usage

See gateway.md and site.md