knife-vrealize 3.0.0 → 6.0.0

data/.github/ISSUE_TEMPLATE.md

@@ -1,23 +0,0 @@
-### Versions:
-<!--- Version of the software where you are encountering the issue --->
-<!-- You should probably update in this is not newest release.--->
-* Version of knife-vrealize:
-* Version of chef:
-
-### Platform Details
-<!--- What version of vRA or vRO are you running? What version of ESXi are you using too?--->
-* Version of vRA:
-* Version of vRO:
-* Version of ESXi:
-
-### Scenario:
-<!--- What you are trying to achieve and you can't?--->
-
-### Steps to Reproduce:
-<!--- If you are filing an issue what are the things we need to do in order to repro your problem? How are you using this cookbook or any resources it includes?--->
-
-### Expected Result:
-<!--- What are you expecting to happen as the consequence of above reproduction steps?--->
-
-### Actual Result:
-<!--- What actually happens after the reproduction steps? Include the error output or a link to a gist if possible.--->

data/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,14 +0,0 @@
-### Description
-
-<!--- Describe what this change achieves--->
-
-### Issues Resolved
-
-<!--- List any existing issues this PR resolves--->
-
-### Check List
-
-- [ ] All tests pass.
-- [ ] All style checks pass.
-- [ ] Functionality includes testing.
-- [ ] Functionality has been documented in the README if applicable

data/.gitignore

@@ -1,17 +0,0 @@
-/.bundle/
-/.yardoc
-/Gemfile.lock
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-*.bundle
-*.so
-*.o
-*.a
-mkmf.log
-.direnv/
-.envrc
-.ruby-version

data/.rubocop.yml

@@ -1,19 +0,0 @@
-AllCops:
-  Exclude:
-    - 'spec/**/*'
-    - 'vendor/**/*'
-  TargetRubyVersion: 2.4.1
-Metrics/AbcSize:
-  Max: 30
-Metrics/LineLength:
-  Max: 150
-Metrics/MethodLength:
-  Max: 30
-Style/Documentation:
-  Enabled: false
-Style/SignalException:
-  Enabled: false
-Layout/SpaceAroundEqualsInParameterDefault:
-  EnforcedStyle: no_space
-Layout/SpaceInsideBrackets:
-  Enabled: false

data/.travis.yml

@@ -1,27 +0,0 @@
-language: ruby
-cache: bundler
-sudo: false
-
-rvm:
-  - 2.3.4
-  - 2.4.1
-  - ruby-head
-
-branches:
-  only:
-    - master
-
-matrix:
-  allow_failures:
-    - rvm: ruby-head
-
-script:
-  - bundle exec rake style
-  - bundle exec rake spec
-
-notifications:
-  slack:
-    on_success: change
-    on_failure: always
-    rooms:
-      secure: fu2EAP4pBts00ofX/5WWPevugan8gqhbTnR3peQ6AHD89JrCyBPfhk3LJk2Nk8OzChHLETIjm9n1CvnnFIXZw+dRidN/lY47WFHPAIWBWfooS9eHR9liKqfnFodn6sJR+eifbOPGd3SMEdPdUIN8M/8/XhHvP4iZ6CjHwvTpWBZ6XAJY8RGtTfIM5Eup1de5bdHpolazGoydRgrP0biQKTMvVG6McyS3VXbZgoXof7Y78uBpEeJKqwUDPCdvCDR3ulcz/AkitlmAaotkU4k/CTR+VSRhYYSqRMRvVU0QYP/wSgf6es8g0YzkAs1KJrhV//OH5Y7w2Fsrr8rOKrFoXmMvqzw8KEGmIUwMzMJwizud7Mz5scCuDaGt5btQjMZcHS/i5s7iU2bxb2dFfQYs18t8s2xAWaFs2bytNc8G5+vObjY5ZAa3uS1YINZCuMeiclmK3mGCcMUS5xqIy6+dURmqoyPNPJcODh6XdX4VAXvTorb7eOxDCO0fgWL3qO6eRpMIcnMm3/UZznroYiWWH2LZHV9GqYG4ePRUCQFWQzp92Fzsl9j1aAthG11JOJpSjKt+jlM3HZTm55IC+jkHW37+ULOkLuzKzvu24R0wdVjgyKr8SIhI5OGV2NQAl86JJeY1ptxOiJEAldrsfgpzFJ9ZriDahVxBAhRnqgo6jTo=

data/CHANGELOG.md

@@ -1,118 +0,0 @@
-# Change Log
-
-## [3.0.0](https://github.com/chef-partners/knife-vrealize/tree/3.0.0) (2017-09-15)
-[Full Changelog](https://github.com/chef-partners/knife-vrealize/compare/v2.1.1...3.0.0)
-
-**Merged pull requests:**
-
-- Removed the chef 12 dependency [\#34](https://github.com/chef-partners/knife-vrealize/pull/34) ([jjasghar](https://github.com/jjasghar))
-
-## [v2.1.1](https://github.com/chef-partners/knife-vrealize/tree/v2.1.1) (2017-08-21)
-[Full Changelog](https://github.com/chef-partners/knife-vrealize/compare/v2.1.0...v2.1.1)
-
-**Closed issues:**
-
-- Driver doesn't appear to support windows yet [\#29](https://github.com/chef-partners/knife-vrealize/issues/29)
-- knife\[:vra\_base\_url\] causes an error if URL has a trailing slash [\#24](https://github.com/chef-partners/knife-vrealize/issues/24)
-
-**Merged pull requests:**
-
-- added more useful/required parameters to readme [\#32](https://github.com/chef-partners/knife-vrealize/pull/32) ([mcascone](https://github.com/mcascone))
-- Initial Jenkinsfile [\#28](https://github.com/chef-partners/knife-vrealize/pull/28) ([jjasghar](https://github.com/jjasghar))
-- Fixes \#24 [\#27](https://github.com/chef-partners/knife-vrealize/pull/27) ([jjasghar](https://github.com/jjasghar))
-- Updating travis and new versions of ruby [\#26](https://github.com/chef-partners/knife-vrealize/pull/26) ([jjasghar](https://github.com/jjasghar))
-
-## [v2.1.0](https://github.com/chef-partners/knife-vrealize/tree/v2.1.0) (2017-02-09)
-[Full Changelog](https://github.com/chef-partners/knife-vrealize/compare/v2.0.1...v2.1.0)
-
-**Merged pull requests:**
-
-- 2.1.0 release [\#23](https://github.com/chef-partners/knife-vrealize/pull/23) ([jjasghar](https://github.com/jjasghar))
-- Added ssl-mode verify [\#22](https://github.com/chef-partners/knife-vrealize/pull/22) ([jjasghar](https://github.com/jjasghar))
-
-## [v2.0.1](https://github.com/chef-partners/knife-vrealize/tree/v2.0.1) (2017-01-10)
-[Full Changelog](https://github.com/chef-partners/knife-vrealize/compare/v2.0.0...v2.0.1)
-
-**Merged pull requests:**
-
-- Add --vra-tenant command line option [\#21](https://github.com/chef-partners/knife-vrealize/pull/21) ([bdiringer](https://github.com/bdiringer))
-
-## [v2.0.0](https://github.com/chef-partners/knife-vrealize/tree/v2.0.0) (2016-12-15)
-[Full Changelog](https://github.com/chef-partners/knife-vrealize/compare/v1.5.0...v2.0.0)
-
-**Closed issues:**
-
-- certificate verify failure [\#16](https://github.com/chef-partners/knife-vrealize/issues/16)
-
-**Merged pull requests:**
-
-- v1.5.1 [\#18](https://github.com/chef-partners/knife-vrealize/pull/18) ([jjasghar](https://github.com/jjasghar))
-
-## [v1.5.0](https://github.com/chef-partners/knife-vrealize/tree/v1.5.0) (2016-08-02)
-[Full Changelog](https://github.com/chef-partners/knife-vrealize/compare/v1.4.0...v1.5.0)
-
-**Closed issues:**
-
-- Provide a --noboostrap option [\#15](https://github.com/chef-partners/knife-vrealize/issues/15)
-- Prompt for password if not supplied [\#14](https://github.com/chef-partners/knife-vrealize/issues/14)
-- Can't create new servers [\#13](https://github.com/chef-partners/knife-vrealize/issues/13)
-- --extra-param option continually failing with Unknown field error [\#11](https://github.com/chef-partners/knife-vrealize/issues/11)
-
-**Merged pull requests:**
-
-- bumped vra gem [\#17](https://github.com/chef-partners/knife-vrealize/pull/17) ([jjasghar](https://github.com/jjasghar))
-- fixing travis notifications [\#12](https://github.com/chef-partners/knife-vrealize/pull/12) ([adamleff](https://github.com/adamleff))
-
-## [v1.4.0](https://github.com/chef-partners/knife-vrealize/tree/v1.4.0) (2015-10-30)
-[Full Changelog](https://github.com/chef-partners/knife-vrealize/compare/v1.3.1...v1.4.0)
-
-**Merged pull requests:**
-
-- Adding logic to fall back to the vRA resource/server name [\#10](https://github.com/chef-partners/knife-vrealize/pull/10) ([adamleff](https://github.com/adamleff))
-
-## [v1.3.1](https://github.com/chef-partners/knife-vrealize/tree/v1.3.1) (2015-10-29)
-[Full Changelog](https://github.com/chef-partners/knife-vrealize/compare/v1.3.0...v1.3.1)
-
-**Merged pull requests:**
-
-- Bug-fix for handling extra parameters [\#9](https://github.com/chef-partners/knife-vrealize/pull/9) ([adamleff](https://github.com/adamleff))
-
-## [v1.3.0](https://github.com/chef-partners/knife-vrealize/tree/v1.3.0) (2015-10-26)
-[Full Changelog](https://github.com/chef-partners/knife-vrealize/compare/v1.2.0...v1.3.0)
-
-**Merged pull requests:**
-
-- Added pagination size option and a higher-than-normal default. [\#8](https://github.com/chef-partners/knife-vrealize/pull/8) ([adamleff](https://github.com/adamleff))
-- Correct homepage in gemspec [\#7](https://github.com/chef-partners/knife-vrealize/pull/7) ([philoserf](https://github.com/philoserf))
-
-## [v1.2.0](https://github.com/chef-partners/knife-vrealize/tree/v1.2.0) (2015-09-17)
-[Full Changelog](https://github.com/chef-partners/knife-vrealize/compare/v1.1.0...v1.2.0)
-
-**Merged pull requests:**
-
-- Enable `--server-create-timeout` option [\#6](https://github.com/chef-partners/knife-vrealize/pull/6) ([afiune](https://github.com/afiune))
-
-## [v1.1.0](https://github.com/chef-partners/knife-vrealize/tree/v1.1.0) (2015-08-14)
-[Full Changelog](https://github.com/chef-partners/knife-vrealize/compare/v1.0.0...v1.1.0)
-
-**Merged pull requests:**
-
-- New "vro workflow execute" command [\#5](https://github.com/chef-partners/knife-vrealize/pull/5) ([adamleff](https://github.com/adamleff))
-- remove release candidate restriction from vmware-vra, add changelog [\#4](https://github.com/chef-partners/knife-vrealize/pull/4) ([adamleff](https://github.com/adamleff))
-- changing from 2-spaces-after-period to 1 space [\#3](https://github.com/chef-partners/knife-vrealize/pull/3) ([adamleff](https://github.com/adamleff))
-
-## [v1.0.0](https://github.com/chef-partners/knife-vrealize/tree/v1.0.0) (2015-08-07)
-[Full Changelog](https://github.com/chef-partners/knife-vrealize/compare/v1.0.0.rc1...v1.0.0)
-
-**Merged pull requests:**
-
-- Release v1.0.0 [\#2](https://github.com/chef-partners/knife-vrealize/pull/2) ([adamleff](https://github.com/adamleff))
-
-## [v1.0.0.rc1](https://github.com/chef-partners/knife-vrealize/tree/v1.0.0.rc1) (2015-07-30)
-**Merged pull requests:**
-
-- Initial release of the knife-vrealize plugin [\#1](https://github.com/chef-partners/knife-vrealize/pull/1) ([adamleff](https://github.com/adamleff))
-
-
-
-\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*

data/Gemfile

@@ -1,4 +0,0 @@
-# frozen_string_literal: true
-
-source 'https://rubygems.org'
-gemspec

data/Jenkinsfile

@@ -1,28 +0,0 @@
-pipeline {
-  agent {
-    docker {
-      image 'localhost:5000/jjkeysv3'
-      args '-u root'
-    }
-    
-  }
-  stages {
-    stage('Pull down the ChefDK') {
-      steps {
-        sh '''apt-get update
-apt-get install -y curl sudo git build-essential
-curl -L https://chef.io/chef/install.sh | sudo bash -s -- -P chefdk -c current'''
-      }
-    }
-    stage('Bundle') {
-      steps {
-        sh 'chef exec bundle install'
-      }
-    }
-    stage('Rake') {
-      steps {
-        sh 'chef exec rake'
-      }
-    }
-  }
-}

data/README.md

@@ -1,217 +0,0 @@
-# knife-vrealize
-
-This is a Knife plugin that will allow you to interact with
-VMware vRealize products, such as vRA and vRO, from Chef's Knife command.
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-```ruby
-gem 'knife-vrealize'
-```
-
-And then execute:
-
-    $ bundle install
-
-Or install it yourself as:
-
-    $ gem install knife-vrealize
-
-... or, even better, from within ChefDK:
-
-    $ chef gem install knife-vrealize
-
-## vRealize Automation (vRA)
-
-### Configuration
-
-In order to communicate with vRA, you must specify your user credentials. You can specify them in your knife.rb:
-
-```ruby
-knife[:vra_username] = 'myuser'
-knife[:vra_password] = 'mypassword'
-knife[:vra_base_url] = 'https://vra.corp.local'
-knife[:vra_tenant]   = 'mytenant'
-knife[:vra_disable_ssl_verify] = true # if you want to disable SSL checking.
-```
-
-... or you can supply them on the command-line:
-
-```
-knife vra command --vra-username myuser --vra-tenant mytenant ...
-```
-
-### Usage
-
-#### knife vra catalog list
-
-Lists catalog items that can be used to submit machine requests. By default, it will list all catalog items that your user has permission to see. To limit it to only items to which you are entitled, supply the `--entitled` flag.
-
-```
-$ knife vra catalog list
-Catalog ID                            Name                         Description                                                Status     Subtenant
-a9cd6148-6e0b-4a80-ac47-f5255c52b43d  CentOS 6.6                   Blueprint for deploying a CentOS Linux development server  published
-5dcd1900-3b89-433d-8563-9606ae1249b8  CentOS 6.6 - business group  Blueprint for deploying a CentOS Linux development server  published  Rainpole Developers
-d29efd6b-3cd6-4f8d-b1d8-da4ddd4e52b1  WindowsServer2012            Windows Server 2012 with the latest updates and patches.   published
-```
-
-#### knife vra server list
-
-Lists all machine resources that your user has permission to see. The "resource ID" is needed for other commands, such as `knife vra server show` and `knife vra server destroy`
-
-```
-$ knife vra server list
-Resource ID                           Name        Status  Catalog Name
-2e1f6632-1613-41d1-a07c-6137c9639609  hol-dev-43  active  CentOS 6.6
-43898686-7395-468a-99b3-b0b18a8abc1b  hol-dev-44  active  CentOS 6.6
-0977f98b-d927-4e71-8b5b-b27c7deda097  hol-dev-45  active  CentOS 6.6
-```
-
-#### knife vra server show RESOURCE_ID
-
-Displays additional information about an individual server, such as its IP addresses.
-
-```
-$ knife vra server show 2e1f6632-1613-41d1-a07c-6137c9639609
-Server ID: 2e1f6632-1613-41d1-a07c-6137c9639609
-Server Name: hol-dev-43
-IP Addresses: 192.168.110.203
-Status: ACTIVE
-Catalog Name: CentOS 6.6
-```
-
-#### knife vra server create CATALOG_ID (options)
-
-Creates a server from a catalog blueprint. Find the catalog ID with the `knife vra catalog list` command. After the resource is created, knife will attempt to bootstrap it (install chef, run chef-client for the first time, etc.).
-
-Each blueprint may require different parameters to successfully complete provisioning. See your vRA administrator with questions. We'll do our best to give you any helpful error messages from vRA if they're available to us.
-
-Common parameters to specify are:
-
- * `--cpus`: number of CPUs
- * `--memory`: amount of RAM in MB
- * `--requested-for`: vRA login that should be listed as the owner
- * `--lease-days`: number of days for the resource lease
- * `--notes`: any optional notes you'd like to be logged with your request
- * `--subtenant-id`: all resources must be tied back to a Business Group, or "subtenant." If your catalog item is tied to a specific Business Group, you do not need to specify this. However, if your catalog item is a global catalog item, then the subtenant ID is not available to us; you will need to provide it. It usually looks like a UUID. See your vRA administrator for assistance in determining your subtenant ID.
- * `--ssh-password`: if a linux host, the password to use during bootstrap
- * `--winrm-password`: if a windows host, the password to use during bootstrap
- * `--image-os-type`: windows/linux
- * `--bootstrap-protocol`: winrm/ssh
- * `--server-create-timeout`: increase this if your vRa environments takes more than 10 minutes to give you a server.
- * `--bootstrap-version`: use to tie to a specific chefdk version if your group is not current
- * `-N`: node-name of the chef node to create. The gem will automatically create a node name with prefix `vra-` if not specified
-
-Most of these can be set in your `knife.rb` to simplify the command:
-```ruby
-knife[:vra_username] = 'your-username'
-knife[:vra_password] = 'your-pass'
-knife[:vra_base_url] = 'https://cloud.yourcompany.com'
-knife[:vra_tenant]   = 'your-tenant-name'
-knife[:vra_disable_ssl_verify] = true # if you want to disable SSL checking.
-knife[:subtenant_id] = 'your-subtenant-ID'
-knife[:cpus] = '2'
-knife[:memory] = '4096'
-knife[:server_create_timeout] = '1800'
-knife[:bootstrap_version] = '12.18.31' # pinning to an older version
-knife[:server_url] = chef_server_url
-knife[:requested_for] = 'your-username'
-knife[:winrm_user] = 'machine-account-name'
-knife[:winrm_password] = 'machine-account-pass'
-```
-
-
-```
-$ knife vra server create 5dcd1900-3b89-433d-8563-9606ae1249b8 --cpus 1 --memory 512 --requested-for devmgr@corp.local --ssh-password 'mypassword' --lease-days 5
-Catalog request d282fde8-6fd2-406c-998e-328d1b659078 submitted.
-Waiting for request to complete.
-Current request status: PENDING_PRE_APPROVAL.
-Current request status: IN_PROGRESS..
-...
-```
-
-#### knife vra server delete RESOURCE_ID
-
-Deletes a server from vRA. If you supply `--purge`, the server will also be removed from the Chef Server.
-
-```
-$ knife vra server delete 2e1f6632-1613-41d1-a07c-6137c9639609 --purge
-Server ID: 2e1f6632-1613-41d1-a07c-6137c9639609
-Server Name: hol-dev-43
-IP Addresses: 192.168.110.203
-Status: ACTIVE
-Catalog Name: CentOS 6.6
-
-Do you really want to delete this server? (Y/N) Y
-Destroy request f2aa716b-ab24-4232-ac4a-07635a03b4d4 submitted.
-Waiting for request to complete.
-Current request status: PENDING_PRE_APPROVAL.
-Current request status: IN_PROGRESS...
-...
-```
-
-### Known Issue: Pagination
-
-A bug in vRA v6 (as late as v6.2.1) causes resource/server lists to potentially return duplicate items and omit items in the returned data. This appears to be a bug in the pagination code in vRA and was initially discovered and discussed [in this GitHub issue](https://github.com/chef-partners/vmware-vra-gem/issues/10). `knife-vrealize` tries to work around this by setting a higher-than-normal page size of 200 items.  However, if you have more items in your returned data than this, you can attempt to work around this further by using:
-
-```
---page-size NUMBER_OF_ITEMS_PER_PAGE
-```
-
-
-## vRealize Orchestrator (vRO)
-
-### Configuration
-
-In order to communicate with vRA, you must specify your user credentials. You can specify them in your knife.rb:
-
-```ruby
-knife[:vro_username] = 'myuser'
-knife[:vro_password] = 'mypassword'
-knife[:vro_base_url] = 'https://vra.corp.local:8281'
-```
-
-... or you can supply them on the command-line:
-
-```
-knife vro command --vro-username myuser ...
-```
-
-### Usage
-
-### knife vro workflow execute
-
-Executes a vRO workflow.  Requires the workflow name.  You may supply any input parameters, as well.
-
-```
-$ knife vro workflow execute "knife testing" key1=value1
-Starting workflow execution...
-Workflow execution 4028eece4effc046014f27da864d0187 started. Waiting for it to complete...
-Workflow execution complete.
-
-Output Parameters:
-outkey1: some value (string)
-
-Workflow Execution Log:
-2015-08-13 09:17:57 -0700 info: cloudadmin: Workflow 'Knife Testing' has started
-2015-08-13 09:17:58 -0700 info: cloudadmin: Workflow 'Knife Testing' has completed
-```
-
-If your workflow name is not unique in your vRO workflow list, you can specify
-a specific workflow to use with `--vro-workflow-id ID`.  You can find the
-workflow ID from within the vRO UI.  However, a workflow name is still required
-by the API.
-
-## Contributing
-
-We'd love to hear from you if you find this isn't working in your VMware vRA/vRO environment. Please submit a GitHub issue with any problems you encounter.
-
-Additionally, contributions are welcome!  If you'd like to send up any fixes or changes:
-
-1. Fork it ( https://github.com/chef-partners/knife-vrealize/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