vcloud-tools 0.8.0 → 1.0.0
Sign up to get free protection for your applications and to get access to all the features.
- data/CHANGELOG.md +8 -0
- data/README.md +28 -39
- data/lib/vcloud/tools/version.rb +1 -1
- data/vcloud-tools.gemspec +6 -5
- metadata +30 -14
data/CHANGELOG.md
CHANGED
@@ -1,3 +1,11 @@
|
|
1
|
+
## 1.0.0 (2014-05-19)
|
2
|
+
|
3
|
+
Features:
|
4
|
+
|
5
|
+
- We no longer specify a version for the gems that this meta-gem installs;
|
6
|
+
installing this gem should now install the most recent versions of its dependencies.
|
7
|
+
- Include vCloud Tools Tester gem
|
8
|
+
|
1
9
|
## 0.8.0 (2014-04-23)
|
2
10
|
|
3
11
|
Features:
|
data/README.md
CHANGED
@@ -38,66 +38,55 @@ vCloud Core also comes with command line tool, vCloud Query, which exposes the v
|
|
38
38
|
|
39
39
|
( [gem in RubyGems](http://rubygems.org/gems/vcloud-core) | [code on GitHub](https://github.com/alphagov/vcloud-core) )
|
40
40
|
|
41
|
-
Required set-up
|
42
|
-
===============
|
43
41
|
|
44
|
-
##
|
42
|
+
## Installation
|
45
43
|
|
46
|
-
|
47
|
-
environment. Fog offers two ways to do this.
|
44
|
+
Add this line to your application's Gemfile:
|
48
45
|
|
49
|
-
|
46
|
+
gem 'vcloud-tools'
|
50
47
|
|
51
|
-
|
48
|
+
And then execute:
|
52
49
|
|
53
|
-
|
50
|
+
$ bundle
|
54
51
|
|
55
|
-
|
56
|
-
vcloud_director_username: 'username@org_name'
|
57
|
-
vcloud_director_password: 'password'
|
58
|
-
vcloud_director_host: 'host.api.example.com'
|
52
|
+
Or install it yourself as:
|
59
53
|
|
60
|
-
|
54
|
+
$ gem install vcloud-tools
|
61
55
|
|
62
|
-
|
63
|
-
vcloud_director_username: 'username@org_name'
|
64
|
-
vcloud_director_password: 'password'
|
65
|
-
vcloud_director_host: 'host.api.example.com'
|
56
|
+
Installing vCloud Tools will install all of the tools listed above.
|
66
57
|
|
67
|
-
|
68
|
-
vcloud_director_username: 'username@org_name'
|
69
|
-
vcloud_director_password: 'password'
|
70
|
-
vcloud_director_host: 'host.api.vendor.net'
|
58
|
+
## Credentials
|
71
59
|
|
72
|
-
|
60
|
+
vCloud Tools is based around [fog](http://fog.io/). To use it you'll need to give it credentials that allow it to talk to a vCloud Director environment.
|
73
61
|
|
74
|
-
|
62
|
+
1. Create a '.fog' file in your home directory.
|
75
63
|
|
76
|
-
|
64
|
+
For example:
|
77
65
|
|
78
|
-
|
66
|
+
test_credentials:
|
67
|
+
vcloud_director_host: 'host.api.example.com'
|
68
|
+
vcloud_director_username: 'username@org_name'
|
69
|
+
vcloud_director_password: ''
|
79
70
|
|
80
|
-
|
81
|
-
tool by setting the `FOG_VCLOUD_TOKEN` ENV variable. This option reduces the risk footprint by allowing the user to
|
82
|
-
store their credentials in safe storage. The default token lifetime is '30 minutes idle' - any activity extends the life by another 30 mins.
|
71
|
+
2. Obtain a session token. First, curl the API:
|
83
72
|
|
84
|
-
|
73
|
+
curl -D- -d '' \
|
74
|
+
-H 'Accept: application/*+xml;version=5.1' -u '<username>@<org_name>' \
|
75
|
+
https://<host.api.example.com>/api/sessions
|
85
76
|
|
86
|
-
|
87
|
-
-D-
|
88
|
-
-d ''
|
89
|
-
-H 'Accept: application/*+xml;version=5.1' -u '<user>@<org>'
|
90
|
-
https://host.com/api/sessions
|
77
|
+
This will prompt for your password.
|
91
78
|
|
92
|
-
|
79
|
+
From the headers returned, the value of the `x-vcloud-authorization` header is your session token, and this will be valid for 30 minutes idle - any activity will extend its life by another 30 minutes.
|
93
80
|
|
94
|
-
|
81
|
+
3. Specify your credentials and session token at the beginning of the command. For example:
|
95
82
|
|
96
|
-
|
83
|
+
FOG_CREDENTIAL=test_credentials \
|
84
|
+
FOG_VCLOUD_TOKEN=AAAABBBBBCCCCCCDDDDDDEEEEEEFFFFF= \
|
85
|
+
vcloud-launch node.yaml
|
97
86
|
|
98
|
-
|
87
|
+
You may find it easier to export one or both of the values as environment variables.
|
99
88
|
|
100
|
-
|
89
|
+
**NB** It is also possible to sidestep the need for the session token by saving your password in the fog file. This is **not recommended**.
|
101
90
|
|
102
91
|
## Contributing
|
103
92
|
|
data/lib/vcloud/tools/version.rb
CHANGED
data/vcloud-tools.gemspec
CHANGED
@@ -17,11 +17,12 @@ Gem::Specification.new do |s|
|
|
17
17
|
s.test_files = s.files.grep(%r{^(test|spec|features)/})
|
18
18
|
s.require_paths = ['lib']
|
19
19
|
|
20
|
-
s.add_runtime_dependency 'vcloud-core'
|
21
|
-
s.add_runtime_dependency 'vcloud-edge_gateway'
|
22
|
-
s.add_runtime_dependency 'vcloud-launcher'
|
23
|
-
s.add_runtime_dependency 'vcloud-net_launcher'
|
24
|
-
s.add_runtime_dependency 'vcloud-walker'
|
20
|
+
s.add_runtime_dependency 'vcloud-core'
|
21
|
+
s.add_runtime_dependency 'vcloud-edge_gateway'
|
22
|
+
s.add_runtime_dependency 'vcloud-launcher'
|
23
|
+
s.add_runtime_dependency 'vcloud-net_launcher'
|
24
|
+
s.add_runtime_dependency 'vcloud-walker'
|
25
25
|
s.add_development_dependency 'gem_publisher', '1.2.0'
|
26
26
|
s.add_development_dependency 'rake'
|
27
|
+
s.add_development_dependency 'vcloud-tools-tester'
|
27
28
|
end
|
metadata
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: vcloud-tools
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.
|
4
|
+
version: 1.0.0
|
5
5
|
prerelease:
|
6
6
|
platform: ruby
|
7
7
|
authors:
|
@@ -9,7 +9,7 @@ authors:
|
|
9
9
|
autorequire:
|
10
10
|
bindir: bin
|
11
11
|
cert_chain: []
|
12
|
-
date: 2014-
|
12
|
+
date: 2014-05-19 00:00:00.000000000 Z
|
13
13
|
dependencies:
|
14
14
|
- !ruby/object:Gem::Dependency
|
15
15
|
name: vcloud-core
|
@@ -18,7 +18,7 @@ dependencies:
|
|
18
18
|
requirements:
|
19
19
|
- - ! '>='
|
20
20
|
- !ruby/object:Gem::Version
|
21
|
-
version: 0
|
21
|
+
version: '0'
|
22
22
|
type: :runtime
|
23
23
|
prerelease: false
|
24
24
|
version_requirements: !ruby/object:Gem::Requirement
|
@@ -26,7 +26,7 @@ dependencies:
|
|
26
26
|
requirements:
|
27
27
|
- - ! '>='
|
28
28
|
- !ruby/object:Gem::Version
|
29
|
-
version: 0
|
29
|
+
version: '0'
|
30
30
|
- !ruby/object:Gem::Dependency
|
31
31
|
name: vcloud-edge_gateway
|
32
32
|
requirement: !ruby/object:Gem::Requirement
|
@@ -34,7 +34,7 @@ dependencies:
|
|
34
34
|
requirements:
|
35
35
|
- - ! '>='
|
36
36
|
- !ruby/object:Gem::Version
|
37
|
-
version: 0
|
37
|
+
version: '0'
|
38
38
|
type: :runtime
|
39
39
|
prerelease: false
|
40
40
|
version_requirements: !ruby/object:Gem::Requirement
|
@@ -42,7 +42,7 @@ dependencies:
|
|
42
42
|
requirements:
|
43
43
|
- - ! '>='
|
44
44
|
- !ruby/object:Gem::Version
|
45
|
-
version: 0
|
45
|
+
version: '0'
|
46
46
|
- !ruby/object:Gem::Dependency
|
47
47
|
name: vcloud-launcher
|
48
48
|
requirement: !ruby/object:Gem::Requirement
|
@@ -50,7 +50,7 @@ dependencies:
|
|
50
50
|
requirements:
|
51
51
|
- - ! '>='
|
52
52
|
- !ruby/object:Gem::Version
|
53
|
-
version: 0
|
53
|
+
version: '0'
|
54
54
|
type: :runtime
|
55
55
|
prerelease: false
|
56
56
|
version_requirements: !ruby/object:Gem::Requirement
|
@@ -58,7 +58,7 @@ dependencies:
|
|
58
58
|
requirements:
|
59
59
|
- - ! '>='
|
60
60
|
- !ruby/object:Gem::Version
|
61
|
-
version: 0
|
61
|
+
version: '0'
|
62
62
|
- !ruby/object:Gem::Dependency
|
63
63
|
name: vcloud-net_launcher
|
64
64
|
requirement: !ruby/object:Gem::Requirement
|
@@ -66,7 +66,7 @@ dependencies:
|
|
66
66
|
requirements:
|
67
67
|
- - ! '>='
|
68
68
|
- !ruby/object:Gem::Version
|
69
|
-
version: 0
|
69
|
+
version: '0'
|
70
70
|
type: :runtime
|
71
71
|
prerelease: false
|
72
72
|
version_requirements: !ruby/object:Gem::Requirement
|
@@ -74,7 +74,7 @@ dependencies:
|
|
74
74
|
requirements:
|
75
75
|
- - ! '>='
|
76
76
|
- !ruby/object:Gem::Version
|
77
|
-
version: 0
|
77
|
+
version: '0'
|
78
78
|
- !ruby/object:Gem::Dependency
|
79
79
|
name: vcloud-walker
|
80
80
|
requirement: !ruby/object:Gem::Requirement
|
@@ -82,7 +82,7 @@ dependencies:
|
|
82
82
|
requirements:
|
83
83
|
- - ! '>='
|
84
84
|
- !ruby/object:Gem::Version
|
85
|
-
version:
|
85
|
+
version: '0'
|
86
86
|
type: :runtime
|
87
87
|
prerelease: false
|
88
88
|
version_requirements: !ruby/object:Gem::Requirement
|
@@ -90,7 +90,7 @@ dependencies:
|
|
90
90
|
requirements:
|
91
91
|
- - ! '>='
|
92
92
|
- !ruby/object:Gem::Version
|
93
|
-
version:
|
93
|
+
version: '0'
|
94
94
|
- !ruby/object:Gem::Dependency
|
95
95
|
name: gem_publisher
|
96
96
|
requirement: !ruby/object:Gem::Requirement
|
@@ -123,6 +123,22 @@ dependencies:
|
|
123
123
|
- - ! '>='
|
124
124
|
- !ruby/object:Gem::Version
|
125
125
|
version: '0'
|
126
|
+
- !ruby/object:Gem::Dependency
|
127
|
+
name: vcloud-tools-tester
|
128
|
+
requirement: !ruby/object:Gem::Requirement
|
129
|
+
none: false
|
130
|
+
requirements:
|
131
|
+
- - ! '>='
|
132
|
+
- !ruby/object:Gem::Version
|
133
|
+
version: '0'
|
134
|
+
type: :development
|
135
|
+
prerelease: false
|
136
|
+
version_requirements: !ruby/object:Gem::Requirement
|
137
|
+
none: false
|
138
|
+
requirements:
|
139
|
+
- - ! '>='
|
140
|
+
- !ruby/object:Gem::Version
|
141
|
+
version: '0'
|
126
142
|
description:
|
127
143
|
email:
|
128
144
|
executables: []
|
@@ -154,7 +170,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
154
170
|
version: '0'
|
155
171
|
segments:
|
156
172
|
- 0
|
157
|
-
hash:
|
173
|
+
hash: 2217743853277878432
|
158
174
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
159
175
|
none: false
|
160
176
|
requirements:
|
@@ -163,7 +179,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
163
179
|
version: '0'
|
164
180
|
segments:
|
165
181
|
- 0
|
166
|
-
hash:
|
182
|
+
hash: 2217743853277878432
|
167
183
|
requirements: []
|
168
184
|
rubyforge_project:
|
169
185
|
rubygems_version: 1.8.23
|