cloudstack-cli 1.1.0 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/Gemfile.lock +9 -11
- data/README.md +34 -18
- data/cloudstack-cli.gemspec +2 -3
- data/lib/cloudstack-cli/version.rb +1 -1
- metadata +7 -22
- data/.ruby-version +0 -1
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 6bcf75b6d058d8544a05a8f2d02bb44cbf2d2e8f
|
4
|
+
data.tar.gz: 29ba8a55a0b369955ee461f869de8ae198c338f9
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: eee90182cc7ba1455d5c3202058235a18f80876f96f53d46751da316062e97b6ea2abebdc410ff38160cd997e668eba3f0153302a43b706792dc10b9927a6443
|
7
|
+
data.tar.gz: 4f3f3c1df8fa562f042abe20ff8ba4e452abfe65265ccc37e54fcb3c8c946d216dac1bcc2a97f3510ff1a0b63c3963748ddefce1f995f59d70a4a6e0f41c5eb9
|
data/Gemfile.lock
CHANGED
@@ -1,22 +1,21 @@
|
|
1
1
|
PATH
|
2
|
-
remote:
|
2
|
+
remote: ../cloudstack_client/
|
3
3
|
specs:
|
4
|
-
|
5
|
-
|
6
|
-
thor (~> 0.19.1)
|
4
|
+
cloudstack_client (1.2.0)
|
5
|
+
multi_json (~> 1.11)
|
7
6
|
|
8
7
|
PATH
|
9
|
-
remote:
|
8
|
+
remote: .
|
10
9
|
specs:
|
11
|
-
|
12
|
-
|
10
|
+
cloudstack-cli (1.2.0)
|
11
|
+
cloudstack_client (~> 1.2)
|
12
|
+
thor (~> 0.19)
|
13
13
|
|
14
14
|
GEM
|
15
15
|
remote: https://rubygems.org/
|
16
16
|
specs:
|
17
|
-
|
17
|
+
multi_json (1.11.2)
|
18
18
|
rake (10.4.2)
|
19
|
-
rdoc (4.2.0)
|
20
19
|
thor (0.19.1)
|
21
20
|
|
22
21
|
PLATFORMS
|
@@ -26,7 +25,6 @@ DEPENDENCIES
|
|
26
25
|
cloudstack-cli!
|
27
26
|
cloudstack_client!
|
28
27
|
rake (~> 10.4)
|
29
|
-
rdoc (~> 4.2)
|
30
28
|
|
31
29
|
BUNDLED WITH
|
32
|
-
1.
|
30
|
+
1.11.2
|
data/README.md
CHANGED
@@ -3,7 +3,7 @@
|
|
3
3
|
[](http://badge.fury.io/rb/cloudstack-cli)
|
4
4
|
|
5
5
|
cloudstack-cli is a [CloudStack](http://cloudstack.apache.org/) API command line client written in Ruby.
|
6
|
-
cloudstack-cli uses the [cloudstack_client](https://github.com/niwo/cloudstack_client) to talk to the
|
6
|
+
cloudstack-cli uses the [cloudstack_client](https://github.com/niwo/cloudstack_client) to talk to the CloudStack API.
|
7
7
|
|
8
8
|
## Installation
|
9
9
|
|
@@ -15,18 +15,26 @@ $ gem install cloudstack-cli
|
|
15
15
|
|
16
16
|
## Setup
|
17
17
|
|
18
|
-
### Create a cloudstack-cli
|
18
|
+
### Create a cloudstack-cli environment
|
19
19
|
|
20
|
-
Create your
|
20
|
+
*Create your initial environment, which defines your connection options:*
|
21
21
|
|
22
22
|
```bash
|
23
|
-
$ cloudstack-cli environment add
|
23
|
+
$ cloudstack-cli environment add production
|
24
24
|
```
|
25
25
|
|
26
|
-
cloudstack-cli expects to find a
|
26
|
+
cloudstack-cli expects to find a configuration file with the API URL and your CloudStack credentials in your home directory named .cloudstack-cli.yml. If the file is located elsewhere you can specify the location using the --config option.
|
27
27
|
|
28
28
|
cloudstack-cli supports multiple environments using the --environment option.
|
29
29
|
|
30
|
+
The first environment added is always the default. You can change the default as soon as you have multiple environments:
|
31
|
+
|
32
|
+
```bash
|
33
|
+
$ cloudstack-cli environment default [environment-name]
|
34
|
+
```
|
35
|
+
|
36
|
+
*List all environments:*
|
37
|
+
|
30
38
|
see `cloudstack-cli help environment` for more options.
|
31
39
|
|
32
40
|
Example content of the configuration file:
|
@@ -55,17 +63,25 @@ __Note__: use `~/.bashrc` on Ubuntu
|
|
55
63
|
|
56
64
|
## Usage
|
57
65
|
|
58
|
-
|
66
|
+
*Display the cli help:*
|
59
67
|
|
60
|
-
|
68
|
+
```bash
|
69
|
+
$ cloudstack-cli help
|
70
|
+
```
|
71
|
+
|
72
|
+
*Help for a specific subcommand and command:*
|
73
|
+
|
74
|
+
```bash
|
75
|
+
$ cloudstack-cli vm help
|
76
|
+
```
|
61
77
|
|
62
78
|
```bash
|
63
|
-
$ cloudstack-cli
|
79
|
+
$ cloudstack-cli vm help list
|
64
80
|
```
|
65
81
|
|
66
|
-
### Example:
|
82
|
+
### Example: Bootstrapping a server
|
67
83
|
|
68
|
-
|
84
|
+
*Bootstraps a server using a template and creating port-forwarding rules for port 22 and 80:*
|
69
85
|
|
70
86
|
```bash
|
71
87
|
$ cloudstack-cli server create server-01 --template CentOS-6.4-x64-v1.4 --zone DC1 --offering 1cpu_1gb --port-rules :22 :80
|
@@ -73,7 +89,7 @@ $ cloudstack-cli server create server-01 --template CentOS-6.4-x64-v1.4 --zone D
|
|
73
89
|
|
74
90
|
### Example: Run any custom API command
|
75
91
|
|
76
|
-
Run the "listAlerts" command against the
|
92
|
+
*Run the "listAlerts" command against the CloudStack API with an argument of type=8:*
|
77
93
|
|
78
94
|
```bash
|
79
95
|
$ cloudstack-cli command listAlerts type=8
|
@@ -81,9 +97,9 @@ $ cloudstack-cli command listAlerts type=8
|
|
81
97
|
|
82
98
|
### Example: Creating a complete stack of servers
|
83
99
|
|
84
|
-
|
100
|
+
CloudStack CLI does support stack files in YAML or JSON.
|
85
101
|
|
86
|
-
An example stackfile could look like this (my_stackfile.yml)
|
102
|
+
*An example stackfile could look like this (my_stackfile.yml):*
|
87
103
|
|
88
104
|
```yaml
|
89
105
|
---
|
@@ -113,7 +129,7 @@ An example stackfile could look like this (my_stackfile.yml):
|
|
113
129
|
- "storage_network"
|
114
130
|
```
|
115
131
|
|
116
|
-
Create the stack of servers from above:
|
132
|
+
*Create the stack of servers from the definition above:
|
117
133
|
|
118
134
|
```bash
|
119
135
|
$ cloudstack-cli stack create my_stackfile.yml
|
@@ -121,7 +137,7 @@ $ cloudstack-cli stack create my_stackfile.yml
|
|
121
137
|
|
122
138
|
**Hint:** You can also parse a stackfile from a URI.
|
123
139
|
|
124
|
-
The following command destroys a stack using a definition gathered from a stackfile lying on a Github repository
|
140
|
+
*The following command destroys a stack using a definition gathered from a stackfile lying on a Github repository:*
|
125
141
|
|
126
142
|
```bash
|
127
143
|
$ cloudstack-cli stack destroy https://raw.githubusercontent.com/niwo/cloudstack-cli/master/test/stack_example.json
|
@@ -134,7 +150,7 @@ Completed: 2/3 (15.4s)
|
|
134
150
|
|
135
151
|
### Example: Sort computing offerings
|
136
152
|
|
137
|
-
Sort all computing offerings by CPU and Memory grouped
|
153
|
+
*Sort all computing offerings by CPU and Memory grouped by domain:*
|
138
154
|
|
139
155
|
```bash
|
140
156
|
$ cloudstack-cli offering sort
|
@@ -142,8 +158,8 @@ $ cloudstack-cli offering sort
|
|
142
158
|
|
143
159
|
### Example: Stop all backup routers of a given project
|
144
160
|
|
145
|
-
Stop all virtual routers of project named Demo (you could filter by zone too)
|
146
|
-
(This command is helpful if you have to deploy new versions of
|
161
|
+
*Stop all virtual routers of project named Demo (you could filter by zone too):*
|
162
|
+
(This command is helpful if you have to deploy new versions of CloudStack when using redundant routers)
|
147
163
|
|
148
164
|
```bash
|
149
165
|
$ cloudstack-cli router list --project Demo --status running --redundant-state BACKUP --command STOP
|
data/cloudstack-cli.gemspec
CHANGED
@@ -21,9 +21,8 @@ Gem::Specification.new do |gem|
|
|
21
21
|
gem.require_paths = %w(lib)
|
22
22
|
gem.rdoc_options = %w[--line-numbers --inline-source]
|
23
23
|
|
24
|
-
gem.add_development_dependency('rdoc', '~> 4.2')
|
25
24
|
gem.add_development_dependency('rake', '~> 10.4')
|
26
25
|
|
27
|
-
gem.add_dependency('thor', '~> 0.19
|
28
|
-
gem.add_dependency('cloudstack_client', '~> 1.
|
26
|
+
gem.add_dependency('thor', '~> 0.19')
|
27
|
+
gem.add_dependency('cloudstack_client', '~> 1.2')
|
29
28
|
end
|
metadata
CHANGED
@@ -1,29 +1,15 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: cloudstack-cli
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 1.
|
4
|
+
version: 1.2.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Nik Wolfgramm
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
11
|
+
date: 2016-01-06 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
|
-
- !ruby/object:Gem::Dependency
|
14
|
-
name: rdoc
|
15
|
-
requirement: !ruby/object:Gem::Requirement
|
16
|
-
requirements:
|
17
|
-
- - "~>"
|
18
|
-
- !ruby/object:Gem::Version
|
19
|
-
version: '4.2'
|
20
|
-
type: :development
|
21
|
-
prerelease: false
|
22
|
-
version_requirements: !ruby/object:Gem::Requirement
|
23
|
-
requirements:
|
24
|
-
- - "~>"
|
25
|
-
- !ruby/object:Gem::Version
|
26
|
-
version: '4.2'
|
27
13
|
- !ruby/object:Gem::Dependency
|
28
14
|
name: rake
|
29
15
|
requirement: !ruby/object:Gem::Requirement
|
@@ -44,28 +30,28 @@ dependencies:
|
|
44
30
|
requirements:
|
45
31
|
- - "~>"
|
46
32
|
- !ruby/object:Gem::Version
|
47
|
-
version: 0.19
|
33
|
+
version: '0.19'
|
48
34
|
type: :runtime
|
49
35
|
prerelease: false
|
50
36
|
version_requirements: !ruby/object:Gem::Requirement
|
51
37
|
requirements:
|
52
38
|
- - "~>"
|
53
39
|
- !ruby/object:Gem::Version
|
54
|
-
version: 0.19
|
40
|
+
version: '0.19'
|
55
41
|
- !ruby/object:Gem::Dependency
|
56
42
|
name: cloudstack_client
|
57
43
|
requirement: !ruby/object:Gem::Requirement
|
58
44
|
requirements:
|
59
45
|
- - "~>"
|
60
46
|
- !ruby/object:Gem::Version
|
61
|
-
version: 1.
|
47
|
+
version: '1.2'
|
62
48
|
type: :runtime
|
63
49
|
prerelease: false
|
64
50
|
version_requirements: !ruby/object:Gem::Requirement
|
65
51
|
requirements:
|
66
52
|
- - "~>"
|
67
53
|
- !ruby/object:Gem::Version
|
68
|
-
version: 1.
|
54
|
+
version: '1.2'
|
69
55
|
description: cloudstack-cli is a CloudStack API command line client written in Ruby.
|
70
56
|
email:
|
71
57
|
- nik.wolfgramm@gmail.com
|
@@ -76,7 +62,6 @@ extensions: []
|
|
76
62
|
extra_rdoc_files: []
|
77
63
|
files:
|
78
64
|
- ".gitignore"
|
79
|
-
- ".ruby-version"
|
80
65
|
- Gemfile
|
81
66
|
- Gemfile.lock
|
82
67
|
- LICENSE.txt
|
@@ -149,7 +134,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
149
134
|
version: '0'
|
150
135
|
requirements: []
|
151
136
|
rubyforge_project:
|
152
|
-
rubygems_version: 2.4.5
|
137
|
+
rubygems_version: 2.4.5.1
|
153
138
|
signing_key:
|
154
139
|
specification_version: 4
|
155
140
|
summary: cloudstack-cli CloudStack API client
|
data/.ruby-version
DELETED
@@ -1 +0,0 @@
|
|
1
|
-
2.2.2
|