linyows / keepalived-cookbook

Installs keepalived and generates the configuration file

Keepalived Cookbook

Installs keepalived and generates the configuration file.

Usage

Role based load balancing example:

run_list(
  'recipe[keepalived]'
)

override_attributes(
  :keepalived => {
    :vrrp_instances => {
      :vi_1 => {
        :ip_addresses => '10.0.0.1',
        :interface => 'eth0',
        :states => { 'app001.foo.com' => :backup, 'app002.foo.com' => :backup },
        :virtual_router_ids => { 'app001.foo.com' => 200, 'app002.foo.com' => 200 },
        :priorities => { 'app001.foo.com' => 100, 'app002.foo.com' => 99 },
        :nopreempt => false,
        :advert_int => 1,
        :garp_master_delay => 3,
        :auth_type => :pass,
        :auth_pass => 'secret'
      }
    },
    :virtual_servers => {
      :secure_web => {
        :ip_addresses => '10.0.0.1 443',
        :delay_loop => 10,
        :lvs_sched => :rr,
        :lvs_method => :dr,
        :protocol => :tcp,
        :real_server => {
          :port => 443, :weight => 0, :inhibit_on_failure => true,
          :tcp_check_port => 443, :tcp_check_timeout => 30
        },
        :real_servers => [
          { :ip_address => '157.7.100.50' }, { :ip_address => '157.7.100.51' },
          { :ip_address => '157.7.100.52' }, { :ip_address => '157.7.100.53' }
        ]
      }
    }
  }
)

Requirements

• Chef >= 12.5
• Platform: ubuntu, debian, fedora, centos and redhat

Installation

Librarian-Chef is a bundler for your Chef cookbooks. To install Librarian-Chef:

cd chef-repo
gem install librarian
librarian-chef init

To reference the Git version:

repo="linyows/keepalived-cookbook"
latest_release=$(curl -s https://api.github.com/repos/$repo/git/refs/tags \
| ruby -rjson -e '
  j = JSON.parse(STDIN.read);
  puts j.map { |t| t["ref"].split("/").last }.sort.last
')
cat >> Cheffile <<END_OF_CHEFFILE
cookbook 'keepalived', :git => 'git://github.com/$repo.git', :ref => '$latest_release'
END_OF_CHEFFILE
librarian-chef install

Attributes

keepalived::default

Key	Description	Default
router_id	router id	default_router_id
notification_emails	notify to emails	[e-mail]
notification_email_from	notify by email	example.com
smtp_server	smtp host	127.0.0.1
smtp_connect_timeout	connect timeout	30
include_files	outside files	[]
check_scripts	hash	{}
vrrp_instances	hash	{}
virtual_servers	hash	{}

keepalived::vrrp_instance

Key	Description	Default
state	instance role	:master
priority	instance priority	100
virtual_router_id	virtual router id	1
garp_master_delay	GARP delay time	5
auth_type	authentication type	nil
auth_pass	authentication password	nil
track_script	check script name	nil
notify_master		nil
notify_backup		nil
notify_fault		nil

keepalived::vrrp_sync_group

Key	Description	Default
group	vrrp instance names	nil
notify_backup		nil
notify_master		nil
notify_fault		nil

keepalived::virtual_server

Key	Description	Default
lvs_sched	scheduling algorithm #=> %i(rr wrr lc wlc sed nq sh dh lblc lblcr)	:lc
lvs_method	nat or dsr	:dr
delay_loop	health check interval	5
protocol	health check protocol	:tcp

Resources / Providers

• keepalived
• keepalived_vrrp_instance
• keepalived_virtual_server
• keepalived_virtual_sync_group
• keepalived_check_script

keepalived

Actions

Action	Description	Default
enable	setup and settings	yes
disable	disable keepalived

License and Author

MIT License

• linyows