cookbook 'wireguard', '~> 1.0.0'
wireguard (1) Versions 1.0.0 Follow0
Install and configure Wireguard
cookbook 'wireguard', '~> 1.0.0', :supermarket
knife supermarket install wireguard
knife supermarket download wireguard
Wireguard Chef cookbook
Example usage
Let's assume a server listening on a static public address [2001:1:2:3::cafe] on UDP port 51820
and with a Wireguard private address [fc00::42:1].
Let's assume a client assigned with a dynamic public IP address
and with a Wireguard private address [fc00::42:2].
Server
Add wireguard::server to the run list with the following attributes:
default['wireguard']['server'] = { address: %w(fc00::42:1/112), port: 51820, public_key: 'SERVER_PUB_KEY', private_key: 'SERVER_PRIV_KEY', peers: { 'fc00::42:2/128': 'CLIENT_PUB_KEY' }, }
Client
Add wireguard::client to the run list with the following attributes:
default['wireguard']['client'] = { public_key: 'CLIENT_PUB_KEY', private_key: 'CLIENT_PRIV_KEY', endpoint: '[2001:1:2:3::cafe]:51820', address: %w(fc00::42:2/128), } default['wireguard']['server'] = { address: %w(fc00::42:1/128), public_key: 'SERVER_PUB_KEY', }
Once server and client are both converged, you can inspect the Wireguard connection with the wg command and ping machines using the [fc00::42:x] addresses.
Bandwidth test using socat:
- server: dd if=/dev/zero bs=1M count=100 | socat - tcp6-listen:1234,reuseport
- client: socat - tcp6:[fc00::42:1]:1234
License
AGPLv3+
Dependent cookbooks
This cookbook has no specified dependencies.
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Collaborator Number Metric
1.0.0 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Cookstyle Metric
1.0.0 passed this metric
No Binaries Metric
1.0.0 passed this metric
Testing File Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
1.0.0 failed this metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Cookstyle Metric
1.0.0 passed this metric
No Binaries Metric
1.0.0 passed this metric
Testing File Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
1.0.0 passed this metric
1.0.0 passed this metric
Testing File Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
1.0.0 failed this metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
