kitchen-vra 3.0.1 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4d867c4c40278ede310114028b5adac346d694f8ff51b94a2b6a22ce9ad81ed
-  data.tar.gz: cd585930793bd9e668e23c0744c0632833d8ee572d5715d6ca2527653e943d74
+  metadata.gz: 42841b378dc1efcd266d40f01990f7dedc82e8e3d49e742d3268e0cca5c21049
+  data.tar.gz: fdd7dfe3c395a460cb92414617a990006508007230aa25c4995af63edadc6a0e
 SHA512:
-  metadata.gz: 1f5c83ba324e3ad87b1dc792e7fc137f239bc8e6de6e5a244e2c92d0df5f614d5fa5c9605f6e91c94fdebe6e305a41fdff40332793858b10d729e40e0e561376
-  data.tar.gz: 29607ec9d52027f6bd67331d157f6d41aee6a647ff3fba5fcc12f5f5befee78da7744bf151bf455d5698f4619cde9f4daa4264b5b29f92f02219bef4ab96086f
+  metadata.gz: c8742b99fef04d72bd9cd87357ff1d6e30971e5afa70ed3ecadec371a705e7505aafbb38cc655a75e6fab47b2089c61a2323fa1bf084e468913aa852d23c4601
+  data.tar.gz: 76d046c6da25ef7c78379bf0c64bb49c3c438cf7f62a05b3a5da49a1c2057b7a5a4d7fbae6b00aac1db2adaa6bf8cd2d1ac84d28f67bc27ab04dea1b139ec6b7

data/.rubocop.yml

@@ -0,0 +1,2 @@
+AllCops:
+  TargetRubyVersion: 2.7

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Change Log
 
