sparkle-pack-jackal-cfn 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 68eac1e8d59b0d0c7ce62f3c8e467313e8c50bf6
+  data.tar.gz: 73e0fb3a5760fd6a5eaf1ff1a82f3c3f6d9d9f5a
+SHA512:
+  metadata.gz: 56b6ba743aff42df8bf5ff15b67fea0e8cbecf162f93de577c7cfd58d13406cd8fac42fa0b7140b7de53416e6ad695827f2a29200cdfa35455fe29c9c09c8760
+  data.tar.gz: 7e685a95dcf3b686bbf41e455d5f5962d05a755bea52e3e0f9fc1cd9b5efadfcac9301cd328e4700188e61e495c793d2d079520cc77811fc96262ea5f3ead498

data/CHANGELOG.md

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

data/LICENSE

@@ -0,0 +1,13 @@
+   Copyright 2016 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,129 @@
+# SparklePack - Jackal CFN
+
+This is a [SparkleFormation][1] [SparklePack][2] for [jackal-cfn][3]. It provides
+integrations for the custom resources provided by the [jackal-cfn][3]
+library as well as templates for worker setup and example usage.
+
+## Integrations
+
+### Dynamics
+
+This [SparklePack][2] provides dynamics for custom resources provided
+by [jackal-cfn][3]:
+
+* `:ami_manager`
+* `:ami_register`
+* `:hash_extractor`
+* `:jackal_stack`
+* `:orchestration_unit`
+
+It also provides a customized `:jackal_image` dynamic which will
+create the resource as well as an output of the newly created
+AMI ID.
+
+### Templates
+
+This [SparklePack][2] includes 3 templates:
+
+1. `jackal_cfn` - Creates a working processor to handle requests
+2. `jackal_bus` - Creates _only_ the required message bus resources
+3. `jackal_usage_example` - Example template to display usage of the OrchestrationUnit resource
+
+_NOTE: The `jackal_cfn` template only supports the follow regions:_
+
+* ap-northeast-1
+* ap-southeast-1
+* ap-southeast-2
+* cn-north-1
+* eu-central-1
+* eu-west-1
+* sa-east-1
+* us-east-1
+* us-west-1
+* us-west-2
+* us-gov-west-1
+
+## Usage
+
+_NOTE: Assumes a working `sfn` setup. (see: [Getting started guide][4])_
+
+### Setup
+
+First, include the [SparklePack][2] into the bundle by adding this line to
+the `./Gemfile`:
+
+```ruby
+gem 'sparkle-pack-jackal-cfn'
+```
+
+Next, update the local bundle:
+
+```
+$ bundle update
+```
+
+Now enable the [SparklePack][2] within the `.sfn` configuration file:
+
+```ruby
+Configuration.new do
+  ...
+  sparkle_pack 'sparkle-pack-jackal-cfn'
+  ...
+end
+```
+
+### Build a jackal-cfn processor
+
+To use the [jackal-cfn][3] resources, a processor instance must be available. The
+[SparklePack][2] provides a template to build a processor stack. This stack will
+build a single EC2 instance which will be used as the base for an on demand
+autoscaling group. To create the stack:
+
+```
+$ bundle exec sfn create STACK_NAME_PROCESSOR --file jackal_cfn
+```
+
+### Using the jackal-cfn processor
+
+This [SparklePack][2] includes an example template that uses the `OrchestrationUnit`
+resource to read the contents of a file on the running processor instance. The
+contents of the file is a JSON serialized Hash that includes the ID of the
+current stack. The example stack will return the full result as well as the
+specific `"OriginStack"` value in the outputs:
+
+```
+$ bundle exec sfn create STACK_NAME_EXAMPLE --file jackal_usage_example --apply-stack STACK_NAME_PROCESSOR
+```
+
+### All in one
+
+The templates in this [SparklePack][2] support nesting. To create a single stack
+that includes the `jackal_cfn` template and the `jackal_usage_example` template,
+create a new local template:
+
+```ruby
+# ./sparkleformation/full_jackal.rb
+
+SparkleFormation.new(:full_jackal) do
+  nest!(:jackal_cfn)
+  nest!(:jackal_usage_example)
+end
+```
+
+And create the nested stacks:
+
+```
+$ bundle exec sfn create STACK_NAME_ALL --file full_stack
+```
+
+## Info
+
+* Repository: https://github.com/carnivore-rb/sparkle-pack-jackal-cfn
+* Jackal CFN: https://github.com/carnivore-rb/jackal-cfn
+* SparkleFormation: http://www.sparkleformation.io
+* IRC: Freenode @ #carnivore
+
+[1]: http://www.sparkleformation.io/
+[2]: http://www.sparkleformation.io/docs/sparkle_formation/sparkle-packs.html
+[3]: https://github.com/carnivore-rb/jackal-cfn
+[4]: http://www.sparkleformation.io/docs/guides/getting-started.html

