exazk 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d5b2fe8898f276ea675160a7ee638d738ed0309c
+  data.tar.gz: f2fe7cc09d850688203a6877419b16cb5bd278b2
+SHA512:
+  metadata.gz: 91996e8ed29abcc364e786190ed4bb0f3bf189b7cf0ada1f6e0e10c76ab4649fe0672916e3955e722b651a04e1c67d01a2382c7ec303ddcd8474dd21d8406b79
+  data.tar.gz: 133b16825f33acd54a391247d55aad47a33e99d0535ca155d2ddd2bc551acc4b303e9840589b9b17b5309120785436777da89377ee8b7f5bbfedbf197059ac95

data/README.md

@@ -0,0 +1,35 @@
+## Workflow
+* ExaBGP forks new process (exazk.rb);
+* exazk.rb is trying to acquire mutex on ZK:
+  * on success - announce routes and write some information to ZK about master node;
+  * on failure - withdraw routes and spin around trying to acquire mutex once again.
+
+![](http://donatas.net/exazk.png)
+
+## Requirements
+* Zookeeper
+* ExaBGP
+* Ruby
+* zk rubygem
+
+## Install
+* gem install exazk
+
+## Recommendations
+* set `minSessionTimeout` or `tickTime` (zookeeper) as low as you can, to have faster convergence.
+
+## Configuration example
+```
+neighbor 10.0.0.1 {
+    router-id 10.0.0.2;
+    local-address 10.0.0.2;
+    local-as 65501;
+    peer-as 65501;
+    hold-time 5;
+    
+    process announce-routes {
+      run /etc/exabgp/exazk.rb;
+    }
+}
+```
+

data/exazk.gemspec

@@ -0,0 +1,17 @@
+Gem::Specification.new do |s|
+  s.name        = 'exazk'
+  s.version     = '0.0.1'
+  s.date        = '2016-10-18'
+  s.summary     = 'ExaZK'
+  s.description = 'ExaZK is simple L3 high availability plugin for ExaBGP'
+  s.authors     = ['Donatas Abraitis']
+  s.email       = 'donatas.abraitis@gmail.com'
+  s.files       = ['README.md', 'exazk.gemspec', 'lib/exazk.rb']
+#  s.add_development_dependency 'zk', '~> 1.9', '>= 1.9.0'
+#  s.add_development_dependency 'json', '~> 2.0', '>= 2.0.0'
+  s.add_runtime_dependency 'zk'
+	s.add_runtime_dependency 'json'
+  s.homepage    =
+    'http://rubygems.org/gems/exazk'
+  s.license       = 'MIT'
+end

data/lib/exazk.rb

@@ -0,0 +1,57 @@
+require 'zk'
+require 'socket'
+require 'json'
+
+class ExaZK
+  def initialize(mutex, zk_string, routes, data)
+    @mutex = mutex
+    @zk_string = zk_string
+    @routes = routes
+    @data = {
+      hostname: Socket.gethostname,
+      data: data
+    }.to_json
+    @zk = ZK.new(@zk_string)
+  end
+
+  def send_update(route)
+    $stdout.write route
+    $stdout.flush
+  end
+
+  def withdraw_routes
+    @routes.map do |route|
+      route % 'withdraw'
+    end
+  end
+
+  def announce_routes
+    @routes.map do |route|
+      route % 'announce'
+    end
+  end
+
+  def mutex_exists?
+    if @zk.exists?(@mutex)
+      data = JSON.parse(@zk.get(@mutex).first)
+      return true if data['hostname'] == Socket.gethostname
+    else
+      begin
+        @zk.create(@mutex, "#{@data}", :ephemeral => true)
+        return true
+      rescue ZK::Exceptions::NodeExists
+        return false
+      end
+    end
+  end
+
+  def main_loop
+    withdraw_routes.each do |route|
+      send_update(route)
+    end unless mutex_exists?
+
+    announce_routes.each do |route|
+      send_update(route)
+    end if mutex_exists?
+  end
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification
+name: exazk
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Donatas Abraitis
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-10-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: zk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ExaZK is simple L3 high availability plugin for ExaBGP
+email: donatas.abraitis@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- exazk.gemspec
+- lib/exazk.rb
+homepage: http://rubygems.org/gems/exazk
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: ExaZK
+test_files: []