vagrant-hostoverseer 1.8.1.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+pkg
+Gemfile.lock
+test/.vagrant

data/CHANGELOG.md

@@ -0,0 +1,67 @@
+# Changelog
+
+## 1.6.1
+### Bug fixes
+* Retain tmp hosts file and fix a bug where powershell mv does not move folder contents, in that context it's moving a file. [[#157](https://github.com/smdahlen/vagrant-hostmanager/issues/157)]
+
+[Full diff](https://github.com/smdahlen/vagrant-hostmanager/compare/v1.6.0...v1.6.1)
+
+
+## 1.6.0
+### Features
+* splits hostnames across many lines [[#67](https://github.com/smdahlen/vagrant-hostmanager/pull/103)]
+
+### Bug fixes
+* show description for hostmanager when vagrant list-commands is triggered [[#105](https://github.com/smdahlen/vagrant-hostmanager/pull/105)]
+
+### Miscelaneous
+* extract old vagrant version compatibility code into util method [[#97](https://github.com/smdahlen/vagrant-hostmanager/pull/97)]
+* migrate HostsFile code into its own class [[#98](https://github.com/smdahlen/vagrant-hostmanager/pull/97)]
+
+[Full diff](https://github.com/smdahlen/vagrant-hostmanager/compare/v1.5.0...v1.6.0)
+
+
+## 1.5.0
+### Features
+* hostmanager now runs *before* provisioning takes place, on `up` action [[#73](https://github.com/smdahlen/vagrant-hostmanager/issues/73)]
+
+### Bug fixes
+* properly detect hosts file location on Windows guests [[#67](https://github.com/smdahlen/vagrant-hostmanager/pull/67)]
+* do not add host if IP cannot be determined [[#85](https://github.com/smdahlen/vagrant-hostmanager/pull/85)]
+* force moving of hosts file on Linux guests [[#93](https://github.com/smdahlen/vagrant-hostmanager/pull/93)]
+* allow top-level config options (eg. `ip_resolver`) to propagate to machine configs [[#91](https://github.com/smdahlen/vagrant-hostmanager/issues/91)]
+
+### Miscelaneous
+* add passwordless sudo instructions to README [[#95](https://github.com/smdahlen/vagrant-hostmanager/pull/95)]
+
+[Full diff](https://github.com/smdahlen/vagrant-hostmanager/compare/v1.4.0...v1.5.0)
+
+
+## 1.4.0
+### Features
+* supports vagrant 1.5 [[#80](https://github.com/smdahlen/vagrant-hostmanager/issues/80), [#81](https://github.com/smdahlen/vagrant-hostmanager/pull/81)]
+* only updates hosts file if contents have changed [[#78](https://github.com/smdahlen/vagrant-hostmanager/pull/78)]
+* custom ip resolver now has access to the machine whose hosts file is being updated [[#62](https://github.com/smdahlen/vagrant-hostmanager/pull/62)]
+
+### Bug fixes
+* custom IP resolver result no longer ignored [[#57](https://github.com/smdahlen/vagrant-hostmanager/pull/57)]
+* when multiple private_networks are configured, the first one is used [[#64](https://github.com/smdahlen/vagrant-hostmanager/pull/64)]
+* destroyed machines are now removed from hosts file [[#52](https://github.com/smdahlen/vagrant-hostmanager/pull/52)]
+
+[Full diff](https://github.com/smdahlen/vagrant-hostmanager/compare/v1.3.0...v1.4.0)
+
+
+## 1.3.0
+### Features
+* allow defining a custom IP resolver block [[#15](https://github.com/smdahlen/vagrant-hostmanager/pull/15)]
+* handle removing destroyed machines from hosts file (currently only works with `include_offline = true`) [[#45](https://github.com/smdahlen/vagrant-hostmanager/pull/45)]
+* attempt to elevate privileges when needed in Windows hosts [[#48](https://github.com/smdahlen/vagrant-hostmanager/pull/48)]
+
+### Bug fixes
+* `--provider` command-line option now finds machines as expected [[#46](https://github.com/smdahlen/vagrant-hostmanager/pull/46)]
+* uses proper `hosts` file location in Windows under cygwin [[#49](https://github.com/smdahlen/vagrant-hostmanager/pull/49)]
+
+### Miscelaneous
+* MIT license added to gemspec
+
+[Full diff](https://github.com/smdahlen/vagrant-hostmanager/compare/v1.2.3...v1.3.0)

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+group :development do
+  gem 'vagrant', :git => 'git://github.com/mitchellh/vagrant.git', :tag => 'v1.6.2'
+end
+
+group :plugins do
+  gemspec
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Shawn Dahlen
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,246 @@
+Vagrant Host Manager
+====================
+
+[![Gem](https://img.shields.io/gem/v/vagrant-hostmanager.svg)](https://rubygems.org/gems/vagrant-hostmanager)
+[![Gem](https://img.shields.io/gem/dt/vagrant-hostmanager.svg)](https://rubygems.org/gems/vagrant-hostmanager)
+[![Gem](https://img.shields.io/gem/dtv/vagrant-hostmanager.svg)](https://rubygems.org/gems/vagrant-hostmanager)
+[![Twitter](https://img.shields.io/twitter/url/https/github.com/smdahlen/vagrant-hostmanager.svg?style=social)](https://twitter.com/intent/tweet?text=Check%20out%20this%20awesome%20Vagrant%20plugin%21&url=https%3A%2F%2Fgithub.com%2Fsmdahlen%2Fvagrant-hostmanager&hashtags=vagrant%hostmanager&original_referer=)
+
+`vagrant-hostoverseer` is a fork of `vagrant-hostmanager` adding a few extras:
+- Manage hostnames of multiple providers,
+- Add the option to manages aliases on one line only,
+- Add the option of automagically add the fqdn to the alias line.
+
+The reasons of these patches are:
+- In the upstream hostmanager, if you spawn a machine with one provider, the addresses
+in all other providers are lost.
+- The format of `/etc/hosts` according the man page is that one IP must appear on one line only.
+- As there are a few ways to set up fqdn on a server and different tools will
+use different ways to get the fqdn, only adding aliases in `/etc/hosts` created some issues,
+for instance on AWS.
+
+I would like to have these patches merged upstream but first I am not sure upstream
+considers these contributions worthwhile and second I know that there is at least an
+annoying limitation where the fqdn option will work properly only for linux hosts.
+
+Beyond the command to install the plugin, all references and configurations are
+still named hostmanager as my goal is not keep this fork, but have it eventually
+properly merged.
+
+`vagrant-hostmanager` is a Vagrant 1.1+ plugin that manages the `/etc/hosts`
+file on guest machines (and optionally the host). Its goal is to enable
+resolution of multi-machine environments deployed with a cloud provider
+where IP addresses are not known in advance.
+
+*NOTE:* Version 1.1 of the plugin prematurely introduced a feature to hook into
+commands other than `vagrant up` and `vagrant destroy`. Version 1.1 broke support
+for some providers. Version 1.2 reverts this feature until a suitable implementation
+supporting all providers is available.
+
+***Potentially breaking change in v1.5.0:*** the running order on `vagrant up` has changed
+so that hostmanager runs before provisioning takes place.  This ensures all hostnames are
+available to the guest when it is being provisioned
+(see [#73](https://github.com/smdahlen/vagrant-hostmanager/issues/73)).
+Previously, hostmanager would run as the very last action.  If you depend on the old behavior,
+see the [provisioner](#provisioner) section.
+
+Installation
+------------
+Install the plugin following the typical Vagrant 1.1 procedure:
+
+    $ vagrant plugin install vagrant-oversser
+
+Usage
+-----
+To update the `/etc/hosts` file on each active machine, run the following
+command:
+
+    $ vagrant hostmanager
+
+The plugin hooks into the `vagrant up` and `vagrant destroy` commands
+automatically.
+When a machine enters or exits the running state , all active
+machines with the same provider will have their `/etc/hosts` file updated
+accordingly. Set the `hostmanager.enabled` attribute to `true` in the
+Vagrantfile to activate this behavior.
+
+To update the host's `/etc/hosts` file, set the `hostmanager.manage_host`
+attribute to `true`.
+
+To update the guests' `/etc/hosts` file, set the `hostmanager.manage_guest`
+attribute to `true`.
+
+A machine's IP address is defined by either the static IP for a private
+network configuration or by the SSH host configuration. To disable
+using the private network IP address, set `config.hostmanager.ignore_private_ip`
+to true.
+
+A machine's host name is defined by `config.vm.hostname`. If this is not
+set, it falls back to the symbol defining the machine in the Vagrantfile.
+
+If the `hostmanager.include_offline` attribute is set to `true`, boxes that are
+up or have a private ip configured will be added to the hosts file.
+
+In addition, the `hostmanager.aliases` configuration attribute can be used
+to provide aliases for your host names.
+
+On some systems, long alias lines have been reported to cause issues
+(see [#60](https://github.com/smdahlen/vagrant-hostmanager/issues/60)).
+In such cases, you may render aliases on separate lines by setting
+```hostmanager.aliases_on_separate_lines = true```.
+
+If you have all your aliases on one line and you do not manage the fqdn fully
+from vagrant (AWS for instance) you might want to add the fqdn as
+well on this line to have only one canonical line. In such case, set
+```hostmanager.add_current_fqdn = true```.
+
+
+Example configuration:
+
+```ruby
+Vagrant.configure("2") do |config|
+  config.hostmanager.enabled = true
+  config.hostmanager.manage_host = true
+  config.hostmanager.manage_guest = true
+  config.hostmanager.ignore_private_ip = false
+  config.hostmanager.include_offline = true
+  config.vm.define 'example-box' do |node|
+    node.vm.hostname = 'example-box-hostname'
+    node.vm.network :private_network, ip: '192.168.42.42'
+    node.hostmanager.aliases = %w(example-box.localdomain example-box-alias)
+  end
+end
+```
+
+### Provisioner
+
+Starting at version 1.5.0, `vagrant up` runs hostmanager before any provisioning occurs.
+If you would like hostmanager to run after or during your provisioning stage,
+you can use hostmanager as a provisioner.  This allows you to use the provisioning
+order to ensure that hostmanager runs when desired. The provisioner will collect
+hosts from boxes with the same provider as the running box.
+
+Example:
+
+```ruby
+# Disable the default hostmanager behavior
+config.hostmanager.enabled = false
+
+# ... possible provisioner config before hostmanager ...
+
+# hostmanager provisioner
+config.vm.provision :hostmanager
+
+# ... possible provisioning config after hostmanager ...
+```
+
+Custom IP resolver
+------------------
+
+You can customize way, how host manager resolves IP address
+for each machine. This might be handy in case of aws provider,
+where host name is stored in ssh_info hash of each machine.
+This causes generation of invalid /etc/hosts file.
+
+Custom IP resolver gives you oportunity to calculate IP address
+for each machine by yourself, giving You also access to the machine that is
+updating /etc/hosts. For example:
+
+```ruby
+config.hostmanager.ip_resolver = proc do |vm, resolving_vm|
+  if hostname = (vm.ssh_info && vm.ssh_info[:host])
+    `host #{hostname}`.split("\n").last[/(\d+\.\d+\.\d+\.\d+)/, 1]
+  end
+end
+```
+
+Passwordless sudo
+-----------------
+
+To avoid being asked for the password every time the hosts file is updated,
+enable passwordless sudo for the specific command that hostmanager uses to
+update the hosts file.
+
+  - Add the following snippet to the sudoers file (e.g.
+    `/etc/sudoers.d/vagrant_hostmanager`):
+
+    ```
+    Cmnd_Alias VAGRANT_HOSTMANAGER_UPDATE = /bin/cp <home-directory>/.vagrant.d/tmp/hosts.local /etc/hosts
+    %<admin-group> ALL=(root) NOPASSWD: VAGRANT_HOSTMANAGER_UPDATE
+    ```
+
+    Replace `<home-directory>` with your actual home directory (e.g.
+    `/home/joe`) and `<admin-group>` with the group that is used by the system
+    for sudo access (usually `sudo` on Debian/Ubuntu systems and `wheel`
+    on Fedora/Red Hat systems).
+
+  - If necessary, add yourself to the `<admin-group>`:
+
+    ```
+    usermod -aG <admin-group> <user-name>
+    ```
+
+    Replace `<admin-group>` with the group that is used by the system for sudo
+    access (see above) and `<user-name>` with you user name.
+
+Windows support
+---------------
+
+Hostmanager will detect Windows guests and hosts and use the appropriate
+path for the ```hosts``` file: ```%WINDIR%\System32\drivers\etc\hosts```
+
+By default on a Windows host, the ```hosts``` file is not writable without
+elevated privileges. If hostmanager detects that it cannot overwrite the file,
+it will attempt to do so with elevated privileges, causing the
+[UAC](http://en.wikipedia.org/wiki/User_Account_Control) prompt to appear.
+
+To avoid the UAC prompt, open ```%WINDIR%\System32\drivers\etc\``` in
+Explorer, right-click the hosts file, go to Properties > Security > Edit
+and give your user Modify permission.
+
+### UAC limitations
+
+Due to limitations caused by UAC, cancelling out of the UAC prompt will not cause any
+visible errors, however the ```hosts``` file will not be updated.
+
+
+Contribute
+----------
+To contribute, fork then clone the repository, and then the following:
+
+**Developing**
+
+1. Install [Bundler](http://bundler.io/)
+2. Currently the Bundler version is locked to 1.6.9, please install this version.
+    * `sudo gem install bundler -v '1.6.9'`
+3. Then install vagrant-hostmanager dependancies:
+    * `bundle _1.6.9_ install`
+
+**Testing**
+
+1. Build and package your newly developed code:
+    * `rake gem:build`
+2. Then install the packaged plugin:
+    * `vagrant plugin install pkg/vagrant-hostmanager-*.gem`
+3. Once you're done testing, roll-back to the latest released version:
+    * `vagrant plugin uninstall vagrant-hostmanager`
+    * `vagrant plugin install vagrant-hostmanager`
+4. Once you're satisfied developing and testing your new code, please submit a pull request for review.
+
+**Releasing**
+
+To release a new version of vagrant-hostmanager you will need to do the following:
+
+*(only contributors of the GitHub repo and owners of the project at RubyGems will have rights to do this)*
+
+1. First, bump the version in ~/lib/vagrant-hostmanager/version.rb:
+    * Follow [Semantic Versioning](http://semver.org/).
+2. Then, create a matching GitHub Release (this will also create a tag):
+    * Preface the version number with a `v`.
+    * https://github.com/smdahlen/vagrant-hostmanager/releases
+3. You will then need to build and push the new gem to RubyGems:
+    * `rake gem:build`
+    * `gem push pkg/vagrant-hostmanager-1.6.1.gem`
+4. Then, when John Doe runs the following, they will receive the updated vagrant-hostmanager plugin:
+    * `vagrant plugin update`
+    * `vagrant plugin update vagrant-hostmanager`

data/Rakefile

@@ -0,0 +1,12 @@
+require 'bundler/gem_helper'
+
+# Change to the directory of this file.
+Dir.chdir(File.expand_path("../", __FILE__))
+
+namespace :gem do
+  Bundler::GemHelper.install_tasks
+end
+
+task :test do
+  sh 'bash test/test.sh'
+end

data/lib/vagrant-hostmanager.rb

@@ -0,0 +1,14 @@
+require 'vagrant-hostmanager/plugin'
+require 'vagrant-hostmanager/version'
+require 'vagrant-hostmanager/errors'
+
+module VagrantPlugins
+  module HostManager
+    def self.source_root
+      @source_root ||= Pathname.new(File.expand_path('../../', __FILE__))
+    end
+
+    I18n.load_path << File.expand_path('locales/en.yml', source_root)
+    I18n.reload!
+  end
+end

data/lib/vagrant-hostmanager/action.rb

@@ -0,0 +1,31 @@
+require 'vagrant-hostmanager/action/update_all'
+require 'vagrant-hostmanager/action/update_guest'
+require 'vagrant-hostmanager/action/update_host'
+
+module VagrantPlugins
+  module HostManager
+    module Action
+      include Vagrant::Action::Builtin
+
+      def self.update_all
+        Vagrant::Action::Builder.new.tap do |builder|
+          builder.use ConfigValidate
+          builder.use UpdateAll
+        end
+      end
+
+      def self.update_guest
+        Vagrant::Action::Builder.new.tap do |builder|
+          builder.use ConfigValidate
+          builder.use UpdateGuest
+        end
+      end
+
+      def self.update_host
+        Vagrant::Action::Builder.new.tap do |builder|
+          builder.use UpdateHost
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-hostmanager/action/update_all.rb

@@ -0,0 +1,49 @@
+require 'vagrant-hostmanager/hosts_file/updater'
+require 'vagrant-hostmanager/util'
+
+module VagrantPlugins
+  module HostManager
+    module Action
+      class UpdateAll
+
+        def initialize(app, env)
+          @app = app
+          @machine = env[:machine]
+          @global_env = @machine.env
+          @provider = @machine.provider_name
+          @config = Util.get_config(@global_env)
+          @updater = HostsFile::Updater.new(@global_env, @provider)
+          @logger = Log4r::Logger.new('vagrant::hostmanager::update_all')
+        end
+
+        def call(env)
+          # skip if machine is not active on destroy action
+          return @app.call(env) if !@machine.id && env[:machine_action] == :destroy
+
+          # check config to see if the hosts file should be update automatically
+          return @app.call(env) unless @config.hostmanager.enabled?
+          @logger.info 'Updating /etc/hosts file automatically'
+
+          @app.call(env)
+
+          # update /etc/hosts file on active machines
+          if @machine.config.hostmanager.manage_guest?
+            env[:ui].info I18n.t('vagrant_hostmanager.action.update_guests')
+            @global_env.active_machines.each do |name, p|
+              if p == @provider
+                machine = @global_env.machine(name, p)
+                @updater.update_guest(machine)
+              end
+            end
+          end
+
+          # update /etc/hosts files on host if enabled
+          if @machine.config.hostmanager.manage_host?
+            env[:ui].info I18n.t('vagrant_hostmanager.action.update_host')
+            @updater.update_host
+          end
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-hostmanager/action/update_guest.rb

@@ -0,0 +1,31 @@
+require 'vagrant-hostmanager/hosts_file/updater'
+require 'vagrant-hostmanager/util'
+
+module VagrantPlugins
+  module HostManager
+    module Action
+      class UpdateGuest
+
+        def initialize(app, env)
+          @app = app
+          global_env = env[:global_env]
+          @config = Util.get_config(global_env)
+          @machine = env[:machine]
+          @updater = HostsFile::Updater.new(@machine.env, env[:provider])
+          @logger = Log4r::Logger.new('vagrant::hostmanager::update_guest')
+        end
+
+        def call(env)
+          if @config.hostmanager.manage_guest?
+            env[:ui].info I18n.t('vagrant_hostmanager.action.update_guest', {
+              :name => @machine.name
+            })
+            @updater.update_guest(@machine)
+
+            @app.call(env)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-hostmanager/action/update_host.rb

@@ -0,0 +1,30 @@
+require 'vagrant-hostmanager/hosts_file/updater'
+require 'vagrant-hostmanager/util'
+
+module VagrantPlugins
+  module HostManager
+    module Action
+      class UpdateHost
+
+        def initialize(app, env)
+          @app = app
+          
+          global_env = env[:global_env]
+          @config = Util.get_config(global_env)
+          @updater = HostsFile::Updater.new(global_env, env[:provider])
+          
+          @logger = Log4r::Logger.new('vagrant::hostmanager::update_host')
+        end
+
+        def call(env)
+          if @config.hostmanager.manage_host?
+            env[:ui].info I18n.t('vagrant_hostmanager.action.update_host')
+            @updater.update_host
+          end
+
+          @app.call(env)
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-hostmanager/command.rb

@@ -0,0 +1,44 @@
+module VagrantPlugins
+  module HostManager
+    class Command < Vagrant.plugin('2', :command)
+
+      # Show description when `vagrant list-commands` is triggered
+      def self.synopsis
+        "plugin: vagrant-hostmanager: manages the /etc/hosts file within a multi-machine environment"
+      end
+
+      def execute
+        options = {}
+        opts = OptionParser.new do |o|
+          o.banner = 'Usage: vagrant hostmanager [vm-name]'
+          o.separator ''
+          o.version = VagrantPlugins::HostManager::VERSION
+          o.program_name = 'vagrant hostmanager'
+
+          o.on('--provider provider', String,
+            'Update machines with the specific provider.') do |provider|
+            options[:provider] = provider.to_sym
+          end
+        end
+
+        argv = parse_options(opts)
+        options[:provider] ||= @env.default_provider
+
+        # update /etc/hosts file for specified guest machines
+        with_target_vms(argv, options) do |machine|
+          @env.action_runner.run(Action.update_guest, {
+            :global_env => @env,
+            :machine => machine,
+            :provider => options[:provider]
+          })
+        end
+
+        # update /etc/hosts file for host
+        @env.action_runner.run(Action.update_host, {
+          :global_env => @env,
+          :provider => options[:provider]
+        })
+      end
+    end
+  end
+end

data/lib/vagrant-hostmanager/config.rb

@@ -0,0 +1,90 @@
+module VagrantPlugins
+  module HostManager
+    class Config < Vagrant.plugin('2', :config)
+      attr_accessor :enabled
+      attr_accessor :manage_host
+      attr_accessor :manage_guest
+      attr_accessor :ignore_private_ip
+      attr_accessor :aliases
+      attr_accessor :include_offline
+      attr_accessor :ip_resolver
+      attr_accessor :aliases_on_separate_lines
+      attr_accessor :add_current_fqdn
+
+      alias_method :enabled?, :enabled
+      alias_method :include_offline?, :include_offline
+      alias_method :manage_host?, :manage_host
+      alias_method :manage_guest?, :manage_guest
+
+      def initialize
+        @enabled            = UNSET_VALUE
+        @manage_host        = UNSET_VALUE
+        @manage_guest       = UNSET_VALUE
+        @ignore_private_ip  = UNSET_VALUE
+        @include_offline    = UNSET_VALUE
+        @aliases            = UNSET_VALUE
+        @ip_resolver        = UNSET_VALUE
+        @aliases_on_separate_lines   = UNSET_VALUE
+        @add_current_fqdn   = UNSET_VALUE
+      end
+
+      def finalize!
+        @enabled            = false if @enabled == UNSET_VALUE
+        @manage_host        = false if @manage_host == UNSET_VALUE
+        @manage_guest       = true if @manage_guest == UNSET_VALUE
+        @ignore_private_ip  = false if @ignore_private_ip == UNSET_VALUE
+        @include_offline    = false if @include_offline == UNSET_VALUE
+        @aliases            = [] if @aliases == UNSET_VALUE
+        @ip_resolver        = nil if @ip_resolver == UNSET_VALUE
+        @aliases_on_separate_lines   = false if @aliases_on_separate_lines == UNSET_VALUE
+        @add_current_fqdn   = false if @add_current_fqdn == UNSET_VALUE
+        @aliases = [ @aliases ].flatten
+      end
+
+      def validate(machine)
+        errors = []
+
+        errors << validate_bool('hostmanager.enabled', @enabled)
+        errors << validate_bool('hostmanager.manage_host', @manage_host)
+        errors << validate_bool('hostmanager.manage_guest', @manage_guest)
+        errors << validate_bool('hostmanager.ignore_private_ip', @ignore_private_ip)
+        errors << validate_bool('hostmanager.include_offline', @include_offline)
+        errors.compact!
+
+        # check if aliases option is an Array
+        if  !machine.config.hostmanager.aliases.kind_of?(Array) &&
+            !machine.config.hostmanager.aliases.kind_of?(String)
+          errors << I18n.t('vagrant_hostmanager.config.not_an_array_or_string', {
+            :config_key => 'hostmanager.aliases',
+            :is_class   => aliases.class.to_s,
+          })
+        end
+
+        if !machine.config.hostmanager.ip_resolver.nil? &&
+           !machine.config.hostmanager.ip_resolver.kind_of?(Proc)
+          errors << I18n.t('vagrant_hostmanager.config.not_a_proc', {
+            :config_key => 'hostmanager.ip_resolver',
+            :is_class   => ip_resolver.class.to_s,
+          })
+        end
+
+        errors.compact!
+        { "HostManager configuration" => errors }
+      end
+
+      private
+
+      def validate_bool(key, value)
+        if ![TrueClass, FalseClass].include?(value.class) &&
+           value != UNSET_VALUE
+          I18n.t('vagrant_hostmanager.config.not_a_bool', {
+            :config_key => key,
+            :value      => value.class.to_s
+          })
+        else
+          nil
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-hostmanager/errors.rb

@@ -0,0 +1,6 @@
+module VagrantPlugins
+  module HostManager
+    module Errors
+    end
+  end
+end

data/lib/vagrant-hostmanager/hosts_file/updater.rb

@@ -0,0 +1,270 @@
+require 'tempfile'
+
+module VagrantPlugins
+  module HostManager
+    module HostsFile
+
+      class Updater
+
+        def initialize(global_env, provider)
+          @global_env = global_env
+          @config = Util.get_config(@global_env)
+          @provider = provider
+          @current_machine_config = nil
+        end
+
+        def update_guest(machine)
+          return unless machine.communicate.ready?
+
+          if (machine.communicate.test("uname -s | grep SunOS"))
+            realhostfile = '/etc/inet/hosts'
+          elsif (machine.communicate.test("test -d $Env:SystemRoot"))
+            windir = ""
+            machine.communicate.execute("echo %SYSTEMROOT%", {:shell => :cmd}) do |type, contents|
+              windir << contents.gsub("\r\n", '') if type == :stdout
+            end
+            realhostfile = "#{windir}\\System32\\drivers\\etc\\hosts"
+          else
+            realhostfile = '/etc/hosts'
+          end
+          # download and modify file with Vagrant-managed entries
+          file = @global_env.tmp_path.join("hosts.#{machine.name}")
+          machine.communicate.download(realhostfile, file)
+          @current_machine_config = ((machine && machine.config) || @config)
+          if update_file(file, machine, false)
+
+            # upload modified file and remove temporary file
+            machine.communicate.upload(file, '/tmp/hosts')
+            if windir
+              machine.communicate.sudo("mv -force /tmp/hosts/hosts.#{machine.name} #{realhostfile}")
+            else
+              machine.communicate.sudo("cat /tmp/hosts > #{realhostfile}")
+            end
+          end
+
+        end
+
+        def update_host
+          # copy and modify hosts file on host with Vagrant-managed entries
+          file = @global_env.tmp_path.join('hosts.local')
+
+          if WindowsSupport.windows?
+            # lazily include windows Module
+            class << self
+              include WindowsSupport unless include? WindowsSupport
+            end
+
+            hosts_location = "#{ENV['WINDIR']}\\System32\\drivers\\etc\\hosts"
+            copy_proc = Proc.new { windows_copy_file(file, hosts_location) }
+          else
+            hosts_location = '/etc/hosts'
+            copy_proc = Proc.new { `sudo cp #{file} #{hosts_location}` }
+          end
+
+          FileUtils.cp(hosts_location, file)
+          if update_file(file)
+            copy_proc.call
+          end
+        end
+
+        private
+
+        def update_file(file, resolving_machine = nil, include_id = true)
+          file = Pathname.new(file)
+          old_file_content = file.read
+          new_file_content = update_content(old_file_content, resolving_machine, include_id)
+          file.open('wb') { |io| io.write(new_file_content) }
+          old_file_content != new_file_content
+        end
+
+        def update_content(file_content, resolving_machine, include_id)
+          id = include_id ? " id: #{read_or_create_id}" : ""
+          header = "## vagrant-hostmanager-start-#{@provider}#{id}\n"
+          footer = "## vagrant-hostmanager-end-#{@provider}\n"
+          body = get_machines
+            .map { |machine| get_hosts_file_entry(machine, resolving_machine) }
+            .join
+          get_new_content(header, footer, body, file_content)
+        end
+
+        def get_hosts_file_entry(machine, resolving_machine)
+          ip = get_ip_address(machine, resolving_machine)
+
+          unless ip.nil?
+            names = get_names(machine, resolving_machine)
+            if @current_machine_config.hostmanager.aliases_on_separate_lines
+              names.map { |a| "#{ip}\t#{a}" }.join("\n") + "\n"
+            else
+              "#{ip}\t" + names.join(" ") + "\n"
+            end
+          end
+        end
+
+        def get_ip_address(machine, resolving_machine)
+          custom_ip_resolver = machine.config.hostmanager.ip_resolver
+          if custom_ip_resolver
+            custom_ip_resolver.call(machine, resolving_machine)
+          else
+            ip = nil
+            if machine.config.hostmanager.ignore_private_ip != true
+              machine.config.vm.networks.each do |network|
+                key, options = network[0], network[1]
+                ip = options[:ip] if key == :private_network
+                break if ip
+              end
+            end
+            ip || (machine.ssh_info ? machine.ssh_info[:host] : nil)
+          end
+        end
+
+        # get all names including aliases, in the right order (fqdn first if relevant)
+        def get_names(machine, resolving_machine)
+          host = machine.config.vm.hostname || machine.name
+          aliases = machine.config.hostmanager.aliases
+          all_names = [host] + aliases
+
+          # Optionally prepend current fqdn as well. Useful with hostname set outside
+          # vagrant (eg. aws)
+          if @current_machine_config.hostmanager.add_current_fqdn
+            dns = get_dns(machine)
+            # put fqdn in front
+            all_names = dns + all_names
+          end
+
+          all_names.uniq # order is kept b uniq
+        end
+
+        # return fqdn *and* short name
+        def get_dns(machine)
+          names = []
+          unless machine.nil?
+            machine.communicate.execute('/bin/hostname -f') do |type, hostname|
+              names += [hostname.strip]
+            end
+            machine.communicate.execute('/bin/hostname') do |type, hostname|
+              names += [hostname.strip]
+            end
+          end
+          names
+        end
+
+        def get_machines
+          if @config.hostmanager.include_offline?
+            machines = @global_env.machine_names
+          else
+            machines = @global_env.active_machines
+              .select { |name, provider| provider == @provider }
+              .collect { |name, provider| name }
+          end
+          # Collect only machines that exist for the current provider
+          machines.collect do |name|
+                begin
+                  machine = @global_env.machine(name, @provider)
+                rescue Vagrant::Errors::MachineNotFound
+                  # ignore
+                end
+                machine
+              end
+            .reject(&:nil?)
+        end
+
+        def get_new_content(header, footer, body, old_content)
+          if body.empty?
+            block = "\n"
+          else
+            block = "\n\n" + header + body + footer + "\n"
+          end
+          # Pattern for finding existing block
+          header_pattern = Regexp.quote(header)
+          footer_pattern = Regexp.quote(footer)
+          pattern = Regexp.new("\n*#{header_pattern}.*?#{footer_pattern}\n*", Regexp::MULTILINE)
+          # Replace existing block or append
+          newcontent = old_content.match(pattern) ? old_content.sub(pattern, block) : old_content.rstrip + block
+
+          ### remove name duplication in 127.*
+          cleancontent = ''
+
+          all_names = []
+          # First, extract back names from the body. If a name appear there, it
+          # should not be anywhere else.
+          body.each_line do |line|
+            tokens = line.sub(/#.*$/, '').strip.split(/\s+/)
+            ip = tokens.shift
+            unless tokens.empty?
+              all_names += tokens
+            end
+          end
+
+          # Then remove those names from any 127.* lines
+          newcontent.each_line do |line|
+            if line =~ /^\s*127\./
+              # Here be dragons.
+              tokens = line.sub(/#.*$/, '').strip.split(/\s+/)
+              ip=tokens.shift
+              dedup = tokens - all_names
+              unless dedup.empty?
+                cleancontent += "#{ip}\t" + dedup.join(' ') + "\n"
+              end
+            else
+              cleancontent += line
+            end
+          end
+
+          cleancontent
+
+        end
+
+        def read_or_create_id
+          file = Pathname.new("#{@global_env.local_data_path}/hostmanager/id")
+          if (file.file?)
+            id = file.read.strip
+          else
+            id = SecureRandom.uuid
+            file.dirname.mkpath
+            file.open('w') { |io| io.write(id) }
+          end
+          id
+        end
+
+        ## Windows support for copying files, requesting elevated privileges if necessary
+        module WindowsSupport
+          require 'rbconfig'
+
+          def self.windows?
+            RbConfig::CONFIG['host_os'] =~ /mswin|mingw|cygwin/
+          end
+
+          require 'win32ole' if windows?
+
+          def windows_copy_file(source, dest)
+            begin
+              # First, try Ruby copy
+              FileUtils.cp(source, dest)
+            rescue Errno::EACCES
+              # Access denied, try with elevated privileges
+              windows_copy_file_elevated(source, dest)
+            end
+          end
+
+          private
+
+          def windows_copy_file_elevated(source, dest)
+            # copy command only supports backslashes as separators
+            source, dest = [source, dest].map { |s| s.to_s.gsub(/\//, '\\') }
+
+            # run 'cmd /C copy ...' with elevated privilege, minimized
+            copy_cmd = "copy \"#{source}\" \"#{dest}\""
+            WIN32OLE.new('Shell.Application').ShellExecute('cmd', "/C #{copy_cmd}", nil, 'runas', 7)
+
+            # Unfortunately, ShellExecute does not give us a status code,
+            # and it is non-blocking so we can't reliably compare the file contents
+            # to see if they were copied.
+            #
+            # If the user rejects the UAC prompt, vagrant will silently continue
+            # without updating the hostsfile.
+          end
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-hostmanager/plugin.rb

@@ -0,0 +1,44 @@
+require 'vagrant-hostmanager/action'
+
+module VagrantPlugins
+  module HostManager
+    class Plugin < Vagrant.plugin('2')
+      name 'HostManager'
+      description <<-DESC
+        This plugin manages the /etc/hosts file for the host and guest machines.
+        An entry is created for each running machine using the hostname attribute.
+
+        You can also use the hostmanager provisioner to update the hosts file.
+      DESC
+
+      config(:hostmanager) do
+        require_relative 'config'
+        Config
+      end
+
+      action_hook(:hostmanager, :machine_action_up) do |hook|
+        hook.after(Vagrant::Action::Builtin::Provision, Action.update_all)
+      end
+
+      action_hook(:hostmanager, :machine_action_destroy) do |hook|
+        hook.prepend(Action.update_all)
+      end
+
+      provisioner(:hostmanager) do
+        require_relative 'provisioner'
+        Provisioner
+      end
+
+      # Work-around for vagrant >= 1.5
+      # It breaks without a provisioner config, so we provide a dummy one
+      config(:hostmanager, :provisioner) do
+        ::Vagrant::Config::V2::DummyConfig.new
+      end
+
+      command(:hostmanager) do
+        require_relative 'command'
+        Command
+      end
+    end
+  end
+end

data/lib/vagrant-hostmanager/provisioner.rb

@@ -0,0 +1,24 @@
+require 'vagrant-hostmanager/hosts_file/updater'
+
+module VagrantPlugins
+  module HostManager
+    class Provisioner < Vagrant.plugin('2', :provisioner)
+
+      def initialize(machine, config)
+        super(machine, config)
+        global_env = machine.env
+        @config = Util.get_config(global_env)
+        @updater = HostsFile::Updater.new(global_env, machine.provider_name)
+      end
+
+      def provision
+        if @config.hostmanager.manage_guest?
+          @updater.update_guest(@machine)
+        end
+        if @config.hostmanager.manage_host?
+          @updater.update_host
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-hostmanager/util.rb

@@ -0,0 +1,14 @@
+module VagrantPlugins
+  module HostManager
+    module Util
+      def self.get_config(env)
+        # config_global has been removed from v1.5
+        if Gem::Version.new(::Vagrant::VERSION) >= Gem::Version.new('1.5')
+          env.vagrantfile.config
+        else
+          env.config_global
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-hostmanager/version.rb

@@ -0,0 +1,5 @@
+module VagrantPlugins
+  module HostManager
+    VERSION = '1.8.1.0'
+  end
+end

data/locales/en.yml

@@ -0,0 +1,10 @@
+en:
+  vagrant_hostmanager:
+    action:
+      update_guests: "Updating /etc/hosts file on active guest machines..."
+      update_guest: "[%{name}] Updating /etc/hosts file..."
+      update_host: "Updating /etc/hosts file on host machine (password may be required)..."
+    config:
+      not_a_bool: "A value for %{config_key} can only be true or false, not type '%{value}'"
+      not_an_array_or_string: "A value for %{config_key} must be an Array or String, not type '%{is_class}'"
+      not_a_proc: "A value for %{config_key} must be a Proc, not type '%{is_class}'"

data/test/Vagrantfile

@@ -0,0 +1,46 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+if Gem::Version.new(::Vagrant::VERSION) < Gem::Version.new('1.5')
+  Vagrant.require_plugin('vagrant-hostmanager')
+end
+
+Vagrant.configure('2') do |config|
+
+  if ENV.key? 'VAGRANT_BOX'
+    config.vm.box = ENV['VAGRANT_BOX']
+  else
+    config.vm.box = 'precise64'
+    config.vm.box_url = 'http://cloud-images.ubuntu.com/precise/current/precise-server-cloudimg-vagrant-amd64-disk1.box'
+  end
+
+  config.hostmanager.enabled = true
+  config.hostmanager.manage_host = true
+  config.hostmanager.manage_guest = true
+  # config.hostmanager.aliases_on_separate_lines = true
+
+
+  config.vm.define :server1 do |server|
+    server.vm.hostname = 'fry'
+    server.vm.network :private_network, :ip => '10.0.5.2'
+    server.hostmanager.aliases = %w(alias1 alias2)
+  end
+
+  config.vm.define :server2 do |server|
+    server.vm.hostname = 'bender'
+    server.vm.network :private_network, :ip => '10.0.5.3'
+    server.hostmanager.aliases = %w(alias3 alias4)
+    server.hostmanager.aliases_on_separate_lines = true
+  end
+
+  config.vm.define :server3 do |server|
+    server.vm.hostname = 'leena'
+    server.vm.network :private_network, :ip => '10.0.5.4'
+    server.vm.provision :hostmanager
+  end
+
+  config.vm.define :server4 do |server|
+    server.vm.hostname = 'scruffy'
+    server.vm.provision :hostmanager
+  end
+end

data/test/test.sh

@@ -0,0 +1,14 @@
+cd test
+
+vagrant up
+
+vagrant hostmanager
+
+echo "[server1] /etc/hosts file:"
+vagrant ssh server1 -c 'cat /etc/hosts'
+echo "[server2] /etc/hosts file:"
+vagrant ssh server2 -c 'cat /etc/hosts'
+
+vagrant destroy -f
+
+cd ..

data/vagrant-hostoverseer.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'vagrant-hostmanager/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = 'vagrant-hostoverseer'
+  gem.version       = VagrantPlugins::HostManager::VERSION
+  gem.authors       = ['Shawn Dahlen','Seth Reeser','Guillaume']
+  gem.email         = ['shawn@dahlen.me','info@devopsgroup.io','guillaume@lomig.net']
+  gem.description   = %q{A Vagrant plugin that manages the /etc/hosts file within a multi-machine environment}
+  gem.homepage      = 'https://github.com/lomignet/vagrant-hostoverseer'
+  gem.summary       = gem.description
+  gem.license       = 'MIT'
+
+  gem.files         = `git ls-files`.split($/)
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ['lib']
+
+  gem.add_development_dependency 'bundler', '~> 1.3'
+  gem.add_development_dependency 'rake'
+end

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification
+name: vagrant-hostoverseer
+version: !ruby/object:Gem::Version
+  version: 1.8.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Shawn Dahlen
+- Seth Reeser
+- Guillaume
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-02-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A Vagrant plugin that manages the /etc/hosts file within a multi-machine
+  environment
+email:
+- shawn@dahlen.me
+- info@devopsgroup.io
+- guillaume@lomig.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/vagrant-hostmanager.rb
+- lib/vagrant-hostmanager/action.rb
+- lib/vagrant-hostmanager/action/update_all.rb
+- lib/vagrant-hostmanager/action/update_guest.rb
+- lib/vagrant-hostmanager/action/update_host.rb
+- lib/vagrant-hostmanager/command.rb
+- lib/vagrant-hostmanager/config.rb
+- lib/vagrant-hostmanager/errors.rb
+- lib/vagrant-hostmanager/hosts_file/updater.rb
+- lib/vagrant-hostmanager/plugin.rb
+- lib/vagrant-hostmanager/provisioner.rb
+- lib/vagrant-hostmanager/util.rb
+- lib/vagrant-hostmanager/version.rb
+- locales/en.yml
+- test/Vagrantfile
+- test/test.sh
+- vagrant-hostoverseer.gemspec
+homepage: https://github.com/lomignet/vagrant-hostoverseer
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: A Vagrant plugin that manages the /etc/hosts file within a multi-machine
+  environment
+test_files:
+- test/Vagrantfile
+- test/test.sh