MEschenbacher's Wireguard Saltstack Formula
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Maximilian Eschenbacher 030cdb0dd0 update README 6 anni fa
_modules module: check on set 6 anni fa
_states state: peer_present: shorten source lines 6 anni fa
wireguard refactor/simplify peer configuration 6 anni fa
README.md update README 6 anni fa
pillar.example update pillar.example 6 anni fa

README.md

wireguard-formula

This formula is supposed to install WireGuard (usually dkms and utils), and create interfaces including peers. Configuration is done via pillar (see below).

Attention: WireGuard is not yet included in the linux mainline kernel. Also, the installation is different on every distribution and sometimes you even have to include unstable/testing branches. For now, please install WireGuard yourself. You can use this formula afterwards.

Installation

See the full Salt Formulas installation and usage instructions.

Configuration

All configuration is done via pillar data. See pillar.example for examples. This means in particular, that you do not have to use any of the following states youself.

Available states

wg.present

Creates a wireguard interface and sets interface-wide parameters.

wg.peer_present

Adds a peer to an interface and sets peer-specific parameters.

wg.absent

Removes a wireguard interface.

wg.peer_absent

Removes a peer from an interface.