stackit 0.3.6 → 0.3.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 373ce527c2a053aa1489bf77aebee2f0697c96dd
-  data.tar.gz: ad0332111443fb1ef5557abf486d844613a2364d
+  metadata.gz: adce33d2a5ecead93eae89893531c47e182a84a3
+  data.tar.gz: 4ee05a5601797cb3295088cd6cb8baaf42a8c9b7
 SHA512:
-  metadata.gz: e9537d7b1bc44e76f2d473dedfbc774e7b1fda5f4ed660361f81d1257728f3a22a26f47e60de2f8557e560e59f7d36c5b6df801a3e50e2311ebe46e932667afb
-  data.tar.gz: 2e4d16c31fe74147fc8efae5b3adc78bca7525c4295c35378870fd14ebff8f685150ed1e4685f9c62adb0735ab778e7c864990764a491ac305e7b3c5e4ecbcfe
+  metadata.gz: 5107099dbd1473014f413162c3a9af3ab72fc4109bfbdd25312c19914d171dae755805b6c883c575b8ada07f409aeb54478a4d1544ce8c42625ab05ce4a748d6
+  data.tar.gz: 2246c6937dcf7c5f9e5c25c489bcde5274ad3761a8a51ab2e6d1f02323f60af0857948e72ff7413f010ff03063e31aaecba176d040e68c65ea120edde06d6da9

data/README.md

@@ -42,7 +42,7 @@ File parameters work just like the default AWS CLI parameters file. Simply speci
 
 ##### Existing CloudFormation Stacks
 
-Your stack can `--depend` on existing stacks. Any resource, output, or parameter whose ID matches a parameter key in the template will automatically have it's value passed into the stack during management.
+Your stack can `--depends` on existing stacks. Any resource, output, or parameter whose ID matches a parameter key in the template will automatically have it's value passed into the stack during creation/update.
 
 > Parameter values mapped using `--depends` override parameters defined in the parameter file.
 
@@ -95,7 +95,7 @@ You may optionally map parameters that don't have matching keys. For example, le
 
 ### Library
 
-StackIT can be used as library in your own automation tools.
+StackIT can be used as a library in your own automation tools.
 
 ```ruby
   ManagedStack.new({
@@ -109,6 +109,63 @@ StackIT can be used as library in your own automation tools.
   }).create!
 ```
 
+```ruby
+module MyToolkit::MyStack
+
+  class Service < Stackit::OpsWorksManagedStackService
+
+    def initialize(options = {})
+      super(options)
+    end
+
+    def stack_name
+      options[:stack_name] || "#{Stackit.environment}-mystack"
+    end
+
+    def template
+      options[:template] || "#{Stackit.home}/mytoolkit/mystack/template.json"
+    end
+
+    def user_defined_parameters
+      {
+        :StackEnvironment => Stackit.environment,
+        :KeyPair => "#{Stackit.environment}-myapp",
+        :OpsWorksStackName => stack_name,
+        :OpsWorksServiceRoleArn => opsworks_service_role_arn,
+        :UseOpsworksSecurityGroups => "false",
+        :OpsWorksDefaultOs => "Amazon Linux 2016.03",
+        :OpsWorksDefaultRootDeviceType => 'ebs',
+        :OpsWorksConfigureRunlist => "mycookbook::configure",
+        :OpsWorksDeployRunlist => "mycookbook::deploy",
+        :OpsWorksSetupRunlist => "mycookbook::setup",
+        :OpsWorksShutdownRunlist => "mycookbook::shutdown",
+        :OpsWorksUndeployRunlist => "mycookbook::undeploy",
+        :S3CookbookSource => 'https://s3.amazonaws.com/devops-automation/cookbooks.tar.gz',
+        :EbsVolumeType => 'gp2',
+        :EbsVolumeSize => 140 # GB
+      }
+    end
+
+    def opsworks_stack_id
+      Stackit::ParameterResolver.new(stack).resolve(:OpsWorksStack)
+    end
+
+    def opsworks_layer_id
+      Stackit::ParameterResolver.new(stack).resolve(:OpsWorksLayer)
+    end
+
+  end
+end
+
+service = MyToolkit::MyStack::Service.new
+service.create! # creates the stack
+service.update! # updates the stack
+service.delete! # deletes the stack
+
+```
+
+At this point, you may be interested in my [awskit](https://github.com/jeremyhahn/awskit) project that generates a DevOps toolkit based on stackit.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/stackit/version.rb

@@ -1,3 +1,3 @@
 module Stackit
-  VERSION = "0.3.6"
+  VERSION = "0.3.7"
 end

data/stackit.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |spec|
   spec.email         = ["mail@jeremyhahn.com"]
 
   spec.summary       = %q{Simple, elegant CloudFormation dependency management.}
-  spec.description   = %q{Use existing stack values (output, resource, or parameters) as input parmeters to CloudFormation templates.}
+  spec.description   = %q{CloudFormation stack management and instance provisioning toolkit for AWS. Provides dynamic parameter mapping and the ability to pass existing stack values (output, resource, or parameters) as input parameters to templates. Supports multiple AWS environments.}
   spec.homepage      = "https://github.com/jeremyhahn/stackit"
   spec.license       = "GPLv3"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stackit
 version: !ruby/object:Gem::Version
-  version: 0.3.6
+  version: 0.3.7
 platform: ruby
 authors:
 - Jeremy Hahn
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-06-06 00:00:00.000000000 Z
+date: 2016-06-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -122,8 +122,10 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.2'
-description: Use existing stack values (output, resource, or parameters) as input
-  parmeters to CloudFormation templates.
+description: CloudFormation stack management and instance provisioning toolkit for
+  AWS. Provides dynamic parameter mapping and the ability to pass existing stack values
+  (output, resource, or parameters) as input parameters to templates. Supports multiple
+  AWS environments.
 email:
 - mail@jeremyhahn.com
 executables: []