{"id":22379119,"url":"https://github.com/sky-uk/vagrant-vrealize","last_synced_at":"2025-07-31T01:31:48.277Z","repository":{"id":59159041,"uuid":"55236045","full_name":"sky-uk/vagrant-vrealize","owner":"sky-uk","description":"VRealize provider plugin for Vagrant","archived":false,"fork":false,"pushed_at":"2017-05-15T11:16:04.000Z","size":36,"stargazers_count":10,"open_issues_count":1,"forks_count":6,"subscribers_count":140,"default_branch":"master","last_synced_at":"2024-09-15T16:12:05.935Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sky-uk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-04-01T13:53:49.000Z","updated_at":"2022-02-25T15:46:33.000Z","dependencies_parsed_at":"2022-09-17T08:11:59.317Z","dependency_job_id":null,"html_url":"https://github.com/sky-uk/vagrant-vrealize","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sky-uk%2Fvagrant-vrealize","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sky-uk%2Fvagrant-vrealize/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sky-uk%2Fvagrant-vrealize/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sky-uk%2Fvagrant-vrealize/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sky-uk","download_url":"https://codeload.github.com/sky-uk/vagrant-vrealize/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228204606,"owners_count":17884711,"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":[],"created_at":"2024-12-04T23:09:00.807Z","updated_at":"2024-12-04T23:09:01.633Z","avatar_url":"https://github.com/sky-uk.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vagrant VRealize Provider\n\nThis is a [Vagrant](http://www.vagrantup.com) 1.2+ plugin that adds a VMware vRealize Automation \nprovider to Vagrant, allowing Vagrant to control and provision machines in\nVRealize.\n\n**NOTE:** This plugin requires Vagrant 1.2+,\n\n**NOTE MORE:**\nThe version of the vmware-vra gem is locked to ~ 2.0 - as such this will only work with vRA 7.X.\nRestrict vmware-vra to ~ 1 to make this work with vRA 6.\n\n**NOTE EVEN MORE:** This plugin is a work in progress.  The basics work, but it's\nnot as fully-featured as the `vagrant-aws` plugin it's largely based on.\n\n## What works\n\n* Boot VRealize instances.\n* SSH into the instances.\n* Provision the instances with any built-in Vagrant provisioner.\n* Minimal synced folder support via `rsync`.\n\n## Usage\n\nInstall using standard Vagrant 1.1+ plugin installation methods. After\ninstalling, `vagrant up` and specify the `vrealize` provider. An\nexample is shown below.\n\n```\n$ vagrant plugin install vagrant-vrealize\n...\n$ vagrant up --provider=vrealize\n...\n```\n\nOf course, prior to doing this, you'll need to obtain a\nVRealize-compatible box file for Vagrant.\n\n## Quick Start\n\nAfter installing the plugin (instructions above), the quickest way to get\nstarted is to actually use the dummy VRealize box and specify all the details\nmanually within a `config.vm.provider` block. So first, build the box:\n\n```\n$ rake box\n$ vagrant box add --provider vrealize example_box/vrealize.box\n```\n\nAnd then make a Vagrantfile that looks like the following, filling in\nyour information where necessary.\n\n```\nVagrant.configure(\"2\") do |config|\n  config.vm.box = \"vrealize\"\n\n  config.vm.provider :vrealize do |vrealize, override|\n    # Note: you'll need to make sure your environment variables\n    # are set up correctly for this bit...\n    vrealize.vra_username = ENV['USER']\n    vrealize.vra_password = ENV['PASSWORD']\n    vrealize.vra_tenant   = ENV['VRA_TENANT']\n    vrealize.vra_base_url = ENV['VRA_BASE_URL']\n\n    # From here on are configuration settings for the specific VM\n    # we're creating\n\n    vrealize.requested_for = ENV['VRA_AD_USER']\n\n    vrealize.subtenant_id = SOME_GUID\n    vrealize.catalog_item_id = SOME_CATALOG_ID\n\n    vrealize.add_entries do |extras|\n      # This isn't actually needed, it's just here to show how to set custom\n      # request data\n      extras.string('provider-Vrm.DataCenter.Location', '')\n    end\n\n\n    override.ssh.username = \"root\"\n    override.ssh.password = SOMETHING_SENSIBLE_HERE\n  end\nend\n```\n\nAnd then run `vagrant up --provider=vrealize`.\n\n## Networks\n\nNetworking features in the form of `config.vm.network` are not\nsupported with `vagrant-vrealize`, currently. If any of these are\nspecified, Vagrant will emit a warning, but will otherwise boot\nthe VRealize machine.\n\n## Synced Folders\n\nThere is minimal support for synced folders. Upon `vagrant up`,\n`vagrant reload`, and `vagrant provision`, the Vrealize provider will\nuse `rsync` (if available) to uni-directionally sync the folder to the\nremote machine over SSH.\n\nSee [Vagrant Synced folders: rsync](https://docs.vagrantup.com/v2/synced-folders/rsync.html)\n\n\n## Development\n\nTo work on the `vagrant-vrealize` plugin, clone this repository out, and use\n[Bundler](http://gembundler.com) to get the dependencies:\n\n```\n$ bundle\n```\n\nIf those install, you're ready to start developing the plugin. You can test\nthe plugin without installing it into your Vagrant environment by just\ncreating a `Vagrantfile` in the top level of this directory (it is gitignored)\nand add the following line to your `Vagrantfile`\n\n```ruby\nVagrant.require_plugin \"vagrant-vrealize\"\n```\nUse bundler to execute Vagrant:\n```\n$ bundle exec vagrant up --provider=vrealize\n```\n\n[![Dependency Status](https://dependencyci.com/github/sky-uk/vagrant-vrealize/badge)](https://dependencyci.com/github/sky-uk/vagrant-vrealize)\n\n## And Finally\n\nThis plugin is an unfinished work-in-progress. It (and large parts of\nthis document) are based on Mitchell Hashimoto's `vagrant-aws` plugin,\nwhich can be found here: https://github.com/mitchellh/vagrant-aws.\n\n## Author\n\nAlex Young \u003cAlexander.Young@sky.uk\u003e\nPlease get in touch, raise issues, make pull requests, if you're trying to use this and running into problems.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsky-uk%2Fvagrant-vrealize","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsky-uk%2Fvagrant-vrealize","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsky-uk%2Fvagrant-vrealize/lists"}