admiral-cloudformation 0.0.2

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+sublime.sublime-*

data/.ruby-version

@@ -0,0 +1 @@
+1.9.3-p547

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in admiral.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Peter T. Brown
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,79 @@
+# Admiral for AWS CloudFormation
+
+An Admiral module that implements tasks for wielding AWS CloudFormation templates. Use it to manage CloudFormation templates and their parameters.
+
+## Installation
+
+Add this line to your application's Gemfile (recommended):
+
+    gem 'admiral-cloudformation'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install admiral-cloudformation
+
+## Usage
+
+On your command line type:
+
+    $ admiral cf help
+
+To see a list of available commands. Make sure your bundle bin is in your PATH.
+
+The following commands are available:
+
+```
+Commands:
+  admiral cf create          # Create new CloudFormation stack for environment.
+  admiral cf destroy         # Destroy the existing CloudFormation stack.
+  admiral cf help [COMMAND]  # Describe subcommands or one specific subcommand
+  admiral cf update          # Update the existing CloudFormation stack
+
+Options:
+  --env, [--environment=ENVIRONMENT]  # The environment (e.g. staging or production). Can also be specified with ADMIRAL_ENV.
+                                      # Default: production
+      [--template=TEMPLATE]           # Path to CloudFormation JSON template.
+                                      # Default: CloudFormation.template
+      [--params=PARAMS]               # Path to override parameter definitions file. Defaults to <environment>.json
+```
+
+# Setup and Configuration
+
+Admiral CloudFormation is designed around the concept of deployment environments. You parameterize your CloudFormation templates, then encode specific parameter values in JSON files for each distinct environment.
+
+For example you may have CloudFormation templates for your database servers and your web application servers, and distinct configurations for production, staging and test environments.
+
+CloudFormation provides a facility to parameterize templates via the [`Parameters`](http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html) section. For example:
+
+```javascript
+  ...
+  "InstanceType": {
+      "Description": "The type of instance to launch.",
+      "Type": "String",
+      "Default": "t2.small"
+  },
+  ...
+```
+
+Admiral CloudFormation let's you specify specific values. For example:
+
+```javascript
+  {
+    "InstanceCount":"2",
+    "InstanceType": "t2.medium",
+  }
+```
+
+## Examples
+
+To create a new CloudFormation stack (and its associated resources) using a staging configuration:
+
+      $ admiral cf create --environment staging --template ./CloudFormation.template
+
+# CloudFormation Templates
+
+Example CloudFormation templates for ElasticSearch, Meteor and MongoDB are included in the `examples` directory.

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/admiral.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |spec|
+  spec.name          = "admiral-cloudformation"
+  spec.version       = '0.0.2'
+  spec.authors       = ["Peter T. Brown"]
+  spec.email         = ["p@ptb.io"]
+  spec.description   = %q{An Admiral module that implements tasks for wielding AWS CloudFormation templates. Use it to manage CloudFormation templates and their parameters.}
+  spec.summary       = %q{A command line tool for wielding cloudformation templates.}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_dependency 'aws-sdk', '< 2'
+  spec.add_dependency 'thor', '~> 0.19'
+  spec.add_dependency 'admiral', '~> 0.0.1'
+end

data/examples/elasticsearch/CloudFormation.template

