Skip to content

Commit fb3381e

Browse files
authored
Merge pull request #311 from danquack/documentation
Updated documentation to use REFERENCE.md and minor data type updates
2 parents 92dc61c + 499953f commit fb3381e

File tree

17 files changed

+1871
-1186
lines changed

17 files changed

+1871
-1186
lines changed

README.md

Lines changed: 4 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -35,57 +35,9 @@ Puppet module to manage OpenVPN servers and clients.
3535

3636
* Version >= 4.10.0
3737

38-
## Example
39-
40-
```puppet
41-
# add a server instance
42-
openvpn::server { 'winterthur':
43-
country => 'CH',
44-
province => 'ZH',
45-
city => 'Winterthur',
46-
organization => 'example.org',
47-
email => '[email protected]',
48-
server => '10.200.200.0 255.255.255.0',
49-
}
50-
51-
# define clients
52-
openvpn::client { 'client1':
53-
server => 'winterthur',
54-
}
55-
openvpn::client { 'client2':
56-
server => 'winterthur',
57-
}
58-
59-
openvpn::client_specific_config { 'client1':
60-
server => 'winterthur',
61-
ifconfig => '10.200.200.50 10.200.200.51',
62-
}
63-
64-
# a revoked client
65-
openvpn::client { 'client3':
66-
server => 'winterthur',
67-
}
68-
openvpn::revoke { 'client3':
69-
server => 'winterthur',
70-
}
38+
## REFERENCES
7139

72-
# a server in client mode
73-
file {
74-
'/etc/openvpn/zurich/keys/ca.crt':
75-
source => 'puppet:///path/to/ca.crt';
76-
'/etc/openvpn/zurich/keys/zurich.crt':
77-
source => 'puppet:///path/to/zurich.crt';
78-
'/etc/openvpn/zurich/keys/zurich.key':
79-
source => 'puppet:///path/to/zurich.key';
80-
}
81-
openvpn::server { 'zurich':
82-
remote => [ 'mgmtnet3.nine.ch 1197', 'mgmtnet2.nine.ch 1197' ],
83-
require => [ File['/etc/openvpn/zurich/keys/ca.crt'],
84-
File['/etc/openvpn/zurich/keys/zurich.crt'],
85-
File['/etc/openvpn/zurich/keys/zurich.key'] ];
86-
87-
}
88-
```
40+
Please see [REFERENCE](REFERENCE.md) for more details.
8941

9042
## Example with hiera
9143

@@ -188,6 +140,7 @@ Details of these ciphers and their uses can be found in the documentation links
188140
Note : TLS ciphers suites shipped with OSes ubuntu14.04 and debian8 are too old compared to our default values.
189141
If the openvpn server is running on these OSes with clients on more modern OSes, you will probably have to use custom value for option `tls_cipher`.
190142

143+
191144
## Contributions
192145

193146
This module is maintained by [Vox Pupuli](https://voxpupuli.org/). Voxpupuli
@@ -200,3 +153,4 @@ Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for more details.
200153

201154
* Raffael Schmid <[email protected]>
202155
* Vox Pupuli Team
156+
* List of contributors https://github.com/danquack/puppet-openvpn/graphs/contributors

0 commit comments

Comments
 (0)