puppetclassify 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9f483cde63ad46f3c698a9777189eb30294a799a
-  data.tar.gz: 1bd815ddd7911c47dac2fe888ff8cfda0d27bfae
+  metadata.gz: 629f0cea233dad57716d3e00801a3b358ef5da4c
+  data.tar.gz: 8d152b9204474c9af61a5efa37f06329b1e5ba66
 SHA512:
-  metadata.gz: 1e7754f2bb28972767f75372bbc1ffca2c85143d57b3456fc1a9d8a796f1df0b54b656d6e495b1cf14bdf0231c046c9f5917b1f1941b58a4900ccd55be9950c1
-  data.tar.gz: 93fbf3cd6a7e65157fe8b79de043d8be8b99b7593d7a52f99b5f5170ebbe7bfff94f39fd66aea02413457c4c1c88b31f53f1abdaf3e8ae636f1bb1133b73a8bc
+  metadata.gz: 17e9ce78366de5cf1416610dc5c6049f3985848eb21303a0d6925dc56b91c227f538cec3ac1c81e7eb433da1b966a99078b79ddac809892b0a5cda0e54952a3a
+  data.tar.gz: 97a064d5eed5b8b6c95e5a12246293eb9663ddf0f2575ed812c186c39c553a50aff6b408b173f473c0ffd6aa8f1f0a60c5d2cf56441bd01001b0821bc78647a7

data/README.md

@@ -17,6 +17,12 @@ gem build puppetclassify.gemspec
 gem install puppetclassify-0.1.0.gem
 ```
 
+## Maintenance
+
+Maintainers: [Brian Cain](https://github.com/briancain) <brian.cain@puppetlabs.com>
+
+Tickets: Open an issue or pull request directly on this repository
+
 ## How to use
 
 ### Basic case
@@ -109,6 +115,34 @@ facts = { 'fact' => Facter.to_hash }
 puppetclassify.classification.get('myhostname.puppetlabs.vm', facts)
 ```
 
+### Pinning and unpinning nodes to a group in Puppet enterprise
+
+If you want to "pin" a node to a specific group so it gets that classification, you can
+invoke the pin_nodes command. And if you want to remove nodes from that group, you can run
+the unpin_nodes command.
+
+```
+require 'puppetclassify'
+# URL of classifier as well as certificates and private key for auth
+auth_info = {
+  "ca_certificate_path" => "/etc/puppetlabs/puppet/ssl/certs/ca.pem",
+  "certificate_path"    => "/etc/puppetlabs/puppet/ssl/certs/myhostname.vm.pem",
+  "private_key_path"    => "/etc/puppetlabs/puppet/ssl/private_keys/myhostname.vm.pem"
+}
+
+classifier_url = 'https://puppetmaster.local:4433/classifier-api'
+puppetclassify = PuppetClassify.new(classifier_url, auth_info)
+
+my_group_id = puppetclassify.groups.get_group_id("My Super Awesome Group Name")
+
+nodes = ["hostname.com", "myotherhost.com", "anotherhost.com"]
+# pin nodes to group
+puppetclassify.groups.pin_nodes(my_group_id, nodes)
+
+# unpin nodes from group
+puppetclassify.groups.unpin_nodes(my_group_id, nodes)
+```
+
 ## Library Docs
 
 [rubydoc](http://www.rubydoc.info/gems/puppetclassify/0.1.0)

data/lib/puppetclassify/groups.rb

@@ -81,4 +81,26 @@ class Groups
       STDERR.puts group_res.body
     end
   end
+
+  def pin_nodes(group_id, node_hash)
+    request_body = {}
+    request_body["nodes"] = node_hash # expects node_hash to be array, i.e. ["foo", "bar", "baz"]
+    group_response = @puppet_https.post("#{@nc_api_url}/v1/groups/#{group_id}/pin", request_body.to_json)
+
+    unless group_response.code.to_i == 204
+      STDERR.puts "An error occured pinning nodes the group: HTTP #{group_response.code} #{group_response.message}"
+      STDERR.puts group_response.body
+    end
+  end
+
+  def unpin_nodes(group_id, node_hash)
+    request_body = {}
+    request_body["nodes"] = node_hash # expects node_hash to be array, i.e. ["foo", "bar", "baz"]
+    group_response = @puppet_https.post("#{@nc_api_url}/v1/groups/#{group_id}/unpin", request_body.to_json)
+
+    unless group_response.code.to_i == 204
+      STDERR.puts "An error occured unpinning nodes the group: HTTP #{group_response.code} #{group_response.message}"
+      STDERR.puts group_response.body
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: puppetclassify
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Brian Cain