facter_ipaddress_primary 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d45d079e786ade6a760604afaacbd4fa1ae2a772
+  data.tar.gz: 7f9242b93dbc6b15f357d9e67b76eb2069b9704e
+SHA512:
+  metadata.gz: abd5e66f9b5e0953c2b1e756190c23d3c153926bb77924bb13d8ffcea21750304075af127f379c814c1b10cb088ce751bf8acb118ca773b06c3742f90a12fdab
+  data.tar.gz: 6286f080bff66f435d32aa4c06c0bb94ac9b6959327269cd89fdfeca997342b9ec88e8d67e275b3fac683fbd0cc08054565829b52eb84755d6fe1483e14a299a

data/bin/ipaddress_primary_path

@@ -0,0 +1,2 @@
+#!/usr/bin/env ruby
+require_relative 'ipaddress_primary_path'

data/bin/ipaddress_primary_path.rb

@@ -0,0 +1,10 @@
+# FACTERLIB return/wrapper
+path = File.expand_path('../../lib/facter', __FILE__)
+# Exec?
+unless ARGV.empty?
+  env = ENV.to_hash
+  env['FACTERLIB'] = [env['FACTERLIB'], path].compact.join(':')
+  Process.exec(env, *ARGV)
+end
+# Simple return if not used to call facter
+puts path

data/facter_ipaddress_primary.gemspec

@@ -0,0 +1,15 @@
+Gem::Specification.new do |spec|
+  raise 'RubyGems 2.0 or newer is required.' unless spec.respond_to?(:metadata)
+  spec.name = File.basename(__FILE__, '.*')
+  spec.files = `git ls-files -z`.split("\x0")
+  spec.executables = ['ipaddress_primary_path']
+  spec.summary = 'ipaddress_primary fact for facter gem'
+  spec.version = '1.0.0'
+  spec.authors = ['Andrew Smith']
+  spec.email = ['andrew.smith at moneysupermarket.com']
+  spec.description = 'Determines more reliably primary/default NIC in multiple'\
+                     ' NIC scenarios'
+  spec.homepage = 'https://github.com/MSMFG/rubygem_facter_ipaddress_primary'
+  spec.license = 'Apache-2.0'
+  spec.add_dependency('facter', '~>2')
+end

data/lib/facter/ipaddress_primary.rb

@@ -0,0 +1,33 @@
+# ipaddress_primary.rb
+require 'socket'
+
+# Determine closest NICs to target addresses and provide a default NIC
+class AdjacentNicTool
+  # As good as any address for adjacent NIC address test
+  AWS_INSTANCE_METADATA_ADDRESS = '169.254.169.254'.freeze
+
+  # The main NIC determined adjacent to the meta address
+  def self.default_nic
+    adjacent_local(AWS_INSTANCE_METADATA_ADDRESS)
+  end
+
+  # Find closest NIC address to target if we have multiple NICs
+  # (reliable local NIC determination)
+  # Note: UDP Sockets do NOT send anything on connect
+  #       but DO work out what source address will be
+  #       used so the port number is irrelevant to this
+  #       mechanism.
+  def self.adjacent_local(addr)
+    dummy_sock = UDPSocket.new
+    dummy_sock.connect(addr, 1)
+    _fam, _port, _name, addr = dummy_sock.addr
+    addr
+  end
+end
+
+Facter.add(:ipaddress_primary) do
+  confine kernel: %w[Linux FreeBSD OpenBSD SunOS HP-UX Darwin GNU/kFreeBSD]
+  setcode do
+    AdjacentNicTool.default_nic
+  end
+end

data/readme.md

@@ -0,0 +1,25 @@
+# facter_ipaddress_primary
+
+A custom fact for facter that reliably determines the primary NIC based upon the NIC chosen adjacent to the default gateway by using UDP sockets.
+
+Since facter lacks the ability to locate custom facts within gems a wrapper/handler can be used to manage the FACTERLIB environment for you.
+
+Usage:
+
+```
+$ # Appends to FACTERLIB environment variable and execs the specified program
+$ ipaddress_primary_path facter | grep ipaddress
+ipaddress => 10.11.90.148
+ipaddress_en0 => 10.11.90.148
+ipaddress_en5 => 10.10.27.133
+ipaddress_lo0 => 127.0.0.1
+ipaddress_primary => 10.10.27.133
+lib => /usr/local/lib/ruby/gems/2.1.0/gems/facter_ipaddress_primary-1.0.0.pre/lib/facter
+
+$ # No arguments returns the path where the library resides..
+$ ipaddress_primary_path
+/usr/local/lib/ruby/gems/2.1.0/gems/facter_ipaddress_primary-1.0.0.pre/lib/facter
+
+# And this can alternatively be used to add to the path in a script if you prefer that approach
+export FACTERLIB="${FACTERLIB}:`ipaddress_primary_path`"
+```

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: facter_ipaddress_primary
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Andrew Smith
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-01-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: facter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+description: Determines more reliably primary/default NIC in multiple NIC scenarios
+email:
+- andrew.smith at moneysupermarket.com
+executables:
+- ipaddress_primary_path
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/ipaddress_primary_path
+- bin/ipaddress_primary_path.rb
+- facter_ipaddress_primary.gemspec
+- lib/facter/ipaddress_primary.rb
+- readme.md
+homepage: https://github.com/MSMFG/rubygem_facter_ipaddress_primary
+licenses:
+- Apache-2.0
+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.5
+signing_key: 
+specification_version: 4
+summary: ipaddress_primary fact for facter gem
+test_files: []