Naminori

Library to manage the load balancer using the Serf

Installation

gem 'naminori'

Or install it yourself as:

$ gem install naminori

Usage

exemple

envent_example.rb

1. check the event classification
2. add or delete rip if these member-join or member-leave(faile)
3. enent target LoadBaranser is health_check with fetch member

#! /usr/bin/env ruby
require 'rubygems'
require 'naminori'

Naminoti::Notifier.configure do
  webhook_url "https://hooks.slack.com/services/XXXXXX"
  channel     "#pyama"
end

service_options = {
  vip:"192.168.77.9",
  role: "dns",
  notifier: Naminori::Notifier.get_notifier("slack" ,notifier_options)
}

case
when Naminori::Serf.role?("dns")
  Naminori::Service::Dns.event("lvs", service_options)
when Naminori::Serf.role?("lb")
  Naminori::Service::Dns.health_check("lvs", service_options)
end

example loadbarance serf config

{
  "event_handlers": [
    "/opt/serf/event_handlers/envent_example.rb"
  ],
  "interface": "enp0s9",
  "discover": "cache-dns",
  "tags": {
    "role": "lb"
  },
  "log_level": "debug"
}

example dns serf config

{
  "event_handlers": [

  ],
  "interface": "enp0s8",
  "discover": "cache-dns",
  "tags": {
    "role": "dns"
  }
}

health_check_example.rb

1. Using cron to the health check of the service
2. Service is removed from the member if that is not healthy
   • Parameter [query, timeout ,retry]

#! /usr/bin/env ruby
require 'rubygems'
require 'naminori'

service_options = { vip:"192.168.77.9", role: "dns" }

Naminori::Service::Dns.health_check("lvs", service_options)

# crontab -l
# Chef Name: health_check
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/root/bin
* * * * * for i in `seq 0 10 59`;do (sleep ${i}; /opt/serf/event_handlers/health_check_example.rb)& done;

Service Event Detail

Naminori::Service::Dns.event(lb_name, options)

• service_name: dns or http
• lb_name: lvs
• options

#dns default
        {
          role: "dns",               # role name
          port: "53",                # service port
          protocols: ["udp", "tcp"], # protocol(array)
          vip: "192.168.77.9",       # service vip
          method: "gateway",         # lvs_method gateway/ip/nat
          query: "pepabo.com",       # health_check_query
          retry: 3,                  # health_check_retry_count
          timeout: 3,                # health_check_time_out
          notifier: nil              # notifier
        }

Author

• pyama