Vcloud-walker is a command line tool, to describe different VMware vCloud Director 5.1 entities. It uses Fog under the hood.
Add this line to your application's Gemfile:
And then execute:
Or install it yourself as:
$ gem install vcloud-walker
To find usage, run
You can perform following operations with walker.
describes all vdcs within given organization. This includes vapp, vm and network information.
describes all catalogs and catalog items within given organization.
Walk organization networks:
describes all organization networks.
describes all edgegateway for given organization. Each edgegateway includes configuration for firewall, load balancer and nat services.
Walk entire organization:
describes the entire organization, which includes edgegateway, catalogs, networks and vdcs within an organization.
Please see the vcloud-tools usage documentation.
Walker can output data in JSON or YAML format. The default output format is JSON.
You can use command line option
--yaml for yaml output.
Find sample json output in docs/examples directory.
The vCloud API
vCloud Tools currently use version 5.1 of the vCloud API. Version 5.5 may work but is not currently supported. You should be able to access the 5.1 API in a 5.5 environment, and this is currently supported.
The default version is defined in Fog.
If you want to be sure you are pinning to 5.1, or use 5.5, you can set the API version to use in your fog file, e.g.
export EXCON_DEBUG=true - this will print out the API requests and responses.
export DEBUG=true - this will show you the stack trace when there is an exception instead of just the message.
Run the default suite of tests (e.g. lint, unit, features):
bundle exec rake
There are also integration tests. These are slower and require a real environment. See the vCloud Tools website for details of how to set up and run the integration tests.
Please see CONTRIBUTING.md.