vcloud-walker 3.1.1

data/.gitignore

@@ -0,0 +1,9 @@
+Gemfile.lock
+.bundle/
+coverage/
+vendor/
+.idea/
+out/
+pkg/
+fog_integration_test.config
+*.un~

data/Gemfile

@@ -0,0 +1,12 @@
+source 'https://rubygems.org'
+
+gemspec
+
+if ENV['VCLOUD_WALKER_DEV_FOG_MASTER']
+  gem 'fog', :git => 'git@github.com:fog/fog.git', :branch => 'master'
+  gem 'vcloud-core', :git => 'git@github.com:alphagov/vcloud-core.git', :branch => 'master'
+elsif ENV['VCLOUD_WALKER_DEV_FOG_LOCAL']
+  gem 'fog', :path => '../fog'
+  gem 'vcloud-core', :path => '../vcloud-core'
+end
+

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+Copyright (c) 2013 Government Digital Service
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
+OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,55 @@
+# VCloud Walker
+
+Vcloud-walker is a command line tool, to describe different VMware vCloud Director 5.1 entities. It uses Fog under the hood.
+
+## Usage
+To find usage, run `vcloud-walk`.
+
+You can perform following operations with walker.
+
+#### Walk vdcs:
+   vcloud-walk vdcs
+
+describes all vdcs within given organization. This includes vapp, vm and network information.
+
+#### Walk catalogs:
+    vcloud-walk catalogs
+
+describes all catalogs and catalog items within given organization.
+
+#### Walk organization networks:
+     vcloud-walk networks
+
+describes all organization networks.
+
+#### Walk edgegateways:
+    vcloud-walk edgegateways
+
+describes all edgegateway for given organization. Each edgegateway includes configuration for firewall, load balancer and nat services.
+
+#### Walk entire organization:
+     vcloud-walk organization
+
+describes the entire organization, which includes edgegateway, catalogs, networks and vdcs within an organization.
+
+### Credentials
+
+You will need to specify the credentials for your VMware environment. As Vcloud-walker uses fog to query the VMware api, you will need to create a `.fog` file containing these credentials.
+
+An example of .fog file is:
+````
+default:
+  vcloud_director_username: 'user_id@org_id'
+  vcloud_director_password: 'password'
+  vcloud_director_host: 'api_endpoint'
+````
+
+To understand more about `.fog` files, visit the 'Credentials' section here => http://fog.io/about/getting_started.html.
+
+### Output
+
+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.
+

data/Rakefile