@@ -0,0 +1,315 @@
+{
+    "AWSTemplateFormatVersion": "2010-09-09",
+    "Parameters": {
+        "CookbookRepo": {
+            "Description": "GitURL",
+            "Type": "String",
+            "Default": "https://github.com/ThoughtWorksStudios/opsworks-elasticsearch-cookbook"
+        },
+
+        "CookbookRepoRevision": {
+            "Description": "Git Revision/Tag",
+            "Type": "String",
+            "Default": "0.0.1"
+        },
+
+        "ElasticSearchVersion": {
+            "Description": "The version of ElasticSearch to install.",
+            "Type": "String",
+            "Default": "1.3.5"
+        },
+
+        "AwsRegion": {
+            "Description": "The AWS region",
+            "Type": "String",
+            "Default": "us-west-2"
+        },
+
+        "ElasticSearchAWSCloudPluginVersion": {
+            "Description": "The version of the ElasticSearch AWS Cloud Plugin to install. Note that this version MUST correspond to the targeted version of ElasticSearch. See https://github.com/elasticsearch/elasticsearch-cloud-aws for the version compatibility table.",
+            "Type": "String",
+            "Default": "2.3.0"
+        },
+
+        "RecipeList": {
+            "Description": "The list of cookbooks to include when setting up the cluster.",
+            "Type": "CommaDelimitedList",
+            "Default":"apt, ark,elasticsearch, elasticsearch::aws, elasticsearch::proxy, java, layer-custom::esplugins, layer-custom::allocation-awareness, layer-custom::esmonit, layer-custom::cloudwatch-custom"
+        },
+
+        "SSLCertificateName": {
+            "Description": "The SSL certificate.",
+            "Type": "String"
+        },
+
+        "InstanceCount": {
+            "Description": "Number of nodes to spin up in the cluster. This also configures the `expected_nodes` setting in ElasticSearch, which serves as a hint when the cluster considers shard reallocation.",
+            "Type": "String"
+        },
+
+        "InstanceType": {
+            "Description": "The type of instance to launch.",
+            "Type": "String",
+            "Default": "t2.small"
+        },
+
+        "MinMasterNodes": {
+            "Description": "Number of master eligible nodes visible to a given node before accepting requests. When this criterion is not satisfied, a given node will assume it has split off from from the cluster. This setting this helps avoid a catastrophic split-brain scenario in the cluster. This is typically is set to [N/2 + 1] nodes.",
+            "Type": "String"
+        },
+
+        "SearchUser": {
+            "Description": "username to access the ElasticSearch cluster.",
+            "Type": "String"
+        },
+
+        "SearchPassword": {
+            "Description": "password to access the ElasticSearch cluster.",
+            "Type": "String"
+        },
+
+        "ClusterName": {
+            "Description": "The name of the ElasticSearch cluster.",
+            "Type": "String"
+        },
+
+        "Route53ZoneName": {
+            "Description": "Route53 zone under which to setup the DNS record.",
+            "Type": "String"
+        },
+
+        "SearchDomainName": {
+            "Description": "Domain name to register for the cluster under Route53.",
+            "Type": "String"
+        },
+
+        "SshKeyName": {
+            "Description": "SSH key name for EC2 instances.",
+            "Type": "String"
+        },
+
+        "PaperTrailHost": {
+            "Description": "The PaperTrail endpoint hostname. Only required if you add the papertrail cookbook.",
+            "Type": "String",
+            "Default": "logs.papertrailapp.com"
+        },
+
+        "PaperTrailPort": {
+            "Description": "The PaperTrail endpoint port. Only required if you add the papertrail cookbook.",
+            "Type": "Number",
+            "Default": 0,
+            "MinValue" : "0",
+            "MaxValue" : "65535"
+        },
+
+        "SecurityGroupLoadBalancer": {
+            "Description": "The load balancer security group.",
+            "Type": "String"
+        },
+
+        "SecurityGroupSearchLayer": {
+            "Description": "The search layer security group.",
+            "Type": "String"
+        }
+
+    },
+
+    "Outputs": {
+        "StackId": {
+            "Description": "opsworks stack id ",
+            "Value": { "Ref": "SearchStack"}
+        },
+
+        "LayerId": {
+            "Description": "opsworks search layer id ",
+            "Value": { "Ref": "SearchLayer"}
+        }
+
+    },
+
+    "Resources": {
+
+        "LoadBalancer" : {
+            "Type" : "AWS::ElasticLoadBalancing::LoadBalancer",
+            "Properties" : {
+                "AvailabilityZones" : { "Fn::GetAZs" : "" },
+                "Listeners" : [
+                    {
+                        "LoadBalancerPort" : "443",
+                        "InstancePort" : "80",
+                        "Protocol" : "HTTPS",
+                        "SSLCertificateId": {
+                            "Fn::Join": ["", ["arn:aws:iam::", { "Ref": "AWS::AccountId" }, ":server-certificate/", { "Ref" : "SSLCertificateName" }]]
+                        }
+                    }
+                ],
+                "HealthCheck" : {
+                    "Target" : "TCP:80",
+                    "HealthyThreshold" : "2",
+                    "UnhealthyThreshold" : "8",
+                    "Interval" : "30",
+                    "Timeout" : "20"
+                },
+                "SecurityGroups": [
+                    {"Ref": "SecurityGroupLoadBalancer"}
+                ]
+            }
+        },
+
+        "DNSRecord": {
+            "Type" : "AWS::Route53::RecordSet",
+            "Properties" : {
+                "HostedZoneName" : {"Ref": "Route53ZoneName"},
+                "Type" : "CNAME",
+                "Name" : { "Ref": "SearchDomainName"},
+                "ResourceRecords" : [ {"Fn::GetAtt":["LoadBalancer","DNSName"]}],
+                "TTL" : "30"
+            }
+        },
+
+        "ELBAttachment" : {
+            "Type" : "AWS::OpsWorks::ElasticLoadBalancerAttachment",
+            "Properties" : {
+                "ElasticLoadBalancerName" : { "Ref" : "LoadBalancer" },
+                "LayerId" : { "Ref" : "SearchLayer" }
+            }
+        },
+
+
+        "SearchStack": {
+            "Type": "AWS::OpsWorks::Stack",
+            "Properties": {
+                "Name": {
+                    "Ref": "AWS::StackName"
+                },
+                "CustomJson": {
+                    "java": {
+                        "jdk_version": "7",
+                        "oracle": {
+                            "accept_oracle_download_terms": "true"
+                        },
+                        "accept_license_agreement": "true",
+                        "install_flavor": "oracle"
+                    },
+                    "papertrail": {
+                        "remote_host": { "Ref": "PaperTrailHost" },
+                        "remote_port": { "Ref": "PaperTrailPort" },
+                        "watch_files": [
+                            { "filename": { "Fn::Join": ["", ["/usr/local/var/log/elasticsearch/", { "Ref": "ClusterName" }, ".log"]] }, "tag": "search" },
+                            { "filename": { "Fn::Join": ["", ["/usr/local/var/log/elasticsearch/", { "Ref": "ClusterName" }, "_index_indexing_slowlog.log"]] }, "tag": "indexing-slowlog" },
+                            { "filename": { "Fn::Join": ["", ["/usr/local/var/log/elasticsearch/", { "Ref": "ClusterName" }, "_index_search_slowlog.log"]] }, "tag": "search-slowlog" }
+                        ]
+                    },
+                    "elasticsearch": {
+                        "version": { "Ref": "ElasticSearchVersion" },
+                        "plugins" : {
+                            "elasticsearch/elasticsearch-cloud-aws": {
+                                "version": { "Ref": "ElasticSearchAWSCloudPluginVersion" }
+                            }
+                        },
+                        "nginx": {
+                            "users": [{
+                                "username": { "Ref": "SearchUser" },
+                                "password": { "Ref": "SearchPassword" }
+                            }],
+                            "allow_cluster_api": "true",
+                            "port": 80
+                        },
+                        "cluster": {
+                            "name": { "Ref" : "ClusterName" }
+                        },
+                        "gateway": {
+                            "expected_nodes": { "Ref": "InstanceCount" }
+                        },
+                        "discovery": {
+                            "type": "ec2",
+                            "zen": {
+                                "minimum_master_nodes": { "Ref": "MinMasterNodes" },
+                                "ping": {
+                                    "multicast": {
+                                        "enabled": false
+                                    }
+                                }
+                            },
+                            "ec2": {
+                                "tag": {
+                                    "opsworks:stack": {
+                                        "Ref": "AWS::StackName"
+                                    }
+                                }
+                            }
+                        },
+                        "path": {
+                            "data": "/mnt/elasticsearch-data"
+                        },
+                        "cloud": {
+                            "aws": {
+                                "region": { "Ref": "AwsRegion" }
+                            }
+                        },
+                        "custom_config": {
+                            "cluster.routing.allocation.awareness.attributes": "rack_id",
+                            "index": "\n  analysis:\n    analyzer:\n      default_index:\n        filter:\n        - standard\n        - lowercase\n        - snowball\n        tokenizer: standard\n      default_search:\n        tokenizer: standard\n        filter:\n        - standard\n        - lowercase\n        - snowball\n"
+                        }
+                    }
+                },
+                "ServiceRoleArn": {
+                    "Fn::Join": ["", ["arn:aws:iam::", { "Ref": "AWS::AccountId" }, ":role/aws-opsworks-service-role"]]
+                },
+                "DefaultInstanceProfileArn": {
+                    "Fn::Join": ["", ["arn:aws:iam::", { "Ref": "AWS::AccountId" }, ":instance-profile/aws-opsworks-ec2-role"]]
+                },
+                "ConfigurationManager": {
+                    "Name": "Chef",
+                    "Version": "11.10"
+                },
+                "ChefConfiguration": {
+                    "BerkshelfVersion": "3.1.3",
+                    "ManageBerkshelf": true
+                },
+                "DefaultOs": "Amazon Linux 2015.03",
+                "DefaultRootDeviceType": "ebs",
+                "DefaultSshKeyName": { "Ref": "SshKeyName" },
+                "UseCustomCookbooks": true,
+                "UseOpsworksSecurityGroups": false,
+                "CustomCookbooksSource": {
+                    "Type": "git",
+                    "Url": {
+                        "Ref": "CookbookRepo"
+                    },
+                    "Revision": { "Ref": "CookbookRepoRevision" }
+                }
+            }
+        },
+
+        "SearchLayer": {
+            "Type": "AWS::OpsWorks::Layer",
+            "Properties": {
+                "StackId": {
+                    "Ref": "SearchStack"
+                },
+                "Name": "Search",
+                "Type": "custom",
+                "Shortname": "search",
+                "CustomRecipes": {
+                    "Setup": { "Ref": "RecipeList" }
+                },
+                "EnableAutoHealing": false,
+                "AutoAssignElasticIps": false,
+                "AutoAssignPublicIps": true,
+                "VolumeConfigurations": [
+                    {
+                        "MountPoint": "/mnt/elasticsearch-data",
+                        "NumberOfDisks": 1,
+                        "Size": 200,
+                        "VolumeType": "gp2"
+                    }
+                ],
+                "CustomSecurityGroupIds": [
+                    {"Ref": "SecurityGroupSearchLayer"}
+                ]
+            }
+        }
+
+    }
+}