data/lib/sparkle-pack-jackal-cfn.rb

@@ -0,0 +1,3 @@
+require 'sparkle_formation'
+
+SparkleFormation::SparklePack.register!

data/lib/sparkleformation/dynamics/ami_manager.rb

@@ -0,0 +1,8 @@
+SparkleFormation.dynamic(:ami_manager) do |name, args={}|
+  resources.set!("#{name}_ami_manager".to_sym) do
+    type 'Custom::AmiManager'
+    properties do
+      service_token args.fetch(:service_token, ref!(:jackal_service_token))
+    end
+  end
+end

data/lib/sparkleformation/dynamics/ami_register.rb

@@ -0,0 +1,8 @@
+SparkleFormation.dynamic(:ami_register) do |name, args={}|
+  resources.set!("#{name}_ami_register".to_sym) do
+    type 'Custom::AmiRegister'
+    properties do
+      service_token args.fetch(:service_token, ref!(:jackal_service_token))
+    end
+  end
+end

data/lib/sparkleformation/dynamics/hash_extractor.rb

@@ -0,0 +1,8 @@
+SparkleFormation.dynamic(:hash_extractor) do |name, args={}|
+  resources.set!("#{name}_hash_extractor".to_sym) do
+    type 'Custom::HashExtractor'
+    properties do
+      service_token args.fetch(:service_token, ref!(:jackal_service_token))
+    end
+  end
+end

data/lib/sparkleformation/dynamics/jackal_image.rb

@@ -0,0 +1,84 @@
+SparkleFormation.dynamic(:jackal_image) do |name, opts={}|
+
+  ec2_required_info = [:image_id, :key_name, :instance_type]
+
+  ec2_required_info.each do |req_value|
+    unless(opts[req_value])
+      parameters.set!("#{name}_#{req_value}".to_sym).type 'String'
+    end
+  end
+
+  unless(opts[:service_token])
+    parameters.jackal_service_token.type 'String'
+  end
+
+  base_instance = dynamic!(:ec2_instance, "#{name}_jackal_image".to_sym) do
+    properties do
+      ec2_required_info.each do |req_value|
+        set!(req_value, opts.fetch(req_value, ref!("#{name}_#{req_value}".to_sym)))
+      end
+      if(opts[:user_data])
+        user_data opts[:user_data]
+      else
+        user_data base64!(
+          join!(
+            "#!/bin/bash\n",
+            "apt-get update\n",
+            "apt-get -y install python-setuptools\n",
+            "easy_install https://s3.amazonaws.com/cloudformation-examples/aws-cfn-bootstrap-latest.tar.gz\n",
+            '/usr/local/bin/cfn-init -v --region ',
+            region!,
+            ' -s ',
+            stack_name!,
+            " -r #{resource_name!}\n",
+            "cfn-signal -e $? -r 'Provision complete' --resource #{resource_name!} --region ",
+            region!,
+            ' --stack ',
+            stack_name!
+          )
+        )
+      end
+    end
+    unless(opts[:user_data])
+      creation_policy.resource_signal do
+        count 1
+        timeout 'PT30M'
+      end
+    end
+  end
+
+  resources.set!("#{name}_jackal_image".to_sym) do
+    type 'Custom::AmiRegister'
+    properties do
+      service_token opts.fetch(:service_token, ref!(:jackal_service_token))
+      parameters do
+        name join!(
+          "jackal-image-#{name}",
+          opts.fetch(
+            :image_instance_id,
+            ref!("#{name}_jackal_image_ec2_instance".to_sym)
+          ),
+          stack_name!,
+          :options => {
+            :delimiter => '-'
+          }
+        )
+        instance_id opts.fetch(
+          :image_instance_id,
+          ref!("#{name}_jackal_image_ec2_instance".to_sym)
+        )
+        region region!
+        description opts.fetch(
+          :image_description,
+          "Jackal Generated Image (#{name})"
+        )
+        no_reboot opts.fetch(:no_reboot, true)
+      end
+    end
+  end
+
+  outputs.set!("#{name}_ami_id".to_sym).value attr!("#{name}_jackal_image", :ami_id)
+
+  base_instance
+
+end

