vagrant-google 0.1.5 → 0.2.0.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 98d90aca1f311a5e931dfba4272b3eea4124186c
-  data.tar.gz: b89236d39cde025535f1a5d93fd2ac8c38524420
+  metadata.gz: 9138dfef6eb002e0a0b062826a22779273f99e3e
+  data.tar.gz: 64f03a09fcb48ff555452da308eb887b0415a62c
 SHA512:
-  metadata.gz: 8e93cc69317c7c7277f328f01d40acbedf74a7242d5a8a9c025c9742c08b775190d30aca35fdc086abd56fa97b526da202529d35af1fc9e599955838909eb90d
-  data.tar.gz: bdb3211ee1f182c97d7e51816acaddf81e63a64b3c6cfd3e2440d43286c10f017498afe6be38c682b610226a1929dbe1c9e3f8b2e11953dea9f8bca36b5b685f
+  metadata.gz: 3540aa6eb5f490cd3342bb3e17f87415975a5d6f722aa9f623f9fbb013423b4a4c87cf6fce36c3399db520d1d4e1f933eca74a7f5754b8fae336c3f73632d908
+  data.tar.gz: de4b191f28d94ff4e9767025253e17dfb5d8f64cc5833ea18a50c062d3e5f5ad1b6fb2aba3253a3e3b28de810cf969b221dfcb35255ca01673cba4436d6f6873

data/.gitignore

@@ -12,6 +12,7 @@ Gemfile.lock
 
 # Vagrant
 .vagrant
