Class: Chef::ApiClient
- Inherits:
-
Object
- Object
- Chef::ApiClient
- Includes:
- Mixin::FromFile, Mixin::ParamsValidate
- Defined in:
- lib/chef/api_client.rb,
lib/chef/api_client/registration.rb
Defined Under Namespace
Classes: Registration
Class Method Summary collapse
- .from_hash(o) ⇒ Object
- .from_json(j) ⇒ Object
- .http_api ⇒ Object
- .json_create(data) ⇒ Object
- .list(inflate = false) ⇒ Object
-
.load(name) ⇒ Object
Load a client by name via the API.
- .reregister(name) ⇒ Object
Instance Method Summary collapse
-
#admin(arg = nil) ⇒ True/False
Gets or sets whether this client is an admin.
-
#create ⇒ Object
Create the client via the REST API.
-
#destroy ⇒ Object
Remove this client via the REST API.
- #http_api ⇒ Object
-
#initialize ⇒ ApiClient
constructor
Create a new Chef::ApiClient object.
- #inspect ⇒ Object
-
#name(arg = nil) ⇒ String
Gets or sets the client name.
-
#private_key(arg = nil) ⇒ String
Gets or sets the private key.
-
#public_key(arg = nil) ⇒ String
Gets or sets the public key.
- #reregister ⇒ Object
-
#save ⇒ Object
Save this client via the REST API, returns a hash including the private key.
-
#to_hash ⇒ Hash
The hash representation of the object.
-
#to_json(*a) ⇒ String
The JSON representation of the object.
-
#to_s ⇒ Object
As a string.
-
#validator(arg = nil) ⇒ Boolean
Gets or sets whether this client is a validator.
Methods included from Mixin::ParamsValidate
#lazy, #set_or_return, #validate
Methods included from Mixin::FromFile
Constructor Details
#initialize ⇒ ApiClient
Create a new Chef::ApiClient object.
40 41 42 43 44 45 46 |
# File 'lib/chef/api_client.rb', line 40 def initialize @name = "" @public_key = nil @private_key = nil @admin = false @validator = false end |
Class Method Details
.from_hash(o) ⇒ Object
133 134 135 136 137 138 139 140 141 |
# File 'lib/chef/api_client.rb', line 133 def self.from_hash(o) client = Chef::ApiClient.new client.name(o["name"] || o["clientname"]) client.private_key(o["private_key"]) if o.key?("private_key") client.public_key(o["public_key"]) client.admin(o["admin"]) client.validator(o["validator"]) client end |
.from_json(j) ⇒ Object
148 149 150 |
# File 'lib/chef/api_client.rb', line 148 def self.from_json(j) from_hash(Chef::JSONCompat.parse(j)) end |
.http_api ⇒ Object
152 153 154 |
# File 'lib/chef/api_client.rb', line 152 def self.http_api Chef::ServerAPI.new(Chef::Config[:chef_server_url], { :api_version => "0" }) end |
.json_create(data) ⇒ Object
143 144 145 146 |
# File 'lib/chef/api_client.rb', line 143 def self.json_create(data) Chef.log_deprecation("Auto inflation of JSON data is deprecated. Please use Chef::ApiClient#from_hash") from_hash(data) end |
.list(inflate = false) ⇒ Object
161 162 163 164 165 166 167 168 169 170 171 172 |
# File 'lib/chef/api_client.rb', line 161 def self.list(inflate = false) if inflate response = Hash.new Chef::Search::Query.new.search(:client) do |n| n = self.json_create(n) if n.instance_of?(Hash) response[n.name] = n end response else http_api.get("clients") end end |
.load(name) ⇒ Object
Load a client by name via the API
175 176 177 178 179 180 181 182 |
# File 'lib/chef/api_client.rb', line 175 def self.load(name) response = http_api.get("clients/#{name}") if response.kind_of?(Chef::ApiClient) response else from_hash(response) end end |
.reregister(name) ⇒ Object
156 157 158 159 |
# File 'lib/chef/api_client.rb', line 156 def self.reregister(name) api_client = load(name) api_client.reregister end |
Instance Method Details
#admin(arg = nil) ⇒ True/False
Gets or sets whether this client is an admin.
64 65 66 67 68 69 70 |
# File 'lib/chef/api_client.rb', line 64 def admin(arg = nil) set_or_return( :admin, arg, :kind_of => [ TrueClass, FalseClass ] ) end |
#create ⇒ Object
Create the client via the REST API
214 215 216 |
# File 'lib/chef/api_client.rb', line 214 def create http_api.post("clients", self) end |
#destroy ⇒ Object
Remove this client via the REST API
185 186 187 |
# File 'lib/chef/api_client.rb', line 185 def destroy http_api.delete("clients/#{@name}") end |
#http_api ⇒ Object
228 229 230 |
# File 'lib/chef/api_client.rb', line 228 def http_api @http_api ||= Chef::ServerAPI.new(Chef::Config[:chef_server_url], { :api_version => "0" }) end |
#inspect ⇒ Object
223 224 225 226 |
# File 'lib/chef/api_client.rb', line 223 def inspect "Chef::ApiClient name:'#{name}' admin:'#{admin.inspect}' validator:'#{validator}' " + "public_key:'#{public_key}' private_key:'#{private_key}'" end |
#name(arg = nil) ⇒ String
Gets or sets the client name.
52 53 54 55 56 57 58 |
# File 'lib/chef/api_client.rb', line 52 def name(arg = nil) set_or_return( :name, arg, :regex => /^[\-[:alnum:]_\.]+$/ ) end |
#private_key(arg = nil) ⇒ String
Gets or sets the private key.
101 102 103 104 105 106 107 |
# File 'lib/chef/api_client.rb', line 101 def private_key(arg = nil) set_or_return( :private_key, arg, :kind_of => [String, FalseClass] ) end |
#public_key(arg = nil) ⇒ String
Gets or sets the public key.
76 77 78 79 80 81 82 |
# File 'lib/chef/api_client.rb', line 76 def public_key(arg = nil) set_or_return( :public_key, arg, :kind_of => String ) end |
#reregister ⇒ Object
203 204 205 206 207 208 209 210 211 |
# File 'lib/chef/api_client.rb', line 203 def reregister reregistered_self = http_api.put("clients/#{name}", { :name => name, :admin => admin, :validator => validator, :private_key => true }) if reregistered_self.respond_to?(:[]) private_key(reregistered_self["private_key"]) else private_key(reregistered_self.private_key) end self end |
#save ⇒ Object
Save this client via the REST API, returns a hash including the private key
190 191 192 193 194 195 196 197 198 199 200 201 |
# File 'lib/chef/api_client.rb', line 190 def save begin http_api.put("clients/#{name}", { :name => self.name, :admin => self.admin, :validator => self.validator }) rescue Net::HTTPServerException => e # If that fails, go ahead and try and update it if e.response.code == "404" http_api.post("clients", { :name => self.name, :admin => self.admin, :validator => self.validator }) else raise e end end end |
#to_hash ⇒ Hash
The hash representation of the object. Includes the name and public_key. Private key is included if available.
113 114 115 116 117 118 119 120 121 122 123 124 |
# File 'lib/chef/api_client.rb', line 113 def to_hash result = { "name" => @name, "public_key" => @public_key, "validator" => @validator, "admin" => @admin, "json_class" => self.class.name, "chef_type" => "client", } result["private_key"] = @private_key if @private_key result end |
#to_json(*a) ⇒ String
The JSON representation of the object.
129 130 131 |
# File 'lib/chef/api_client.rb', line 129 def to_json(*a) Chef::JSONCompat.to_json(to_hash, *a) end |
#to_s ⇒ Object
As a string
219 220 221 |
# File 'lib/chef/api_client.rb', line 219 def to_s "client[#{@name}]" end |
#validator(arg = nil) ⇒ Boolean
Gets or sets whether this client is a validator.
89 90 91 92 93 94 95 |
# File 'lib/chef/api_client.rb', line 89 def validator(arg = nil) set_or_return( :validator, arg, :kind_of => [TrueClass, FalseClass] ) end |