cookbook 'baragon', '= 3.1.2'
baragon (10) Versions 3.1.2 Follow1
Installs/Configures baragon
cookbook 'baragon', '= 3.1.2', :supermarket
knife supermarket install baragon
knife supermarket download baragon
baragon-cookbook
Installs Baragon (service or agent) on a node. Baragon is the loadbalancer management service for HubSpot's Singularity cluster management system.
Supported Platforms
Tested on an extensive range of platforms including Ubuntu 14.04 and nothing else.
Requirements
Zookeeper
Baragon depends on ZooKeeper to store internal state, and perform coordination between multiple BaragonService
instances if high availability is desired. Using an existing Zookeeper cluster is totally fine if you happen to have one. Separate Baragon installations can also share the same Zookeeper cluster, provided they use different zkNamespace
values.
Nginx
Baragon writes nginx-style config files by default. In theory other load balancers could be used, but the tool is designed around the style of config files used by nginx.
The main requirement is that each application and upstream has its own file containing all necessary configuration directives (as opposed to, say, haproxy, where all configuration is parsed in order from top to bottom from a single, monolithic file).
Attributes
<table>
<tr>
<th>Key</th>
<th>Type</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td><tt>['baragon']['group_name']</tt></td>
<td>String</td>
<td>Load Balancer Group Name</td>
<td><tt>default</tt></td>
</tr>
<tr>
<td><tt>['baragon']['proxy_conf_dir']</tt></td>
<td>String</td>
<td>Directory where the proxy config files are placed</td>
<td><tt>/tmp</tt></td>
</tr>
<tr>
<td><tt>['baragon']['upstream_conf_dir']</tt></td>
<td>String</td>
<td>Directory where the upstream config files are placed</td>
<td>Value of <tt>node['baragon']['proxy_conf_dir']</tt></td>
</tr>
<tr>
<td><tt>['baragon']['server_port']</tt></td>
<td>Integer</td>
<td>Baragon service listener port</td>
<td><tt>8080</tt></td>
</tr>
</table>
Usage
baragon::server
Include baragon::server
in your node's run_list
:
{ "run_list": [ "recipe[baragon::server]" ] }
…or in a wrapper cookbook:
include_recipe 'baragon::server'
baragon::agent
Include baragon::agent
in your node's run_list
:
{ "run_list": [ "recipe[baragon::agent]" ] }
…or in a wrapper cookbook:
include_recipe 'baragon::agent'
License and Authors
Author:: EverTrue, Inc. (devops@evertrue.com)
Dependent cookbooks
java >= 0.0.0 |
git >= 0.0.0 |
logrotate >= 0.0.0 |
maven >= 0.0.0 |
magic ~> 1.1 |
compat_resource ~> 12.5 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Foodcritic Metric
3.1.2 failed this metric
FC003: Check whether you are running with chef server before using server-specific features: /tmp/cook/28b2644717e54d7fcd5faa8f/baragon/recipes/common.rb:33
3.1.2 failed this metric