cookbook 'stud', '~> 0.0.2'
stud (2) Versions 0.0.2 Follow4
Installs/Configures stud
cookbook 'stud', '~> 0.0.2', :supermarket
knife supermarket install stud
knife supermarket download stud
Description
Install and configure stud, a scalable TLS unwrapping daemon
Requirements
Tested on Ubuntu Linux
Uses the install_from cookbook to build stud.
Attributes
All attributes exist under the node[:stud]
-
[:version]- The tagged version of stud to install from. Installing from HEAD is not currently supported. -
[:user]- The user to install and run stud under. Must have write permissions under /usr/local/share. -
[:install_prefix_root]- The prefix root under which stud is installed. Stud will be installed to <this folder>/share/stud. -
[:pemfile_path]= The path to the chained pemfile (must include private key and certificate)
The following attributes are used to pass options to the stud command line interface. They default to the stud defaults/recommendations.
-
[:options][:tls]- Use TLSv1. Ignored if[:options][:ssl]is true. -
[:options][:ssl]- Use SSLv3 (implies no TLSv1) -
[:options][:cipher_suite]- set allowed ciphers (default is OpenSSL defaults) -
[:options][:engine]- set OpenSSL engine -
[:options][:backend_host]- backend host to connect to (default 127.0.0.1) -
[:options][:backend_port]- backend port to connect to (default 8000) -
[:options][:frontend_host]- frontend host to connect to (default *) -
[:options][:frontend_port]- frontend port to connect to (default 8443) -
[:options][:workers]- number of worker processes (default 1) -
[:options][:backlog]- listen backlog size (default 100) -
[:options][:keepalive_secs]- change the default keepalive on client socket [:options][:chroot_path]-
[:options][:user]- gid/uid to set after binding the sockiet -
[:options][:quiet]- emit only error messages -
[:options][:send_to_syslog]- send log messages to syslog -
[:options][:write_ip]- write 1 octet with the IP family allowed by the IP address in 4 (IPv4) or 16 (IPv6) octets little-endian -
[:options][:write_proxy]- write HaProxy's PROXY (IPv4 or IPv6) protocol line before actual data
Usage
All you need to do is include the [stud::default] recipe in your role, and configure any attributes whose defaults you wish to override.
Note that this recipe honors the defaults/recommendations as set forth by the stud authors. I recommend the following changes for a typical SSL environment.
-
[:options][:ssl]- true -
[:options][:workers]- 2 (or however many workers you have - nobody runs single core machines these days) -
[:options][:write_proxy]- true (iff you use haproxy 1.5+)
Dependent cookbooks
| build-essential >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Collaborator Number Metric
0.0.2 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
0.0.2 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
Foodcritic Metric
0.0.2 failed this metric
FC064: Ensure issues_url is set in metadata: stud/metadata.rb:1
FC065: Ensure source_url is set in metadata: stud/metadata.rb:1
FC066: Ensure chef_version is set in metadata: stud/metadata.rb:1
FC121: Cookbook depends on cookbook made obsolete by Chef 14: stud/metadata.rb:1
FC122: Use the build_essential resource instead of the recipe: stud/recipes/default.rb:10
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
0.0.2 passed this metric
Testing File Metric
0.0.2 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
0.0.2 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
0.0.2 failed this metric
0.0.2 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
Foodcritic Metric
0.0.2 failed this metric
FC064: Ensure issues_url is set in metadata: stud/metadata.rb:1
FC065: Ensure source_url is set in metadata: stud/metadata.rb:1
FC066: Ensure chef_version is set in metadata: stud/metadata.rb:1
FC121: Cookbook depends on cookbook made obsolete by Chef 14: stud/metadata.rb:1
FC122: Use the build_essential resource instead of the recipe: stud/recipes/default.rb:10
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
0.0.2 passed this metric
Testing File Metric
0.0.2 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
0.0.2 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
0.0.2 failed this metric
FC065: Ensure source_url is set in metadata: stud/metadata.rb:1
FC066: Ensure chef_version is set in metadata: stud/metadata.rb:1
FC121: Cookbook depends on cookbook made obsolete by Chef 14: stud/metadata.rb:1
FC122: Use the build_essential resource instead of the recipe: stud/recipes/default.rb:10
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
0.0.2 passed this metric
Testing File Metric
0.0.2 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
0.0.2 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
0.0.2 failed this metric
0.0.2 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
