pe-razor-client 0.15.2.2 → 1.0.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/NEWS.md +27 -0
- data/bin/razor +27 -2
- data/lib/razor/cli.rb +11 -2
- data/lib/razor/cli/command.rb +150 -0
- data/lib/razor/cli/document.rb +8 -4
- data/lib/razor/cli/format.rb +46 -22
- data/lib/razor/cli/navigate.rb +28 -156
- data/lib/razor/cli/parse.rb +49 -7
- data/lib/razor/cli/query.rb +69 -0
- data/lib/razor/cli/table_format.rb +41 -0
- data/lib/razor/cli/transforms.rb +25 -0
- data/lib/razor/cli/version.rb +1 -1
- data/lib/razor/cli/views.yaml +53 -2
- data/spec/cli/command_spec.rb +66 -0
- data/spec/cli/format_spec.rb +95 -5
- data/spec/cli/navigate_spec.rb +50 -6
- data/spec/cli/parse_spec.rb +42 -2
- data/spec/fixtures/vcr/Razor_CLI_Navigate/argument_formatting/should_allow_in_string.yml +233 -0
- data/spec/fixtures/vcr/Razor_CLI_Navigate/argument_formatting/should_allow_spaces.yml +281 -548
- data/spec/fixtures/vcr/Razor_CLI_Navigate/for_command_help/should_provide_command_help_for_razor_--help_command_.yml +160 -37
- data/spec/fixtures/vcr/Razor_CLI_Navigate/for_command_help/should_provide_command_help_for_razor_-h_command_.yml +160 -37
- data/spec/fixtures/vcr/Razor_CLI_Navigate/for_command_help/should_provide_command_help_for_razor_command_--help_.yml +160 -37
- data/spec/fixtures/vcr/Razor_CLI_Navigate/for_command_help/should_provide_command_help_for_razor_command_-h_.yml +160 -37
- data/spec/fixtures/vcr/Razor_CLI_Navigate/for_command_help/should_provide_command_help_for_razor_command_help_.yml +160 -37
- data/spec/fixtures/vcr/Razor_CLI_Navigate/for_command_help/should_provide_command_help_for_razor_help_command_.yml +160 -37
- data/spec/fixtures/vcr/Razor_CLI_Navigate/with_authentication/should_preserve_that_across_navigation.yml +10 -10
- data/spec/fixtures/vcr/Razor_CLI_Navigate/with_authentication/should_supply_that_to_the_API_service.yml +5 -5
- data/spec/fixtures/vcr/Razor_CLI_Navigate/with_invalid_parameter/should_fail_with_bad_JSON.yml +71 -166
- data/spec/fixtures/vcr/Razor_CLI_Navigate/with_invalid_parameter/should_fail_with_malformed_argument.yml +109 -59
- data/spec/fixtures/vcr/Razor_CLI_Navigate/with_multiple_arguments_with_same_name/combining_as_an_array/should_merge_an_array_into_an_existing_array.yml +527 -1360
- data/spec/fixtures/vcr/Razor_CLI_Navigate/with_multiple_arguments_with_same_name/combining_as_an_array/should_merge_the_arguments_as_an_array.yml +528 -1361
- data/spec/fixtures/vcr/Razor_CLI_Navigate/with_multiple_arguments_with_same_name/combining_as_an_array/should_merge_the_arguments_into_an_existing_array.yml +528 -1361
- data/spec/fixtures/vcr/Razor_CLI_Navigate/with_multiple_arguments_with_same_name/combining_as_an_object/should_construct_a_json_object.yml +80 -111
- data/spec/fixtures/vcr/Razor_CLI_Navigate/with_multiple_arguments_with_same_name/combining_as_an_object/should_construct_a_json_object_with_unicode.yml +137 -123
- data/spec/fixtures/vcr/Razor_CLI_Navigate/with_multiple_arguments_with_same_name/combining_as_an_object/should_fail_with_mixed_types_array_then_hash_.yml +71 -166
- data/spec/fixtures/vcr/Razor_CLI_Navigate/with_multiple_arguments_with_same_name/combining_as_an_object/should_fail_with_mixed_types_hash_then_array_.yml +71 -102
- data/spec/fixtures/vcr/Razor_CLI_Navigate/with_no_parameters/should_fail_with_bad_JSON.yml +98 -5
- data/spec/fixtures/vcr/Razor_CLI_Navigate/with_query_parameters/should_append_limit.yml +69 -0
- data/spec/fixtures/vcr/Razor_CLI_Navigate/with_query_parameters/should_append_start.yml +69 -0
- data/spec/fixtures/vcr/Razor_CLI_Navigate/with_query_parameters/should_not_fail_when_query_returns_details_for_one_item.yml +313 -0
- data/spec/fixtures/vcr/Razor_CLI_Navigate/with_query_parameters/should_store_query_without_query_parameters.yml +557 -0
- data/spec/fixtures/vcr/Razor_CLI_Navigate/with_query_parameters/should_throw_an_error_if_the_query_parameter_is_not_in_the_API.yml +36 -0
- data/spec/fixtures/vcr/Razor_CLI_Navigate/with_query_parameters/should_throw_an_error_if_the_query_parameter_is_not_in_the_API_from_a_single_item.yml +280 -0
- data/spec/fixtures/vcr/Razor_CLI_Parse/_new/_help/should_print_a_list_of_known_endpoints.yml +5 -5
- data/spec/spec_helper.rb +8 -4
- metadata +26 -7
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
http_interactions:
|
|
3
3
|
- request:
|
|
4
4
|
method: get
|
|
5
|
-
uri: http://localhost:
|
|
5
|
+
uri: http://localhost:8150/api
|
|
6
6
|
body:
|
|
7
7
|
encoding: US-ASCII
|
|
8
8
|
string: ''
|
|
@@ -25,17 +25,17 @@ http_interactions:
|
|
|
25
25
|
Content-Type:
|
|
26
26
|
- application/json;charset=utf-8
|
|
27
27
|
Content-Length:
|
|
28
|
-
- '
|
|
28
|
+
- '5650'
|
|
29
29
|
Date:
|
|
30
|
-
-
|
|
30
|
+
- Mon, 09 Mar 2015 19:53:39 GMT
|
|
31
31
|
body:
|
|
32
32
|
encoding: US-ASCII
|
|
33
|
-
string: '{"commands":[{"name":"add-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/add-policy-tag","id":"http://localhost:
|
|
33
|
+
string: '{"commands":[{"name":"add-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/add-policy-tag","id":"http://localhost:8150/api/commands/add-policy-tag"},{"name":"create-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/create-broker","id":"http://localhost:8150/api/commands/create-broker"},{"name":"create-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/create-hook","id":"http://localhost:8150/api/commands/create-hook"},{"name":"create-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/create-policy","id":"http://localhost:8150/api/commands/create-policy"},{"name":"create-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/create-repo","id":"http://localhost:8150/api/commands/create-repo"},{"name":"create-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/create-tag","id":"http://localhost:8150/api/commands/create-tag"},{"name":"create-task","rel":"http://api.puppetlabs.com/razor/v1/commands/create-task","id":"http://localhost:8150/api/commands/create-task"},{"name":"delete-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-broker","id":"http://localhost:8150/api/commands/delete-broker"},{"name":"delete-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-hook","id":"http://localhost:8150/api/commands/delete-hook"},{"name":"delete-node","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-node","id":"http://localhost:8150/api/commands/delete-node"},{"name":"delete-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-policy","id":"http://localhost:8150/api/commands/delete-policy"},{"name":"delete-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-repo","id":"http://localhost:8150/api/commands/delete-repo"},{"name":"delete-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-tag","id":"http://localhost:8150/api/commands/delete-tag"},{"name":"disable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/disable-policy","id":"http://localhost:8150/api/commands/disable-policy"},{"name":"enable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/enable-policy","id":"http://localhost:8150/api/commands/enable-policy"},{"name":"modify-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-node-metadata","id":"http://localhost:8150/api/commands/modify-node-metadata"},{"name":"modify-policy-max-count","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-policy-max-count","id":"http://localhost:8150/api/commands/modify-policy-max-count"},{"name":"move-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/move-policy","id":"http://localhost:8150/api/commands/move-policy"},{"name":"reboot-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reboot-node","id":"http://localhost:8150/api/commands/reboot-node"},{"name":"register-node","rel":"http://api.puppetlabs.com/razor/v1/commands/register-node","id":"http://localhost:8150/api/commands/register-node"},{"name":"reinstall-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reinstall-node","id":"http://localhost:8150/api/commands/reinstall-node"},{"name":"remove-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-node-metadata","id":"http://localhost:8150/api/commands/remove-node-metadata"},{"name":"remove-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-policy-tag","id":"http://localhost:8150/api/commands/remove-policy-tag"},{"name":"set-node-desired-power-state","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-desired-power-state","id":"http://localhost:8150/api/commands/set-node-desired-power-state"},{"name":"set-node-hw-info","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-hw-info","id":"http://localhost:8150/api/commands/set-node-hw-info"},{"name":"set-node-ipmi-credentials","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-ipmi-credentials","id":"http://localhost:8150/api/commands/set-node-ipmi-credentials"},{"name":"update-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-node-metadata","id":"http://localhost:8150/api/commands/update-node-metadata"},{"name":"update-tag-rule","rel":"http://api.puppetlabs.com/razor/v1/commands/update-tag-rule","id":"http://localhost:8150/api/commands/update-tag-rule"}],"collections":[{"name":"brokers","rel":"http://api.puppetlabs.com/razor/v1/collections/brokers","id":"http://localhost:8150/api/collections/brokers"},{"name":"repos","rel":"http://api.puppetlabs.com/razor/v1/collections/repos","id":"http://localhost:8150/api/collections/repos"},{"name":"tags","rel":"http://api.puppetlabs.com/razor/v1/collections/tags","id":"http://localhost:8150/api/collections/tags"},{"name":"policies","rel":"http://api.puppetlabs.com/razor/v1/collections/policies","id":"http://localhost:8150/api/collections/policies"},{"name":"nodes","rel":"http://api.puppetlabs.com/razor/v1/collections/nodes","id":"http://localhost:8150/api/collections/nodes","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"tasks","rel":"http://api.puppetlabs.com/razor/v1/collections/tasks","id":"http://localhost:8150/api/collections/tasks"},{"name":"commands","rel":"http://api.puppetlabs.com/razor/v1/collections/commands","id":"http://localhost:8150/api/collections/commands"},{"name":"events","rel":"http://api.puppetlabs.com/razor/v1/collections/events","id":"http://localhost:8150/api/collections/events","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"hooks","rel":"http://api.puppetlabs.com/razor/v1/collections/hooks","id":"http://localhost:8150/api/collections/hooks"}],"version":{"server":"v0.16.1-18-gd3acc7a-dirty"}}'
|
|
34
34
|
http_version:
|
|
35
|
-
recorded_at:
|
|
35
|
+
recorded_at: Mon, 09 Mar 2015 19:53:39 GMT
|
|
36
36
|
- request:
|
|
37
37
|
method: get
|
|
38
|
-
uri: http://localhost:
|
|
38
|
+
uri: http://localhost:8150/api/commands/create-broker
|
|
39
39
|
body:
|
|
40
40
|
encoding: US-ASCII
|
|
41
41
|
string: ''
|
|
@@ -54,119 +54,88 @@ http_interactions:
|
|
|
54
54
|
Server:
|
|
55
55
|
- Apache-Coyote/1.1
|
|
56
56
|
Etag:
|
|
57
|
-
- '"server-version-v0.
|
|
57
|
+
- '"server-version-v0.16.1-18-gd3acc7a-dirty"'
|
|
58
58
|
X-Content-Type-Options:
|
|
59
59
|
- nosniff
|
|
60
60
|
Content-Type:
|
|
61
61
|
- application/json;charset=utf-8
|
|
62
62
|
Content-Length:
|
|
63
|
-
- '
|
|
63
|
+
- '5184'
|
|
64
64
|
Date:
|
|
65
|
-
-
|
|
65
|
+
- Mon, 09 Mar 2015 19:53:39 GMT
|
|
66
66
|
body:
|
|
67
67
|
encoding: US-ASCII
|
|
68
|
-
string: '{"name":"create-broker","help":{"
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
68
|
+
string: '{"name":"create-broker","help":{"summary":"Create a new broker configuration
|
|
69
|
+
for hand-off of installed nodes","description":"Create a new broker configuration. Brokers
|
|
70
|
+
are responsible for handing a node\noff to a config management system, such
|
|
71
|
+
as Puppet or Chef. In cases where you\nhave no configuration management system,
|
|
72
|
+
you can use the `noop` broker.","schema":"# Access Control\n\nThis command''s
|
|
73
|
+
access control pattern: `commands:create-broker:%{name}`\n\nWords surrounded
|
|
74
|
+
by `%{...}` are substitutions from the input data: typically\nthe name of
|
|
75
|
+
the object being modified, or some other critical detail, these\nallow roles
|
|
76
|
+
to be granted partial access to modify the system.\n\nFor more detail on how
|
|
77
|
+
the permission strings are structured and work, you can\nsee the [Shiro Permissions
|
|
78
|
+
documentation][shiro]. That pattern is expanded\nand then a permission check
|
|
79
|
+
applied to it, before the command is authorized.\n\nThese checks only apply
|
|
80
|
+
if security is enabled in the Razor configuration\nfile; on this server security
|
|
81
|
+
is currently disabled.\n\n[shiro]: http://shiro.apache.org/permissions.html\n\n#
|
|
82
82
|
Attributes\n\n * name\n - The name of the broker, as it will be referenced
|
|
83
|
-
within Razor.\n
|
|
84
|
-
to specify\n
|
|
85
|
-
This attribute is required
|
|
86
|
-
be between 1 and 250 in length.\n\n *
|
|
87
|
-
this broker is created
|
|
88
|
-
are:\n
|
|
89
|
-
attribute is required
|
|
83
|
+
within Razor.\n This is the name that you supply to, eg, `create-policy`
|
|
84
|
+
to specify\n which broker the node will be handed off via after installation.\n -
|
|
85
|
+
This attribute is required.\n - It must be of type string.\n - It must
|
|
86
|
+
be between 1 and 250 in length.\n\n * broker_type\n - The broker type from
|
|
87
|
+
which this broker is created. The available\n broker types on your server
|
|
88
|
+
are:\n - chef\n - noop\n - puppet-pe\n - puppet\n - This
|
|
89
|
+
attribute is required.\n - It must be of type string.\n - It must match
|
|
90
90
|
the name of an existing broker type.\n\n * configuration\n - The configuration
|
|
91
|
-
for the broker. The acceptable values here are\n
|
|
92
|
-
selected. In general this has\n
|
|
93
|
-
and other configuration\n
|
|
94
|
-
to the final\n
|
|
95
|
-
|
|
96
|
-
\
|
|
97
|
-
\"
|
|
91
|
+
for the broker. The acceptable values here are\n determined by the `broker_type`
|
|
92
|
+
selected. In general this has\n settings like which server to contact,
|
|
93
|
+
and other configuration\n related to handing on the newly installed system
|
|
94
|
+
to the final\n configuration management system.\n \n This attribute
|
|
95
|
+
can be abbreviated as `c` for convenience.\n - It must be of type object.\n","examples":{"api":"Creating
|
|
96
|
+
a simple Puppet broker:\n\n{\n \"name\": \"puppet\",\n \"configuration\":
|
|
97
|
+
{\n \"server\": \"puppet.example.org\",\n \"environment\": \"production\"\n },\n \"broker_type\":
|
|
98
|
+
\"puppet\"\n}","cli":"Creating a simple Puppet broker:\n\nrazor create-broker
|
|
99
|
+
--name puppet -c server=puppet.example.org \\\n -c environment=production
|
|
100
|
+
--broker-type puppet"},"full":"# SYNOPSIS\nCreate a new broker configuration
|
|
101
|
+
for hand-off of installed nodes\n\n# DESCRIPTION\nCreate a new broker configuration. Brokers
|
|
102
|
+
are responsible for handing a node\noff to a config management system, such
|
|
103
|
+
as Puppet or Chef. In cases where you\nhave no configuration management system,
|
|
104
|
+
you can use the `noop` broker.\n# Access Control\n\nThis command''s access
|
|
105
|
+
control pattern: `commands:create-broker:%{name}`\n\nWords surrounded by `%{...}`
|
|
106
|
+
are substitutions from the input data: typically\nthe name of the object being
|
|
107
|
+
modified, or some other critical detail, these\nallow roles to be granted
|
|
108
|
+
partial access to modify the system.\n\nFor more detail on how the permission
|
|
109
|
+
strings are structured and work, you can\nsee the [Shiro Permissions documentation][shiro]. That
|
|
110
|
+
pattern is expanded\nand then a permission check applied to it, before the
|
|
111
|
+
command is authorized.\n\nThese checks only apply if security is enabled in
|
|
112
|
+
the Razor configuration\nfile; on this server security is currently disabled.\n\n[shiro]:
|
|
113
|
+
http://shiro.apache.org/permissions.html\n\n# Attributes\n\n * name\n -
|
|
114
|
+
The name of the broker, as it will be referenced within Razor.\n This
|
|
115
|
+
is the name that you supply to, eg, `create-policy` to specify\n which
|
|
116
|
+
broker the node will be handed off via after installation.\n - This attribute
|
|
117
|
+
is required.\n - It must be of type string.\n - It must be between 1 and
|
|
118
|
+
250 in length.\n\n * broker_type\n - The broker type from which this broker
|
|
119
|
+
is created. The available\n broker types on your server are:\n -
|
|
120
|
+
chef\n - noop\n - puppet-pe\n - puppet\n - This attribute is
|
|
121
|
+
required.\n - It must be of type string.\n - It must match the name of
|
|
122
|
+
an existing broker type.\n\n * configuration\n - The configuration for the
|
|
123
|
+
broker. The acceptable values here are\n determined by the `broker_type`
|
|
124
|
+
selected. In general this has\n settings like which server to contact,
|
|
125
|
+
and other configuration\n related to handing on the newly installed system
|
|
126
|
+
to the final\n configuration management system.\n \n This attribute
|
|
127
|
+
can be abbreviated as `c` for convenience.\n - It must be of type object.\n\n#
|
|
128
|
+
EXAMPLES\n\n Creating a simple Puppet broker:\n \n {\n \"name\": \"puppet\",\n \"configuration\":
|
|
129
|
+
{\n \"server\": \"puppet.example.org\",\n \"environment\":
|
|
130
|
+
\"production\"\n },\n \"broker_type\": \"puppet\"\n }\n"},"schema":{"name":{"type":"string"},"broker_type":{"type":"string","aliases":["broker-type"]},"configuration":{"type":"object","aliases":["c"]}}}'
|
|
98
131
|
http_version:
|
|
99
|
-
recorded_at:
|
|
100
|
-
- request:
|
|
101
|
-
method: get
|
|
102
|
-
uri: http://localhost:8080/api/commands/create-broker
|
|
103
|
-
body:
|
|
104
|
-
encoding: US-ASCII
|
|
105
|
-
string: ''
|
|
106
|
-
headers:
|
|
107
|
-
Accept:
|
|
108
|
-
- application/json
|
|
109
|
-
Accept-Encoding:
|
|
110
|
-
- gzip, deflate
|
|
111
|
-
User-Agent:
|
|
112
|
-
- Ruby
|
|
113
|
-
response:
|
|
114
|
-
status:
|
|
115
|
-
code: 200
|
|
116
|
-
message: OK
|
|
117
|
-
headers:
|
|
118
|
-
Server:
|
|
119
|
-
- Apache-Coyote/1.1
|
|
120
|
-
Etag:
|
|
121
|
-
- '"server-version-v0.14.1-113-g8b33d83-dirty"'
|
|
122
|
-
X-Content-Type-Options:
|
|
123
|
-
- nosniff
|
|
124
|
-
Content-Type:
|
|
125
|
-
- application/json;charset=utf-8
|
|
126
|
-
Content-Length:
|
|
127
|
-
- '2496'
|
|
128
|
-
Date:
|
|
129
|
-
- Fri, 16 May 2014 22:18:28 GMT
|
|
130
|
-
body:
|
|
131
|
-
encoding: US-ASCII
|
|
132
|
-
string: '{"name":"create-broker","help":{"full":"# SYNOPSIS\nCreate a new broker
|
|
133
|
-
configuration for hand-off of installed nodes\n\n# DESCRIPTION\nCreate a new
|
|
134
|
-
broker configuration. Brokers are responsible for handing a node\noff to
|
|
135
|
-
a config management system, such as Puppet or Chef. In cases where you\nhave
|
|
136
|
-
no configuration management system, you can use the `noop` broker.\n\n\n#
|
|
137
|
-
Access Control\n\nThis command''s access control pattern: `commands:create-broker:%{name}`\n\nWords
|
|
138
|
-
surrounded by `%{...}` are substitutions from the input data: typically\nthe
|
|
139
|
-
name of the object being modified, or some other critical detail, these\nallow
|
|
140
|
-
roles to be granted partial access to modify the system.\n\nFor more detail
|
|
141
|
-
on how the permission strings are structured and work, you can\nsee the [Shiro
|
|
142
|
-
Permissions documentation][shiro]. That pattern is expanded\nand then a permission
|
|
143
|
-
check applied to it, before the command is authorized.\n\nThese checks only
|
|
144
|
-
apply if security is enabled in the Razor configuration\nfile; on this server
|
|
145
|
-
security is currently disabled.\n\n[shiro]: http://shiro.apache.org/permissions.html\n\n#
|
|
146
|
-
Attributes\n\n * name\n - The name of the broker, as it will be referenced
|
|
147
|
-
within Razor.\n This is the name that you supply to, eg, `create-policy`
|
|
148
|
-
to specify\n which broker the node will be handed off via after installation.\n -
|
|
149
|
-
This attribute is required\n - It must be of type string.\n - It must
|
|
150
|
-
be between 1 and 250 in length.\n\n * broker-type\n - The broker type that
|
|
151
|
-
this broker is created from. The available\n broker types on your server
|
|
152
|
-
are:\n - chef\n - noop\n - puppet-pe\n - puppet\n - This
|
|
153
|
-
attribute is required\n - It must be of type string.\n - It must match
|
|
154
|
-
the name of an existing broker type.\n\n * configuration\n - The configuration
|
|
155
|
-
for the broker. The acceptable values here are\n determined by the `broker-type`
|
|
156
|
-
selected. In general this has\n settings like which server to contact,
|
|
157
|
-
and other configuration\n related to handing on the newly installed system
|
|
158
|
-
to the final\n configuration management system.\n - It must be of type
|
|
159
|
-
object.\n \n \n\n\n\n# EXAMPLES\n Creating a simple Puppet broker:\n \n {\n \"name\":
|
|
160
|
-
\"puppet\",\n \"configuration\": {\n \"server\": \"puppet.example.org\",\n \"environment\":
|
|
161
|
-
\"production\"\n },\n \"broker-type\": \"puppet\"\n }\n\n"},"schema":{"name":{"type":"string"},"broker-type":{"type":"string"},"configuration":{"type":"object"}}}'
|
|
162
|
-
http_version:
|
|
163
|
-
recorded_at: Fri, 16 May 2014 22:18:28 GMT
|
|
132
|
+
recorded_at: Mon, 09 Mar 2015 19:53:39 GMT
|
|
164
133
|
- request:
|
|
165
134
|
method: post
|
|
166
|
-
uri: http://localhost:
|
|
135
|
+
uri: http://localhost:8150/api/commands/create-broker
|
|
167
136
|
body:
|
|
168
137
|
encoding: UTF-8
|
|
169
|
-
string: '{"name":"broker1","
|
|
138
|
+
string: '{"name":"broker1","broker_type":"puppet","configuration":{"server":"puppet.example.org","environment":"production"}}'
|
|
170
139
|
headers:
|
|
171
140
|
Accept:
|
|
172
141
|
- application/json
|
|
@@ -192,15 +161,15 @@ http_interactions:
|
|
|
192
161
|
Content-Length:
|
|
193
162
|
- '211'
|
|
194
163
|
Date:
|
|
195
|
-
-
|
|
164
|
+
- Mon, 09 Mar 2015 19:53:39 GMT
|
|
196
165
|
body:
|
|
197
166
|
encoding: US-ASCII
|
|
198
|
-
string: '{"spec":"http://api.puppetlabs.com/razor/v1/collections/brokers/member","id":"http://localhost:
|
|
167
|
+
string: '{"spec":"http://api.puppetlabs.com/razor/v1/collections/brokers/member","id":"http://localhost:8150/api/collections/brokers/broker1","name":"broker1","command":"http://localhost:8150/api/collections/commands/1"}'
|
|
199
168
|
http_version:
|
|
200
|
-
recorded_at:
|
|
169
|
+
recorded_at: Mon, 09 Mar 2015 19:53:39 GMT
|
|
201
170
|
- request:
|
|
202
171
|
method: get
|
|
203
|
-
uri: http://localhost:
|
|
172
|
+
uri: http://localhost:8150/api/collections/brokers/broker1
|
|
204
173
|
body:
|
|
205
174
|
encoding: US-ASCII
|
|
206
175
|
string: ''
|
|
@@ -225,10 +194,10 @@ http_interactions:
|
|
|
225
194
|
Content-Length:
|
|
226
195
|
- '359'
|
|
227
196
|
Date:
|
|
228
|
-
-
|
|
197
|
+
- Mon, 09 Mar 2015 19:53:39 GMT
|
|
229
198
|
body:
|
|
230
199
|
encoding: US-ASCII
|
|
231
|
-
string: '{"spec":"http://api.puppetlabs.com/razor/v1/collections/brokers/member","id":"http://localhost:
|
|
200
|
+
string: '{"spec":"http://api.puppetlabs.com/razor/v1/collections/brokers/member","id":"http://localhost:8150/api/collections/brokers/broker1","name":"broker1","configuration":{"server":"puppet.example.org","environment":"production"},"broker_type":"puppet","policies":{"id":"http://localhost:8150/api/collections/brokers/broker1/policies","count":0,"name":"policies"}}'
|
|
232
201
|
http_version:
|
|
233
|
-
recorded_at:
|
|
202
|
+
recorded_at: Mon, 09 Mar 2015 19:53:39 GMT
|
|
234
203
|
recorded_with: VCR 2.5.0
|
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
http_interactions:
|
|
3
3
|
- request:
|
|
4
4
|
method: get
|
|
5
|
-
uri: http://localhost:
|
|
5
|
+
uri: http://localhost:8150/api
|
|
6
6
|
body:
|
|
7
|
-
encoding:
|
|
7
|
+
encoding: US-ASCII
|
|
8
8
|
string: ''
|
|
9
9
|
headers:
|
|
10
10
|
Accept:
|
|
@@ -25,19 +25,19 @@ http_interactions:
|
|
|
25
25
|
Content-Type:
|
|
26
26
|
- application/json;charset=utf-8
|
|
27
27
|
Content-Length:
|
|
28
|
-
- '
|
|
28
|
+
- '5650'
|
|
29
29
|
Date:
|
|
30
|
-
-
|
|
30
|
+
- Mon, 09 Mar 2015 19:53:44 GMT
|
|
31
31
|
body:
|
|
32
|
-
encoding:
|
|
33
|
-
string: '{"commands":[{"name":"add-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/add-policy-tag","id":"http://localhost:
|
|
32
|
+
encoding: US-ASCII
|
|
33
|
+
string: '{"commands":[{"name":"add-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/add-policy-tag","id":"http://localhost:8150/api/commands/add-policy-tag"},{"name":"create-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/create-broker","id":"http://localhost:8150/api/commands/create-broker"},{"name":"create-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/create-hook","id":"http://localhost:8150/api/commands/create-hook"},{"name":"create-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/create-policy","id":"http://localhost:8150/api/commands/create-policy"},{"name":"create-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/create-repo","id":"http://localhost:8150/api/commands/create-repo"},{"name":"create-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/create-tag","id":"http://localhost:8150/api/commands/create-tag"},{"name":"create-task","rel":"http://api.puppetlabs.com/razor/v1/commands/create-task","id":"http://localhost:8150/api/commands/create-task"},{"name":"delete-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-broker","id":"http://localhost:8150/api/commands/delete-broker"},{"name":"delete-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-hook","id":"http://localhost:8150/api/commands/delete-hook"},{"name":"delete-node","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-node","id":"http://localhost:8150/api/commands/delete-node"},{"name":"delete-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-policy","id":"http://localhost:8150/api/commands/delete-policy"},{"name":"delete-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-repo","id":"http://localhost:8150/api/commands/delete-repo"},{"name":"delete-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-tag","id":"http://localhost:8150/api/commands/delete-tag"},{"name":"disable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/disable-policy","id":"http://localhost:8150/api/commands/disable-policy"},{"name":"enable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/enable-policy","id":"http://localhost:8150/api/commands/enable-policy"},{"name":"modify-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-node-metadata","id":"http://localhost:8150/api/commands/modify-node-metadata"},{"name":"modify-policy-max-count","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-policy-max-count","id":"http://localhost:8150/api/commands/modify-policy-max-count"},{"name":"move-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/move-policy","id":"http://localhost:8150/api/commands/move-policy"},{"name":"reboot-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reboot-node","id":"http://localhost:8150/api/commands/reboot-node"},{"name":"register-node","rel":"http://api.puppetlabs.com/razor/v1/commands/register-node","id":"http://localhost:8150/api/commands/register-node"},{"name":"reinstall-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reinstall-node","id":"http://localhost:8150/api/commands/reinstall-node"},{"name":"remove-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-node-metadata","id":"http://localhost:8150/api/commands/remove-node-metadata"},{"name":"remove-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-policy-tag","id":"http://localhost:8150/api/commands/remove-policy-tag"},{"name":"set-node-desired-power-state","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-desired-power-state","id":"http://localhost:8150/api/commands/set-node-desired-power-state"},{"name":"set-node-hw-info","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-hw-info","id":"http://localhost:8150/api/commands/set-node-hw-info"},{"name":"set-node-ipmi-credentials","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-ipmi-credentials","id":"http://localhost:8150/api/commands/set-node-ipmi-credentials"},{"name":"update-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-node-metadata","id":"http://localhost:8150/api/commands/update-node-metadata"},{"name":"update-tag-rule","rel":"http://api.puppetlabs.com/razor/v1/commands/update-tag-rule","id":"http://localhost:8150/api/commands/update-tag-rule"}],"collections":[{"name":"brokers","rel":"http://api.puppetlabs.com/razor/v1/collections/brokers","id":"http://localhost:8150/api/collections/brokers"},{"name":"repos","rel":"http://api.puppetlabs.com/razor/v1/collections/repos","id":"http://localhost:8150/api/collections/repos"},{"name":"tags","rel":"http://api.puppetlabs.com/razor/v1/collections/tags","id":"http://localhost:8150/api/collections/tags"},{"name":"policies","rel":"http://api.puppetlabs.com/razor/v1/collections/policies","id":"http://localhost:8150/api/collections/policies"},{"name":"nodes","rel":"http://api.puppetlabs.com/razor/v1/collections/nodes","id":"http://localhost:8150/api/collections/nodes","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"tasks","rel":"http://api.puppetlabs.com/razor/v1/collections/tasks","id":"http://localhost:8150/api/collections/tasks"},{"name":"commands","rel":"http://api.puppetlabs.com/razor/v1/collections/commands","id":"http://localhost:8150/api/collections/commands"},{"name":"events","rel":"http://api.puppetlabs.com/razor/v1/collections/events","id":"http://localhost:8150/api/collections/events","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"hooks","rel":"http://api.puppetlabs.com/razor/v1/collections/hooks","id":"http://localhost:8150/api/collections/hooks"}],"version":{"server":"v0.16.1-18-gd3acc7a-dirty"}}'
|
|
34
34
|
http_version:
|
|
35
|
-
recorded_at:
|
|
35
|
+
recorded_at: Mon, 09 Mar 2015 19:53:44 GMT
|
|
36
36
|
- request:
|
|
37
37
|
method: get
|
|
38
|
-
uri: http://localhost:
|
|
38
|
+
uri: http://localhost:8150/api/commands/register-node
|
|
39
39
|
body:
|
|
40
|
-
encoding:
|
|
40
|
+
encoding: US-ASCII
|
|
41
41
|
string: ''
|
|
42
42
|
headers:
|
|
43
43
|
Accept:
|
|
@@ -54,29 +54,29 @@ http_interactions:
|
|
|
54
54
|
Server:
|
|
55
55
|
- Apache-Coyote/1.1
|
|
56
56
|
Etag:
|
|
57
|
-
- '"server-version-v0.
|
|
57
|
+
- '"server-version-v0.16.1-18-gd3acc7a-dirty"'
|
|
58
58
|
X-Content-Type-Options:
|
|
59
59
|
- nosniff
|
|
60
60
|
Content-Type:
|
|
61
61
|
- application/json;charset=utf-8
|
|
62
62
|
Content-Length:
|
|
63
|
-
- '
|
|
63
|
+
- '6207'
|
|
64
64
|
Date:
|
|
65
|
-
-
|
|
65
|
+
- Mon, 09 Mar 2015 19:53:44 GMT
|
|
66
66
|
body:
|
|
67
|
-
encoding:
|
|
68
|
-
string: '{"name":"register-node","help":{"
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
67
|
+
encoding: US-ASCII
|
|
68
|
+
string: '{"name":"register-node","help":{"summary":"Register a node with Razor
|
|
69
|
+
before it is discovered","description":"In order to make brownfield deployments
|
|
70
|
+
of Razor easier we allow users to\nregister nodes explicitly. This command
|
|
71
|
+
allows you to perform the same\nregistration that would happen when a new
|
|
72
|
+
node checked in, ahead of time.\n\nIn order for this to be effective the hw_info
|
|
73
|
+
must contain enough information\nthat the node can successfully be matched
|
|
74
|
+
during the iPXE boot phase.\n\nIf the node matches an existing node, in keeping
|
|
75
|
+
with the overall policy of\ncommands declaring desired state, the node installed
|
|
76
|
+
field will be updated to\nmatch the value in this command.\n\nThe final state
|
|
77
|
+
is that a node with the supplied hardware information, and the\ndesired installed
|
|
78
|
+
state, will be present in the database, regardless of it\nexisting before
|
|
79
|
+
hand or not.","schema":"# Access Control\n\nThis command''s access control
|
|
80
80
|
pattern: `commands:register-node`\n\nFor more detail on how the permission
|
|
81
81
|
strings are structured and work, you can\nsee the [Shiro Permissions documentation][shiro]. That
|
|
82
82
|
pattern is expanded\nand then a permission check applied to it, before the
|
|
@@ -85,57 +85,27 @@ http_interactions:
|
|
|
85
85
|
http://shiro.apache.org/permissions.html\n\n# Attributes\n\n * installed\n -
|
|
86
86
|
Should the node be considered ''installed'' already? Installed nodes are\n not
|
|
87
87
|
eligible for policy matching, and will simply boot locally.\n - This attribute
|
|
88
|
-
is required.\n - It must be of type boolean.\n\n *
|
|
88
|
+
is required.\n - It must be of type boolean.\n\n * hw_info\n - The hardware
|
|
89
89
|
information for the node. This is used to match the node on first\n boot
|
|
90
90
|
with the record in the database. The order of MAC address assignment in\n this
|
|
91
91
|
data is not significant, as a node with reordered MAC addresses will be\n treated
|
|
92
92
|
as the same node.\n - This attribute is required.\n - It must be of type
|
|
93
|
-
object.\n - It must be between 1 and Infinity in length.\n
|
|
93
|
+
object.\n - It must be between 1 and Infinity in length.\n # Attributes\n \n *
|
|
94
94
|
serial\n - The DMI serial number of the node\n - It must be of type
|
|
95
95
|
string.\n \n * asset\n - The DMI asset tag of the node\n -
|
|
96
96
|
It must be of type string.\n \n * uuid\n - The DMI UUID of the node\n -
|
|
97
|
-
It must be of type string.\n
|
|
98
|
-
boot it, and note that it already has an OS\
|
|
99
|
-
subject to policy-based reinstallation:\n
|
|
100
|
-
|
|
101
|
-
\"
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
encoding: UTF-8
|
|
110
|
-
string: ''
|
|
111
|
-
headers:
|
|
112
|
-
Accept:
|
|
113
|
-
- application/json
|
|
114
|
-
Accept-Encoding:
|
|
115
|
-
- gzip, deflate
|
|
116
|
-
User-Agent:
|
|
117
|
-
- Ruby
|
|
118
|
-
response:
|
|
119
|
-
status:
|
|
120
|
-
code: 200
|
|
121
|
-
message: OK
|
|
122
|
-
headers:
|
|
123
|
-
Server:
|
|
124
|
-
- Apache-Coyote/1.1
|
|
125
|
-
Etag:
|
|
126
|
-
- '"server-version-v0.15.0-3-gb0cbb3f-dirty"'
|
|
127
|
-
X-Content-Type-Options:
|
|
128
|
-
- nosniff
|
|
129
|
-
Content-Type:
|
|
130
|
-
- application/json;charset=utf-8
|
|
131
|
-
Content-Length:
|
|
132
|
-
- '2936'
|
|
133
|
-
Date:
|
|
134
|
-
- Tue, 03 Jun 2014 23:18:44 GMT
|
|
135
|
-
body:
|
|
136
|
-
encoding: UTF-8
|
|
137
|
-
string: '{"name":"register-node","help":{"full":"# SYNOPSIS\nRegister a node
|
|
138
|
-
with Razor before it is discovered\n\n# DESCRIPTION\nIn order to make brownfield
|
|
97
|
+
It must be of type string.\n","examples":{"api":"Register a machine before
|
|
98
|
+
you boot it, and note that it already has an OS\ninstalled, so should not
|
|
99
|
+
be subject to policy-based reinstallation:\n\n {\n \"hw_info\": {\n \"net0\": \"78:31:c1:be:c8:00\",\n \"net1\": \"72:00:01:f2:13:f0\",\n \"net2\": \"72:00:01:f2:13:f1\",\n \"serial\":
|
|
100
|
+
\"xxxxxxxxxxx\",\n \"asset\": \"Asset-1234567890\",\n \"uuid\": \"Not
|
|
101
|
+
Settable\"\n },\n \"installed\": true\n }","cli":"Register a
|
|
102
|
+
machine before you boot it, and note that it already has an OS\ninstalled,
|
|
103
|
+
so should not be subject to policy-based reinstallation:\n\n razor register-node
|
|
104
|
+
--hw-info net0=78:31:c1:be:c8:00 \\\n --hw-info net1=72:00:01:f2:13:f0
|
|
105
|
+
\\\n --hw-info net2=72:00:01:f2:13:f1 \\\n --hw-info serial=xxxxxxxxxxx
|
|
106
|
+
\\\n --hw-info asset=Asset-1234567890 \\\n --hw-info uuid=\"Not
|
|
107
|
+
Settable\" \\\n --installed"},"full":"# SYNOPSIS\nRegister a node with
|
|
108
|
+
Razor before it is discovered\n\n# DESCRIPTION\nIn order to make brownfield
|
|
139
109
|
deployments of Razor easier we allow users to\nregister nodes explicitly. This
|
|
140
110
|
command allows you to perform the same\nregistration that would happen when
|
|
141
111
|
a new node checked in, ahead of time.\n\nIn order for this to be effective
|
|
@@ -145,21 +115,21 @@ http_interactions:
|
|
|
145
115
|
the node installed field will be updated to\nmatch the value in this command.\n\nThe
|
|
146
116
|
final state is that a node with the supplied hardware information, and the\ndesired
|
|
147
117
|
installed state, will be present in the database, regardless of it\nexisting
|
|
148
|
-
before hand or not.\n
|
|
149
|
-
|
|
150
|
-
|
|
118
|
+
before hand or not.\n# Access Control\n\nThis command''s access control pattern:
|
|
119
|
+
`commands:register-node`\n\nFor more detail on how the permission strings
|
|
120
|
+
are structured and work, you can\nsee the [Shiro Permissions documentation][shiro]. That
|
|
151
121
|
pattern is expanded\nand then a permission check applied to it, before the
|
|
152
122
|
command is authorized.\n\nThese checks only apply if security is enabled in
|
|
153
123
|
the Razor configuration\nfile; on this server security is currently disabled.\n\n[shiro]:
|
|
154
124
|
http://shiro.apache.org/permissions.html\n\n# Attributes\n\n * installed\n -
|
|
155
125
|
Should the node be considered ''installed'' already? Installed nodes are\n not
|
|
156
126
|
eligible for policy matching, and will simply boot locally.\n - This attribute
|
|
157
|
-
is required.\n - It must be of type boolean.\n\n *
|
|
127
|
+
is required.\n - It must be of type boolean.\n\n * hw_info\n - The hardware
|
|
158
128
|
information for the node. This is used to match the node on first\n boot
|
|
159
129
|
with the record in the database. The order of MAC address assignment in\n this
|
|
160
130
|
data is not significant, as a node with reordered MAC addresses will be\n treated
|
|
161
131
|
as the same node.\n - This attribute is required.\n - It must be of type
|
|
162
|
-
object.\n - It must be between 1 and Infinity in length.\n
|
|
132
|
+
object.\n - It must be between 1 and Infinity in length.\n # Attributes\n \n *
|
|
163
133
|
serial\n - The DMI serial number of the node\n - It must be of type
|
|
164
134
|
string.\n \n * asset\n - The DMI asset tag of the node\n -
|
|
165
135
|
It must be of type string.\n \n * uuid\n - The DMI UUID of the node\n -
|
|
@@ -168,15 +138,15 @@ http_interactions:
|
|
|
168
138
|
subject to policy-based reinstallation:\n \n {\n \"hw_info\":
|
|
169
139
|
{\n \"net0\": \"78:31:c1:be:c8:00\",\n \"net1\": \"72:00:01:f2:13:f0\",\n \"net2\": \"72:00:01:f2:13:f1\",\n \"serial\":
|
|
170
140
|
\"xxxxxxxxxxx\",\n \"asset\": \"Asset-1234567890\",\n \"uuid\": \"Not
|
|
171
|
-
Settable\"\n },\n \"installed\": true\n }\n"},"schema":{"installed":{"type":"boolean"},"
|
|
141
|
+
Settable\"\n },\n \"installed\": true\n }\n"},"schema":{"installed":{"type":"boolean"},"hw_info":{"type":"object","aliases":["hw-info"]}}}'
|
|
172
142
|
http_version:
|
|
173
|
-
recorded_at:
|
|
143
|
+
recorded_at: Mon, 09 Mar 2015 19:53:44 GMT
|
|
174
144
|
- request:
|
|
175
145
|
method: post
|
|
176
|
-
uri: http://localhost:
|
|
146
|
+
uri: http://localhost:8150/api/commands/register-node
|
|
177
147
|
body:
|
|
178
148
|
encoding: UTF-8
|
|
179
|
-
string: '{"installed":true,"
|
|
149
|
+
string: '{"installed":true,"hw_info":{"net0":"abcdef"}}'
|
|
180
150
|
headers:
|
|
181
151
|
Accept:
|
|
182
152
|
- application/json
|
|
@@ -202,17 +172,17 @@ http_interactions:
|
|
|
202
172
|
Content-Length:
|
|
203
173
|
- '203'
|
|
204
174
|
Date:
|
|
205
|
-
-
|
|
175
|
+
- Mon, 09 Mar 2015 19:53:44 GMT
|
|
206
176
|
body:
|
|
207
|
-
encoding:
|
|
208
|
-
string: '{"spec":"http://api.puppetlabs.com/razor/v1/collections/nodes/member","id":"http://localhost:
|
|
177
|
+
encoding: US-ASCII
|
|
178
|
+
string: '{"spec":"http://api.puppetlabs.com/razor/v1/collections/nodes/member","id":"http://localhost:8150/api/collections/nodes/node1","name":"node1","command":"http://localhost:8150/api/collections/commands/1"}'
|
|
209
179
|
http_version:
|
|
210
|
-
recorded_at:
|
|
180
|
+
recorded_at: Mon, 09 Mar 2015 19:53:44 GMT
|
|
211
181
|
- request:
|
|
212
182
|
method: get
|
|
213
|
-
uri: http://localhost:
|
|
183
|
+
uri: http://localhost:8150/api/collections/nodes/node1
|
|
214
184
|
body:
|
|
215
|
-
encoding:
|
|
185
|
+
encoding: US-ASCII
|
|
216
186
|
string: ''
|
|
217
187
|
headers:
|
|
218
188
|
Accept:
|
|
@@ -233,19 +203,19 @@ http_interactions:
|
|
|
233
203
|
Content-Type:
|
|
234
204
|
- application/json;charset=utf-8
|
|
235
205
|
Content-Length:
|
|
236
|
-
- '
|
|
206
|
+
- '398'
|
|
237
207
|
Date:
|
|
238
|
-
-
|
|
208
|
+
- Mon, 09 Mar 2015 19:53:44 GMT
|
|
239
209
|
body:
|
|
240
|
-
encoding:
|
|
241
|
-
string: '{"spec":"http://api.puppetlabs.com/razor/v1/collections/nodes/member","id":"http://localhost:
|
|
210
|
+
encoding: US-ASCII
|
|
211
|
+
string: '{"spec":"http://api.puppetlabs.com/razor/v1/collections/nodes/member","id":"http://localhost:8150/api/collections/nodes/node1","name":"node1","hw_info":{"mac":["abcdef"]},"log":{"id":"http://localhost:8150/api/collections/nodes/node1/log","name":"log","params":{"limit":{"type":"number"},"start":{"type":"number"}}},"tags":[],"state":{"installed":"true","installed_at":"2015-03-09T14:53:44-05:00"}}'
|
|
242
212
|
http_version:
|
|
243
|
-
recorded_at:
|
|
213
|
+
recorded_at: Mon, 09 Mar 2015 19:53:44 GMT
|
|
244
214
|
- request:
|
|
245
215
|
method: get
|
|
246
|
-
uri: http://localhost:
|
|
216
|
+
uri: http://localhost:8150/api
|
|
247
217
|
body:
|
|
248
|
-
encoding:
|
|
218
|
+
encoding: US-ASCII
|
|
249
219
|
string: ''
|
|
250
220
|
headers:
|
|
251
221
|
Accept:
|
|
@@ -266,19 +236,19 @@ http_interactions:
|
|
|
266
236
|
Content-Type:
|
|
267
237
|
- application/json;charset=utf-8
|
|
268
238
|
Content-Length:
|
|
269
|
-
- '
|
|
239
|
+
- '5650'
|
|
270
240
|
Date:
|
|
271
|
-
-
|
|
241
|
+
- Mon, 09 Mar 2015 19:53:44 GMT
|
|
272
242
|
body:
|
|
273
|
-
encoding:
|
|
274
|
-
string: '{"commands":[{"name":"add-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/add-policy-tag","id":"http://localhost:
|
|
243
|
+
encoding: US-ASCII
|
|
244
|
+
string: '{"commands":[{"name":"add-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/add-policy-tag","id":"http://localhost:8150/api/commands/add-policy-tag"},{"name":"create-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/create-broker","id":"http://localhost:8150/api/commands/create-broker"},{"name":"create-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/create-hook","id":"http://localhost:8150/api/commands/create-hook"},{"name":"create-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/create-policy","id":"http://localhost:8150/api/commands/create-policy"},{"name":"create-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/create-repo","id":"http://localhost:8150/api/commands/create-repo"},{"name":"create-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/create-tag","id":"http://localhost:8150/api/commands/create-tag"},{"name":"create-task","rel":"http://api.puppetlabs.com/razor/v1/commands/create-task","id":"http://localhost:8150/api/commands/create-task"},{"name":"delete-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-broker","id":"http://localhost:8150/api/commands/delete-broker"},{"name":"delete-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-hook","id":"http://localhost:8150/api/commands/delete-hook"},{"name":"delete-node","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-node","id":"http://localhost:8150/api/commands/delete-node"},{"name":"delete-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-policy","id":"http://localhost:8150/api/commands/delete-policy"},{"name":"delete-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-repo","id":"http://localhost:8150/api/commands/delete-repo"},{"name":"delete-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-tag","id":"http://localhost:8150/api/commands/delete-tag"},{"name":"disable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/disable-policy","id":"http://localhost:8150/api/commands/disable-policy"},{"name":"enable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/enable-policy","id":"http://localhost:8150/api/commands/enable-policy"},{"name":"modify-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-node-metadata","id":"http://localhost:8150/api/commands/modify-node-metadata"},{"name":"modify-policy-max-count","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-policy-max-count","id":"http://localhost:8150/api/commands/modify-policy-max-count"},{"name":"move-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/move-policy","id":"http://localhost:8150/api/commands/move-policy"},{"name":"reboot-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reboot-node","id":"http://localhost:8150/api/commands/reboot-node"},{"name":"register-node","rel":"http://api.puppetlabs.com/razor/v1/commands/register-node","id":"http://localhost:8150/api/commands/register-node"},{"name":"reinstall-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reinstall-node","id":"http://localhost:8150/api/commands/reinstall-node"},{"name":"remove-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-node-metadata","id":"http://localhost:8150/api/commands/remove-node-metadata"},{"name":"remove-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-policy-tag","id":"http://localhost:8150/api/commands/remove-policy-tag"},{"name":"set-node-desired-power-state","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-desired-power-state","id":"http://localhost:8150/api/commands/set-node-desired-power-state"},{"name":"set-node-hw-info","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-hw-info","id":"http://localhost:8150/api/commands/set-node-hw-info"},{"name":"set-node-ipmi-credentials","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-ipmi-credentials","id":"http://localhost:8150/api/commands/set-node-ipmi-credentials"},{"name":"update-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-node-metadata","id":"http://localhost:8150/api/commands/update-node-metadata"},{"name":"update-tag-rule","rel":"http://api.puppetlabs.com/razor/v1/commands/update-tag-rule","id":"http://localhost:8150/api/commands/update-tag-rule"}],"collections":[{"name":"brokers","rel":"http://api.puppetlabs.com/razor/v1/collections/brokers","id":"http://localhost:8150/api/collections/brokers"},{"name":"repos","rel":"http://api.puppetlabs.com/razor/v1/collections/repos","id":"http://localhost:8150/api/collections/repos"},{"name":"tags","rel":"http://api.puppetlabs.com/razor/v1/collections/tags","id":"http://localhost:8150/api/collections/tags"},{"name":"policies","rel":"http://api.puppetlabs.com/razor/v1/collections/policies","id":"http://localhost:8150/api/collections/policies"},{"name":"nodes","rel":"http://api.puppetlabs.com/razor/v1/collections/nodes","id":"http://localhost:8150/api/collections/nodes","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"tasks","rel":"http://api.puppetlabs.com/razor/v1/collections/tasks","id":"http://localhost:8150/api/collections/tasks"},{"name":"commands","rel":"http://api.puppetlabs.com/razor/v1/collections/commands","id":"http://localhost:8150/api/collections/commands"},{"name":"events","rel":"http://api.puppetlabs.com/razor/v1/collections/events","id":"http://localhost:8150/api/collections/events","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"hooks","rel":"http://api.puppetlabs.com/razor/v1/collections/hooks","id":"http://localhost:8150/api/collections/hooks"}],"version":{"server":"v0.16.1-18-gd3acc7a-dirty"}}'
|
|
275
245
|
http_version:
|
|
276
|
-
recorded_at:
|
|
246
|
+
recorded_at: Mon, 09 Mar 2015 19:53:44 GMT
|
|
277
247
|
- request:
|
|
278
248
|
method: get
|
|
279
|
-
uri: http://localhost:
|
|
249
|
+
uri: http://localhost:8150/api/commands/modify-node-metadata
|
|
280
250
|
body:
|
|
281
|
-
encoding:
|
|
251
|
+
encoding: US-ASCII
|
|
282
252
|
string: ''
|
|
283
253
|
headers:
|
|
284
254
|
Accept:
|
|
@@ -295,24 +265,58 @@ http_interactions:
|
|
|
295
265
|
Server:
|
|
296
266
|
- Apache-Coyote/1.1
|
|
297
267
|
Etag:
|
|
298
|
-
- '"server-version-v0.
|
|
268
|
+
- '"server-version-v0.16.1-18-gd3acc7a-dirty"'
|
|
299
269
|
X-Content-Type-Options:
|
|
300
270
|
- nosniff
|
|
301
271
|
Content-Type:
|
|
302
272
|
- application/json;charset=utf-8
|
|
303
273
|
Content-Length:
|
|
304
|
-
- '
|
|
274
|
+
- '5386'
|
|
305
275
|
Date:
|
|
306
|
-
-
|
|
276
|
+
- Mon, 09 Mar 2015 19:53:44 GMT
|
|
307
277
|
body:
|
|
308
|
-
encoding:
|
|
309
|
-
string: '{"name":"modify-node-metadata","help":{"
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
278
|
+
encoding: US-ASCII
|
|
279
|
+
string: '{"name":"modify-node-metadata","help":{"summary":"Perform various editing
|
|
280
|
+
operations on node metadata","description":"Node metadata can be added, changed,
|
|
281
|
+
or removed with this command; it contains\na limited editing language to make
|
|
282
|
+
changes to the existing metadata in an\natomic fashion.\n\nIt can also clear
|
|
283
|
+
all metadata from a node, although that operation is\nexclusive to all other
|
|
284
|
+
editing operations, and cannot be performed atomically\nwith them.","schema":"#
|
|
285
|
+
Access Control\n\nThis command''s access control pattern: `commands:modify-node-metadata:%{node}`\n\nWords
|
|
286
|
+
surrounded by `%{...}` are substitutions from the input data: typically\nthe
|
|
287
|
+
name of the object being modified, or some other critical detail, these\nallow
|
|
288
|
+
roles to be granted partial access to modify the system.\n\nFor more detail
|
|
289
|
+
on how the permission strings are structured and work, you can\nsee the [Shiro
|
|
290
|
+
Permissions documentation][shiro]. That pattern is expanded\nand then a permission
|
|
291
|
+
check applied to it, before the command is authorized.\n\nThese checks only
|
|
292
|
+
apply if security is enabled in the Razor configuration\nfile; on this server
|
|
293
|
+
security is currently disabled.\n\n[shiro]: http://shiro.apache.org/permissions.html\n\n#
|
|
294
|
+
Attributes\n\n * node\n - The name of the node for which to modify metadata.\n -
|
|
295
|
+
This attribute is required.\n - It must be of type string.\n - It must
|
|
296
|
+
match the name of an existing node.\n\n * update\n - The metadata to update\n -
|
|
297
|
+
It must be of type object.\n\n * remove\n - The metadata to remove\n -
|
|
298
|
+
It must be of type array.\n\n * clear\n - Remove all metadata from the node. Cannot
|
|
299
|
+
be used together with\n either ''update'' or ''remove''.\n - It must
|
|
300
|
+
be of type boolean.\n - If present, update, remove must not be present.\n\n
|
|
301
|
+
* no_replace\n - If true, the `update` operation will cause this command
|
|
302
|
+
to fail if the\n metadata key is already present on the node. No effect
|
|
303
|
+
on `remove` or\n clear.\n - It must be of type boolean.\n","examples":{"api":"Editing
|
|
304
|
+
node metadata, by adding and removing some keys, but refusing to\nmodify an
|
|
305
|
+
existing value already present on a node:\n\n {\n \"node\": \"node1\",\n \"update\":
|
|
306
|
+
{\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n }\n \"remove\":
|
|
307
|
+
[\"key3\", \"key4\"],\n \"no_replace\": true\n }\n\nRemoving all
|
|
308
|
+
node metadata:\n\n {\"node\": \"node1\", \"clear\": true}","cli":"Editing
|
|
309
|
+
node metadata, by adding and removing some keys, but refusing to\nmodify an
|
|
310
|
+
existing value already present on a node:\n\n razor modify-node-metadata
|
|
311
|
+
--node node1 --update key1=value1 \\\n --update key2=value2 --remove
|
|
312
|
+
key3 --remove key4 --no-replace\n\nRemoving all node metadata:\n\n razor
|
|
313
|
+
modify-node-metadata --node node1 --clear"},"full":"# SYNOPSIS\nPerform various
|
|
314
|
+
editing operations on node metadata\n\n# DESCRIPTION\nNode metadata can be
|
|
315
|
+
added, changed, or removed with this command; it contains\na limited editing
|
|
316
|
+
language to make changes to the existing metadata in an\natomic fashion.\n\nIt
|
|
313
317
|
can also clear all metadata from a node, although that operation is\nexclusive
|
|
314
318
|
to all other editing operations, and cannot be performed atomically\nwith
|
|
315
|
-
them.\n
|
|
319
|
+
them.\n# Access Control\n\nThis command''s access control pattern: `commands:modify-node-metadata:%{node}`\n\nWords
|
|
316
320
|
surrounded by `%{...}` are substitutions from the input data: typically\nthe
|
|
317
321
|
name of the object being modified, or some other critical detail, these\nallow
|
|
318
322
|
roles to be granted partial access to modify the system.\n\nFor more detail
|
|
@@ -328,20 +332,20 @@ http_interactions:
|
|
|
328
332
|
It must be of type array.\n\n * clear\n - Remove all metadata from the node. Cannot
|
|
329
333
|
be used together with\n either ''update'' or ''remove''.\n - It must
|
|
330
334
|
be of type boolean.\n - If present, update, remove must not be present.\n\n
|
|
331
|
-
*
|
|
335
|
+
* no_replace\n - If true, the `update` operation will cause this command
|
|
332
336
|
to fail if the\n metadata key is already present on the node. No effect
|
|
333
337
|
on `remove` or\n clear.\n - It must be of type boolean.\n\n# EXAMPLES\n\n Editing
|
|
334
338
|
node metadata, by adding and removing some keys, but refusing to\n modify
|
|
335
339
|
an existing value already present on a node:\n \n {\n \"node\":
|
|
336
340
|
\"node1\",\n \"update\": {\n \"key1\": \"value1\",\n \"key2\":
|
|
337
|
-
\"value2\"\n }\n \"remove\": [\"key3\", \"key4\"],\n \"
|
|
341
|
+
\"value2\"\n }\n \"remove\": [\"key3\", \"key4\"],\n \"no_replace\":
|
|
338
342
|
true\n }\n \n Removing all node metadata:\n \n {\"node\": \"node1\",
|
|
339
|
-
\"clear\": true}\n"},"schema":{"node":{"type":"string"},"update":{"type":"object"},"remove":{"type":"array"},"clear":{"type":"boolean"},"
|
|
343
|
+
\"clear\": true}\n"},"schema":{"node":{"type":"string"},"update":{"type":"object"},"remove":{"type":"array"},"clear":{"type":"boolean"},"no_replace":{"type":"boolean","aliases":["no-replace"]}}}'
|
|
340
344
|
http_version:
|
|
341
|
-
recorded_at:
|
|
345
|
+
recorded_at: Mon, 09 Mar 2015 19:53:44 GMT
|
|
342
346
|
- request:
|
|
343
347
|
method: post
|
|
344
|
-
uri: http://localhost:
|
|
348
|
+
uri: http://localhost:8150/api/commands/modify-node-metadata
|
|
345
349
|
body:
|
|
346
350
|
encoding: UTF-8
|
|
347
351
|
string: '{"node":"node1","update":{"keyᓱ123":"valueᓱ1"}}'
|
|
@@ -370,17 +374,17 @@ http_interactions:
|
|
|
370
374
|
Content-Length:
|
|
371
375
|
- '203'
|
|
372
376
|
Date:
|
|
373
|
-
-
|
|
377
|
+
- Mon, 09 Mar 2015 19:53:44 GMT
|
|
374
378
|
body:
|
|
375
|
-
encoding:
|
|
376
|
-
string: '{"spec":"http://api.puppetlabs.com/razor/v1/collections/nodes/member","id":"http://localhost:
|
|
379
|
+
encoding: US-ASCII
|
|
380
|
+
string: '{"spec":"http://api.puppetlabs.com/razor/v1/collections/nodes/member","id":"http://localhost:8150/api/collections/nodes/node1","name":"node1","command":"http://localhost:8150/api/collections/commands/2"}'
|
|
377
381
|
http_version:
|
|
378
|
-
recorded_at:
|
|
382
|
+
recorded_at: Mon, 09 Mar 2015 19:53:45 GMT
|
|
379
383
|
- request:
|
|
380
384
|
method: get
|
|
381
|
-
uri: http://localhost:
|
|
385
|
+
uri: http://localhost:8150/api/collections/nodes/node1
|
|
382
386
|
body:
|
|
383
|
-
encoding:
|
|
387
|
+
encoding: US-ASCII
|
|
384
388
|
string: ''
|
|
385
389
|
headers:
|
|
386
390
|
Accept:
|
|
@@ -401,12 +405,22 @@ http_interactions:
|
|
|
401
405
|
Content-Type:
|
|
402
406
|
- application/json;charset=utf-8
|
|
403
407
|
Content-Length:
|
|
404
|
-
- '
|
|
408
|
+
- '435'
|
|
405
409
|
Date:
|
|
406
|
-
-
|
|
410
|
+
- Mon, 09 Mar 2015 19:53:44 GMT
|
|
407
411
|
body:
|
|
408
|
-
encoding:
|
|
409
|
-
string:
|
|
412
|
+
encoding: ASCII-8BIT
|
|
413
|
+
string: !binary |-
|
|
414
|
+
eyJzcGVjIjoiaHR0cDovL2FwaS5wdXBwZXRsYWJzLmNvbS9yYXpvci92MS9j
|
|
415
|
+
b2xsZWN0aW9ucy9ub2Rlcy9tZW1iZXIiLCJpZCI6Imh0dHA6Ly9sb2NhbGhv
|
|
416
|
+
c3Q6ODE1MC9hcGkvY29sbGVjdGlvbnMvbm9kZXMvbm9kZTEiLCJuYW1lIjoi
|
|
417
|
+
bm9kZTEiLCJod19pbmZvIjp7Im1hYyI6WyJhYmNkZWYiXX0sImxvZyI6eyJp
|
|
418
|
+
ZCI6Imh0dHA6Ly9sb2NhbGhvc3Q6ODE1MC9hcGkvY29sbGVjdGlvbnMvbm9k
|
|
419
|
+
ZXMvbm9kZTEvbG9nIiwibmFtZSI6ImxvZyIsInBhcmFtcyI6eyJsaW1pdCI6
|
|
420
|
+
eyJ0eXBlIjoibnVtYmVyIn0sInN0YXJ0Ijp7InR5cGUiOiJudW1iZXIifX19
|
|
421
|
+
LCJ0YWdzIjpbXSwibWV0YWRhdGEiOnsia2V54ZOxMTIzIjoidmFsdWXhk7Ex
|
|
422
|
+
In0sInN0YXRlIjp7Imluc3RhbGxlZCI6InRydWUiLCJpbnN0YWxsZWRfYXQi
|
|
423
|
+
OiIyMDE1LTAzLTA5VDE0OjUzOjQ0LTA1OjAwIn19
|
|
410
424
|
http_version:
|
|
411
|
-
recorded_at:
|
|
425
|
+
recorded_at: Mon, 09 Mar 2015 19:53:45 GMT
|
|
412
426
|
recorded_with: VCR 2.5.0
|