data/examples/elasticsearch/production.json

@@ -0,0 +1,16 @@
+{
+  "Route53ZoneName": "example.io.",
+  "SearchDomainName": "search.example.io",
+  "SSLCertificateName": "search.example.io",
+  "SshKeyName": "production",
+  "InstanceCount":"2",
+  "InstanceType": "t2.medium",
+  "ElasticSearchVersion": "1.4.4",
+  "ElasticSearchAWSCloudPluginVersion": "2.4.1",
+  "SearchUser":"admin",
+  "SearchPassword":"example-password",
+  "ClusterName": "staging-cluster",
+  "MinMasterNodes": "1",
+  "SecurityGroupLoadBalancer": "sg-8aab365ef",
+  "SecurityGroupSearchLayer": "sg-9e9d35f8"
+}

data/examples/meteor/CloudFormation.template

@@ -0,0 +1,249 @@
+{
+    "AWSTemplateFormatVersion": "2010-09-09",
+    "Parameters": {
+        "CookbookRepo": {
+            "Description": "GitURL",
+            "Type": "String",
+            "Default": "https://github.com/flippyhead/chef-mongodb"
+        },
+
+        "CookbookRepoRevision": {
+            "Description": "Git Revision/Tag",
+            "Type": "String",
+            "Default": "0.0.1"
+        },
+
+        "Route53ZoneName": {
+            "Description": "Route53 zone under which to setup the DNS record.",
+            "Type": "String"
+        },
+
+        "AppDomainName": {
+            "Description": "Domain name to register for the app under Route53.",
+            "Type": "String"
+        },
+
+        "SSLCertificateName": {
+            "Description": "The SSL certificate.",
+            "Type": "String"
+        },
+
+        "SshKeyName": {
+            "Description": "SSH key name for EC2 instances.",
+            "Type": "String"
+        },
+
+        "InstanceCount": {
+            "Description": "The number of instances to launch.",
+            "Type": "Number",
+            "Default": 1
+        },
+
+        "InstanceType": {
+            "Description": "The type of instance to launch.",
+            "Type": "String",
+            "Default": "t2.small"
+        },
+
+        "SecurityGroupLoadBalancer": {
+            "Description": "The load balancer security group.",
+            "Type": "String"
+        },
+
+        "SecurityGroupMeteorLayer": {
+            "Description": "The meteor layer security group.",
+            "Type": "String"
+        }
+
+    },
+
+    "Outputs": {
+        "StackId": {
+            "Description": "opsworks stack id ",
+            "Value": { "Ref": "MeteorStack"}
+        },
+
+        "LayerId": {
+            "Description": "opsworks search layer id ",
+            "Value": { "Ref": "MeteorLayer"}
+        },
+
+        "PrimaryAppId": {
+            "Description": "fetching app id ",
+            "Value": { "Ref": "FetchingApp"}
+        },
+
+         "SecondaryAppId": {
+            "Description": "exporter app id ",
+            "Value": { "Ref": "FetchingExporter"}
+        }
+
+    },
+
+    "Resources": {
+
+        "LoadBalancer" : {
+            "Type" : "AWS::ElasticLoadBalancing::LoadBalancer",
+            "Properties" : {
+                "AvailabilityZones" : { "Fn::GetAZs" : "" },
+                "Listeners" : [
+                    {
+                        "LoadBalancerPort" : "443",
+                        "InstancePort" : "80",
+                        "Protocol" : "SSL",
+                        "SSLCertificateId": {
+                            "Fn::Join": ["", ["arn:aws:iam::", { "Ref": "AWS::AccountId" }, ":server-certificate/", { "Ref" : "SSLCertificateName" }]]
+                        }
+                    },
+                    {
+                        "LoadBalancerPort" : "80",
+                        "InstancePort" : "80",
+                        "Protocol" : "HTTP"
+                    }
+                ],
+                "HealthCheck" : {
+                    "Target" : "TCP:80",
+                    "HealthyThreshold" : "2",
+                    "UnhealthyThreshold" : "8",
+                    "Interval" : "30",
+                    "Timeout" : "20"
+                },
+                "SecurityGroups": [
+                    {"Ref": "SecurityGroupLoadBalancer"}
+                ]
+            }
+        },
+
+        "DNSRecord": {
+            "Type" : "AWS::Route53::RecordSet",
+            "Properties" : {
+                "HostedZoneName" : {"Ref": "Route53ZoneName"},
+                "Type" : "CNAME",
+                "Name" : { "Ref": "AppDomainName"},
+                "ResourceRecords" : [ {"Fn::GetAtt":["LoadBalancer","DNSName"]}],
+                "TTL" : "30"
+            }
+        },
+
+        "ELBAttachment" : {
+            "Type" : "AWS::OpsWorks::ElasticLoadBalancerAttachment",
+            "Properties" : {
+                "ElasticLoadBalancerName" : { "Ref" : "LoadBalancer" },
+                "LayerId" : { "Ref" : "MeteorLayer" }
+            }
+        },
+
+        "MeteorStack": {
+            "Type": "AWS::OpsWorks::Stack",
+            "Properties": {
+                "Name": {
+                    "Ref": "AWS::StackName"
+                },
+                "CustomJson": {
+                    "opsworks_nodejs":{
+                        "version":"0.10.38"
+                    },
+                    "deploy": {
+                        "primary-app": {
+                            "nodejs": {
+                                "port": 80
+                            },
+                            "environment_variables": {
+                                "METEOR_SETTINGS": "{}"
+                            }
+                        },
+                        "secondary-app": {
+                            "nodejs": {
+                                "port": 8081
+                            },
+                            "environment_variables": {
+                                "METEOR_SETTINGS": "{}"
+                            }
+                        }
+                    }
+                },
+                "ServiceRoleArn": {
+                    "Fn::Join": ["", ["arn:aws:iam::", { "Ref": "AWS::AccountId" }, ":role/aws-opsworks-service-role"]]
+                },
+                "DefaultInstanceProfileArn": {
+                    "Fn::Join": ["", ["arn:aws:iam::", { "Ref": "AWS::AccountId" }, ":instance-profile/aws-opsworks-ec2-role"]]
+                },
+                "ConfigurationManager": {
+                    "Name": "Chef",
+                    "Version": "11.10"
+                },
+                "ChefConfiguration": {
+                    "BerkshelfVersion": "3.1.3",
+                    "ManageBerkshelf": true
+                },
+                "DefaultOs": "Amazon Linux 2015.03",
+                "DefaultRootDeviceType": "ebs",
+                "DefaultSshKeyName": { "Ref": "SshKeyName" },
+                "UseCustomCookbooks": false,
+                "UseOpsworksSecurityGroups": false,
+                "CustomCookbooksSource": {
+                    "Type": "git",
+                    "Url": {
+                        "Ref": "CookbookRepo"
+                    },
+                    "Revision": { "Ref": "CookbookRepoRevision" }
+                }
+            }
+        },
+
+        "MeteorLayer": {
+            "Type": "AWS::OpsWorks::Layer",
+            "Properties": {
+                "StackId": {
+                    "Ref": "MeteorStack"
+                },
+                "Name": "Meteor",
+                "Type": "nodejs-app",
+                "Shortname": "meteor",
+                "EnableAutoHealing": false,
+                "AutoAssignElasticIps": false,
+                "AutoAssignPublicIps": true,
+                "CustomSecurityGroupIds": [
+                    {"Ref": "SecurityGroupMeteorLayer"}
+                ]
+            }
+        },
+
+        "PrimaryApp": {
+            "Type":"AWS::OpsWorks::App",
+            "Properties": {
+                "Type": "nodejs",
+                "Name": "Fetching Application",
+                "Shortname": "fetching-app",
+                "StackId": {
+                    "Ref": "MeteorStack"
+                },
+                "AppSource": {
+                    "Username": "AKDIKDSKSKEWS",
+                    "Password": "x6gYSTr+qDSKDFJSLdksldjfLAKDjdRE8mKi1bAZXm",
+                    "Type": "s3",
+                    "Url":"https://s3-us-west-2.amazonaws.com/primary-builds/primary-app.tar.gz"
+                }
+            }
+        },
+
+        "SecondaryApp": {
+            "Type":"AWS::OpsWorks::App",
+            "Properties": {
+                "Type": "nodejs",
+                "Name": "Fetching Exporter",
+                "Shortname": "fetching-exporter",
+                "StackId": {
+                    "Ref": "MeteorStack"
+                },
+                "AppSource": {
+                    "Username": "AKDIKDSKSKEWS",
+                    "Password": "x6gYSTr+qDSKDFJSLdksldjfLAKDjdRE8mKi1bAZXm",
+                    "Type": "s3",
+                    "Url":"https://s3-us-west-2.amazonaws.com/secondary-builds/secondary-app.tar.gz"
+                }
+            }
+        }
+
+    }
+}

