kitchen-google 0.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4085522e906870ad6ced21e1324fd139ffb2f454
+  data.tar.gz: e0337e83aa1ae41006264dfe93c0ddd2739f63f8
+SHA512:
+  metadata.gz: b0b0e34c10fa46f788a8e36a11d637a2fe6d5e6729f7c023481a5fae135d4df1eab74ee7cf2c9a877bda863ceb3e46a9df27734ebb4857acb60aaa4669ef7c2a
+  data.tar.gz: a683597a6f9cd2eac0d90cf34bd2b7e4ab7c6612558781c52a78ed646c778b353b513603f9d9b215eb5534a7a6f810d248a27c6e2ca1f790b9953dc3355e5c08

data/.gitignore

@@ -0,0 +1,5 @@
+*~
+*#
+.ruby-version
+*.gem
+Gemfile.lock

data/.rubocop.yml

@@ -0,0 +1 @@
+inherit_from: .rubocop_todo.yml

data/.rubocop_todo.yml

@@ -0,0 +1,11 @@
+# This configuration was generated by `rubocop --auto-gen-config`
+# on 2014-09-20 08:00:47 -0700 using RuboCop version 0.26.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: 1
+# Configuration parameters: CountComments.
+Metrics/ClassLength:
+  Max: 102

data/.travis.yml

@@ -0,0 +1,9 @@
+language: ruby
+
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.0
+
+before_install:
+  - gem update bundler

data/CHANGELOG.md

@@ -0,0 +1,76 @@
+## 0.3.0 / 2016-01-23
+
+### New Features
+
+* #14: Support service_accounts option in Fog
+* #22: Add JSON credential file and Preemptible VM support
+
+### Improvements
+
+* Move to test-kitchen GitHub org
+* Fixes to tests
+
+## 0.2.0 / 2014-09-20
+
+### Improvements
+
+* #10: Deprecate "area" in configuration for "region"
+* #11: Fix name length, via @pdunnavant
+* #12: Generate instance names that are valid for GCE
+
+## 0.1.2 / 2014-04-16
+
+### New Features
+
+* Add documentation for new asia-east1 region.
+
+### Improvements
+
+* #9: Dependency updates: Remove faraday version constraint; require newer 
+  ridley gem.
+
+## 0.1.0 / 2014-03-29
+
+### New Features
+
+* PR #7: Add support for specifying SSH keys in public_key_path, via @someara
+* Add support for setting username
+* Support GCE v1 API, including persistent disks.
+
+### Improvements
+
+* Add rspec tests and Travis support.
+
+## 0.0.6 / 2014-02-23:
+
+* Require Ruby 1.9 or greater.
+
+### Improvements
+
+* Add support for specifying GCE network and tags.
+
+### Bug fixes
+
+* Temporarily pin Fog version to 1.19.0 until 1.20.0 support is added.
+* Require Faraday Gem version to be ~> 0.8.9; 0.9.0 breaks test-kitchen.
+
+## 0.0.4 / 2013-12-28
+
+### Bug fixes
+
+* In GCE, instance names must be unique; derive by default from
+  `<suite>-<platform>` and a UUID.
+* Fix bug where running `kitchen create` multiple times would create
+  duplicate instances.
+* Require version of Fog with exponential backoff in GCE API queries.
+
+### Improvements
+
+* README formatting and clarity fixes.
+* Add concept of an "area" (us, europe, any) to automatically select
+  an availability zone from those that are up within the requested
+  area for each instance.
+
+## 0.0.1 / 2013-10-20
+
+### Initial release

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify dependencies in gemspec:
+gemspec

data/LICENSE

@@ -0,0 +1,15 @@
+Author:: Andrew Leonard (<andy@hurricane-ridge.com>)
+
+Copyright (C) 2013-2014, Andrew Leonard
+
+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.

data/README.md