+## [v3.1.0](https://github.com/chef-partners/kitchen-vra/tree/v3.1.0)
+
+[Full Changelog](https://github.com/chef-partners/kitchen-vra/compare/v3.0.1...v3.1.0)
+
+- Move usage documentation from the readme to the kitchen.ci website
+- Make the version configuration optional
+- Remove the bundler dev dep
+- Update the gemspec for the new maintainer of this project
+
 ## [v3.0.1](https://github.com/chef-partners/kitchen-vra/tree/v3.0.1)
 
 [Full Changelog](https://github.com/chef-partners/kitchen-vra/compare/v3.0.0...v3.0.1)

data/README.md

@@ -22,107 +22,9 @@ Or even better, install it via ChefDK:
 
     $ chef gem install kitchen-vra
 
-## Usage
-
-After installing the gem as described above, edit your .kitchen.yml file to set the driver to 'vra' and supply your login credentials:
-
-```yaml
-driver:
-  name: vra
-  username: myuser@corp.local
-  password: mypassword
-  tenant: mytenant
-  base_url: https://vra.corp.local
-  verify_ssl: true
-```
-
-If you want username and password to be prompted, remove usename and password in your .kitchen.yml as shown below:
-
-```yaml
-driver:
-  name: vra
-  tenant: mytenant
-  base_url: https://vra.corp.local
-  verify_ssl: true
-```
-If you don't want to explicitly specify username and password in the kitchen.yml, you have an option to set it in the environment variable as 
-
-    $ export VRA_USER_NAME='myuser@corp.local'
-    $ export VRA_USER_PASSWORD='mypassword'
-
-Then configure your platforms. You will need to specify project_id, image_mapping, flavor_mapping and version for the platform. image_mapping specifies the OS image for a machine and the flavor_mapping specifies the CPU count and RAM of the machine. Either a catalog_id or a catalog_name is required for each platform. If both catalog_id and catalog_name are mentioned in .kitchen.yml then catalog_name would be used to derive the catalog_id and this catalog_id would override the catalog_id being passed in .kitchen.yml. In the below example as can be seen we are using catalog_id for centos6 driver while catalog_name for the centos7 driver just to demonstrate that we can use either of the two.
-
-
-```yaml
-platforms:
-  - name: centos6
-    driver:
-      catalog_id: e9db1084-d1c6-4c1f-8e3c-eb8f3dc574f9
-      project_id: 6ba69375-79d5-42c3-a099-7d32739f71a9
-      image_mapping: SQL 2016
-      flavor_mapping: Small
-      version: 1
-  - name: centos7
-    driver:
-      catalog_name: my_catalog_name
-      project_id: 6ba69375-79d5-42c3-a099-7d32739f71a9
-      image_mapping: VRA-nc-lnx-ce8.4-Docker
-      flavor_mapping: Small
-      version: 1
-```
-
+## Configuration
 
-
-Other options that you can set include:
-
- * **request_timeout**: amount of time, in seconds, to wait for a vRA request to complete. Default is 600 seconds.
- * **server_ready_retries**: Number of times to retry the "waiting for server to be ready" check. In some cases, this will error out immediately due to DNS propagation issues, etc. Setting this to a number greater than 0 will retry the `wait_until_ready` method with a growing sleep in between each attempt. Defaults to 1. Set to 0 to disable any retrying of the `wait_until_ready` method.
- * **subtenant_id**: the Business Group ID to list as the owner. This is required if the catalog item is a shared/global item; we are unable to determine the subtenant_id from the catalog, and vRA requires it to be set on every request.
- * **subtenant_name**: the Business Group Name as the owner. This can be passed instead of subtenant_id and would act as a more friendly name. subtenant_id would be internally retrieved based on the provided subtenant_name. In case both subtenant_id and subtenant_name are passed, subtenant_name would take the precendence and would try to retrieve subtenant_id based on subtenant_name passed.
- * **private_key_path**: path to the SSH private key to use when logging in. Defaults to '~/.ssh/id_rsa' or '~/.ssh/id_dsa', preferring the RSA key. Only applies to instances where SSH transport is used; i.e., does not apply to Windows hosts with the WinRM transport configured.
- * **use_dns**: Defaults to `false`.  Set to `true` if vRA doesn't manage vm ip addresses.  This will cause kitchen to attempt to connect via hostname.
- * **dns_suffix**: Defaults to `nil`.  Set to your domain suffix, for example 'mydomain.com'.  This only takes effect when `use_dns` == true and is appended to the hostname returned by vRA.
- * **extra_parameters**: a hash of other data to set on a catalog request, most notably custom properties. Allows updates to existing properties on the blueprint as well as the addition of new properties. Each key in the hash is the property name, and the value is a another hash containing the value data type and the value itself. It is possible to use a `~` to add nested parameters.
-
-These settings can be set globally under the top-level `driver` section, or they can be set on each platform, which allows you to set globals and then override them. For example, this configuration would set the CPU count to 1 except on the "large" platform:
-
-```yaml
-driver:
-  name: vra
-
-platforms:
-  - name: small
-    driver:
-      catalog_name: my_catalog_name_small
-      catalog_id: 8a189191-fea6-43eb-981e-ee0fa40f8f57
-      project_id: 6ba69375-79d5-42c3-a099-7d32739f71a9
-      image_mapping: SQL 2016
-      flavor_mapping: Small
-      version: 1
-      extra_parameters:
-        mycustompropname:
-          type: string
-          value: smallvalue
-        Vrm.DataCenter.Location:
-          type: string
-          value: Non-Prod
-  - name: large
-    driver:
-      catalog_name: my_catalog_name_large
-      catalog_id: 1d7c6122-18fa-4ed6-bd13-8a33b6c6ed50
-      project_id: 6ba69375-79d5-42c3-a099-7d32739f71a9
-      image_mapping: VRA-nc-lnx-ce8.4-Docker
-      flavor_mapping: Large
-      version: 1
-      subtenant_name: my_subtenant_name
-      extra_parameters:
-        mycustompropname:
-          type: string
-          value: largevalue
-        Vrm.DataCenter.Location:
-          type: string
-          value: Prod
-```
+See the [kitchen.ci kitchen-vra docs](https://kitchen.ci/docs/drivers/vra/) for a complete list of configuration options.
 
 ## License and Authors
 

data/kitchen-vra.gemspec

@@ -7,11 +7,11 @@ require "kitchen/driver/vra_version"
 Gem::Specification.new do |spec|
   spec.name          = "kitchen-vra"
   spec.version       = Kitchen::Driver::VRA_VERSION
-  spec.authors       = ["Chef Partner Engineering"]
-  spec.email         = ["partnereng@chef.io"]
+  spec.authors       = ["Chef Commmunity Tools Team"]
+  spec.email         = ["oss@chef.io"]
   spec.summary       = "A Test Kitchen driver for VMware vRealize Automation (vRA)"
   spec.description   = spec.summary
-  spec.homepage      = "https://github.com/chef-partners/kitchen-vra"
+  spec.homepage      = "https://github.com/test-kitchen/kitchen-vra"
   spec.license       = "Apache-2.0"
 
   spec.files         = `git ls-files -z`.split("\x0")
@@ -22,11 +22,10 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = ">= 2.7"
 
   spec.add_dependency "test-kitchen"
-  spec.add_dependency "vmware-vra", "~> 3.0" # 3.0 required for vRA 8.x
+  spec.add_dependency "vmware-vra", ">= 3.1.0" # 3.0 required for vRA 8.x
   spec.add_dependency "highline"
   spec.add_dependency "rack", ">= 1.6", "< 3.0"
   spec.add_dependency "ffi-yajl", ">= 2.2.3", "< 2.5.0"
-  spec.add_development_dependency "bundler", ">= 1.7"
   spec.add_development_dependency "rake",      "~> 13.0"
   spec.add_development_dependency "rspec",     "~> 3.2"
   spec.add_development_dependency "simplecov", "~> 0.10"

data/lib/kitchen/driver/vra.rb

@@ -39,8 +39,8 @@ module Kitchen
       required_config :project_id
       required_config :image_mapping
       required_config :flavor_mapping
-      required_config :version
 
+      default_config :version, nil
       default_config :catalog_id, nil
       default_config :catalog_name, nil
 

data/lib/kitchen/driver/vra_version.rb

@@ -2,7 +2,7 @@
 
 #
 # Author:: Chef Partner Engineering (<partnereng@chef.io>)
-# Copyright:: Copyright (c) 2015 Chef Software, Inc.
+# Copyright:: Copyright (c) Chef Software, Inc.
 # License:: Apache License, Version 2.0
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -20,6 +20,6 @@
 
 module Kitchen
   module Driver
-    VRA_VERSION = "3.0.1"
+    VRA_VERSION = "3.1.0"
   end
 end

data/spec/vra_spec.rb

@@ -44,7 +44,6 @@ describe Kitchen::Driver::Vra do
       subtenant_id:    "160b473a-0ec9-473d-8156-28dd96c0b6b7",
       use_dns:         false,
       deployment_name: "test-instance",
-      version:          1,
     }
   end
 
@@ -421,7 +420,6 @@ describe Kitchen::Driver::Vra do
           project_id:      "6ba69375-79d5-42c3-a099-7d32739f71a7",
           image_mapping:   "VRA-nc-lnx-ce8.4-Docker",
           flavor_mapping:  "Small",
-          version:         1,
         }
       end
 
@@ -442,15 +440,14 @@ describe Kitchen::Driver::Vra do
           project_id:       "6ba69375-79d5-42c3-a099-7d32739f71a7",
           image_mapping:    "VRA-nc-lnx-ce8.4-Docker",
           flavor_mapping:   "Small",
-          version:          1,
           extra_parameters: { "key1" => { type: "string", value: "value1" },
                               "key2" => { type: "integer", value: 123 } },
         }
       end
 
       it "sets extra parmeters" do