@@ -0,0 +1,21 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+require 'rspec/core/rake_task'
+require 'vcloud/walker/version'
+
+RSpec::Core::RakeTask.new(:spec) do |task|
+ENV['COVERAGE'] = 'true'
+task.pattern = FileList['spec/**/*_spec.rb'] - FileList['spec/integration/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:integration_test) do |task|
+task.pattern = FileList['spec/integration/*_spec.rb']
+end
+
+task :default => :spec
+
+require "gem_publisher"
+task :publish_gem do |t|
+  gem = GemPublisher.publish_if_updated("vcloud-walker.gemspec", :rubygems)
+  puts "Published #{gem}" if gem
+end

data/bin/vcloud-walk

@@ -0,0 +1,41 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'bundler/setup'
+require 'methadone'
+
+require 'json'
+require 'vcloud/walker'
+
+class App
+  include Methadone::Main
+  include Methadone::CLILogging
+  include Vcloud
+
+  main do |resource_to_walk|
+    walker_output = Vcloud::Walker.walk(resource_to_walk)
+    options[:yaml] ? print(walker_output.to_yaml)  :  print(JSON.pretty_generate walker_output)
+  end
+
+  on("--verbose", "Verbose output")
+  on("--debug",   "Debugging output")
+  on("--yaml",   "Yaml output")
+
+  arg :resource_to_walk
+
+  description '
+  Vcloud-walker is a command line tool, to describe different VMware vCloud Director 5.1 resources. It uses Fog under the hood.
+
+  Resources that can be walked using vcloud-walker are:
+    catalogs
+    vdcs
+    networks
+    edgegateways
+    organization
+
+  See https://github.com/alphagov/vcloud-walker for more info'
+
+  version Vcloud::Walker::VERSION
+
+  go!
+end

data/docs/examples/catalogs.json

@@ -0,0 +1,40 @@
+[
+    {
+        "id": "bf3dc47a-4138-4154-91ba-d0fde3c94f32",
+        "name": "walker-ci",
+        "description": "",
+        "items": [
+            {
+                "id": "13afd303-1a70-4040-a508-e56cf2d1f483",
+                "name": "ubuntu-precise-image-2",
+                "description": "",
+                "vapp_template_id": "vappTemplate-c390e7a9-b8d5-402b-b71f-7cbeea545621"
+            },
+            {
+                "id": "89946d4a-7371-4a00-9775-73569bb62299",
+                "name": "ubuntu-precise-201309091031",
+                "description": "",
+                "vapp_template_id": "vappTemplate-0015359d-07ca-442a-9314-fbb52536cb8a"
+            }
+        ]
+    },
+    {
+        "id": "9999c6c8-52f9-4460-b0ad-219c322b3964",
+        "name": "Windows Templates",
+        "description": "",
+        "items": [
+            {
+                "id": "11760eb3-a4a3-415d-9274-ee195ae2d587",
+                "name": "Windows_2008_R2_STD_50GB_LargeHighMem_v1.0.2",
+                "description": "Public templatePassword \"Windows#1\"\n------------------------------------------------\nSkyscape Windows 2008 R2\nLarge High Memory Machine Size - 8 vCPU 32GB RAM\n50GB HDD\nv1.0.2",
+                "vapp_template_id": "vappTemplate-b01c681b-e66f-46fb-b0ec-aec37fad7d9c"
+            },
+            {
+                "id": "19d115de-1d19-42d7-8abc-57f7f8554086",
+                "name": "Windows_2008_R2_ENT_50GB_Medium_v1.0.2",
+                "description": "Public templatePassword \"Windows#1\"\n------------------------------------------------\nSkyscape Windows 2008 R2\nMedium Machine Size - 4 vCPU 8GB RAM\n50GB HDD\nv1.0.2",
+                "vapp_template_id": "vappTemplate-699c8fbb-8850-4ce2-a361-006c73a5b686"
+            }
+        ]
+    }
+]

data/docs/examples/edgegateways.json

@@ -0,0 +1,285 @@
+[
+    {
+        "xmlns": "http://www.vmware.com/vcloud/v1.5",
+        "xmlns_xsi": "http://www.w3.org/2001/XMLSchema-instance",
+        "status": "1",
+        "name": "Test Edgegateway",
+        "id": "urn:vcloud:gateway:c1b44ae3-7858-4c54-8fcd-fdc913d8314e",
+        "type": "application/vnd.vmware.admin.edgeGateway+xml",
+        "href": "https://api.vcd.portal.skyscapecloud.com/api/admin/edgeGateway/c1b44ae3-7858-4c54-8fcd-fdc913d8314e",
+        "xsi_schemaLocation": "http://www.vmware.com/vcloud/v1.5 http://api.vcd.portal.skyscapecloud.com/api/v1.5/schema/master.xsd",
+        "Link": [
+            {
+                "rel": "up",
+                "type": "application/vnd.vmware.vcloud.vdc+xml",
+                "href": "https://api.vcd.portal.skyscapecloud.com/api/vdc/074aea1e-a5e9-4dd1-a028-40db8c98d237"
+            },
+            {
+                "rel": "edgeGateway:redeploy",
+                "href": "https://api.vcd.portal.skyscapecloud.com/api/admin/edgeGateway/c1b44ae3-7858-4c54-8fcd-fdc913d8314e/action/redeploy"
+            },
+            {
+                "rel": "edgeGateway:configureServices",
+                "type": "application/vnd.vmware.admin.edgeGatewayServiceConfiguration+xml",
+                "href": "https://api.vcd.portal.skyscapecloud.com/api/admin/edgeGateway/c1b44ae3-7858-4c54-8fcd-fdc913d8314e/action/configureServices"
+            },
+            {
+                "rel": "edgeGateway:reapplyServices",
+                "href": "https://api.vcd.portal.skyscapecloud.com/api/admin/edgeGateway/c1b44ae3-7858-4c54-8fcd-fdc913d8314e/action/reapplyServices"
+            },
+            {
+                "rel": "edgeGateway:syncSyslogSettings",
+                "href": "https://api.vcd.portal.skyscapecloud.com/api/admin/edgeGateway/c1b44ae3-7858-4c54-8fcd-fdc913d8314e/action/syncSyslogServerSettings"
+            }
+        ],
+        "Description": "",
+        "Configuration": {
+            "GatewayBackingConfig": "compact",
+            "GatewayInterfaces": {
+                "GatewayInterface": [
+                    {
+                        "Name": "NetworkTest2",
+                        "DisplayName": "NetworkTest2",
+                        "Network": {
+                            "type": "application/vnd.vmware.admin.network+xml",
+                            "name": "NetworkTest2",
+                            "href": "https://api.vcd.portal.skyscapecloud.com/api/admin/network/61cf57b5-544f-4fdb-aad0-8448926f4060"
+                        },
+                        "InterfaceType": "internal",
+                        "SubnetParticipation": {
+                            "Gateway": "192.168.1.1",
+                            "Netmask": "255.255.255.240",
+                            "IpAddress": "192.168.1.1"
+                        },
+                        "ApplyRateLimit": "false",
+                        "UseForDefaultRoute": "false"
+                    },
+                    {
+                        "Name": "nft00012i2",
+                        "DisplayName": "nft00012i2",
+                        "Network": {
+                            "type": "application/vnd.vmware.admin.network+xml",
+                            "name": "nft00012i2",
+                            "href": "https://api.vcd.portal.skyscapecloud.com/api/admin/network/44265cc3-6d63-4ea9-ac72-4905b5aa65d8"
+                        },
+                        "InterfaceType": "uplink",
+                        "SubnetParticipation": {
+                            "Gateway": "37.26.89.185",
+                            "Netmask": "255.255.255.248",
+                            "IpAddress": "37.26.89.99",
+                            "IpRanges": {
+                                "IpRange": {
+                                    "StartAddress": "37.26.89.100",
+                                    "EndAddress": "37.26.89.199"
+                                }
+                            }
+                        },
+                        "ApplyRateLimit": "false",
+                        "InRateLimit": "100.0",
+                        "OutRateLimit": "100.0",
+                        "UseForDefaultRoute": "true"
+                    },
+                    {
+                        "Name": "Default",
+                        "DisplayName": "Default",
+                        "Network": {
+                            "type": "application/vnd.vmware.admin.network+xml",
+                            "name": "Default",
+                            "href": "https://api.vcd.portal.skyscapecloud.com/api/admin/network/ffa5aa5a-a5a1-4cdb-891f-1a92af7ef550"
+                        },
+                        "InterfaceType": "internal",
+                        "SubnetParticipation": {
+                            "Gateway": "192.168.2.1",
+                            "Netmask": "255.255.255.240",
+                            "IpAddress": "192.168.2.1"
+                        },
+                        "ApplyRateLimit": "false",
+                        "UseForDefaultRoute": "false"
+                    }
+                ]
+            },
+            "EdgeGatewayServiceConfiguration": {
+                "FirewallService": {
+                    "IsEnabled": "true",
+                    "DefaultAction": "allow",
+                    "LogDefaultAction": "false",
+                    "FirewallRule": [
+                        {
+                            "Id": "1",
+                            "IsEnabled": "true",
+                            "MatchOnTranslate": "false",
+                            "Description": "description",
+                            "Policy": "allow",
+                            "Protocols": {
+                                "Tcp": "true"
+                            },
+                            "Port": "22",
+                            "DestinationPortRange": "22",
+                            "DestinationIp": "internal",
+                            "SourcePort": "22",
+                            "SourcePortRange": "22",
+                            "SourceIp": "external",
+                            "EnableLogging": "false"
+                        }
+                    ]
+                },
+                "NatService": {
+                    "IsEnabled": "true",
+                    "NatRule": [
+                        {
+                            "RuleType": "SNAT",
+                            "IsEnabled": "true",
+                            "Id": "65538",
+                            "GatewayNatRule": {
+                                "Interface": {
+                                    "type": "application/vnd.vmware.admin.network+xml",
+                                    "name": "nft00012i2",
+                                    "href": "https://api.vcd.portal.skyscapecloud.com/api/admin/network/44265cc3-6d63-4ea9-ac72-4905b5aa65d8"
+                                },
+                                "OriginalIp": "192.168.2.2",
+                                "TranslatedIp": "37.26.89.189"
+                            }
+                        },
+                        {
+                            "RuleType": "DNAT",
+                            "IsEnabled": "true",
+                            "Id": "65539",
+                            "GatewayNatRule": {
+                                "Interface": {
+                                    "type": "application/vnd.vmware.admin.network+xml",
+                                    "name": "nft00012i2",
+                                    "href": "https://api.vcd.portal.skyscapecloud.com/api/admin/network/44265cc3-6d63-4ea9-ac72-4905b5aa65d8"
+                                },
+                                "OriginalIp": "37.26.89.189",
+                                "OriginalPort": "22",
+                                "TranslatedIp": "192.168.2.2",
+                                "TranslatedPort": "22",
+                                "Protocol": "tcp"
+                            }
+                        }
+                    ]
+                },
+                "LoadBalancerService": {
+                    "IsEnabled": "false",
+                    "Pool": [
+                        {
+                            "Name": "app-pool",
+                            "Description": "app pool 1",
+                            "ServicePort": [
+                                {
+                                    "IsEnabled": "true",
+                                    "Protocol": "HTTP",
+                                    "Algorithm": "ROUND_ROBIN",
+                                    "Port": "80",
+                                    "HealthCheckPort": "80",
+                                    "HealthCheck": {
+                                        "Mode": "HTTP",
+                                        "Uri": "/",
+                                        "HealthThreshold": "2",
+                                        "UnhealthThreshold": "3",
+                                        "Interval": "5",
+                                        "Timeout": "15"
+                                    }
+                                },
+                                {
+                                    "IsEnabled": "true",
+                                    "Protocol": "HTTPS",
+                                    "Algorithm": "ROUND_ROBIN",
+                                    "Port": "443",
+                                    "HealthCheckPort": "443",
+                                    "HealthCheck": {
+                                        "Mode": "SSL",
+                                        "HealthThreshold": "2",
+                                        "UnhealthThreshold": "3",
+                                        "Interval": "5",
+                                        "Timeout": "15"
+                                    }
+                                },
+                                {
+                                    "IsEnabled": "false",
+                                    "Protocol": "TCP",
+                                    "Algorithm": "ROUND_ROBIN",
+                                    "Port": "",
+                                    "HealthCheckPort": "",
+                                    "HealthCheck": {
+                                        "Mode": "TCP",
+                                        "HealthThreshold": "2",
+                                        "UnhealthThreshold": "3",
+                                        "Interval": "5",
+                                        "Timeout": "15"
+                                    }
+                                }
+                            ],
+                            "Member": [
+                                {
+                                    "IpAddress": "37.26.89.100",
+                                    "Weight": "1",
+                                    "ServicePort": [
+                                        {
+                                            "Protocol": "HTTP",
+                                            "Port": "",
+                                            "HealthCheckPort": ""
+                                        },
+                                        {
+                                            "Protocol": "HTTPS",
+                                            "Port": "",
+                                            "HealthCheckPort": ""
+                                        },
+                                        {
+                                            "Protocol": "TCP",
+                                            "Port": "",
+                                            "HealthCheckPort": ""
+                                        }
+                                    ]
+                                }
+                            ],
+                            "Operational": "false"
+                        }
+                    ],
+                    "VirtualServer": [
+                        {
+                            "IsEnabled": "true",
+                            "Name": "web-server-1",
+                            "Interface": {
+                                "type": "application/vnd.vmware.vcloud.orgVdcNetwork+xml",
+                                "name": "nft00012i2",
+                                "href": "https://api.vcd.portal.skyscapecloud.com/api/admin/network/44265cc3-6d63-4ea9-ac72-4905b5aa65d8"
+                            },
+                            "IpAddress": "37.26.89.100",
+                            "ServiceProfile": [
+                                {
+                                    "IsEnabled": "false",
+                                    "Protocol": "HTTP",
+                                    "Port": "80",
+                                    "Persistence": {
+                                        "Method": ""
+                                    }
+                                },
+                                {
+                                    "IsEnabled": "true",
+                                    "Protocol": "HTTPS",
+                                    "Port": "443",
+                                    "Persistence": {
+                                        "Method": "SSL_SESSION_ID"
+                                    }
+                                },
+                                {
+                                    "IsEnabled": "false",
+                                    "Protocol": "TCP",
+                                    "Port": "",
+                                    "Persistence": {
+                                        "Method": ""
+                                    }
+                                }
+                            ],
+                            "Logging": "false",
+                            "Pool": "app-pool"
+                        }
+                    ]
+                }
+            },
+            "HaEnabled": "false",
+            "UseDefaultRouteForDnsRelay": "false"
+        }
+    }
+]

data/docs/examples/networks.json

@@ -0,0 +1,53 @@
+[
+    {
+        "id": "61cf57b5-544f-4fdb-aad0-8448926f4060",
+        "name": "NetworkTest2",
+        "description": "Network Test 2",
+        "is_inherited": false,
+        "gateway": "192.168.1.1",
+        "netmask": "255.255.255.240",
+        "dns1": "8.8.8.8",
+        "dns2": "8.8.4.4",
+        "dns_suffix": "tester2.networktest",
+        "ip_ranges": [
+            {
+                "start_address": "192.168.1.2",
+                "end_address": "192.168.1.14"
+            }
+        ]
+    },
+    {
+        "id": "a3568eee-caaa-480d-8b13-f7df33e369a6",
+        "name": "NetworkTest",
+        "description": "Test network",
+        "is_inherited": false,
+        "gateway": "192.168.0.1",
+        "netmask": "255.255.255.0",
+        "dns1": "8.8.8.8",
+        "dns2": "8.8.4.4",
+        "dns_suffix": "tester.networktest",
+        "ip_ranges": [
+            {
+                "start_address": "192.168.0.2",
+                "end_address": "192.168.0.254"
+            }
+        ]
+    },
+    {
+        "id": "ffa5aa5a-a5a1-4cdb-891f-1a92af7ef550",
+        "name": "Default",
+        "description": "default network",
+        "is_inherited": false,
+        "gateway": "192.168.2.1",
+        "netmask": "255.255.255.240",
+        "dns1": "8.8.8.8",
+        "dns2": "8.8.4.4",
+        "dns_suffix": "tester.default",
+        "ip_ranges": [
+            {
+                "start_address": "192.168.2.2",
+                "end_address": "192.168.2.14"
+            }
+        ]
+    }
+]