data/lib/sparkleformation/dynamics/jackal_stack.rb

@@ -0,0 +1,8 @@
+SparkleFormation.dynamic(:jackal_stack) do |name, args={}|
+  resources.set!("#{name}_jackal_stack".to_sym) do
+    type 'Custom::JackalStack'
+    properties do
+      service_token args.fetch(:service_token, ref!(:jackal_service_token))
+    end
+  end
+end

data/lib/sparkleformation/dynamics/orchestration_unit.rb

@@ -0,0 +1,8 @@
+SparkleFormation.dynamic(:orchestration_unit) do |name, args={}|
+  resources.set!("#{name}_orchestration_unit".to_sym) do
+    type 'Custom::OrchestrationUnit'
+    properties do
+      service_token args.fetch(:service_token, ref!(:jackal_service_token))
+    end
+  end
+end

data/lib/sparkleformation/jackal_bus.rb

@@ -0,0 +1,46 @@
+SparkleFormation.new(:jackal_bus) do
+
+  AWSTemplateFormatVersion '2010-09-09'
+  description 'Jackal CFN Bus'
+
+  dynamic!(:sqs_queue, :jackal)
+
+  dynamic!(:sns_topic, :jackal) do
+    properties.subscription array!(
+      ->{
+        endpoint attr!(:jackal_sqs_queue, :arn)
+        protocol 'sqs'
+      }
+    )
+  end
+
+  dynamic!(:sqs_queue_policy, :jackal) do
+    properties do
+      policy_document do
+        version '2012-10-17'
+        id 'jackal-sns-policy'
+        statement array!(
+          ->{
+            sid 'jackal-sns-access'
+            effect 'Allow'
+            principal '*'
+            action ['sqs:SendMessage']
+            resource '*'
+            condition.arnEquals.set!('aws:SourceArn', ref!(:jackal_sns_topic))
+
+          }
+        )
+      end
+      queues [ref!(:jackal_sqs_queue)]
+    end
+  end
+
+  outputs do
+    jackal_service_token.value ref!(:jackal_sns_topic)
+    jackal_sns_arn.value ref!(:jackal_sns_topic)
+    jackal_sns_topic.value attr!(:jackal_sns_topic, :topic_name)
+    jackal_sqs_arn.value attr!(:jackal_sqs_queue, :arn)
+    jackal_sqs_http.value ref!(:jackal_sqs_queue)
+    jackal_sqs_queue_name.value attr!(:jackal_sqs_queue, :queue_name)
+  end
+end

data/lib/sparkleformation/jackal_cfn.rb