data/examples/meteor/production.json

@@ -0,0 +1,10 @@
+{
+  "Route53ZoneName": "example.io.",
+  "AppDomainName": "app.example.io",
+  "SSLCertificateName": "app.example.io",
+  "SshKeyName": "production",
+  "InstanceCount":"1",
+  "InstanceType": "t2.small",
+  "SecurityGroupLoadBalancer": "sg-8ad62234ef",
+  "SecurityGroupMeteorLayer": "sg-2265dsd7"
+}

data/examples/mongo/CloudFormation.template

@@ -0,0 +1,132 @@
+{
+    "AWSTemplateFormatVersion": "2010-09-09",
+    "Parameters": {
+        "CookbookRepo": {
+            "Description": "GitURL",
+            "Type": "String",
+            "Default": "https://github.com/flippyhead/chef-mongodb"
+        },
+
+        "MongoVersion": {
+            "Description": "The version of MongoDB to install.",
+            "Type": "String",
+            "Default": "2.6.1"
+        },
+
+        "RecipeList": {
+            "Description": "The list of cookbooks to include when setting up the cluster.",
+            "Type": "CommaDelimitedList",
+            "Default": "mongodb::10gen_repo, mongodb::default"
+        },
+
+        "SshKeyName": {
+            "Description": "SSH key name for EC2 instances.",
+            "Type": "String"
+        },
+
+        "InstanceCount": {
+            "Description": "The number of instances to launch.",
+            "Type": "Number",
+            "Default": 1
+        },
+
+        "InstanceType": {
+            "Description": "The type of instance to launch.",
+            "Type": "String",
+            "Default": "t2.small"
+        },
+
+        "SecurityGroupMongoLayer": {
+            "Description": "The mongo layer security group.",
+            "Type": "String"
+        }
+
+    },
+
+    "Outputs": {
+        "StackId": {
+            "Description": "opsworks stack id ",
+            "Value": { "Ref": "MongoStack"}
+        },
+
+        "LayerId": {
+            "Description": "opsworks mongo layer id ",
+            "Value": { "Ref": "MongoLayer"}
+        }
+
+    },
+
+    "Resources": {
+
+        "MongoStack": {
+            "Type": "AWS::OpsWorks::Stack",
+            "Properties": {
+                "Name": {
+                    "Ref": "AWS::StackName"
+                },
+                "CustomJson": {
+                    "mongodb": {
+                        "config":{
+                            "dbpath": "/mnt/mongodb-data"
+                        }
+                    }
+                },
+                "ServiceRoleArn": {
+                    "Fn::Join": ["", ["arn:aws:iam::", { "Ref": "AWS::AccountId" }, ":role/aws-opsworks-service-role"]]
+                },
+                "DefaultInstanceProfileArn": {
+                    "Fn::Join": ["", ["arn:aws:iam::", { "Ref": "AWS::AccountId" }, ":instance-profile/aws-opsworks-ec2-role"]]
+                },
+                "ConfigurationManager": {
+                    "Name": "Chef",
+                    "Version": "11.10"
+                },
+                "ChefConfiguration": {
+                    "BerkshelfVersion": "3.1.3",
+                    "ManageBerkshelf": true
+                },
+                "DefaultOs": "Ubuntu 14.04 LTS",
+                "DefaultRootDeviceType": "ebs",
+                "DefaultSshKeyName": { "Ref": "SshKeyName" },
+                "UseCustomCookbooks": true,
+                "UseOpsworksSecurityGroups": false,
+                "CustomCookbooksSource": {
+                    "Type": "git",
+                    "Url": {
+                        "Ref": "CookbookRepo"
+                    }
+                }
+            }
+        },
+
+        "MongoLayer": {
+            "Type": "AWS::OpsWorks::Layer",
+            "Properties": {
+                "StackId": {
+                    "Ref": "MongoStack"
+                },
+                "Name": "Mongo",
+                "Type": "custom",
+                "Shortname": "mongo",
+                "CustomRecipes": {
+                    "Setup": { "Ref": "RecipeList" }
+                },
+                "EnableAutoHealing": false,
+                "AutoAssignElasticIps": false,
+                "AutoAssignPublicIps": true,
+                "VolumeConfigurations": [
+                    {
+                        "MountPoint": "/mnt/mongodb-data",
+                        "NumberOfDisks": 1,
+                        "Size": 200,
+                        "VolumeType": "gp2"
+                    }
+                ],
+                "CustomSecurityGroupIds": [
+                    {"Ref": "SecurityGroupMongoLayer"}
+                ]
+            }
+        }
+
+    }
+}