-        expect(catalog_request).to receive(:set_parameters).with("key1", type: "string", value: "value1")
-        expect(catalog_request).to receive(:set_parameters).with("key2", type: "integer", value: 123)
+        expect(catalog_request).to receive(:set_parameters).with("key1", { type: "string", value: "value1" })
+        expect(catalog_request).to receive(:set_parameters).with("key2", { type: "integer", value: 123 })
         driver.catalog_request
       end
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kitchen-vra
 version: !ruby/object:Gem::Version
-  version: 3.0.1
+  version: 3.1.0
 platform: ruby
 authors:
-- Chef Partner Engineering
+- Chef Commmunity Tools Team
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-01-19 00:00:00.000000000 Z
+date: 2022-02-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: test-kitchen
@@ -28,16 +28,16 @@ dependencies:
   name: vmware-vra
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: 3.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: 3.1.0
 - !ruby/object:Gem::Dependency
   name: highline
   requirement: !ruby/object:Gem::Requirement
@@ -92,20 +92,6 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.5.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
@@ -178,7 +164,7 @@ dependencies:
         version: 2.2.1
 description: A Test Kitchen driver for VMware vRealize Automation (vRA)
 email:
-- partnereng@chef.io
+- oss@chef.io
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -188,6 +174,7 @@ files:
 - ".github/dependabot.yml"
 - ".github/workflows/ci.yml"
 - ".gitignore"
+- ".rubocop.yml"
 - CHANGELOG.md
 - Gemfile
 - LICENSE.txt
@@ -198,7 +185,7 @@ files:
 - lib/kitchen/driver/vra_version.rb
 - spec/spec_helper.rb
 - spec/vra_spec.rb
-homepage: https://github.com/chef-partners/kitchen-vra
+homepage: https://github.com/test-kitchen/kitchen-vra
 licenses:
 - Apache-2.0
 metadata: {}