kitchen-oraclecloud 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 33b69dd01851094025ad850c33a4aabe6d99d423
+  data.tar.gz: 98ccb73064289c4ac8a899fc3a21a56761ed5892
+SHA512:
+  metadata.gz: d3def71eb20c1a700bb650601e9d5b13eb96ef99c50829bd93f7ccef2f83ad32520ec6923ee66a4e784d8e39057eb58baf20b6b9e0f7e35f6b79257ffe2c67ca
+  data.tar.gz: 3091a8663a5754f2ead5829e5aac8c79382599f6c5a380670aa20e7524cf7c3e5bafa86ea5c20c2644f9ad06f7d13ee4b9fa55ae8c7b95aa9d8467fda58c249a

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/.kitchen
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.rubocop.yml

@@ -0,0 +1,14 @@
+Metrics/AbcSize:
+  Max: 50
+Metrics/ClassLength:
+  Max: 125
+Metrics/LineLength:
+  Max: 130
+Metrics/MethodLength:
+  Max: 25
+Style/Documentation:
+  Enabled: false
+Style/SignalException:
+  Enabled: false
+Style/SpaceInsideBrackets:
+  Enabled: false

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+# kitchen-oraclecloud
+
+## v1.0.0 (2015-10-15)
+* Initial release
+

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,201 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction,
+and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by
+the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all
+other entities that control, are controlled by, or are under common
+control with that entity. For the purposes of this definition,
+"control" means (i) the power, direct or indirect, to cause the
+direction or management of such entity, whether by contract or
+otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity
+exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications,
+including but not limited to software source code, documentation
+source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical
+transformation or translation of a Source form, including but
+not limited to compiled object code, generated documentation,
+and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or
+Object form, made available under the License, as indicated by a
+copyright notice that is included in or attached to the work
+(an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object
+form, that is based on (or derived from) the Work and for which the
+editorial revisions, annotations, elaborations, or other modifications
+represent, as a whole, an original work of authorship. For the purposes
+of this License, Derivative Works shall not include works that remain
+separable from, or merely link (or bind by name) to the interfaces of,
+the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including
+the original version of the Work and any modifications or additions
+to that Work or Derivative Works thereof, that is intentionally
+submitted to Licensor for inclusion in the Work by the copyright owner
+or by an individual or Legal Entity authorized to submit on behalf of
+the copyright owner. For the purposes of this definition, "submitted"
+means any form of electronic, verbal, or written communication sent
+to the Licensor or its representatives, including but not limited to
+communication on electronic mailing lists, source code control systems,
+and issue tracking systems that are managed by, or on behalf of, the
+Licensor for the purpose of discussing and improving the Work, but
+excluding communication that is conspicuously marked or otherwise
+designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity
+on behalf of whom a Contribution has been received by Licensor and
+subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+copyright license to reproduce, prepare Derivative Works of,
+publicly display, publicly perform, sublicense, and distribute the
+Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+(except as stated in this section) patent license to make, have made,
+use, offer to sell, sell, import, and otherwise transfer the Work,
+where such license applies only to those patent claims licensable
+by such Contributor that are necessarily infringed by their
+Contribution(s) alone or by combination of their Contribution(s)
+with the Work to which such Contribution(s) was submitted. If You
+institute patent litigation against any entity (including a
+cross-claim or counterclaim in a lawsuit) alleging that the Work
+or a Contribution incorporated within the Work constitutes direct
+or contributory patent infringement, then any patent licenses
+granted to You under this License for that Work shall terminate
+as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+Work or Derivative Works thereof in any medium, with or without
+modifications, and in Source or Object form, provided that You
+meet the following conditions:
+
+(a) You must give any other recipients of the Work or
+Derivative Works a copy of this License; and
+
+(b) You must cause any modified files to carry prominent notices
+stating that You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works
+that You distribute, all copyright, patent, trademark, and
+attribution notices from the Source form of the Work,
+excluding those notices that do not pertain to any part of
+the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its
+distribution, then any Derivative Works that You distribute must
+include a readable copy of the attribution notices contained
+within such NOTICE file, excluding those notices that do not
+pertain to any part of the Derivative Works, in at least one
+of the following places: within a NOTICE text file distributed
+as part of the Derivative Works; within the Source form or
+documentation, if provided along with the Derivative Works; or,
+within a display generated by the Derivative Works, if and
+wherever such third-party notices normally appear. The contents
+of the NOTICE file are for informational purposes only and
+do not modify the License. You may add Your own attribution
+notices within Derivative Works that You distribute, alongside
+or as an addendum to the NOTICE text from the Work, provided
+that such additional attribution notices cannot be construed
+as modifying the License.
+
+You may add Your own copyright statement to Your modifications and
+may provide additional or different license terms and conditions
+for use, reproduction, or distribution of Your modifications, or
+for any such Derivative Works as a whole, provided Your use,
+reproduction, and distribution of the Work otherwise complies with
+the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+any Contribution intentionally submitted for inclusion in the Work
+by You to the Licensor shall be under the terms and conditions of
+this License, without any additional terms or conditions.
+Notwithstanding the above, nothing herein shall supersede or modify
+the terms of any separate license agreement you may have executed
+with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+names, trademarks, service marks, or product names of the Licensor,
+except as required for reasonable and customary use in describing the
+origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+agreed to in writing, Licensor provides the Work (and each
+Contributor provides its Contributions) on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+implied, including, without limitation, any warranties or conditions
+of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any
+risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+whether in tort (including negligence), contract, or otherwise,
+unless required by applicable law (such as deliberate and grossly
+negligent acts) or agreed to in writing, shall any Contributor be
+liable to You for damages, including any direct, indirect, special,
+incidental, or consequential damages of any character arising as a
+result of this License or out of the use or inability to use the
+Work (including but not limited to damages for loss of goodwill,
+work stoppage, computer failure or malfunction, or any and all
+other commercial damages or losses), even if such Contributor
+has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+the Work or Derivative Works thereof, You may choose to offer,
+and charge a fee for, acceptance of support, warranty, indemnity,
+or other liability obligations and/or rights consistent with this
+License. However, in accepting such obligations, You may act only
+on Your own behalf and on Your sole responsibility, not on behalf
+of any other Contributor, and only if You agree to indemnify,
+defend, and hold each Contributor harmless for any liability
+incurred by, or claims asserted against, such Contributor by reason
+of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+To apply the Apache License to your work, attach the following
+boilerplate notice, with the fields enclosed by brackets "{}"
+replaced with your own identifying information. (Don't include
+the brackets!)  The text should be enclosed in the appropriate
+comment syntax for the file format. We also recommend that a
+file or class name and description of purpose be included on the
+same "printed page" as the copyright notice for easier
+identification within third-party archives.
+
+Copyright {yyyy} {name of copyright owner}
+
+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,110 @@
+# kitchen-oraclecloud
+
+A driver to allow Test Kitchen to consume Oracle Cloud resources to perform testing.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'kitchen-oraclecloud'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install kitchen-oraclecloud
+
+Or even better, install it via ChefDK:
+
+    $ chef gem install kitchen-oraclecloud
+
+## Usage
+
+After installing the gem as described above, edit your .kitchen.yml file to set the driver to 'oraclecloud' and supply your login credentials:
+
+```yaml
+driver:
+  name: oraclecloud
+  username: user@domain.io
+  password: mypassword
+  identity_domain: oracle12345
+  api_url: https://api.cloud.oracle.com
+  verify_ssl: true
+```
+
+Then configure your platforms. A shape and image is required for each platform:
+
+```yaml
+platforms:
+  - name: oel64
+    driver:
+      shape: oc3
+      image: /oracle/public/oel_6.4_20GB_x11_RD
+  - name: oel66
+    driver:
+      shape: oc3
+      image: /oracle/public/oel_6.6_20GB_x11_RD
+```
+
+Other options that you can set include:
+
+ * **sshkeys**: array of Oracle Cloud SSH keys to associate with the instance.
+ * **project_name**: optional; descriptive string to be used in the orchestration name, in addition to the Test Kitchen instance name.  If one is not provided, a UUID will be generated.  This helps keep the orchestration names unique but allows you to set something more descriptive for use when displaying all orchestrations in the UI.
+ * **description**: optional; override the default description supplied by Test Kitchen
+ * **public_ip**: optional; set to `pool` if you want Oracle Cloud to assign an IP from the default pool, or specify an existing IP Reservation name
+ * **wait_time**: optional; number of seconds to wait for a server to start.  Defaults to 600.
+ * **refresh_time**: optional; number of seconds sleep between checks on whether a server has started.  Defaults to 2.
+
+All of these settings can be set per-platform, as shown above, or can be set globally in the `driver` section of your .kitchen.yml:
+
+```yaml
+driver:
+  name: oraclecloud
+  sshkeys:
+    - user1@domain.io/key1
+    - user1@domain.io/key2
+    - user2@domain.io/user2key
+```
+
+### Username
+
+Most Oracle Cloud images use a default username of "opc".  However, Test Kitchen assumes the default user is "root" so you will need to override this in your .kitchen.yml:
+
+```yaml
+transport:
+  username: opc
+```
+
+## License and Authors
+
+Author:: Chef Partner Engineering (<partnereng@chef.io>)
+
+Copyright:: Copyright (c) 2015 Chef Software, Inc.
+
+License:: Apache License, Version 2.0
+
+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.
+
+## Contributing
+
+We'd love to hear from you if this doesn't work for you. Please log a GitHub issue, or even better, submit a Pull Request with a fix!
+
+1. Fork it ( https://github.com/chef-partners/kitchen-oraclecloud/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/kitchen-oraclecloud.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'kitchen/driver/oraclecloud_version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'kitchen-oraclecloud'
+  spec.version       = Kitchen::Driver::ORACLECLOUD_VERSION
+  spec.authors       = ['Chef Partner Engineering']
+  spec.email         = ['partnereng@chef.io']
+  spec.summary       = 'A Test Kitchen driver for Oracle Cloud'
+  spec.description   = spec.summary
+  spec.homepage      = 'https://github.com/chef-partners/kitchen-oraclecloud'
+  spec.license       = 'Apache 2.0'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = []
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'test-kitchen', '~> 1.4', '>= 1.4.1'
+  spec.add_dependency 'oraclecloud',  '~> 1.0'
+
+  spec.add_development_dependency 'bundler',   '~> 1.7'
+  spec.add_development_dependency 'rake',      '~> 10.0'
+  spec.add_development_dependency 'rspec',     '~> 3.2'
+end

data/lib/kitchen/driver/oraclecloud.rb

@@ -0,0 +1,213 @@
+#
+# Author:: Chef Partner Engineering (<partnereng@chef.io>)
+# Copyright:: Copyright (c) 2015 Chef Software, Inc.
+# License:: Apache License, Version 2.0
+#
+# 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 'kitchen'
+require 'oraclecloud'
+require 'securerandom'
+require_relative 'oraclecloud_version'
+
+module Kitchen
+  module Driver
+    class Oraclecloud < Kitchen::Driver::Base # rubocop:disable Metrics/ClassLength
+      kitchen_driver_api_version 2
+      plugin_version Kitchen::Driver::ORACLECLOUD_VERSION
+
+      required_config :username
+      required_config :password
+      required_config :api_url
+      required_config :identity_domain
+      required_config :shape
+      required_config :image
+
+      default_config :verify_ssl, true
+      default_config :wait_time, 600
+      default_config :refresh_time, 2
+      default_config :sshkeys, []
+      default_config :description, nil
+      default_config :project_name, nil
+      default_config :public_ip, nil
+
+      def name
+        'OracleCloud'
+      end
+
+      def create(state)
+        return if state[:orchestration_id]
+
+        info('Creating Oracle Cloud orchestration...')
+        orchestration
+
+        info("Orchestration #{orchestration.name_with_container} created. Starting...")
+        orchestration.start
+        wait_for_status(orchestration, 'ready')
+
+        state[:orchestration_id] = orchestration.name_with_container
+
+        ip_address = server_ip_address
+        raise 'No IP address returned for Oracle Cloud instance' if ip_address.nil?
+
+        state[:hostname] = ip_address
+
+        wait_for_server(state)
+        info("Server #{orchestration_name} ready.")
+      end
+
+      def destroy(state)
+        return if state[:orchestration_id].nil?
+
+        info("Looking up orchestration #{state[:orchestration_id]}...")
+
+        begin
+          orchestration(state[:orchestration_id])
+        rescue OracleCloud::Exception::HTTPNotFound
+          warn("No orchestration found with ID #{state[:orchestration_id]}, assuming it has been destroyed already.")
+          return
+        end
+
+        info("Stopping orchestration #{orchestration.name_with_container} and associated instance...")
+        orchestration.stop
+        wait_for_status(orchestration, 'stopped')
+
+        info("Deleting orchestration #{orchestration.name_with_container} and associated instance...")
+        orchestration.delete
+        info('Orchestration deleted.')
+      end
+
+      def oraclecloud_client
+        @client ||= OracleCloud::Client.new(
+          username:        config[:username],
+          password:        config[:password],
+          api_url:         config[:api_url],
+          identity_domain: config[:identity_domain],
+          verify_ssl:      config[:verify_ssl]
+        )
+      end
+
+      def orchestration(name = nil)
+        return @orchestration if @orchestration
+
+        if name
+          @orchestration = oraclecloud_client.orchestrations.by_name(name)
+        else
+          @orchestration = oraclecloud_client.orchestrations.create(
+            name: orchestration_name,
+            description: description,
+            instances: [ instance_request ]
+          )
+        end
+
+        @orchestration
+      end
+
+      def instance_request
+        oraclecloud_client.instance_request(
+          name:      orchestration_name,
+          shape:     config[:shape],
+          imagelist: config[:image],
+          sshkeys:   sshkeys,
+          public_ip: public_ip
+        )
+      end
+
+      def server
+        @server ||= orchestration.instances.first
+      end
+
+      def server_ip_address
+        public_ips = server.public_ip_addresses
+        public_ips.empty? ? server.ip_address : public_ips.first
+      end
+
+      def wait_for_server(state)
+        info("Server #{orchestration_name} created. Waiting until ready...")
+        begin
+          instance.transport.connection(state).wait_until_ready
+        rescue
+          error("Server #{orchestration_name} not reachable. Destroying server...")
+          destroy(state)
+          raise
+        end
+      end
+
+      def wait_for_status(item, requested_status)
+        last_status = ''
+
+        begin
+          Timeout.timeout(wait_time) do
+            loop do
+              item.refresh
+              current_status = item.status
+
+              if item.error?
+                error_str = "Request encountered an error: #{item.errors}"
+                error(error_str)
+                raise error_str
+              end
+
+              unless last_status == current_status
+                last_status = current_status
+                info("Current status: #{current_status}.")
+              end
+
+              break if current_status == requested_status
+
+              sleep refresh_time
+            end
+          end
+        rescue Timeout::Error
+          error("Request did not complete in #{wait_time} seconds. Check the Oracle Cloud Web UI for more information.")
+          raise
+        end
+      end
+
+      def wait_time
+        config[:wait_time].to_i
+      end
+
+      def refresh_time
+        config[:refresh_time].to_i
+      end
+
+      def description
+        config[:description].nil? ? "#{instance.name} for #{username} via Test Kitchen" : config[:description]
+      end
+
+      def username
+        config[:username]
+      end
+
+      def orchestration_name
+        "TK-#{project_name}-#{instance.name.gsub(/\s+/, '')}"
+      end
+
+      def project_name
+        @project_name ||= config[:project_name].nil? ? SecureRandom.uuid : config[:project_name].gsub(/\s+/, '')
+      end
+
+      def sshkeys
+        config[:sshkeys].map { |key| "#{oraclecloud_client.compute_identity_domain}/#{key}" }
+      end
+
+      def public_ip
+        return nil unless config[:public_ip]
+
+        (config[:public_ip] == 'pool') ? :pool : "ipreservation:#{config[:public_ip]}"
+      end
+    end
+  end
+end

data/lib/kitchen/driver/oraclecloud_version.rb

@@ -0,0 +1,23 @@
+#
+# Author:: Chef Partner Engineering (<partnereng@chef.io>)
+# Copyright:: Copyright (c) 2015 Chef Software, Inc.
+# License:: Apache License, Version 2.0
+#
+# 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 Kitchen
+  module Driver
+    ORACLECLOUD_VERSION = '1.0.0'
+  end
+end

data/spec/oraclecloud_spec.rb

@@ -0,0 +1,447 @@
+#
+# Author:: Chef Partner Engineering (<partnereng@chef.io>)
+# Copyright:: Copyright (c) 2015 Chef Software, Inc.
+# License:: Apache License, Version 2.0
+#
+# 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 'spec_helper'
+require 'oraclecloud'
+require 'kitchen/driver/oraclecloud'
+require 'kitchen/provisioner/dummy'
+require 'kitchen/transport/dummy'
+require 'kitchen/verifier/dummy'
+
+describe Kitchen::Driver::Oraclecloud do
+  let(:logged_output) { StringIO.new }
+  let(:logger)        { Logger.new(logged_output) }
+  let(:platform)      { Kitchen::Platform.new(name: 'fake_platform') }
+  let(:transport)     { Kitchen::Transport::Dummy.new }
+  let(:driver)        { Kitchen::Driver::Oraclecloud.new(config) }
+
+  let(:config) do
+    {
+      api_url:         'https://testcloud.oracle.com',
+      username:        'test_user',
+      password:        'test_password',
+      identity_domain: 'test_domain',
+      shape:           'test_shape',
+      image:           'test_image',
+      verify_ssl:      true
+    }
+  end
+
+  let(:instance) do
+    instance_double(Kitchen::Instance,
+                    logger:    logger,
+                    transport: transport,
+                    platform:  platform,
+                    to_str:    'instance_str'
+                   )
+  end
+
+  before do
+    allow(driver).to receive(:instance).and_return(instance)
+  end
+
+  it 'driver API version is 2' do
+    expect(driver.diagnose_plugin[:api_version]).to eq(2)
+  end
+
+  describe '#name' do
+    it 'has an overridden name' do
+      expect(driver.name).to eq('OracleCloud')
+    end
+  end
+
+  describe '#create' do
+    let(:state) { {} }
+    let(:orchestration) { double('orchestration') }
+
+    before do
+      allow(driver).to receive(:orchestration).and_return(orchestration)
+      allow(driver).to receive(:wait_for_status)
+      allow(driver).to receive(:wait_for_server)
+      allow(driver).to receive(:server_ip_address).and_return('1.2.3.4')
+      allow(instance).to receive(:name).and_return('instance_name')
+      allow(orchestration).to receive(:start)
+      allow(orchestration).to receive(:name_with_container)
+    end
+
+    context 'when the server is already created' do
+      let(:state) { { orchestration_id: 'orch1' } }
+
+      it 'does not create an orchestration' do
+        expect(driver).not_to receive(:orchestration)
+        driver.create(state)
+      end
+    end
+
+    it 'requests the server' do
+      expect(driver).to receive(:orchestration).and_return(orchestration)
+      driver.create(state)
+    end
+
+    it 'starts the orchestration' do
+      expect(orchestration).to receive(:start)
+      driver.create(state)
+    end
+
+    it 'waits for the orchestration to become ready' do
+      expect(driver).to receive(:wait_for_status).with(orchestration, 'ready')
+      driver.create(state)
+    end
+
+    it 'sets the orchesration ID in the state object' do
+      allow(orchestration).to receive(:name_with_container).and_return('orch1')
+      driver.create(state)
+
+      expect(state[:orchestration_id]).to eq('orch1')
+    end
+
+    context 'when no IP address is available for the server' do
+      it 'raises an exception' do
+        expect(driver).to receive(:server_ip_address).and_return(nil)
+        expect { driver.create(state) }.to raise_error(RuntimeError)
+      end
+    end
+
+    context 'when an IP address is available' do
+      it 'sets it in the state object' do
+        expect(driver).to receive(:server_ip_address).and_return('1.2.3.4')
+        driver.create(state)
+        expect(state[:hostname]).to eq('1.2.3.4')
+      end
+    end
+
+    it 'waits for the server to be ready' do
+      expect(driver).to receive(:wait_for_server).with(state)
+      driver.create(state)
+    end
+  end
+
+  describe '#destroy' do
+    let(:state) { { orchestration_id: 'orch1' } }
+    let(:orchestration) { double('orchestration') }
+
+    before do
+      allow(driver).to receive(:wait_for_status)
+      allow(driver).to receive(:orchestration).and_return(orchestration)
+      allow(orchestration).to receive(:name_with_container)
+      allow(orchestration).to receive(:stop)
+      allow(orchestration).to receive(:delete)
+    end
+
+    context 'when the orchestration is not in the state object' do
+      let(:state) { {} }
+      it 'does not attempt to delete the orchestration' do
+        expect(driver).not_to receive(:orchestration)
+        driver.destroy(state)
+      end
+    end
+
+    it 'looks up the orchestration by ID' do
+      expect(driver).to receive(:orchestration).with('orch1').and_return(orchestration)
+      driver.destroy(state)
+    end
+
+    it 'does not attempt to stop the orchestration if it cannot be found' do
+      allow(driver).to receive(:orchestration).with('orch1').and_raise(OracleCloud::Exception::HTTPNotFound)
+
+      expect(driver).to receive(:warn)
+      expect(orchestration).not_to receive(:stop)
+      driver.destroy(state)
+    end
+
+    it 'stops the orchestration' do
+      expect(orchestration).to receive(:stop)
+      driver.destroy(state)
+    end
+
+    it 'waits for the orchestration to stop' do
+      expect(driver).to receive(:wait_for_status).with(orchestration, 'stopped')
+      driver.destroy(state)
+    end
+
+    it 'deletes the orchestration' do
+      expect(orchestration).to receive(:delete)
+      driver.destroy(state)
+    end
+  end
+
+  describe '#oraclecloud_client' do
+    it 'returns an OracleCloud::Client instance' do
+      expect(driver.oraclecloud_client).to be_an_instance_of(OracleCloud::Client)
+    end
+  end
+
+  describe '#orchestration' do
+    let(:client)         { double('oraclecloud_client') }
+    let(:orchestration)  { double('orchestration') }
+    let(:orchestrations) { double('orchestrations') }
+
+    before do
+      allow(driver).to receive(:oraclecloud_client).and_return(client)
+      allow(client).to receive(:orchestrations).and_return(orchestrations)
+    end
+
+    context 'when an orchestration has already been created' do
+      it 'returns the existing orchestration' do
+        driver.instance_variable_set(:@orchestration, '123')
+        expect(driver.orchestration).to eq('123')
+      end
+    end
+
+    context 'when a name is not provided' do
+      it 'creates a new orchestration and returns it' do
+        allow(driver).to receive(:orchestration_name).and_return('test_orchestration')
+        allow(driver).to receive(:description).and_return('test_description')
+        allow(driver).to receive(:instance_request).and_return('test_instance')
+
+        expect(orchestrations).to receive(:create).with(name: 'test_orchestration',
+                                                        description: 'test_description',
+                                                        instances: [ 'test_instance' ])
+          .and_return(orchestration)
+        expect(driver.orchestration).to eq(orchestration)
+      end
+    end
+
+    context 'when a name is provided' do
+      it 'locates the orchestration and returns it' do
+        expect(orchestrations).to receive(:by_name).with('orch1').and_return(orchestration)
+        expect(driver.orchestration('orch1')).to eq(orchestration)
+      end
+    end
+  end
+
+  describe '#instance_request' do
+    let(:client)           { double('oraclecloud_client') }
+    let(:config)           { { shape: 'test_shape', image: 'test_image' } }
+    let(:instance_request) { double('instance_request') }
+    it 'creates an instance request and returns it' do
+      allow(driver).to receive(:oraclecloud_client).and_return(client)
+      allow(driver).to receive(:config).and_return(config)
+      allow(driver).to receive(:orchestration_name).and_return('test_name')
+      allow(driver).to receive(:sshkeys).and_return('test_keys')
+      allow(driver).to receive(:public_ip).and_return('test_ip')
+
+      expect(client).to receive(:instance_request).with(name: 'test_name',
+                                                        shape: 'test_shape',
+                                                        imagelist: 'test_image',
+                                                        sshkeys: 'test_keys',
+                                                        public_ip: 'test_ip')
+        .and_return(instance_request)
+      expect(driver.instance_request).to eq(instance_request)
+    end
+  end
+
+  describe '#server' do
+    let(:orchestration) { double('orchestration') }
+    let(:instances)     { [ 'server1'] }
+    it 'returns the server' do
+      allow(driver).to receive(:orchestration).and_return(orchestration)
+
+      expect(orchestration).to receive(:instances).and_return(instances)
+      expect(driver.server).to eq('server1')
+    end
+  end
+
+  describe '#server_ip_address' do
+    let(:server) { double('server') }
+    it 'returns the private IP address when no public IPs are available' do
+      allow(driver).to receive(:server).and_return(server)
+      allow(server).to receive(:public_ip_addresses).and_return([])
+      allow(server).to receive(:ip_address).and_return('192.168.100.100')
+
+      expect(driver.server_ip_address).to eq('192.168.100.100')
+    end
+
+    it 'returns the public IP address if a public IP is available' do
+      allow(driver).to receive(:server).and_return(server)
+      allow(server).to receive(:public_ip_addresses).and_return([ '1.2.3.4' ])
+
+      expect(driver.server_ip_address).to eq('1.2.3.4')
+    end
+  end
+
+  describe '#wait_for_server' do
+    let(:connection) { instance.transport.connection(state) }
+    let(:state)      { {} }
+
+    before do
+      allow(transport).to receive(:connection).and_return(connection)
+      allow(driver).to receive(:orchestration_name)
+    end
+
+    it 'waits for the server to be ready' do
+      expect(connection).to receive(:wait_until_ready)
+      driver.wait_for_server(state)
+    end
+
+    it 'destroys the server and raises an exception if it fails to become ready' do
+      allow(connection).to receive(:wait_until_ready).and_raise(Timeout::Error)
+      expect(driver).to receive(:destroy).with(state)
+      expect { driver.wait_for_server(state) }.to raise_error(Timeout::Error)
+    end
+  end
+
+  describe '#wait_for_status' do
+    let(:item) { double('item') }
+
+    before do
+      allow(driver).to receive(:wait_time).and_return(600)
+      allow(driver).to receive(:refresh_time).and_return(2)
+      allow(item).to receive(:error?)
+
+      # don't actually sleep
+      allow(driver).to receive(:sleep)
+    end
+
+    context 'when the items completes normally, 3 loops' do
+      it 'only refreshes the item 3 times' do
+        allow(item).to receive(:status).exactly(3).times.and_return('working', 'working', 'complete')
+        expect(item).to receive(:refresh).exactly(3).times
+
+        driver.wait_for_status(item, 'complete')
+      end
+    end
+
+    context 'when the item is completed on the first loop' do
+      it 'only refreshes the item 1 time' do
+        allow(item).to receive(:status).once.and_return('complete')
+        expect(item).to receive(:refresh).once
+
+        driver.wait_for_status(item, 'complete')
+      end
+    end
+
+    context 'when the timeout is exceeded' do
+      it 'prints a warning and exits' do
+        allow(Timeout).to receive(:timeout).and_raise(Timeout::Error)
+        expect(driver).to receive(:error)
+          .with('Request did not complete in 600 seconds. Check the Oracle Cloud Web UI for more information.')
+        expect { driver.wait_for_status(item, 'complete') }.to raise_error(Timeout::Error)
+      end
+    end
+
+    context 'when a non-timeout exception is raised' do
+      it 'raises the original exception' do
+        allow(item).to receive(:refresh).and_raise(RuntimeError)
+        expect { driver.wait_for_status(item, 'complete') }.to raise_error(RuntimeError)
+      end
+    end
+
+    context 'when the item errors out' do
+      it 'raises an exception' do
+        allow(item).to receive(:refresh)
+        allow(item).to receive(:status).and_return('error')
+        allow(item).to receive(:error?).and_return(true)
+        allow(item).to receive(:errors).and_return('test_error')
+
+        expect(driver).to receive(:error).with('Request encountered an error: test_error')
+        expect { driver.wait_for_status(item, 'complete') }.to raise_error(RuntimeError)
+      end
+    end
+  end
+
+  describe '#wait_time' do
+    it 'returns the correct wait time' do
+      allow(driver).to receive(:config).and_return(wait_time: 123)
+      expect(driver.wait_time).to eq(123)
+    end
+  end
+
+  describe '#refresh_time' do
+    it 'returns the correct refresh time' do
+      allow(driver).to receive(:config).and_return(refresh_time: 123)
+      expect(driver.refresh_time).to eq(123)
+    end
+  end
+
+  describe '#description' do
+    let(:instance) { double('instance', name: 'test_instance_name') }
+    it 'returns a default description if none is specified in the config' do
+      allow(driver).to receive(:config).and_return({})
+      allow(driver).to receive(:instance).and_return(instance)
+      allow(driver).to receive(:username).and_return('test_username')
+
+      expect(driver.description).to eq('test_instance_name for test_username via Test Kitchen')
+    end
+
+    it 'returns the configured description if one is provided' do
+      allow(driver).to receive(:config).and_return(description: 'test_description')
+      expect(driver.description).to eq('test_description')
+    end
+  end
+
+  describe '#username' do
+    it 'returns the correct username ' do
+      allow(driver).to receive(:config).and_return(username: 'test_username')
+      expect(driver.username).to eq('test_username')
+    end
+  end
+
+  describe '#orchestration_name' do
+    let(:instance) { double('instance', name: 'test instance') }
+    it 'returns a properly formatted name' do
+      allow(driver).to receive(:project_name).and_return('testproject')
+      allow(driver).to receive(:instance).and_return(instance)
+
+      expect(driver.orchestration_name).to eq('TK-testproject-testinstance')
+    end
+  end
+
+  describe '#project_name' do
+    it 'returns a UUID if a project name has not been configured' do
+      allow(driver).to receive(:config).and_return({})
+
+      expect(SecureRandom).to receive(:uuid).and_return('test_uuid')
+      expect(driver.project_name).to eq('test_uuid')
+    end
+
+    it 'returns the configured project name with spaces stripped' do
+      allow(driver).to receive(:config).and_return(project_name: 'my test project')
+
+      expect(driver.project_name).to eq('mytestproject')
+    end
+  end
+
+  describe '#sshkeys' do
+    let(:client) { double('oraclecloud_client') }
+    it 'returns an array of formatted keys' do
+      allow(driver).to receive(:config).and_return(sshkeys: %w(key1 key2))
+      allow(driver).to receive(:oraclecloud_client).and_return(client)
+      allow(client).to receive(:compute_identity_domain).and_return('test_domain')
+
+      expect(driver.sshkeys).to eq([ 'test_domain/key1', 'test_domain/key2' ])
+    end
+  end
+
+  describe '#public_ip' do
+    it 'returns nil if no public_ip is configured' do
+      allow(driver).to receive(:config).and_return({})
+      expect(driver.public_ip).to eq(nil)
+    end
+
+    it 'returns :pool if pool is configured' do
+      allow(driver).to receive(:config).and_return(public_ip: 'pool')
+      expect(driver.public_ip).to eq(:pool)
+    end
+
+    it 'returns a reservation name if a non-pool is configured' do
+      allow(driver).to receive(:config).and_return(public_ip: 'test_reservation')
+      expect(driver.public_ip).to eq('ipreservation:test_reservation')
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+#
+# Author:: Chef Partner Engineering (<partnereng@chef.io>)
+# Copyright:: Copyright (c) 2015 Chef Software, Inc.
+# License:: Apache License, Version 2.0
+#
+# 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.
+#

metadata

@@ -0,0 +1,135 @@
+--- !ruby/object:Gem::Specification
+name: kitchen-oraclecloud
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Chef Partner Engineering
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-10-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: test-kitchen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.1
+- !ruby/object:Gem::Dependency
+  name: oraclecloud
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+description: A Test Kitchen driver for Oracle Cloud
+email:
+- partnereng@chef.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- kitchen-oraclecloud.gemspec
+- lib/kitchen/driver/oraclecloud.rb
+- lib/kitchen/driver/oraclecloud_version.rb
+- spec/oraclecloud_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/chef-partners/kitchen-oraclecloud
+licenses:
+- Apache 2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: A Test Kitchen driver for Oracle Cloud
+test_files:
+- spec/oraclecloud_spec.rb
+- spec/spec_helper.rb
+has_rdoc: