jackal-copperegg 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 96fb71981b676056dcff2b278f68e715d7f35872
+  data.tar.gz: dd6fcde30ddf58eeb08531cb0fbe136ba0607f38
+SHA512:
+  metadata.gz: ece2dc63ee8c4aaf0c69fda8ed75a70f6dc38ea616e7c7c4f74c051b8ddc4de9cd4a0ae9a98e855c764554164cd974056e6daab4f3bd7677c603055410613a9c
+  data.tar.gz: efa91ceb49b057909b8ca66e9ef30bd29b214438debd51271685f6be9fd383ac775f09bb4f00636a05a5b31e716a84f9a620a4f15f98d046c7ec0518bac8f39a

data/CHANGELOG.md

@@ -0,0 +1,2 @@
+# v0.1.0
+* Initial release

data/CONTRIBUTING.md

@@ -0,0 +1,25 @@
+# Contributing
+
+## Branches
+
+### `master` branch
+
+The master branch is the current stable released version.
+
+### `develop` branch
+
+The develop branch is the current edge of development.
+
+## Pull requests
+
+* https://github.com/carnivore-rb/jackal-copperegg/pulls
+
+Please base all pull requests of the `develop` branch. Merges to
+`master` only occur through the `develop` branch. Pull requests
+based on `master` will likely be cherry picked.
+
+## Issues
+
+Need to report an issue? Use the github issues:
+
+* https://github.com/carnivore-rb/jackal-copperegg/issues

data/LICENSE

@@ -0,0 +1,13 @@
+   Copyright 2014 Chris Roberts
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/README.md

@@ -0,0 +1 @@
+# CFN Copperegg helpers

data/jackal-copperegg.gemspec

@@ -0,0 +1,17 @@
+$LOAD_PATH.unshift File.expand_path(File.dirname(__FILE__)) + '/lib/'
+require 'jackal-copperegg/version'
+Gem::Specification.new do |s|
+  s.name = 'jackal-copperegg'
+  s.version = Jackal::Copperegg::VERSION.version
+  s.summary = 'Message processing helper'
+  s.author = 'Chris Roberts'
+  s.email = 'code@chrisroberts.org'
+  s.homepage = 'https://github.com/carnivore-rb/jackal-copperegg'
+  s.description = 'Copperegg callback helpers'
+  s.require_path = 'lib'
+  s.license = 'Apache 2.0'
+  s.add_dependency 'jackal'
+  s.add_dependency 'jackal-cfn'
+  s.add_dependency 'patron'
+  s.files = Dir['lib/**/*'] + %w(jackal-copperegg.gemspec README.md CHANGELOG.md CONTRIBUTING.md LICENSE)
+end

data/lib/jackal-copperegg.rb

@@ -0,0 +1,9 @@
+require 'jackal-cfn'
+require 'jackal-copperegg/version'
+
+module Jackal
+  module CfnTools
+    autoload :CoppereggProbe, 'jackal-copperegg/resources/probe'
+    autoload :CoppereggStackServerCleanup, 'jackal-copperegg/events/stack_server_cleanup'
+  end
+end

data/lib/jackal-copperegg/events/stack_server_cleanup.rb

@@ -0,0 +1,94 @@
+require 'jackal-copperegg'
+
+module Jackal
+  module CfnTools
+
+    # Removes servers from revealcloud on stack deletion. Depends
+    # on servers being registered with the CFN stack ID tagged on
+    # it.
+    class CoppereggStackServerCleanup < Jackal::Cfn::Event
+
+      # Validity of message
+      #
+      # @param message [Carnivore::Message]
+      # @return [TrueClass, FalseClass]
+      def valid?(message)
+        super do |payload|
+          payload.get(:data, :cfn_event, :resource_type) == 'AWS::CloudFormation::Stack' &&
+            payload.get(:data, :cfn_event, :resource_status) == 'DELETE_COMPLETE'
+        end
+      end
+
+      # Delete any revealcloud servers
+      #
+      # @param message [Carnivore::Message]
+      def execute(message)
+        failure_wrap(message) do |payload|
+          event = payload.get(:data, :cfn_event)
+          url = URI.parse(
+            config.fetch(
+              :copperegg,
+              :revealcloud_url,
+              'https://api.copperegg.com'
+            )
+          )
+          endpoint = http_endpoint(url.host, url.scheme)
+          endpoint.username = config.get(:copperegg, :revealcloud_username)
+          endpoint.password = config.get(:copperegg, :revealcloud_password)
+          endpoint.connect_timeout = 30
+          endpoint.timeout = 30
+          destroy_revealcloud_servers(event[:stack_id], endpoint)
+          completed(payload, message)
+        end
+      end
+
+      # Search for all revealcloud servers registered
+      # with provided stack ID
+      #
+      # @param stack_id [String]
+      # @param endpoint [Patron::Session]
+      # @return [Array<Hash>] servers deleted
+      # @todo catch HTTP related errors, log and continue on
+      def destroy_revealcloud_servers(stack_id, endpoint)
+        servers = detect_revealcloud_servers(stack_id, endpoint)
+        debug "Number of servers detected to remove from revealcloud: #{servers.count}"
+        servers.each do |server|
+          info "Removing server instance from revealcloud: #{server[:uuid]}"
+          debug "Server instance information: #{server.inspect}"
+          endpoint.delete(
+            File.join(
+              config.fetch(
+                :copperegg,
+                :revealcloud_delete_path,
+                '/v2/revealcloud/uuids'
+              ),
+              "#{server[:uuid]}.json"
+            )
+          )
+        end
+        servers
+      end
+
+      # Find all revealcloud servers tagged with stack id
+      #
+      # @param stack_id [String]
+      # @param endpoint [Patron::Session]
+      # @return [Array<Hash>] matching servers
+      def detect_revealcloud_servers(stack_id, endpoint)
+        response = endpoint.get(
+          config.fetch(
+            :copperegg,
+            :revealcloud_index_path,
+            '/v2/revealcloud/systems.json?show_hidden=1'
+          )
+        )
+        servers = MultiJson.load(response.body)
+        servers.find_all do |server|
+          server.fetch('t', []).include?(stack_id)
+        end
+      end
+
+    end
+
+  end
+end

data/lib/jackal-copperegg/resources/probe.rb

@@ -0,0 +1,190 @@
+require 'base64'
+require 'jackal-copperegg'
+
+module Jackal
+  module CfnTools
+    # Add or remove probes from a stack
+    #
+    # Expected resource:
+    #   {
+    #     "Type": "Custom::CoppereggProbe",
+    #     "Properties": {
+    #       "Parameters": {
+    #         "Probes": [
+    #           {
+    #             ## required
+    #             "ProbeDesc": "A description",
+    #             "Type": "GET", # or POST, TCP, IMCP
+    #             "ProbeDest": "http://localhost",
+    #             ## optional
+    #             "CheckContents": "match", # or nomatch
+    #             "ContentMatch": "StringForComparison",
+    #             "Frequency": 30,
+    #             "Timeout": 10000,
+    #             "Retries": 3,
+    #             "Tags": "comma,delimited,tags",
+    #             "Stations": ["LON"]
+    #           }
+    #         ]
+    #       }
+    #     }
+    #   }
+    # @see http://dev.copperegg.com/revealuptime/probes.html
+    class CoppereggProbe < Jackal::Cfn::Resource
+
+      # Process probe related action
+      #
+      # @param message [Carnivore::Message]
+      def execute(message)
+        failure_wrap(message) do |payload|
+          cfn_resource = rekey_hash(payload.get(:data, :cfn_resource))
+          properties = rekey_hash(cfn_resource[:resource_properties])
+          parameters = rekey_hash(properties[:parameters])
+          cfn_response = build_response(cfn_resource)
+          case cfn_resource[:request_type].to_sym
+          when :create
+            create_probes(
+              :probes => [parameters[:probes]].flatten,
+              :response => cfn_response
+            )
+          when :update
+            error 'Update requested but not supported!'
+            cfn_response['Status'] = 'FAILED'
+            cfn_response['Reason'] = 'Updates are not supported on this resource'
+          when :delete
+            delete_probes(
+              :physical_resource_id => cfn_resource[:physical_resource_id],
+              :response => cfn_response
+            )
+          else
+            error "Unknown request type received: #{payload[:request_type]}"
+            cfn_response['Status'] = 'FAILED'
+            cfn_response['Reason'] = 'Unknown request type received'
+          end
+          respond_to_stack(cfn_response, cfn_resource[:response_url])
+          completed(payload, message)
+        end
+      end
+
+      # Create new probes
+      #
+      # @param args [Hash]
+      # @option args [Array<Hash>] :probes probes to create
+      # @option args [Hash] :response cfn response message
+      # @return [TrueClass]
+      def create_probes(args={})
+        endpoint = generate_endpoint
+        results = []
+        args[:probes].each do |probe|
+          probe_data = MultiJson.dump(rekey_hash(probe))
+          debug "Attempting probe creation (#{probe_data.inspect})"
+          results.push(
+            endpoint.post(
+              config.fetch(
+                :copperegg,
+                :revealuptime_create_path,
+                '/v2/revealuptime/probes.json'
+              ),
+              probe_data,
+              'Content-Type' => 'application/json'
+            )
+          )
+        end
+        errors = results.find_all do |result|
+          result.status != 200
+        end
+        results -= errors
+        results.map! do |result|
+          MultiJson.load(result.body)['id']
+        end
+        if(errors.empty?)
+          debug "Probes created: #{results.inspect}"
+          args[:response]['PhysicalResourceId'] = Base64.urlsafe_encode64(
+            MultiJson.dump(results)
+          )
+          args[:response]['Status'] = 'SUCCESS'
+          args[:response]['Data']['Reason'] = "New copperegg probes added: #{results.size}"
+        else
+          probe_deletion(*results)
+          args[:response]['Status'] = 'FAILED'
+          args[:response]['Reason'] = "Probe creation failed: #{errors.map(&:body).map(&:strip).join(', ')}"
+        end
+        true
+      end
+
+      # Call API to delete probes
+      #
+      # @param ids [String] probe id list
+      # @return [Array<Patron::Response>]
+      def probe_deletion(*ids)
+        endpoint = generate_endpoint
+        ids.map do |probe_id|
+          debug "Copperegg probe deletion ID: #{probe_id}"
+          if(probe_id.to_s.strip.empty?)
+            error 'Encountered an empty probe ID. Skipping.'
+            nil
+          else
+            delete_path = File.join(
+              config.fetch(
+                :copperegg,
+                :revealuptime_delete_path,
+                '/v2/revealuptime/probes'
+              ),
+              "#{probe_id}.json"
+            )
+            endpoint.delete(delete_path)
+          end
+        end.compact
+      end
+
+      # Delete probes
+      #
+      # @param args [Hash]
+      # @option args [String] :physical_resource_id probes to delete
+      # @option args [Hash] :response cfn response message
+      # @return [TrueClass]
+      def delete_probes(args={})
+        begin
+          ids = MultiJson.load(
+            Base64.urlsafe_decode64(
+              args[:physical_resource_id]
+            )
+          )
+          results = probe_deletion(*ids)
+          errors = results.find_all do |r|
+            r.status != 200 && r.status != 404
+          end
+          results -= errors
+          if(errors.empty?)
+            args[:response]['Status'] = 'SUCCESS'
+            args[:response]['Data']['Reason'] = "Probes removed (#{ids.count})"
+          else
+            args[:response]['Status'] = 'FAILED'
+            args[:response]['Reason'] = "Probe deletion failed: #{errors.map(&:body).map(&:strip).join(', ')}"
+          end
+        rescue ArgumentError, MultiJson::ParseError
+          args[:response]['Status'] = 'SUCCESS'
+          args[:response]['Data']['Reason'] = 'No probes to delete!'
+        end
+        true
+      end
+
+      # @return [Patron::Session]
+      def generate_endpoint
+        url = URI.parse(
+          config.fetch(
+            :copperegg,
+            :revealuptime_url,
+            'https://api.copperegg.com'
+          )
+        )
+        endpoint = http_endpoint(url.host, url.scheme)
+        endpoint.username = config.get(:copperegg, :revealuptime_username)
+        endpoint.password = config.get(:copperegg, :revealuptime_password)
+        endpoint
+      end
+
+    end
+
+  end
+end

data/lib/jackal-copperegg/version.rb

@@ -0,0 +1,6 @@
+module Jackal
+  module Copperegg
+    # Current library version
+    VERSION = Gem::Version.new('0.1.0')
+  end
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: jackal-copperegg
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Chris Roberts
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-08-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: jackal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: jackal-cfn
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: patron
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Copperegg callback helpers
+email: code@chrisroberts.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- CONTRIBUTING.md
+- LICENSE
+- README.md
+- jackal-copperegg.gemspec
+- lib/jackal-copperegg.rb
+- lib/jackal-copperegg/events/stack_server_cleanup.rb
+- lib/jackal-copperegg/resources/probe.rb
+- lib/jackal-copperegg/version.rb
+homepage: https://github.com/carnivore-rb/jackal-copperegg
+licenses:
+- Apache 2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Message processing helper
+test_files: []
+has_rdoc: