{"id":17832413,"url":"https://github.com/test-kitchen/kitchen-vro","last_synced_at":"2025-03-27T10:31:50.412Z","repository":{"id":36866010,"uuid":"41172979","full_name":"test-kitchen/kitchen-vro","owner":"test-kitchen","description":"A Test Kitchen driver for VMware vRealize Orchestrator","archived":false,"fork":false,"pushed_at":"2024-04-10T08:08:03.000Z","size":34,"stargazers_count":6,"open_issues_count":3,"forks_count":5,"subscribers_count":15,"default_branch":"main","last_synced_at":"2024-04-14T05:31:18.668Z","etag":null,"topics":["hacktoberfest","managed-by-terraform","ruby","ruby-gem","test-kitchen","testing"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/test-kitchen.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2015-08-21T19:12:47.000Z","updated_at":"2024-06-09T15:40:33.056Z","dependencies_parsed_at":"2023-12-19T07:15:56.109Z","dependency_job_id":"e259dd44-e962-43f3-9387-91284f7041eb","html_url":"https://github.com/test-kitchen/kitchen-vro","commit_stats":{"total_commits":24,"total_committers":9,"mean_commits":"2.6666666666666665","dds":0.75,"last_synced_commit":"69391a5a5e0d0ea25c1f6114f027386a746b2438"},"previous_names":["chef-partners/kitchen-vro"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/test-kitchen%2Fkitchen-vro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/test-kitchen%2Fkitchen-vro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/test-kitchen%2Fkitchen-vro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/test-kitchen%2Fkitchen-vro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/test-kitchen","download_url":"https://codeload.github.com/test-kitchen/kitchen-vro/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245189402,"owners_count":20574963,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","managed-by-terraform","ruby","ruby-gem","test-kitchen","testing"],"created_at":"2024-10-27T19:56:48.853Z","updated_at":"2025-03-27T10:31:50.128Z","avatar_url":"https://github.com/test-kitchen.png","language":"Ruby","readme":"# kitchen-vro\n\nA driver to allow Test Kitchen to consume VMware resources provisioned by\nway of vRealize Orchestrator workflows.\n\nvRO allows you to create any workflow you can imagine, but our plugin needs\nto make some assumptions about the workflows you design in order to properly\nprovision and destroy resources.  Therefore, please pay special attention to\nthe **Workflow Design** section below and ensure your workflows adhere to\nthese design requirements.\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n```ruby\ngem 'kitchen-vro'\n```\n\nAnd then execute:\n\n```shell\nbundle\n```\n\nOr install it yourself as:\n\n```shell\ngem install kitchen-vro\n```\n\nOr even better, install it via ChefDK:\n\n```shell\nchef gem install kitchen-vro\n```\n\n## Usage\n\nAfter installing the gem as described above, edit your .kitchen.yml file to set the driver to 'vro' and supply your login credentials:\n\n```yaml\ndriver:\n  name: vro\n  vro_username: user@domain.com\n  vro_password: MyS33kretPassword\n  vro_base_url: https://vra.corp.local:8281\n```\n\nAdditionally, the following parameters are required, either globally or per-platform:\n\n* **create_workflow_name**: The name of the vRO workflow to execute to create a server.\n* **destroy_workflow_name**: The name of the vRO workflow to execute to destroy a server.\n\nThere are a number of optional parameters you can configure as well:\n\n* **create_workflow_id**: If your create workflow name is not unique within vRO, you can use\n   this parameter to specify the workflow unique ID.\n* **destroy_workflow_id**: If your destroy workflow name is not unique within vRO, you can use\n   this parameter to specify the workflow unique ID.\n* **create_workflow_parameters**: A hash of key-value pairs of parameters to pass to your\n   create workflow.\n* **destroy_workflow_parameters**: A hash of key-value pairs of parameters to pass to your\n   destroy workflow.\n* **request_timeout**: Number of seconds to wait for a vRO workflow to execute.  Default: 300\n* **vro_disable_ssl_verify**: Disable SSL validation.  Default: false\n\nAn example `.kitchen.yml` that uses a combination of global and per-platform\nsettings might look like this:\n\n```yaml\ndriver:\n  name: vro\n  vro_username: user@domain.com\n  vro_password: MyS33kretPassword\n  vro_base_url: https://vra.corp.local:8281\n  create_workflow_name: Create TK Server\n  destroy_workflow_name: Destroy TK Server\n\nplatforms:\n  - name: centos\n    driver:\n      create_workflow_parameters:\n        os_name: centos\n        os_version: 6.7\n  - name: windows\n    driver:\n      create_workflow_parameters:\n        os_name: windows\n        os_version: server2012\n        cpus: 4\n        memory: 4096\n```\n\n## Workflow Design\n\nThere are no limits as to what you can do with your vRO workflows!  However,\nthey must meet the following requirements.\n\n### Create Workflow\n\n* Must contain an output parameter called `ip_address` that Test Kitchen can\n   connect to in order to bootstrap and test your node.\n* Must contain an output parameter called `server_id` that is a unique ID of\n   the server created.  Test Kitchen will provide this value to the Destroy\n   Workflow in order to request the destruction of the server once testing is\n   complete.\n* Must end the workflow with a raised exception if the creation did not\n   succeed.  The workflow status must not be 'completed.'\n\n### Destroy Workflow\n\n* Must contain an input parameter called `server_id` that Test Kitchen will\n   populate with the unique ID returned from the Create Workflow output.\n* Must end the workflow with a raised exception if the creation did not\n     succeed.  The workflow status must not be 'completed.'\n\n## License and Authors\n\nAuthor:: Chef Partner Engineering (\u003cpartnereng@chef.io\u003e)\n\nCopyright:: Copyright (c) 2015 Chef Software, Inc.\n\nLicense:: Apache License, Version 2.0\n\nLicensed under the Apache License, Version 2.0 (the \"License\"); you may not use\nthis file except in compliance with the License. You may obtain a copy of the License at\n\n```text\nhttp://www.apache.org/licenses/LICENSE-2.0\n```\n\nUnless required by applicable law or agreed to in writing, software distributed under the\nLicense is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,\neither express or implied. See the License for the specific language governing permissions\nand limitations under the License.\n\n## Contributing\n\nWe'd love to hear from you if this doesn't perform in the manner you expect. Please log a GitHub issue, or even better, submit a Pull Request with a fix!\n\n1. Fork it ( \u003chttps://github.com/chef-partners/kitchen-vro/fork\u003e )\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create a new Pull Request\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftest-kitchen%2Fkitchen-vro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftest-kitchen%2Fkitchen-vro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftest-kitchen%2Fkitchen-vro/lists"}