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

Maximilian Wilhelm bd9b0bc5ca unattended-upgrades: Add config for Debian Boorkworm преди 6 месеца
Documentation 80c977116f Doc: Add monitoring rule configuration examples преди 1 година
_modules 8620f9d1f5 SDN: Assume IPv6 LLA VTEPs if no IPs configured on underlay преди 11 месеца
anycast-healthchecker 2455517ceb Add anycast-healthcecker state преди 1 година
apt 69f9d4be0f apt: Salt sources.list and GPG key for Bookworm преди 9 месеца
apu2 0ae03f896f apu2: Document how to force firmware update. преди 4 години
bash 517b3b0d4a bash: Increase history and make sure it's always appended. преди 5 години
batman 34aa0e91f5 batman: Don't expose any errors from checking DHCP daemon's status преди 11 месеца
bird 645f9acc52 bird: Add default local config knob values преди 1 година
build 6cb331e575 GIT: Use internal DNS alias for our GIT преди 1 година
burp 0b3ae3b258 burp: Let server listen on IPv6 преди 3 години
certs 42fdb07d21 certs: Allow more flexibal configuration преди 1 година
dhcp-client 79e07f458c Add dhcp-client state, with VRF support преди 11 месеца
dhcp-server 89247b5720 dhcp-server: Use input from dhcp_server NACL module преди 6 месеца
dns-server 29b2c1fba9 DNS: Update and activate base-line DNS generator based on NetBox data преди 1 година
docker 4cf47cbc5f Add docker state. преди 5 години
elasticsearch 5b3cbfb6c3 Added elasticsearch config преди 3 години
fastd 4e1d44b0f0 fastd: Use SDN to determine B.A.T.M.A.N. adv. iface penalty преди 2 години
ffinfo ab3833e402 ffinfo: Store main node role (from NetBox) on the system преди 1 година
firewall a77faefab6 firewall: Add files to load on boot-up преди 3 години
firmware 6cb331e575 GIT: Use internal DNS alias for our GIT преди 1 година
gogs bef28a1d26 gogs: Replace us-ascii with binary key преди 3 години
grafana a59933b2c1 Grafana: Set up Prometheus front end with some dashboards преди 1 година
graylog 172990e9c3 graylog: Use mongodb with authentication преди 1 година
icinga2 79c2e08b00 icinga2: Only write secrets on icinga server преди 8 месеца
icingaweb2 dd46e91fbe icingaweb2: The icingaweb2-module-monitoring pkg doesn't seem required преди 1 година
influxdb 1ea0d959e7 influxdb: Switch to new repo key преди 1 година
install-server a021074e44 install-server: Add preseed for Debian Bookworm преди 6 месеца
kernel 5ee6a1bd4e kernel: Install backports Kernel for Buster for B.A.T.M.A.N. iface penalty support преди 3 години
kvm 9c7c0bd8b1 KVM: Remove need for ifupdown* to configure VM interfaces преди 1 година
locales 54cdaf4438 locales: Add new config file for Debian Bookworm преди 9 месеца
mongodb 29b4318138 mongodb: Enable authorization by default преди 1 година
mosh d243476e23 First bunch of ffho salt configuration files to be public. преди 8 години
motd 6605a8fd50 add motd state преди 7 години
needrestart d77bad69c3 Install needrestart on all nodes. преди 4 години
network 5295aa0bd8 Make ifupdown-ng the default suite to configure interfaces преди 1 година
nftables 56639cfd8e nftables: Generate set of iBGP peers преди 1 година
nginx 533917fb8b Update firmware/openwrt redirect path to up-to-date mirror преди 2 години
ntp d243476e23 First bunch of ffho salt configuration files to be public. преди 8 години
openvpn df8977fb36 openvpn: Add configuration for OPS VPNs преди 2 години
postfix aff112a215 postfix: Use Debian Bullseye's config as standard преди 9 месеца
pppoe 2032bdc052 pppoe: Remove Debian stretch Sonderlocke преди 2 години
prometheus-exporters c69ac4fd59 Prometheus: Install bird-exporter on routers преди 1 година
prometheus-server 3774498fb5 prometheus: Only scrape active nodes преди 9 месеца
respondd 16d83640de respondd: Start respondd service after network-online target преди 3 години
rsyslog 825d0c5915 rsyslog: Rotate slapd logs преди 3 години
salt-minion 10f714bd5f salt-minion: python3-tornado isn't required anymore преди 3 години
screen d243476e23 First bunch of ffho salt configuration files to be public. преди 8 години
slapd ebaf2828e5 Add slapd state to configure LDAP servers. преди 4 години
snmpd 89781ebb00 snmpd: Don't generate synthetica bandwidth for VLAN and VXLAN interfaces преди 1 година
ssh a6f75e13fc ssh: Add sshd_config for Debian Bookworm преди 9 месеца
sudo 28aaa76adf sudo: Add sudoers file for Debian Bookworm преди 9 месеца
sury 74dbf64e12 Add sury php repository преди 1 година
sysctl 51cb518159 sysctl: Use Debian Bullseye's values as default преди 9 месеца
systemd 1c6d5423bd systemd: Work around new systemd persistent MAC "feature" преди 3 години
timezone f07fb87dcd Set system timezone to Europe/Berlin. преди 5 години
unattended-upgrades bd9b0bc5ca unattended-upgrades: Add config for Debian Boorkworm преди 6 месеца
users 07d06cc8dc Add users statee to manage users and passwords преди 1 година
vim 40755b33a6 vim: Do not use the Debian default vimrc. Ever. преди 4 години
wireguard 4c2f0c4408 Wireguard: Reflect data structure changes преди 2 години
yanic 3fa8a70532 yanic: Migrate ff_merge_nodes_json to Python3 преди 9 месеца
.gitignore 5d8869e75a Ignore VIM's *.swp files преди 1 година
README.md 26bc096db5 Update README преди 1 година
top.sls 351677e136 Take DHCP out of highstate for now преди 1 година
utils.sls 47b4966ae8 Add simple utils state to list utils worth installing преди 3 години

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 :-)