@@ -0,0 +1,192 @@
+# Kitchen::Gce - A Test Kitchen Driver for Google Compute Engine
+
+[![Build Status](https://travis-ci.org/test-kitchen/kitchen-google.png?branch=master)](https://travis-ci.org/test-kitchen/kitchen-google)
+[![Code Climate](https://codeclimate.com/github/test-kitchen/kitchen-google.png)](https://codeclimate.com/github/test-kitchen/kitchen-google)
+
+This is a [Test Kitchen](https://github.com/opscode/test-kitchen/)
+driver for Google Compute Engine.  While similar to EC2 and other IaaS
+providers, GCE has a couple of advantages for Chef cookbook testing:
+
+* (Subjectively) faster instance launch times; and
+* Sub-hour billing.
+
+## Requirements
+
+Ruby 1.9 or greater.
+
+A [Google Cloud Platform](https://cloud.google.com) account is
+required.  If you do not already have an appropriate "project" in
+which to run your test-kitchen instances, create one, noting the
+"project id".  Then, within the [Google API
+Console](https://code.google.com/apis/console/), create a "service
+account" for the project under the "API Access" tab.  Save the key
+file, and note the email address associated with the service account
+(e.g. 123456789012@developer.gserviceaccount.com - not the project
+owner's email address).
+
+If you are not using the `public_key_path` setting (see below) and
+have not [set up SSH keys for your GCE
+environment](https://cloud.google.com/compute/docs/instances/adding-removing-ssh-keys),
+you must also do that prior to using kitchen-gce.  Also, you will
+likely want to add your SSH keys to ssh-agent prior to converging any
+instances.
+
+## Installation
+
+Assuming you are using Bundler, ensure the Gemfile within your Chef
+cookbook contains at least the following:
+
+```ruby
+source 'https://rubygems.org'
+
+gem 'berkshelf'
+
+group :integration do
+  gem 'kitchen-gce'
+end
+```
+
+Then, execute `bundle install`.
+
+## Configuration
+
+### `area`
+
+Deprecated - use equivalent [`region`](#region) instead.  If both `area` and
+`region` are set, the value of `region` will be used.
+
+### `autodelete_disk`
+
+Boolean specifying whether or not to automatically delete boot disk
+for test instance.  Default: `true`
+
+### `disk_size`
+
+Size, in gigabytes, of boot disk.  Default: `10`.
+
+### `google_client_email`
+
+**Required** Email address associated with your GCE service account.
+(N.B. - this is not the same as the Google Cloud Platform user's email
+account; should be in the form
+"123456789012@developer.gserviceaccount.com".)
+
+### `google_key_location`
+
+**Required** Path to GCE service account key file.
+
+### `google_project`
+
+**Required** Project ID of the GCE project into which test-kitchen
+instances will be launched.
+
+### `image_name`
+
+**Required** Operating system image to deploy.
+
+### `inst_name`
+
+Name to give to instance; unlike EC2's "Name" tag, this is used as an
+instance identifier and must be unique.  If none is specified, a unique
+name will be auto-generated; note that auto-generated names must be
+used if there is more than one test suite.  Default:
+`<suite>-<platform>-<UUID>`
+
+### `machine_type`
+
+GCE instance type (size) to launch; default: `n1-standard-1`
+
+### `network`
+
+GCE network that instance will be attached to; default: `default`
+
+### `preemptible`
+
+If set to `true`, GCE instance will be brought up as a  [preemptible](https://cloud.google.com/compute/docs/instances/preemptible) virtual machine,
+that runs at a much lower price than normal instances. However, Compute 
+Engine might terminate (preempt) these instances if it requires access 
+to those resources for other tasks; default: `false`
+
+### `public_key_path`
+
+Path to the public half of the ssh key that will be deployed to
+`~username/.ssh/authorized_keys`; see also [`username`](#username) below.
+
+### `region`
+
+Region in which to launch instances.  `region` is defined as the part
+prior to the second hyphen in an availability zone's name; e.g. in
+`us-central1-b`, the region is `us-central1`.  Specifying region but
+not `zone_name` allows kitchen-gce to avoid launching instances into a
+zone that is down for maintenance.  If `any` is specified, kitchen-gce
+will select a zone from all regions.  Default: `us-central1` (lowest
+cost region); valid values: `any`, `asia-east1`, `europe-west1`,
+`us-central1`
+
+### `tags`
+
+Array of tags to associate with instance; default: `[]`
+
+### `username`
+
+Username test-kitchen will log into instance as; default: `ENV['USER']`
+
+### `zone_name`
+
+Location into which instances will be launched.  If not specified, a
+zone is chosen from available zones within the [`region`](#region).
+
+## Example
+
+An example `.kitchen.yml` file using kitchen-gce might look something
+like this:
+
+```ruby
+---
+driver_plugin: gce
+driver_config:
+  google_client_email: "123456789012@developer.gserviceaccount.com"
+  google_key_location: "<%= ENV['HOME']%>/gce/1234567890abcdef1234567890abcdef12345678-privatekey.p12"
+  google_project: "alpha-bravo-123"
+  network: "kitchenci"
+  region: any
+
+platforms:
+- name: debian-7
+  driver_config:
+    image_name: debian-7-wheezy-v20151104
+    require_chef_omnibus: true
+    public_key_path: '/home/alice/.ssh/google_compute_engine.pub'
+    tags: ["somerole"]
+
+suites:
+- name: default
+  run_list: ["recipe[somecookbook]"]
+  attributes: {}
+```
+
+## Development
+
+Source is hosted on [GitHub](https://github.com/anl/kitchen-gce).
+
+* Pull requests are welcome, using topic branches if possible:
+
+1. Fork the repo.
+2. Create a feature branch, commit changes to it and push them.
+3. Submit a pull request.
+
+* Report issues or submit feature requests on [GitHub](https://github.com/anl/kitchen-gce/issues)
+
+## Author, Acknowledgements, Etc.
+
+Created and maintained by [Andrew Leonard](http://andyleonard.com)
+([andy@hurricane-ridge.com](mailto:andy@hurricane-ridge.com)).
+
+The initial release drew heavily on the
+[kitchen-ec2](https://github.com/opscode/kitchen-ec2/) gem for both
+inspiration and implementation details.  Any bugs, however, are solely
+the author's own doing.
+
+## License
+
+Licensed under Apache 2.0.

data/Rakefile

@@ -0,0 +1,8 @@
+# -*- coding: utf-8 -*-
+
+require 'rspec/core/rake_task'
+
+desc 'Run RSpec unit tests'
+RSpec::Core::RakeTask.new(:spec)
+
+task default: [:spec]

data/kitchen-google.gemspec

@@ -0,0 +1,26 @@
+# -*- coding: utf-8 -*-
+Gem::Specification.new do |s|
+  s.name        = 'kitchen-google'
+  s.version     = '0.3.0'
+  s.date        = '2016-01-23'
+  s.summary     = 'Kitchen::Driver::Gce'
+  s.description = 'A Test-Kitchen driver for Google Compute Engine'
+  s.authors     = ['Andrew Leonard']
+  s.email       = 'andy@hurricane-ridge.com'
+  s.files       = `git ls-files`.split($/) # rubocop:disable SpecialGlobalVars
+  s.homepage    = 'https://github.com/test-kitchen/kitchen-google'
+  s.license     = 'Apache 2.0'
+
+  s.add_dependency 'fog', '>= 1.31.0'
+  s.add_dependency 'google-api-client'
+  s.add_dependency 'ridley', '>= 3.0.0' # See GH issue RiotGames/ridley#239
+  s.add_dependency 'test-kitchen'
+
+  s.add_development_dependency 'bundler'
+  s.add_development_dependency 'pry'
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'rubocop'
+
+  s.required_ruby_version = '>= 1.9'
+end

data/lib/kitchen/driver/gce.rb

@@ -0,0 +1,170 @@
+# -*- coding: utf-8 -*-
+#
+# Author:: Andrew Leonard (<andy@hurricane-ridge.com>)
+#
+# Copyright (C) 2013-2014, Andrew Leonard
+#
+# 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.
+
+require 'fog'
+require 'securerandom'
+
+require 'kitchen'
+
+module Kitchen
+  module Driver
+    # Google Compute Engine driver for Test Kitchen
+    #
+    # @author Andrew Leonard <andy@hurricane-ridge.com>
+    class Gce < Kitchen::Driver::SSHBase
+      default_config :area, 'us-central1'
+      default_config :autodelete_disk, true
+      default_config :disk_size, 10
+      default_config :machine_type, 'n1-standard-1'
+      default_config :network, 'default'
+      default_config :inst_name, nil
+      default_config :service_accounts, nil
+      default_config :tags, []
+      default_config :username, ENV['USER']
+      default_config :zone_name, nil
+      default_config :google_key_location, nil
+      default_config :google_json_key_location, nil
+      default_config :preemptible, false
+      default_config :auto_restart, false
+
+      required_config :google_client_email
+      required_config :google_project
+      required_config :image_name
+
+      def create(state)
+        return if state[:server_id]
+
+        instance = create_instance
+        state[:server_id] = instance.identity
+
+        info("GCE instance <#{state[:server_id]}> created.")
+
+        wait_for_up_instance(instance, state)
+
+      rescue Fog::Errors::Error, Excon::Errors::Error => ex
+        raise ActionFailed, ex.message
+      end
+
+      def destroy(state)
+        return if state[:server_id].nil?
+
+        instance = connection.servers.get(state[:server_id])
+        instance.destroy unless instance.nil?
+        info("GCE instance <#{state[:server_id]}> destroyed.")
+        state.delete(:server_id)
+        state.delete(:hostname)
+      end
+
+      private
+
+      def connection
+        options = {
+          provider: 'google',
+          google_client_email: config[:google_client_email],
+          google_project: config[:google_project]
+        }
+
+        [
+          :google_key_location,
+          :google_json_key_location
+        ].each do |k|
+          options[k] = config[k] unless config[k].nil?
+        end
+
+        Fog::Compute.new(options)
+      end
+
+      def create_disk
+        disk = connection.disks.create(
+          name: config[:inst_name],
+          size_gb: config[:disk_size],
+          zone_name: config[:zone_name],
+          source_image: config[:image_name]
+        )
+
+        disk.wait_for { disk.ready? }
+        disk
+      end
+
+      def create_instance
+        config[:region] ||= config[:area]
+
+        config[:inst_name] ||= generate_inst_name
+        config[:zone_name] ||= select_zone
+
+        disk = create_disk
+        create_server(disk)
+      end
+
+      def create_server(disk)
+        connection.servers.create(
+          name: config[:inst_name],
+          disks: [disk.get_as_boot_disk(true, config[:autodelete_disk])],
+          machine_type: config[:machine_type],
+          network: config[:network],
+          service_accounts: config[:service_accounts],
+          tags: config[:tags],
+          zone_name: config[:zone_name],
+          public_key_path: config[:public_key_path],
+          username: config[:username],
+          preemptible: config[:preemptible],
+          on_host_maintenance: config[:preemptible] ? 'TERMINATE': 'MIGRATE',
+          auto_restart: config[:auto_restart]
+        )
+      end
+
+      def generate_inst_name
+        # Inspired by generate_name from kitchen-rackspace
+        name = instance.name.downcase
+        name.gsub!(/([^-a-z0-9])/, '-')
+        name = 't' + name unless name =~ /^[a-z]/
+        base_name = name[0..25] # UUID is 36 chars, max name length 63
+        gen_name = "#{base_name}-#{SecureRandom.uuid}"
+        unless gen_name =~ /^[a-z]([-a-z0-9]*[a-z0-9])?$/
+          fail "Invalid generated instance name: #{gen_name}"
+        end
+        gen_name
+      end
+
+      def select_zone
+        if config[:region] == 'any'
+          zone_regexp = /^[a-z]+\-/
+        else
+          zone_regexp = /^#{config[:region]}\-/
+        end
+        zones = connection.zones.select do |z|
+          z.status == 'UP' && z.name.match(zone_regexp)
+        end
+        fail 'No up zones in region' unless zones.length >= 1
+        zones.sample.name
+      end
+
+      def wait_for_up_instance(instance, state)
+        instance.wait_for do
+          print '.'
+          ready?
+        end
+        print '(server ready)'
+        state[:hostname] = instance.public_ip_address ||
+          instance.private_ip_address
+        wait_for_sshd(state[:hostname], config[:username])
+        puts '(ssh ready)'
+      end
+    end
+  end
+end

data/spec/kitchen/driver/gce_spec.rb

@@ -0,0 +1,398 @@
+# -*- coding: utf-8 -*-
+#
+# Author:: Andrew Leonard (<andy@hurricane-ridge.com>)
+#
+# Copyright (C) 2013-2014, Andrew Leonard
+#
+# 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.
+
+require_relative '../../spec_helper.rb'
+
+require 'resolv'
+
+describe Kitchen::Driver::Gce do
+
+  let(:config) do
+    { google_client_email: '123456789012@developer.gserviceaccount.com',
+      google_project: 'alpha-bravo-123'
+    }
+  end
+
+  let(:state) { Hash.new }
+
+  let(:logged_output) { StringIO.new }
+  let(:logger) { Logger.new(logged_output) }
+
+  let(:instance) do
+    double(
+      logger: logger,
+      name: 'default-distro-12'
+    )
+  end
+
+  let(:driver) do
+    d = Kitchen::Driver::Gce.new(config)
+    allow(d).to receive(:instance) { instance }
+    allow(d).to receive(:wait_for_sshd) { true }
+    d
+  end
+
+  let(:fog) do
+    Fog::Compute::Google::Mock.new({})
+  end
+
+  let(:disk) do
+    fog.disks.create(
+      name: 'rspec-test-disk',
+      size_gb: 10,
+      zone_name: 'us-central1-b',
+      source_image: 'debian-7-wheezy-v20130816'
+    )
+  end
+
+  let(:server) do
+    fog.servers.create(
+      name: 'rspec-test-instance',
+      disks: [disk],
+      machine_type: 'n1-standard-1',
+      zone_name: 'us-central1-b'
+    )
+  end
+
+  before(:each) do
+    Fog.mock!
+    Fog::Mock.reset
+    Fog::Mock.delay = 0
+  end
+
+  describe '#initialize' do
+    context 'with default options' do
+
+      defaults = {
+        area: 'us-central1',
+        autodelete_disk: true,
+        disk_size: 10,
+        inst_name: nil,
+        machine_type: 'n1-standard-1',
+        network: 'default',
+        region: nil,
+        service_accounts: nil,
+        tags: [],
+        username: ENV['USER'],
+        zone_name: nil,
+        google_key_location: nil,
+        google_json_key_location: nil,
+        preemptible: false,
+        auto_restart: false
+      }
+
+      defaults.each do |k, v|
+        it "sets the correct default for #{k}" do
+          expect(driver[k]).to eq(v)
+        end
+      end
+    end
+
+    context 'with overriden options' do
+      overrides = {
+        area: 'europe-west',
+        autodelete_disk: false,
+        disk_size: 15,
+        inst_name: 'ci-instance',
+        machine_type: 'n1-highmem-8',
+        network: 'dev-net',
+        region: 'asia-east1',
+        service_accounts: %w(userdata.email compute.readonly),
+        tags: %w(qa integration),
+        username: 'root',
+        zone_name: 'europe-west1-a',
+        google_key_location: '/path/to/foo.p12',
+        google_json_key_location: '/path/to/bar.json',
+        preemptible: true,
+        auto_restart: false # because of preemptible, see kitchen-google/pull/22
+      }
+
+      let(:config) { overrides }
+
+      overrides.each do |k, v|
+        it "overrides the default value for #{k}" do
+          expect(driver[k]).to eq(v)
+        end
+      end
+    end
+  end
+
+  describe '#connection' do
+    context 'with required variables set' do
+      it 'returns a Fog Compute object' do
+        expect(driver.send(:connection)).to be_a(Fog::Compute::Google::Mock)
+      end
+
+      it 'uses the v1 api version' do
+        conn = driver.send(:connection)
+        expect(conn.api_version).to eq('v1')
+      end
+    end
+
+    context 'without required variables set' do
+      let(:config) { Hash.new }
+
+      it 'raises an error' do
+        expect { driver.send(:connection) }.to raise_error(ArgumentError)
+      end
+    end
+  end
+
+  describe '#create' do
+    context 'with an existing server' do
+      let(:state) do
+        s = Hash.new
+        s[:server_id] = 'default-distro-12345678'
+        s
+      end
+
+      it 'returns if server_id already exists' do
+        expect(driver.create(state)).to equal nil
+      end
+    end
+
+    context 'when an instance is successfully created' do
+
+      let(:driver) do
+        d = Kitchen::Driver::Gce.new(config)
+        allow(d).to receive(:create_instance) { server }
+        allow(d).to receive(:wait_for_up_instance) { nil }
+        d
+      end
+
+      it 'sets a value for server_id in the state hash' do
+        driver.send(:create, state)
+        expect(state[:server_id]).to eq('rspec-test-instance')
+      end
+
+      it 'returns nil' do
+        expect(driver.send(:create, state)).to equal(nil)
+      end
+    end
+  end
+
+  describe '#create_disk' do
+    context 'with defaults and required options' do
+      it 'returns a Google Disk object' do
+        config[:image_name] = 'debian-7-wheezy-v20130816'
+        config[:inst_name] = 'rspec-disk'
+        config[:zone_name] = 'us-central1-a'
+        expect(driver.send(:create_disk)).to be_a(Fog::Compute::Google::Disk)
+      end
+    end
+
+    context 'without required options' do
+      it 'returns a Fog NotFound Error' do
+        expect { driver.send(:create_disk) }.to raise_error(
+          Fog::Errors::NotFound)
+      end
+    end
+  end
+
+  describe '#create_instance' do
+    context 'with default options' do
+      it 'returns a Fog Compute Server object' do
+        expect(driver.send(:create_instance)).to be_a(
+          Fog::Compute::Google::Server)
+      end
+
+      it 'sets the region to the default "us-central1"' do
+        driver.send(:create_instance)
+        expect(config[:region]).to eq('us-central1')
+      end
+    end
+
+    context 'area set, region unset' do
+      let(:config) do
+        { area: 'europe-west1',
+          google_client_email: '123456789012@developer.gserviceaccount.com',
+          google_key_location: '/home/user/gce/123456-privatekey.p12',
+          google_project: 'alpha-bravo-123'
+        }
+      end
+
+      it 'sets region to the area value' do
+        driver.send(:create_instance)
+        expect(config[:region]).to eq(config[:area])
+      end
+    end
+
+    context 'area set, region set' do
+      let(:config) do
+        { area: 'fugazi',
+          google_client_email: '123456789012@developer.gserviceaccount.com',
+          google_key_location: '/home/user/gce/123456-privatekey.p12',
+          google_project: 'alpha-bravo-123',
+          region: 'europe-west1'
+        }
+      end
+
+      it 'sets the region independent of the area value' do
+        driver.send(:create_instance)
+        expect(config[:region]).to eq('europe-west1')
+      end
+
+    end
+  end
+
+  describe '#create_server' do
+    context 'with default options' do
+      it 'returns a Fog Compute Server object' do
+        expect(driver.send(:create_instance)).to be_a(
+          Fog::Compute::Google::Server)
+      end
+    end
+  end
+
+  describe '#destroy' do
+    let(:state) do
+      s = Hash.new
+      s[:server_id] = 'rspec-test-instance'
+      s[:hostname] = '198.51.100.17'
+      s
+    end
+
+    it 'returns if server_id does not exist' do
+      expect(driver.destroy({})).to equal nil
+    end
+
+    it 'removes the server state information' do
+      driver.destroy(state)
+      expect(state[:hostname]).to equal(nil)
+      expect(state[:server_id]).to equal(nil)
+    end
+  end
+
+  describe '#generate_inst_name' do
+    context 'with a name less than 28 characters' do
+      it 'concatenates the name and a UUID' do
+        expect(driver.send(:generate_inst_name)).to match(
+          /^default-distro-12-[a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}$/)
+      end
+    end
+
+    context 'with a name 27 characters or longer' do
+      let(:instance) do
+        double(name: 'a23456789012345678901234567')
+      end
+
+      it 'shortens the base name and appends a UUID' do
+        expect(driver.send(:generate_inst_name).length).to eq 63
+        expect(driver.send(:generate_inst_name)).to match(
+          /^a2345678901234567890123456
+            -[a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}$/x)
+      end
+    end
+
+    context 'with a "name" value containing an invalid leading character' do
+      let(:instance) do
+        double(name: '12345')
+      end
+
+      it 'adds a leading "t"' do
+        expect(driver.send(:generate_inst_name)).to match(
+          /^t12345
+            -[a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}$/x)
+      end
+    end
+
+    context 'with a "name" value containing uppercase letters' do
+      let(:instance) do
+        double(name: 'AbCdEf')
+      end
+
+      it 'downcases the "name" characters in the instance name' do
+        expect(driver.send(:generate_inst_name)).to match(
+          /^abcdef
+            -[a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}$/x)
+      end
+    end
+
+    context 'with a name value containing invalid characters' do
+      let(:instance) do
+        double(name: 'a!b@c#d$e%f^g&h*i(j)')
+      end
+
+      it 'replaces the invalid characters with dashes' do
+        expect(driver.send(:generate_inst_name)).to match(
+          /^a-b-c-d-e-f-g-h-i-j-
+            -[a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}$/x)
+      end
+    end
+  end
+
+  describe '#select_zone' do
+    context 'when choosing from any region' do
+      let(:config) do
+        { region: 'any',
+          google_client_email: '123456789012@developer.gserviceaccount.com',
+          google_key_location: '/home/user/gce/123456-privatekey.p12',
+          google_project: 'alpha-bravo-123'
+        }
+      end
+
+      it 'chooses from all zones' do
+        expect(driver.send(:select_zone)).to satisfy do |zone|
+          %w(europe-west1-a us-central1-a us-central1-b
+             us-central2-a).include?(zone)
+        end
+      end
+    end
+
+    context 'when choosing from the "europe-west1" region' do
+      let(:config) do
+        { region: 'europe-west1',
+          google_client_email: '123456789012@developer.gserviceaccount.com',
+          google_key_location: '/home/user/gce/123456-privatekey.p12',
+          google_project: 'alpha-bravo-123'
+        }
+      end
+
+      it 'chooses a zone in europe-west1' do
+        expect(driver.send(:select_zone)).to satisfy do |zone|
+          %w(europe-west1-a).include?(zone)
+        end
+      end
+    end
+
+    context 'when choosing from the default "us-central1" region' do
+      let(:config) do
+        { region: 'us-central1',
+          google_client_email: '123456789012@developer.gserviceaccount.com',
+          google_key_location: '/home/user/gce/123456-privatekey.p12',
+          google_project: 'alpha-bravo-123'
+        }
+      end
+
+      it 'chooses a zone in us-central1' do
+        expect(driver.send(:select_zone)).to satisfy do |zone|
+          %w(us-central1-a us-central1-b us-central2-a).include?(zone)
+        end
+
+      end
+    end
+  end
+
+  describe '#wait_for_up_instance' do
+    it 'sets the hostname' do
+      driver.send(:wait_for_up_instance, server, state)
+      # Mock instance gives us a random IP each time:
+      expect(state[:hostname]).to match(Resolv::IPv4::Regex)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,21 @@
+# -*- coding: utf-8 -*-
+#
+# Author:: Andrew Leonard (<andy@hurricane-ridge.com>)
+#
+# Copyright (C) 2013-2014, Andrew Leonard
+#
+# 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.
+
+require 'rspec'
+
+require_relative '../lib/kitchen/driver/gce'

metadata

@@ -0,0 +1,182 @@
+--- !ruby/object:Gem::Specification
+name: kitchen-google
+version: !ruby/object:Gem::Version
+  version: 0.3.0
+platform: ruby
+authors:
+- Andrew Leonard
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-01-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: fog
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.31.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 1.31.0
+- !ruby/object:Gem::Dependency
+  name: google-api-client
+  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: ridley
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+- !ruby/object:Gem::Dependency
+  name: test-kitchen
+  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: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A Test-Kitchen driver for Google Compute Engine
+email: andy@hurricane-ridge.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rubocop.yml
+- .rubocop_todo.yml
+- .travis.yml
+- CHANGELOG.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- kitchen-google.gemspec
+- lib/kitchen/driver/gce.rb
+- spec/kitchen/driver/gce_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/test-kitchen/kitchen-google
+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: '1.9'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.14
+signing_key: 
+specification_version: 4
+summary: Kitchen::Driver::Gce
+test_files: []