@@ -0,0 +1,371 @@
+SparkleFormation.new(:jackal_cfn, :inherit => :jackal_bus) do
+
+  description 'Jackal CFN'
+
+  parameters do
+    jackal_max_cluster_size do
+      type 'Number'
+      value 2
+    end
+    jackal_custom_packages do
+      type 'CommaDelimitedList'
+      default 'bash,jq'
+    end
+    networking_vpc_id do
+      type 'String'
+      default 'none'
+    end
+    networking_subnet_ids do
+      type 'CommaDelimitedList'
+      default 'none'
+    end
+  end
+
+  mappings do
+    config do
+      flavor do
+        classic 'm1.small'
+        vpc 't2.micro'
+      end
+      set!('ap-northeast-1'.disable_camel!) do
+        classic_ami_id 'ami-d5665cbb'
+        vpc_ami_id 'ami-41675d2f'
+      end
+      set!('ap-southeast-1'.disable_camel!) do
+        classic_ami_id 'ami-5a6fa039'
+        vpc_ami_id 'ami-5e6ea13d'
+      end
+      set!('ap-southeast-2'.disable_camel!) do
+        classic_ami_id 'ami-d2d8fcb1'
+        vpc_ami_id 'ami-8cdafeef'
+      end
+      set!('cn-north-1'.disable_camel!) do
+        classic_ami_id 'ami-d97db4b4'
+        vpc_ami_id 'ami-3378b15e'
+      end
+      set!('eu-central-1'.disable_camel!) do
+        classic_ami_id 'ami-15f6ee79'
+        vpc_ami_id 'ami-acf4ecc0'
+      end
+      set!('sa-east-1'.disable_camel!) do
+        classic_ami_id 'ami-6219990e'
+        vpc_ami_id 'ami-1c1b9b70'
+      end
+      set!('eu-west-1'.disable_camel!) do
+        classic_ami_id 'ami-6d70c61e'
+        vpc_ami_id 'ami-bf72c4cc'
+      end
+      set!('us-east-1'.disable_camel!) do
+        classic_ami_id 'ami-59d6f933'
+        vpc_ami_id 'ami-20d3fc4a'
+      end
+      set!('us-west-1'.disable_camel!) do
+        classic_ami_id 'ami-cd2056ad'
+        vpc_ami_id 'ami-842355e4'
+      end
+      set!('us-west-2'.disable_camel!) do
+        classic_ami_id 'ami-a1c721c1'
+        vpc_ami_id 'ami-25c52345'
+      end
+      set!('us-gov-west-1'.disable_camel!) do
+        classic_ami_id 'ami-ecbbd9cf'
+        vpc_ami_id 'ami-d6bbd9f5'
+      end
+    end
+  end
+
+  conditions.vpc_enabled not!(equals!(ref!(:networking_vpc_id), 'none'))
+
+  dynamic!(:ec2_security_group, :jackal) do
+    properties do
+      group_description 'Jackal compute security group'
+      vpc_id if!(:vpc_enabled, ref!(:networking_vpc_id), no_value!)
+      security_group_ingress array!(
+        ->{
+          ip_protocol 'tcp'
+          from_port 22
+          to_port 22
+          cidr_ip '0.0.0.0/0'
+        }
+      )
+    end
+  end
+
+  dynamic!(:iam_user, :jackal).properties do
+    path '/'
+    policies array!(
+      ->{
+        policy_name 'service-access'
+        policy_document.statement array!(
+          ->{
+            effect 'Allow'
+            action '*'
+            resource '*'
+          }
+        )
+      }
+    )
+  end
+
+  dynamic!(:iam_access_key, :jackal).properties.user_name ref!(:jackal_iam_user)
+
+  dynamic!(:jackal_image, :jackal_cfn,
+    :image_id => if!(:vpc_enabled, map!(:config, region!, :vpc_ami_id), map!(:config, region!, :classic_ami_id)),
+    :instance_type => if!(:vpc_enabled, map!(:config, 'Flavor', :vpc), map!(:config, 'Flavor', :classic)),
+    :service_token => ref!(:jackal_sns_topic)
+  ) do
+    properties do
+      security_groups [ref!(:jackal_ec2_security_group)]
+      network_interfaces if!(
+        :vpc_enabled,
+        array!(
+          -> {
+            device_index 0
+            associate_public_ip_address 'true'
+            subnet_id select!(0, ref!(:networking_subnet_ids))
+          }
+        ),
+        []
+      )
+    end
+    metadata('AWS::CloudFormation::Init') do
+      camel_keys_set!(:auto_disable)
+      config do
+        files('/etc/jackal/configuration.json') do
+          content do
+            jackal do
+              require [
+                'carnivore-sqs',
+                'jackal-cfn'
+              ]
+              cfn do
+                sources do
+                  input do
+                    type :sqs
+                    args do
+                      fog do
+                        aws_access_key_id ref!(:jackal_iam_access_key)
+                        aws_secret_access_key attr!(:jackal_iam_access_key, :secret_access_key)
+                        region region!
+                      end
+                      queues [
+                        ref!(:jackal_sqs_queue)
+                      ]
+                    end
+                  end
+                end
+                config do
+                  reprocess true
+                  ami.credentials.compute do
+                    aws_access_key_id ref!(:jackal_iam_access_key)
+                    aws_secret_access_key attr!(:jackal_iam_access_key, :secret_access_key)
+                    region region!
+                  end
+                  jackal_stack do
+                    credentials do
+                      storage do
+                        aws_access_key_id ref!(:jackal_iam_access_key)
+                        aws_secret_access_key attr!(:jackal_iam_access_key, :secret_access_key)
+                      end
+                      us_west_1 do
+                        provider "aws"
+                        aws_access_key_id ref!(:jackal_iam_access_key)
+                        aws_secret_access_key attr!(:jackal_iam_access_key, :secret_access_key)
+                        aws_region 'us-west-1'
+                      end
+                    end
+                  end
+                end
+                callbacks [
+                  'Jackal::Cfn::Resource',
+                  'Jackal::Cfn::AmiRegister',
+                  'Jackal::Cfn::AmiManager',
+                  'Jackal::Cfn::JackalStack',
+                  'Jackal::Cfn::OrchestrationUnit'
+                ]
+              end
+            end
+          end
+        end
+        files('/etc/init.d/jackal') do
+          content "#!/bin/sh\nstart-stop-daemon --start --oknodo --user jackal --pidfile /var/run/jackal.pid --make-pidfile --chuid jackal --background --exec /bin/bash -- -c 'jackal -c /etc/jackal > /opt/jackal/run.log 2>&1'\n"
+          mode '000755'
+        end
+        files('/jackal-example.json') do
+          content.set!('OriginStack', stack_id!)
+        end
+        users.jackal.homeDir '/opt/jackal'
+        commands('00_ntp_sync') do
+          command 'apt-get install ntpdate -qy && ntpdate -b -s pool.ntp.org'
+        end
+        commands('01_jackal_directory') do
+          command 'mkdir /opt/jackal && chown jackal /opt/jackal'
+        end
+        commands('02_custom_packages') do
+          command join!(
+            'apt-get install -yq ',
+            join!(
+              ref!(:jackal_custom_packages),
+              :options => {
+                :delimiter => ' '
+              }
+            )
+          )
+          ignoreErrors 'true'
+        end
+        commands('02_software_properties_old') do
+          command 'apt-get install -yq python-software-properties'
+          ignoreErrors 'true'
+        end
+        commands('02_software_properties_new') do
+          command 'apt-get install -yq software-properties-common'
+          ignoreErrors 'true'
+        end
+        commands('03_add_repository') do
+          command 'apt-add-repository ppa:brightbox/ruby-ng -y'
+        end
+        commands('04_apt_reupdate') do
+          command 'apt-get update'
+        end
+        commands('05_ruby_install') do
+          command 'apt-get install -qy ruby2.2 ruby2.2-dev libyajl-dev build-essential libcurl3-dev libxslt1-dev libxml2 zlib1g-dev awscli'
+        end
+        commands('06_jackal_install') do
+          command 'gem install --no-document jackal-cfn carnivore-sqs'
+        end
+        commands('07_jackal_startup') do
+          command '/etc/init.d/jackal start'
+        end
+        commands('08_pause_for_file_stabilization') do
+          command 'sleep 180'
+        end
+        commands('09_notify_complete') do
+          command join!(
+            "cfn-signal -e 0 -r 'Provision complete' --resource #{resource_name!} --region ",
+            region!,
+            ' --stack ',
+            stack_name!
+          )
+        end
+        commands('10_pause_for_dramatic_effect') do
+          command 'sleep 3500'
+        end
+        commands('11_kill_self') do
+          command join!(
+            'aws ec2 terminate-instances --instance-ids `curl -s http://169.254.169.254/latest/meta-data/instance-id` --region ',
+            region!
+          )
+          env do
+            set!('AWS_ACCESS_KEY_ID', ref!(:jackal_iam_access_key))
+            set!('AWS_SECRET_ACCESS_KEY', attr!(:jackal_iam_access_key, :secret_access_key))
+          end
+        end
+      end
+    end
+  end
+
+  dynamic!(:auto_scaling_launch_configuration, :jackal) do
+    properties do
+      image_id attr!(:jackal_cfn_jackal_image, :ami_id)
+      key_name ref!(:jackal_cfn_key_name)
+      instance_type if!(:vpc_enabled, map!(:config, 'Flavor', :vpc), map!(:config, 'Flavor', :classic))
+      security_groups [ref!(:jackal_ec2_security_group)]
+      user_data base64!(
+        join!(
+          "#!/bin/bash\n",
+          '/usr/local/bin/cfn-init -v --region ',
+          region!,
+          ' -s ',
+          stack_name!,
+          " -r #{resource_name!}"
+        )
+      )
+    end
+    metadata('AWS::CloudFormation::Init') do
+      camel_keys_set!(:auto_disable)
+      config do
+        files('/usr/local/bin/suicider') do
+          content join!(
+            "#!/bin/bash\n",
+            "while true\ndo\nsleep 3500\n",
+            "tail -n 1 /opt/jackal/run.log | grep 'no message received'\n",
+            "if [ $? -eq 0 ]\nthen\n",
+            'AWS_ACCESS_KEY_ID="',
+            ref!(:jackal_iam_access_key),
+            '" AWS_SECRET_ACCESS_KEY="',
+            attr!(:jackal_iam_access_key, :secret_access_key),
+            '" aws autoscaling terminate-instance-in-autoscaling-group --should-decrement-desired-capacity --instance-id `curl -s http://169.254.169.254/latest/meta-data/instance-id` --region ',
+            region!,
+            "\nexit 0\nfi\ndone\n"
+          )
+          mode '000700'
+        end
+        commands('00_jackal_init') do
+          command '/etc/init.d/jackal start'
+        end
+        commands('01_suicider') do
+          command 'nohup bash -c /usr/local/bin/suicider &'
+        end
+      end
+    end
+  end
+
+  dynamic!(:auto_scaling_group, :jackal) do
+    properties do
+      cooldown 500
+      max_size ref!(:jackal_max_cluster_size)
+      min_size 0
+      availability_zones if!(:vpc_enabled, no_value!, azs!)
+      VPCZoneIdentifier if!(:vpc_enabled, ref!(:networking_subnet_ids), no_value!)
+      launch_configuration_name ref!(:jackal_auto_scaling_launch_configuration)
+    end
+  end
+
+  dynamic!(:auto_scaling_scaling_policy, :jackal) do
+    properties do
+      adjustment_type 'ChangeInCapacity'
+      auto_scaling_group_name ref!(:jackal_auto_scaling_group)
+      cooldown 600
+      scaling_adjustment 1
+    end
+  end
+
+  dynamic!(:cloud_watch_alarm, :jackal) do
+    properties do
+      actions_enabled true
+      alarm_actions [ref!(:jackal_auto_scaling_scaling_policy)]
+      alarm_description 'Jackal Kickstart'
+      comparison_operator 'GreaterThanOrEqualToThreshold'
+      evaluation_periods 2
+      metric_name 'ApproximateNumberOfMessagesVisible'
+      namespace 'AWS/SQS'
+      dimensions array!(
+        ->{
+          name 'QueueName'
+          value attr!(:jackal_sqs_queue, :queue_name)
+        }
+      )
+      period 60
+      statistic 'Average'
+      threshold 1
+    end
+  end
+
+  resources.jackal_image_cleanup do
+    type 'Custom::AmiManager'
+    depends_on!(
+      :jackal_cloud_watch_alarm,
+      :jackal_sqs_queue_policy,
+      :jackal_auto_scaling_scaling_policy,
+      :jackal_auto_scaling_group
+    )
+    properties do
+      service_token ref!(:jackal_sns_topic)
+      parameters do
+        ami_id attr!(:jackal_cfn_jackal_image, :ami_id)
+        region region!
+      end
+    end
+  end
+
+end

