Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Release 2.0.0 #57

Merged
merged 1 commit into from
Aug 14, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,22 @@ All notable changes to this project will be documented in this file.
Each new release typically also includes the latest modulesync defaults.
These should not affect the functionality of the module.

## [v2.0.0](https://github.com/voxpupuli/puppet-wireguard/tree/v2.0.0) (2022-08-14)

[Full Changelog](https://github.com/voxpupuli/puppet-wireguard/compare/v1.1.0...v2.0.0)

**Breaking changes:**

- Move preshared\_key from interface to peer configuration [\#51](https://github.com/voxpupuli/puppet-wireguard/pull/51) ([hashworks](https://github.com/hashworks))

**Implemented enhancements:**

- Add wg quick as another provider for interfaces [\#54](https://github.com/voxpupuli/puppet-wireguard/pull/54) ([sebastianrakel](https://github.com/sebastianrakel))

**Fixed bugs:**

- Throw warning instead of fail if peers is empty [\#55](https://github.com/voxpupuli/puppet-wireguard/pull/55) ([sebastianrakel](https://github.com/sebastianrakel))

## [v1.1.0](https://github.com/voxpupuli/puppet-wireguard/tree/v1.1.0) (2022-08-03)

[Full Changelog](https://github.com/voxpupuli/puppet-wireguard/compare/v1.0.0...v1.1.0)
Expand Down
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",
"author": "Vox Pupuli",
"summary": "installs, configures, and manages wireguard",
"license": "AGPL-3.0",
Expand Down