EugenMayer / chef-tinc-cookbook

Chef cookbook for creating tinc vpn networks

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Build Status

Description

Installs tinc vpn for meshed VPN networks.

  • supports multiple networks per node
  • connect_to can be either configured manually or extracted using node-search
  • you can run router and switch mode, the latter is for unicast/multicast enabled networks

All you need is deploying this cookbook on several nodes while using the same network name - the connection between those nodes (hosts) will be configured automatically (published hosts/ with public keys)

Available on the chef supermarket

Requirements

Platform:

  • debian
  • ubuntu

Cookbooks:

  • openssl (= 4.4.0)

Attributes

See tincvpn.rb for the available attributes and how to use them

Recipes

  • tincvpn::default

tincvpn::default

Installs tinc and configure all your hosts and networks. Hosts are actually looked up using a node search, picking all nodes having the same network deployed

Release

bundle install --binstubs --without='development vagrant docker dokken integration' 
./bin/stove login --username <user>--key ~/.ssh/key.pem
# edit metadata.rb and release
./bin/stove 

Tests

You can run the test using kitchen

# vagrant basesed 
chef exec bundle exec kitchen test

# dokken based
export KITCHEN_YAML=.kitchen.dokken.yml
chef exec bundle exec kitchen test

# dokken based - just the default suite
export KITCHEN_YAML=.kitchen.dokken.yml
chef exec bundle exec kitchen test default

# docker based
export KITCHEN_YAML=.kitchen.docker.yml
chef exec bundle exec kitchen test           

There are to test suites, default for testing anything with router mode and switch to ensure we can set the mode properly/

Contributions

I am very happy to accept this PRs or work on issues to extend the usage of this cookbook.

Just use the issue queue or even better, create pull requests for what you like to improve.

License and Maintainer

Maintainer::

License:: Apache 2.0

About

Chef cookbook for creating tinc vpn networks

License:MIT License


Languages

Language:Ruby 96.5%Language:HTML 2.7%Language:Shell 0.8%