data/examples/mongo/production.json

@@ -0,0 +1,7 @@
+{
+  "SshKeyName": "production",
+  "InstanceCount":"1",
+  "InstanceType": "t2.small",
+  "MongoVersion": "2.6.1",
+  "SecurityGroupMongoLayer": "sg-334rt5fc"
+}

data/lib/admiral-cloudformation.rb

@@ -0,0 +1 @@
+require "admiral-cloudformation/tasks"

data/lib/admiral-cloudformation/tasks.rb

@@ -0,0 +1,50 @@
+require 'json'
+require 'thor'
+require 'admiral/base'
+require_relative 'util'
+
+module Admiral
+  module Tasks
+    class CloudFormation < Thor
+      extend Admiral::Base
+      include Util::CloudFormation
+
+      NAME = 'cf'
+      USAGE = 'cf <command> <options>'
+      DESCRIPTION = 'Commands for wielding AWS CloudFormation templates.'
+
+      namespace :cf
+
+      class_option :template,
+        desc: 'Path to CloudFormation JSON template.',
+        default: 'CloudFormation.template'
+
+      class_option :params,
+        desc: 'Path to override parameter definitions file. Defaults to <environment>.json'
+
+
+      desc 'create', 'Create new CloudFormation stack for environment.'
+
+      def create
+        template = File.read options[:template]
+        create_stack stack_name(options[:environment]), template, params(options[:environment])
+      end
+
+
+      desc 'update', 'Update the existing CloudFormation stack'
+
+      def update
+        template = File.read options[:template]
+        update_stack stack_name(options[:environment]), template, params(options[:environment])
+      end
+
+
+      desc 'destroy', 'Destroy the existing CloudFormation stack.'
+
+      def destroy
+        super stack_name options[:environment]
+      end
+
+    end
+  end
+end

data/lib/admiral-cloudformation/util.rb

@@ -0,0 +1,100 @@
+require 'aws-sdk-v1'
+
+module Admiral
+  module Util
+    module CloudFormation
+
+      SUCCESS_STATS = [:create_complete, :update_complete, :update_rollback_complete]
+      FAILED_STATS = [:create_failed, :update_failed, :rollback_complete]
+      DEFAULT_RECIPES = [].join(",")
+
+      def client
+        AWS::CloudFormation.new
+      end
+
+      def create_stack(stack_name, template, params)
+        stack = client.stacks[stack_name]
+
+        if stack.exists?
+          raise '[admiral] Stack already exists. Use update command instead.'
+        end
+
+        puts "[admiral] Creating CloudFormation stack #{stack_name}."
+        begin
+          stack = client.stacks.create(stack_name, template, :parameters => params)
+          wait_for_stack_op_to_finish stack
+        rescue => e
+          puts "[admiral] Error creating stack #{stack_name}: #{e}"
+        end
+      end
+
+      def update_stack(stack_name, template, params)
+        stack = client.stacks[stack_name]
+
+        unless stack.exists?
+          raise "[admiral] CloudFormation stack #{stack_name} doesn't exist. Use create instead."
+        end
+
+        begin
+          puts "[admiral] Updating CloudFormation stack #{stack_name}"
+          stack.update(:template => template, :parameters => params)
+          wait_for_stack_op_to_finish stack
+        rescue => e
+          puts "[admiral] Error updating stack #{stack_name}: #{e}"
+          # raise unless e.message =~ /No updates are to be performed/
+          # puts "Your CloudFormation stack is already up to date"
+        end
+      end
+
+      def destroy(stack_name)
+        stack = client.stacks[stack_name]
+
+        if stack.exists?
+          puts "Deleting stack #{stack_name}"
+          stack.delete
+        else
+          puts "Environment does not exist"
+        end
+      end
+
+      def stack_name(env)
+        "#{env}-#{name}"
+      end
+
+      def name
+        ENV["ADMIRAL_NAME"] || "test"
+      end
+
+      def params(env, options = {})
+        JSON.parse File.read(options[:params] || "#{env}.json")
+      end
+
+      private
+
+      def wait_for_stack_op_to_finish(stack)
+        stats = stack.status.downcase.to_sym
+        puts "[admiral] Stack #{stack.name} current status: #{stats}"
+
+        while !SUCCESS_STATS.include?(stats)
+          sleep 15
+          stats = stack.status.downcase.to_sym
+          raise "[admiral] Resource stack update failed." if FAILED_STATS.include?(stats)
+          puts "[admiral] Stack #{stack.name} current status: #{stats}"
+        end
+      end
+
+      def cf_query_output(stack, key)
+        output = stack.outputs.find do |o|
+          /#{key}/i =~ o.key
+        end
+        output && output.value
+      end
+
+      def all_availability_zones
+        ec2 = AWS::EC2.new
+        ec2.availability_zones.map(&:name)
+      end
+
+    end
+  end
+end

