cookbook 'f5', '= 0.2.2', :supermarket
f5
(30) Versions
0.2.2
-
Follow10
Resources for managing an F5 BigIP load balancer
cookbook 'f5', '= 0.2.2'
knife supermarket install f5
knife supermarket download f5
f5-cookbook
A LWRP to manage F5 VIPs and Pools. Currently a WIP, but it will create VIPs and pools, and add nodes to pools
Supported Platforms
TBA
Attributes
<table> <tr> <th>Key</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </table>
Usage
f5::default
Not needed at the moment
Include f5
in your node's run_list
:
{
"run_list": [
"recipe[f5::default]"
]
}
Or if you are using a wrapper cookbook,
include_recipe "f5::default"
Your node will also need access to the credentials for the load balancer either in the attributes or a data bag:
If you're using a data bag, call it f5
and the default item is called default
.
$ knife data bag show f5 default
Unencrypted data bag detected, ignoring any provided secret options.
host: lb1.example.com
id: default
password: TopSecret
username: chef-api
Or, if no data bag is found, attributes are used
default[:f5][:credentials][:default] = {
host: "lb1.example.com",
username: "chef-api",
password: "TopSecret"
}
LWRP
In an application's recipe:
# Creates the pool if missing and adds this node to the pool
# (currently using node.ipaddress and node.fqdn for the node)
f5_pool 'mypool' do
host 'value'
port 'value'
lb_method 'method' # LB_METHOD_ROUND_ROBIN default
end
# Creates the VIP if missing
f5_vip 'myvip' do
address 'vipaddress'
port 'vipport'
protocol 'protocol' # TCP default
pool 'mypool'
end
See the documentation for LocalLB::LBMethod and protocol.
Testing
Run rspec
to run the chefspec tests.
License and Authors
Author:: Sean Walberg (sean@ertw.com)
Dependent cookbooks
This cookbook has no specified dependencies.
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
0.2.2
Bugfix for the last version
0.2.1
Supporting credentials in a databag
0.2.0
Still rough around the edges and nowhere near feature complete, but this cookbook will create the pool and VIP and add the node as a member
0.1.0
Initial release of f5