-Vagrantfile*
-!example_box/Vagrantfile
-!vagrantfile_examples/*
+/Vagrantfile*
+
+# Intellij projects folder
+.idea

data/.rubocop.yml

@@ -0,0 +1,7 @@
+# Importing TODO list to sanely lint new submissions.
+inherit_from: .rubocop_todo.yml
+
+AllCops:
+  Exclude:
+  - './Vagrantfile'
+  - './vagrant-google.gemspec'

data/.rubocop_todo.yml

@@ -0,0 +1,201 @@
+# This configuration was generated by `rubocop --auto-gen-config`
+# on 2015-07-13 18:02:44 +0000 using RuboCop version 0.31.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 2
+Lint/LiteralInCondition:
+  Enabled: false
+
+# Offense count: 3
+Lint/ParenthesesAsGroupedExpression:
+  Enabled: false
+
+# Offense count: 1
+Lint/RescueException:
+  Enabled: false
+
+# Offense count: 4
+# Cop supports --auto-correct.
+Lint/UnusedBlockArgument:
+  Enabled: false
+
+# Offense count: 14
+# Cop supports --auto-correct.
+Lint/UnusedMethodArgument:
+  Enabled: false
+
+# Offense count: 2
+Lint/UselessAssignment:
+  Enabled: false
+
+# Offense count: 12
+Metrics/AbcSize:
+  Max: 155
+
+# Offense count: 2
+# Configuration parameters: CountComments.
+Metrics/ClassLength:
+  Max: 156
+
+# Offense count: 4
+Metrics/CyclomaticComplexity:
+  Max: 22
+
+# Offense count: 62
+# Configuration parameters: AllowURI, URISchemes.
+Metrics/LineLength:
+  Max: 132
+
+# Offense count: 15
+# Configuration parameters: CountComments.
+Metrics/MethodLength:
+  Max: 124
+
+# Offense count: 1
+# Configuration parameters: CountComments.
+Metrics/ModuleLength:
+  Max: 141
+
+# Offense count: 4
+Metrics/PerceivedComplexity:
+  Max: 22
+
+# Offense count: 1
+Style/AccessorMethodName:
+  Enabled: false
+
+# Offense count: 7
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/AndOr:
+  Enabled: false
+
+# Offense count: 18
+Style/Documentation:
+  Enabled: false
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/DotPosition:
+  Enabled: false
+
+# Offense count: 9
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/EmptyLinesAroundBlockBody:
+  Enabled: false
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/EmptyLinesAroundClassBody:
+  Enabled: false
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/EmptyLinesAroundModuleBody:
+  Enabled: false
+
+# Offense count: 2
+# Configuration parameters: Exclude.
+Style/FileName:
+  Enabled: false
+
+# Offense count: 2
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/FirstParameterIndentation:
+  Enabled: false
+
+# Offense count: 1
+# Configuration parameters: MinBodyLength.
+Style/GuardClause:
+  Enabled: false
+
+# Offense count: 33
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles, UseHashRocketsWithSymbolValues.
+Style/HashSyntax:
+  Enabled: false
+
+# Offense count: 2
+# Cop supports --auto-correct.
+Style/InfiniteLoop:
+  Enabled: false
+
+# Offense count: 3
+# Cop supports --auto-correct.
+Style/MethodCallParentheses:
+  Enabled: false
+
+# Offense count: 19
+# Cop supports --auto-correct.
+Style/NegatedIf:
+  Enabled: false
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Style/NilComparison:
+  Enabled: false
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Style/Not:
+  Enabled: false
+
+# Offense count: 2
+# Cop supports --auto-correct.
+# Configuration parameters: AllowMultipleReturnValues.
+Style/RedundantReturn:
+  Enabled: false
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Style/RedundantSelf:
+  Enabled: false
+
+# Offense count: 8
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/SignalException:
+  Enabled: false
+
+# Offense count: 2
+# Cop supports --auto-correct.
+# Configuration parameters: SupportedStyles.
+Style/SpaceAroundEqualsInParameterDefault:
+  EnforcedStyle: no_space
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/SpaceBeforeBlockBraces:
+  Enabled: false
+
+# Offense count: 1
+# Cop supports --auto-correct.
+Style/SpaceBeforeComma:
+  Enabled: false
+
+# Offense count: 342
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/StringLiterals:
+  Enabled: false
+
+# Offense count: 6
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+Style/StringLiteralsInInterpolation:
+  Enabled: false
+
+# Offense count: 4
+# Cop supports --auto-correct.
+# Configuration parameters: IgnoredMethods.
+Style/SymbolProc:
+  Enabled: false

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+# 0.1.6 (Unreleased)
+
+* Added support for service account definitions [tcr]
+* Added support for preemptible instances [jcdang]
+* Implemented auto_restart and on_host_maintenance options [jcdang]
+* Added support for IP address specification by name [temikus]
+* Instance name now defaults to time + uuid [temikus]
+* Removed legacy rsync code, switched to Vagrant built-in SyncedFolders [temikus]
+* Implemented vagrant halt and reload actions [temikus]
+* Switched to fog-google metagem [temikus]
+* Added a linter and custom acceptance tests [temikus]
+* Updated documentation and examples [mbrukman, temikus]
+* Miscellaneous UI/UX updates and bugfixes [temikus]
+
 # 0.1.5 (May 2015)
 
 * Added support for JSON private keys [temikus]

data/README.md

@@ -4,7 +4,7 @@ This is a [Vagrant](http://www.vagrantup.com) 1.2+ plugin that adds an
 [Google Compute Engine](http://cloud.google.com/compute/) (GCE) provider to
 Vagrant, allowing Vagrant to control and provision instances in GCE.
 
-**NOTE:** This plugin requires Vagrant 1.2+,
+**NOTE:** This plugin requires Vagrant 1.2+.
 
 ## Features
 
@@ -91,8 +91,8 @@ end
 
 And then run `vagrant up --provider=google`.
 
-This will start an Debian 7 (Wheezy) instance in the us-central1-f zone,
-with an n1-standard-1 machine, and the "default" network within your project.
+This will start a Debian 7 (Wheezy) instance in the `us-central1-f` zone,
+with an `n1-standard-1` machine, and the `"default"` network within your project.
 And assuming your SSH information (see below) was filled in properly within
 your Vagrantfile, SSH and provisioning will work as well.
 
@@ -110,15 +110,32 @@ respective `~/.ssh/authorized_keys` entries.  Most new GCE users will use the
 [Cloud SDK](https://cloud.google.com/sdk/) `gcloud compute` utility when first
 getting started with GCE. This utility has built in support for creating SSH
 key pairs, and uploading the public key to the GCE metadata service.  By
-default, `glcoud compute` creates a key pair named
+default, `gcloud compute` creates a key pair named
 `~/.ssh/google_compute_engine[.pub]`.
 
 Note that you can use the more standard `~/.ssh/id_rsa[.pub]` files, but you
 will need to manually add your public key to the GCE metadata service so your
 VMs will pick up the the key. Note that they public key is typically
 prefixed with the username, so that the daemon on the VM adds the public key
-to the correct user account.  See the blow links for more help with SSH and
-GCE VMs.
+to the correct user account.
+
+Additionally, you will probably need to add the key and username to override
+settings in your Vagrantfile like so:
+
+```ruby
+config.vm.provider :google do |google, override|
+
+    #...google provider settings are skipped...
+
+    override.ssh.username = "testuser"
+    override.ssh.private_key_path = "~/.ssh/id_rsa"
+
+    #...google provider settings are skipped...
+
+end
+```
+
+See the links below for more help with SSH and GCE VMs.
 
   * https://cloud.google.com/compute/docs/instances#sshing
   * https://cloud.google.com/compute/docs/console#sshkeys
@@ -126,8 +143,8 @@ GCE VMs.
 ## Box Format
 
 Every provider in Vagrant must introduce a custom box format. This provider
-introduces `google` boxes. You can view an example box in the
-[example_box/](https://github.com/mitchellh/vagrant-google/tree/master/example_box).
+introduces `google` boxes. You can view an example box in
+[example_boxes/](https://github.com/mitchellh/vagrant-google/tree/master/example_boxes).
 That directory also contains instructions on how to build a box.
 
 The box format is basically just the required `metadata.json` file along with
@@ -156,8 +173,15 @@ This provider exposes quite a few provider-specific configuration options:
  "default".
 * `tags` - An array of tags to apply to this instance.
 * `zone` - The zone name where the instance will be created.
-* `can_ip_forward` - Boolean wether to enable IP Forwarding.
-* `external_ip` - The external IP address to use.
+* `can_ip_forward` - Boolean whether to enable IP Forwarding.
+* `external_ip` - The external IP address to use (supports names).
+* `preemptible` - Boolean whether to enable preemptibility. Default is false.
+* `auto_restart` - Boolean whether to enable auto_restart. Default is true.
+* `on_host_maintenance` - What to do on host maintenance. Default is "MIGRATE".
+* `service_accounts` or `scopes` - An array of OAuth2 account scopes for
+  services that the instance will have access to. Those can be both full API
+  scopes and just endpoint aliases (the part after `...auth/`), for example:
+  `['bigquery', 'https://www.googleapis.com/auth/compute']`.
 
 These can be set like typical provider-specific configuration:
 
@@ -197,6 +221,7 @@ Vagrant.configure("2") do |config|
         zone1f.machine_type = "n1-standard-4"
         zone1f.zone = "us-central1-f"
         zone1f.metadata = {'custom' => 'metadata', 'testing' => 'foobarbaz'}
+        zone1f.scopes = ['bigquery', 'monitoring', 'https://www.googleapis.com/auth/compute']
         zone1f.tags = ['web', 'app1']
     end
   end
@@ -205,10 +230,10 @@ end
 
 The zone-specific configurations will override the top-level configurations
 when that zone is used. They otherwise inherit the top-level configurations,
-as you would probably expect.
+as you would expect.
 
-There are a few example Vagrantfile's located in the
-[vagrantfile_examples/ directory](https://github.com/mitchellh/vagrant-google/tree/master/vagrantfile_examples/)
+There are a few example Vagrantfiles located in the
+[vagrantfile_examples/ directory](https://github.com/mitchellh/vagrant-google/tree/master/vagrantfile_examples/).
 
 ## Networks
 
@@ -222,22 +247,20 @@ There is minimal support for synced folders. Upon `vagrant up`,
 `vagrant reload`, and `vagrant provision`, the Google provider will use
 `rsync` (if available) to uni-directionally sync the folder to the remote
 machine over SSH.
-
-This is good enough for all built-in Vagrant provisioners (shell, chef, and
-puppet) to work!
+See [Vagrant Synced folders: rsync](https://docs.vagrantup.com/v2/synced-folders/rsync.html)
 
 ## Development
 
 To work on the `vagrant-google` plugin, clone this repository out, and use
 [Bundler](http://gembundler.com) to get the dependencies:
 
-```
+```sh
 $ bundle
 ```
 
 Once you have the dependencies, verify the unit tests pass with `rake`:
 
-```
+```sh
 $ bundle exec rake
 ```
 
@@ -246,7 +269,7 @@ the plugin without installing it into your Vagrant environment by just
 creating a `Vagrantfile` in the top level of this directory (it is gitignored)
 that uses it, and uses bundler to execute Vagrant:
 
-```
+```sh
 $ bundle exec vagrant up --provider=google
 ```
 
@@ -259,7 +282,7 @@ Before you start acceptance tests, you'll need to set the authentication variabl
 
 Next, export your GCP authentication data:
 
-```
+```sh
 export GOOGLE_CLIENT_EMAIL="your-google_service_account_email@developer.gserviceaccount.com"
 export GOOGLE_PROJECT_ID="your-google-cloud-project-id"
 export GOOGLE_JSON_KEY_LOCATION="/full/path/to/your/private-key.json"
@@ -269,8 +292,8 @@ export GOOGLE_SSH_KEY_LOCATION="/home/testuser/.ssh/id_rsa"
 ```
 
 After, you can run acceptance tests by running the `run` task in `acceptance` namespace:
-```
-bundle exec rake acceptance:run
+```sh
+$ bundle exec rake acceptance:run
 ```
 
 ## Changelog

data/example_boxes/gce/Vagrantfile

@@ -0,0 +1,23 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+# Copyright 2013 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+Vagrant.configure("2") do |config|
+  config.vm.provider :google do |google|
+    google.image = "debian-7-wheezy-v20150127"
+    google.machine_type = "n1-standard-1"
+    google.zone = "us-central1-f"
+  end
+end

data/example_boxes/gce-test/Vagrantfile

@@ -0,0 +1,30 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+# Copyright 2013 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+Vagrant.configure("2") do |config|
+  config.vm.provider :google do |google, override|
+
+    if ENV['GOOGLE_SSH_USER'] and ENV['GOOGLE_SSH_KEY_LOCATION']
+      override.ssh.username = ENV['GOOGLE_SSH_USER']
+      override.ssh.private_key_path = ENV['GOOGLE_SSH_KEY_LOCATION']
+    end
+
+    google.image = "debian-7-wheezy-v20150127"
+    google.machine_type = "n1-standard-1"
+    google.zone = "us-central1-f"
+
+  end
+end

data/lib/vagrant-google/action/connect_google.rb

@@ -11,7 +11,7 @@
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
-require "fog"
+require "fog/google"
 require "log4r"
 
 module VagrantPlugins
@@ -29,20 +29,16 @@ module VagrantPlugins
         def call(env)
           provider_config = env[:machine].provider_config
 
-          unless provider_config.google_json_key_location.nil?
-            fog_config = {
-              :provider            => :google,
-              :google_project      => provider_config.google_project_id,
-              :google_client_email => provider_config.google_client_email,
-              :google_json_key_location => provider_config.google_json_key_location
-            }
+          # Build fog config
+          fog_config = {
+            :provider            => :google,
+            :google_project      => provider_config.google_project_id,
+            :google_client_email => provider_config.google_client_email
+          }
+          if provider_config.google_json_key_location.nil?
+            fog_config[:google_key_location] = provider_config.google_key_location
           else
-            fog_config = {
-              :provider            => :google,
-              :google_project      => provider_config.google_project_id,
-              :google_client_email => provider_config.google_client_email,
-              :google_key_location => provider_config.google_key_location
-            }
+            fog_config[:google_json_key_location] = provider_config.google_json_key_location
           end
 
           @logger.info("Connecting to Google...")

data/lib/vagrant-google/action/is_terminated.rb

@@ -0,0 +1,31 @@
+# Copyright 2015 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+module VagrantPlugins
+  module Google
+    module Action
+      # This can be used with "Call" built-in to check if the machine
+      # is stopped and branch in the middleware.
+      class IsTerminated
+        def initialize(app, env)
+          @app = app
+        end
+
+        def call(env)
+          env[:result] = env[:machine].state.id == :TERMINATED
+          @app.call(env)
+        end
+      end
+    end
+  end
+end

data/lib/vagrant-google/action/run_instance.rb

@@ -35,19 +35,23 @@ module VagrantPlugins
           zone = env[:machine].provider_config.zone
 
           # Get the configs
-          zone_config        = env[:machine].provider_config.get_zone_config(zone)
-          image              = zone_config.image
-          name               = zone_config.name
-          machine_type       = zone_config.machine_type
-          disk_size          = zone_config.disk_size
-          disk_name          = zone_config.disk_name
-          disk_type          = zone_config.disk_type
-          network            = zone_config.network
-          metadata           = zone_config.metadata
-          tags               = zone_config.tags
-          can_ip_forward     = zone_config.can_ip_forward
-          external_ip        = zone_config.external_ip
-          autodelete_disk    = zone_config.autodelete_disk
+          zone_config         = env[:machine].provider_config.get_zone_config(zone)
+          image               = zone_config.image
+          name                = zone_config.name
+          machine_type        = zone_config.machine_type
+          disk_size           = zone_config.disk_size
+          disk_name           = zone_config.disk_name
+          disk_type           = zone_config.disk_type
+          network             = zone_config.network
+          metadata            = zone_config.metadata
+          tags                = zone_config.tags
+          can_ip_forward      = zone_config.can_ip_forward
+          external_ip         = zone_config.external_ip
+          preemptible         = zone_config.preemptible
+          auto_restart        = zone_config.auto_restart
+          on_host_maintenance = zone_config.on_host_maintenance
+          autodelete_disk     = zone_config.autodelete_disk
+          service_accounts    = zone_config.service_accounts
 
           # Launch!
           env[:ui].info(I18n.t("vagrant_google.launching_instance"))
@@ -63,26 +67,27 @@ module VagrantPlugins
           env[:ui].info(" -- Tags:            '#{tags}'")
           env[:ui].info(" -- IP Forward:      #{can_ip_forward}")
           env[:ui].info(" -- External IP:     #{external_ip}")
+          env[:ui].info(" -- Preemptible:     #{preemptible}")
+          env[:ui].info(" -- Auto Restart:    #{auto_restart}")
+          env[:ui].info(" -- On Maintenance:  #{on_host_maintenance}")
           env[:ui].info(" -- Autodelete Disk: #{autodelete_disk}")
+          env[:ui].info(" -- Scopes:          #{service_accounts}")
           begin
             request_start_time = Time.now().to_i
-            if !external_ip.nil?
-              address = env[:google_compute].addresses.get_by_ip_address(external_ip)
-              if !address.nil?
-                if address.in_use?
-                  raise Errors::ExternalIpError,
-                    :externalip => external_ip
-                end
-              end
+            # Warn on ssh-key overrides
+            if env[:machine].config.ssh.username.nil?
+              env[:ui].warn(I18n.t("vagrant_google.warn_ssh_vagrant_user"))
             end
-            #Check if disk type is available in the zone
+            # Check if specified external ip is available
+            external_ip = get_external_ip(env, external_ip) if external_ip
+            # Check if disk type is available in the zone
             if !disk_type.nil?
               disk_type_obj = env[:google_compute].list_disk_types(zone).body['items'].select { |dt| dt['name'] == disk_type } || []
               if !disk_type_obj.empty?
                 disk_type = disk_type_obj[0]["selfLink"]
               else
                 raise Errors::DiskTypeError,
-                  :disktype => disk_type
+                      :disktype => disk_type
               end
             end
 
@@ -112,18 +117,22 @@ module VagrantPlugins
             end
 
             defaults = {
-              :name               => name,
-              :zone_name          => zone,
-              :machine_type       => machine_type,
-              :disk_size          => disk_size,
-              :disk_type          => disk_type,
-              :image              => image,
-              :network            => network,
-              :metadata           => metadata,
-              :tags               => tags,
-              :can_ip_forward     => can_ip_forward,
-              :external_ip        => external_ip,
-              :disks              => [disk.get_as_boot_disk(true, autodelete_disk)],
+              :name                => name,
+              :zone_name           => zone,
+              :machine_type        => machine_type,
+              :disk_size           => disk_size,
+              :disk_type           => disk_type,
+              :image               => image,
+              :network             => network,
+              :metadata            => metadata,
+              :tags                => tags,
+              :can_ip_forward      => can_ip_forward,
+              :external_ip         => external_ip,
+              :preemptible         => preemptible,
+              :auto_restart        => auto_restart,
+              :on_host_maintenance => on_host_maintenance,
+              :disks               => [disk.get_as_boot_disk(true, autodelete_disk)],
+              :service_accounts    => service_accounts
             }
             server = env[:google_compute].servers.create(defaults)
             @logger.info("Machine '#{zone}:#{name}' created.")
@@ -184,6 +193,20 @@ module VagrantPlugins
           destroy_env[:force_confirm_destroy] = true
           env[:action_runner].run(Action.action_destroy, destroy_env)
         end
+
+        def get_external_ip(env, external_ip)
+          address = env[:google_compute].addresses.get_by_ip_address_or_name(external_ip)
+          if address.nil?
+            raise Errors::ExternalIpDoesNotExistError,
+                  :externalip => external_ip
+          end
+          if address.in_use?
+            raise Errors::ExternalIpInUseError,
+                  :externalip => external_ip
+          end
+          # Resolve the name to IP address
+          address.address
+        end
       end
     end
   end