data/spec/test.json

@@ -0,0 +1,3 @@
+{
+  "Key": "Value"
+}

data/spec/test.template

@@ -0,0 +1 @@
+{}

metadata

@@ -0,0 +1,147 @@
+--- !ruby/object:Gem::Specification
+name: admiral-cloudformation
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- Peter T. Brown
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: aws-sdk
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - <
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - <
+      - !ruby/object:Gem::Version
+        version: '2'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.19'
+- !ruby/object:Gem::Dependency
+  name: admiral
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.1
+description: An Admiral module that implements tasks for wielding AWS CloudFormation
+  templates. Use it to manage CloudFormation templates and their parameters.
+email:
+- p@ptb.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .ruby-version
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- admiral.gemspec
+- examples/elasticsearch/CloudFormation.template
+- examples/elasticsearch/production.json
+- examples/meteor/CloudFormation.template
+- examples/meteor/production.json
+- examples/mongo/CloudFormation.template
+- examples/mongo/production.json
+- lib/admiral-cloudformation.rb
+- lib/admiral-cloudformation/tasks.rb
+- lib/admiral-cloudformation/util.rb
+- spec/test.json
+- spec/test.template
+homepage: ''
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23.2
+signing_key: 
+specification_version: 3
+summary: A command line tool for wielding cloudformation templates.
+test_files:
+- spec/test.json
+- spec/test.template