Salt-Orchestrated OpenSource based Software-Defined-Freifunk-Infrastructre-Network configuration

Maximilian Wilhelm 674c24ed2b wireguard: Send keepalives every 25s hai 2 días
Documentation 80c977116f Doc: Add monitoring rule configuration examples hai 1 ano
_modules 1ad46124d0 SDN: Fix fwmark for vrf_oobm_ext hai 2 días
anycast-healthchecker 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
apt 69f9d4be0f apt: Salt sources.list and GPG key for Bookworm hai 11 meses
apu2 0ae03f896f apu2: Document how to force firmware update. %!s(int64=5) %!d(string=hai) anos
bash 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
batman 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
bird 9f86fe6eb8 bird: Don't generate potential down BGP peers in template hai 7 meses
build 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
burp 51a28612c0 burp: client: Only log to burp's own log file hai 5 meses
certs 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
dhcp-client 8645ad5d8a dhcp-client: Only request address/router config hai 5 meses
dhcp-server 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
dns-server 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
docker 4cf47cbc5f Add docker state. %!s(int64=5) %!d(string=hai) anos
elasticsearch 5b3cbfb6c3 Added elasticsearch config %!s(int64=4) %!d(string=hai) anos
fastd 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
ffinfo 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
firewall a77faefab6 firewall: Add files to load on boot-up %!s(int64=3) %!d(string=hai) anos
firmware 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
gogs 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
grafana 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
graylog 172990e9c3 graylog: Use mongodb with authentication hai 1 ano
icinga2 04a731046d icinga2: Disable some check_ssl_cert params on Bookworm only hai 5 meses
icingaweb2 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
influxdb 1ea0d959e7 influxdb: Switch to new repo key hai 1 ano
install-server a021074e44 install-server: Add preseed for Debian Bookworm hai 8 meses
kernel 5ee6a1bd4e kernel: Install backports Kernel for Buster for B.A.T.M.A.N. iface penalty support %!s(int64=3) %!d(string=hai) anos
kvm 9c7c0bd8b1 KVM: Remove need for ifupdown* to configure VM interfaces hai 1 ano
locales 54cdaf4438 locales: Add new config file for Debian Bookworm hai 11 meses
mongodb 29b4318138 mongodb: Enable authorization by default hai 1 ano
mosh d243476e23 First bunch of ffho salt configuration files to be public. %!s(int64=8) %!d(string=hai) anos
motd 6605a8fd50 add motd state %!s(int64=7) %!d(string=hai) anos
needrestart d77bad69c3 Install needrestart on all nodes. %!s(int64=4) %!d(string=hai) anos
network 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
nftables 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
nginx 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
ntp d243476e23 First bunch of ffho salt configuration files to be public. %!s(int64=8) %!d(string=hai) anos
openvpn 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
postfix 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
pppoe 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
prometheus-exporters 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
prometheus-server 0728957ae0 prometheus-server: Scrape database exporters hai 5 meses
respondd 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
rsyslog 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
salt-minion 10f714bd5f salt-minion: python3-tornado isn't required anymore %!s(int64=3) %!d(string=hai) anos
screen d243476e23 First bunch of ffho salt configuration files to be public. %!s(int64=8) %!d(string=hai) anos
slapd ebaf2828e5 Add slapd state to configure LDAP servers. %!s(int64=4) %!d(string=hai) anos
snmpd 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
ssh 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
sudo 28aaa76adf sudo: Add sudoers file for Debian Bookworm hai 11 meses
sury 74dbf64e12 Add sury php repository hai 1 ano
sysctl 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
systemd 1c6d5423bd systemd: Work around new systemd persistent MAC "feature" %!s(int64=3) %!d(string=hai) anos
timezone f07fb87dcd Set system timezone to Europe/Berlin. %!s(int64=5) %!d(string=hai) anos
unattended-upgrades 678580eb76 unattended-upgrades: Upgrade libc6 and fastd, too hai 5 meses
users 07d06cc8dc Add users statee to manage users and passwords %!s(int64=2) %!d(string=hai) anos
vim 40755b33a6 vim: Do not use the Debian default vimrc. Ever. %!s(int64=4) %!d(string=hai) anos
wireguard 674c24ed2b wireguard: Send keepalives every 25s hai 2 días
yanic 60a5299b0b Use 'node' pillar instead of 'nodes:' ~ grains.id hai 7 meses
.gitignore 5d8869e75a Ignore VIM's *.swp files hai 1 ano
README.md 26bc096db5 Update README hai 1 ano
top.sls 4f3cb48596 Fix order in top.sls hai 2 días
utils.sls 47b4966ae8 Add simple utils state to list utils worth installing %!s(int64=3) %!d(string=hai) anos

README.md

Freifunk Hochstift infrastructure - SaltStack configuration

This repository contains the Salt environment (states + modules) used to configure the infrastructure of the Freifunk Hochstift community network.

It uses the NetBox Abstraction and Caching Layer (NACL) as its interface to communicate with NetBox, which holds all node specific configuration. This includes the node name, role(s), interfaces, IP addresses, tags, config contexts, etc.

Principles

This whole code base follows the principles of Holistic (network) automation, which means that as much configuration bits are derived from properties of nodes or its relationship(s) to other nodes. This includes but is not limited to, OSPF adjacencies, internal BGP sessions, B.A.T.M.A.N. adv. configuration, Nftables rules, etc.

Most of these bits live inside the Python modules which are included in this repository (see the _modules/ directory), which contains modules for authentication, netfilter, and networking related configuration. The ffho_net modules currently is the heart of our SDN logic, with more recent pieces (e.g. iBGP mesh calculation) living inside NACL. Eventually most logic should move over to NACL or another daemon which takes over the SDN role, so that Salt is only used to apply configuration based on a generic device configuration.

Further Reading

Our CTO, @BarbarossaTM, has started a blog series about our infrastructure, its architecture and evolution and also blogs about NetBox related things, which may or may not be related to this code base - it mostly is though :-)