Skip to content

Commit

Permalink
Release 2.0.0
Browse files Browse the repository at this point in the history
  • Loading branch information
sebastianrakel committed Aug 14, 2022
1 parent b4af6c4 commit 71fdd00
Show file tree
Hide file tree
Showing 2 changed files with 30 additions and 4 deletions.
32 changes: 29 additions & 3 deletions REFERENCE.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,15 @@

### Defined types

#### Public Defined types

* [`wireguard::interface`](#wireguardinterface): manages a wireguard setup

#### Private Defined types

* `wireguard::provider::systemd`: Manage the systemd components of a wireguard setup
* `wireguard::provider::wgquick`: Manage the wg quick components of a wireguard setup

### Data types

* [`Wireguard::Peers`](#wireguardpeers): custom data type for an array with wireguard peers
Expand Down Expand Up @@ -131,7 +138,6 @@ wireguard::interface {'as2273':
wireguard::interface {'as3668-2':
source_addresses => ['144.76.249.220', '2a01:4f8:171:1152::12'],
public_key => 'Tci/bHoPCjTpYv8bw17xQ7P4OdqzGpEN+NDueNjUvBA=',
preshared_key => '/22q9I+RpWRsU+zshW8skv1p00TvnEE6fTvPJuI2Cp4=',
endpoint => 'router02.bastelfreak.org:1338',
dport => 1338,
input_interface => $facts['networking']['primary'],
Expand All @@ -141,7 +147,7 @@ wireguard::interface {'as3668-2':
mtu => 1412,
```

##### create a wireguard interface with multiple peers
##### create a wireguard interface with multiple peers where one uses a preshared key

```puppet
wireguard::interface { 'wg0':
Expand All @@ -150,6 +156,7 @@ wireguard::interface { 'wg0':
peers => [
{
public_key => 'foo==',
preshared_key => '/22q9I+RpWRsU+zshW8skv1p00TvnEE6fTvPJuI2Cp4=',
allowed_ips => ['192.0.2.2'],
},
{
Expand All @@ -165,6 +172,7 @@ wireguard::interface { 'wg0':
The following parameters are available in the `wireguard::interface` defined type:

* [`interface`](#interface)
* [`ensure`](#ensure)
* [`input_interface`](#input_interface)
* [`manage_firewall`](#manage_firewall)
* [`dport`](#dport)
Expand All @@ -180,6 +188,7 @@ The following parameters are available in the `wireguard::interface` defined typ
* [`routes`](#routes)
* [`private_key`](#private_key)
* [`preshared_key`](#preshared_key)
* [`provider`](#provider)

##### <a name="interface"></a>`interface`

Expand All @@ -189,6 +198,14 @@ the title of the defined resource, will be used for the wg interface

Default value: `$title`

##### <a name="ensure"></a>`ensure`

Data type: `Enum['present', 'absent']`

will ensure that the files for the provider will be present or absent

Default value: `'present'`

##### <a name="input_interface"></a>`input_interface`

Data type: `String[1]`
Expand Down Expand Up @@ -305,10 +322,18 @@ Default value: ``undef``

Data type: `Optional[String[1]]`

Define preshared key which should be used for this interface
Define preshared key for the remote peer

Default value: ``undef``

##### <a name="provider"></a>`provider`

Data type: `Enum['systemd', 'wgquick']`

The specific backend to use for this `wireguard::interface` resource

Default value: `'systemd'`

## Data types

### <a name="wireguardpeers"></a>`Wireguard::Peers`
Expand All @@ -323,6 +348,7 @@ Alias of
```puppet
Array[Struct[{
public_key => String[1],
preshared_key => Optional[String[1]],
allowed_ips => Optional[Array[String[1]]],
endpoint => Optional[String[1]],
persistent_keepalive => Optional[Stdlib::Port],
Expand Down
2 changes: 1 addition & 1 deletion metadata.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "puppet-wireguard",
"version": "1.1.1-rc0",
"version": "2.0.0-rc0",
"author": "Vox Pupuli",
"summary": "installs, configures, and manages wireguard",
"license": "AGPL-3.0",
Expand Down

0 comments on commit 71fdd00

Please sign in to comment.