data/lib/sparkleformation/jackal_usage_example.rb

@@ -0,0 +1,15 @@
+SparkleFormation.new(:jackal_cfn_usage_example) do
+
+  AWSTemplateFormatVersion '2010-09-09'
+  description 'Jackal CFN Example Usage'
+
+  parameters.jackal_service_token.type 'String'
+
+  dynamic!(:orchestration_unit, :example).properties.parameters.exec 'cat /jackal-example.json'
+
+  outputs do
+    full_result.value attr!(:example_orchestration_unit, :orchestration_unit_result)
+    key_result.value attr!(:example_orchestration_unit, :origin_stack)
+  end
+
+end

data/sparkle-pack-jackal-cfn.gemspec

@@ -0,0 +1,13 @@
+Gem::Specification.new do |s|
+  s.name = 'sparkle-pack-jackal-cfn'
+  s.version = '0.1.0'
+  s.summary = 'Jackal CFN compute stacker'
+  s.author = 'Chris Roberts'
+  s.email = 'chrisroberts.code@gmail.com'
+  s.homepage = 'http://github.com/carnivore-rb/sparkle-pack-jackal-cfn'
+  s.description = 'SparkleFormation pack for generating Jackal CFN compute stack'
+  s.license = 'Apache-2.0'
+  s.require_path = 'lib'
+  s.add_runtime_dependency 'sparkle_formation', '>= 2.1.0'
+  s.files = Dir['{lib,docs}/**/*'] + %w(sparkle-pack-jackal-cfn.gemspec README.md CHANGELOG.md LICENSE)
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification
+name: sparkle-pack-jackal-cfn
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Chris Roberts
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-02-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sparkle_formation
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+description: SparkleFormation pack for generating Jackal CFN compute stack
+email: chrisroberts.code@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/sparkle-pack-jackal-cfn.rb
+- lib/sparkleformation/dynamics/ami_manager.rb
+- lib/sparkleformation/dynamics/ami_register.rb
+- lib/sparkleformation/dynamics/hash_extractor.rb
+- lib/sparkleformation/dynamics/jackal_image.rb
+- lib/sparkleformation/dynamics/jackal_stack.rb
+- lib/sparkleformation/dynamics/orchestration_unit.rb
+- lib/sparkleformation/jackal_bus.rb
+- lib/sparkleformation/jackal_cfn.rb
+- lib/sparkleformation/jackal_usage_example.rb
+- sparkle-pack-jackal-cfn.gemspec
+homepage: http://github.com/carnivore-rb/sparkle-pack-jackal-cfn
+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.4.8
+signing_key: 
+specification_version: 4
+summary: Jackal CFN compute stacker
+test_files: []
+has_rdoc: