aws-must-templates 0.1.2

data/mustache/resources.mustache

@@ -0,0 +1,65 @@
+{{! 
+
++++start+++
+
+## <a id="resources.mustache"></a>resources.mustache <a class='navigator' href='#top'>[top]</a>
+
+Empty template.
+
+**Attributes**: context=  `.`
+
+* none
+
+
+
++++close+++
+
+
+}}
+{{! +++fold-on+++ }}
+
+{{!
+
+"S3AccessRole" : {
+    "Type"  : "AWS::IAM::Role",
+    "Properties" : {
+        "AssumeRolePolicyDocument" : {
+            "Statement" : [ {
+                "Effect" : "Allow",
+                "Principal" : {
+                    "Service" : [ "ec2.amazonaws.com" ]
+                },
+                "Action" : [ "sts:AssumeRole" ]
+            } ]
+        },
+        "Path" : "/"
+    }
+},
+
+
+"S3RolePolicies" : {
+    "Type" : "AWS::IAM::Policy",
+    "Properties" : {
+        "PolicyName" : "s3access",
+        "PolicyDocument" : {
+            "Statement" : [ {
+                "Effect" : "Allow",
+                "Action" : "s3:*",
+                "Resource" : "*"
+            }]
+        },
+        "Roles" : [ { "Ref" : "S3AccessRole" } ]
+    }
+},
+
+"S3InstanceProfile" : {
+    "Type" : "AWS::IAM::InstanceProfile",
+    "Properties" : {
+        "Path" : "/",
+        "Roles" : [ { "Ref" : "S3AccessRole" } ]
+    }
+},
+
+}}
+
+{{! +++fold-off+++ }}

data/mustache/root.mustache

@@ -0,0 +1,244 @@
+{{!
+
+     root.mustache: root level template, 
+
+==================================================================
+STYLE section
+==================================================================
+
++++start+++
+<style>
+h1 {
+    color:blue; 
+    font-size: 2.5em;
+   }
+h2 {
+      color:blue;
+      font-size: 1.5em;
+   }
+h3 {
+      color:blue;
+      font-size: 1.5em;
+   }
+.navigator {
+      font-size: 0.5em;
+   }
+body {
+    background-color: #b0c4de;
+} 
+/* Support fold-on/fold-off toggle */
+div.fold { 
+    width: 90%; padding: .42rem; border-radius: 5px;  margin: 1rem; 
+
+}
+div.fold div { 
+       height: 0px; margin: .2rem; overflow: hidden; 
+}
+div.toggle ~ div { height: 0px; margin: .2rem; overflow: hidden; }
+input.toggle:checked ~ div { 
+     height: auto;      
+     color: white; 
+     background: #c6a24b;
+     font-family: monospace;
+     white-space: pre; 
+}
+</style>
+
++++close+++
+
+
+==================================================================
+CONTENT section
+==================================================================
+
++++start+++
+
+# <a id="top"/><a href="https://github.com/jarjuk/aws-must-templates">aws-must-templates</a>
+
+Templates for `aws-must` tool.
+
+## Table of contents
+
+<ul>
+
+    <li><a href="#root.mustache">root.mustache</a>: root template = starting point of template rendering</li>
+
+    <li><a href="#parameter.mustache">parameter.mustache</a>: create one parameter entry to CloudFormation JSON parameter section</li>
+
+    <li><a href="#mappings.mustache">mappings.mustache</a>: matches a key to a corresponding set of named values</li>
+
+    <li><a href="#mappingSubnetConfig.mustache">mappingSubnetConfig.mustache</a>: subnet config mapping to map VPC/Public/Private key to CIDR subnet block.</li>
+
+    <li><a href="#resource.mustache">resource.mustache</a>: dispatch resource based on resource type</li>
+
+    <ul> 
+
+        <li><a href="#resourceSecurityGroup.mustache">resourceSecurityGroup.mustache</a>: create an security group for accessing EC2 instances</li>
+
+        <li><a href="#resourceS3Bucket.mustache">resourceS3Bucket.mustache</a>: create an S3 Bucket</li>
+
+        <li><a href="#resourceRole.mustache">resourceRole.mustache</a>: AWS Identity and Access Management (IAM) role.</li>
+
+        <li><a href="#resourcePolicy.mustache">resourcePolicy.mustache</a>: lists permissions to be assigned to a user, group, role, or resource</li>
+
+        <li><a href="#resourceWait.mustache">resourceWait.mustache</a>: Creates a WaitHandle, and a WaitCondition on a resource `DependsOn`</li>
+
+        <li><a href="#resourceVPC.mustache">resourceVPC.mustache</a>: Creates a Virtual Private Cloud (VPC) with a CIDR block</li>
+
+        <li><a href="#resourceSubnet.mustache">resourceSubnet.mustache</a>: Creates a subnet in an existing VPC</li>
+
+        <li><a href="#resourceInternetGateway.mustache">resourceInternetGateway.mustache</a>: a new Internet gateway in your AWS account</li>
+
+        <li><a href="#resourceUser.mustache">resourceUser.mustache</a>: Creates User and AccessKey resources. User resource is associated with a fixed policy</li>
+
+        <li><a href="#resourceStack.mustache">resourceStack.mustache</a>: Nests a stack as a resource in a top-level template.</li>
+
+        <li><a href="#resourceInstanceProfile.mustache">resourceInstanceProfile.mustache</a>: a container for an IAM role and enables you to pass role information to an Amazon EC2 instance when the instance starts</li>
+
+        <li><a href="#resourceInstance.mustache">resourceInstance.mustache</a>: create an EC2 instance</li>
+
+        <ul>
+
+            <li><a href="#tag.mustache">tag.mustache</a>: add key-value tag property to an</li>
+
+            <li><a href="#resourceInstanceInitialize.mustache">resourceInstanceInitialize.mustache</a>: user-data script</li>
+
+            <li><a href="#initializeInstallChef.mustache">initializeInstallChef.mustache</a>: UserData -script to install Chef</li>
+
+            <li><a href="#initializeInstallAwsCli.mustache">initializeInstallAwsCli.mustache</a>: UserData -script to install AwsCli</li>
+
+            <li><a href="#initializeProvisionChef.mustache">initializeProvisionChef.mustache</a>: UserData -script to provision Chef</li>
+
+            <li><a href="#initializeCFtools.mustache">initializeCFtools.mustache</a>: Ubuntu CloudFormation Tools installation snippet</li>
+
+        </ul> <!-- resoureceInstance sub-templates -->
+
+    </ul> <!-- resource.mustache -->
+
+    <li><a href="#output.mustache">output.mustache</a>: values in response to describe stack calls </li> 
+
+    <li>Common templates</li> 
+
+    <ul> 
+
+        <li><a href="#commonInstanceType.mustache">commonInstanceType.mustache</a>: Output value for `InstanceType` -attribute</li> 
+
+        <li><a href="#commonValue.mustache">commonValue.mustache</a>: Common template to output value (Value/Ref/Attr/StackRef)</li> 
+
+        <li><a href="#commonKeyValue.mustache">commonKeyValue.mustache</a>: Common template output key value pairs</li> 
+
+        <li> <a href="#commonDependsOn.mustache">commonDependsOn.mustache</a>: </li>
+
+        <li> <a href="#commonCreationPolicy.mustache">commonCreationPolicy.mustache</a>: </li>
+
+        <li> <a href="#commonCfnSignal.mustache">commonCfnSignal.mustache</a>: </li>
+
+        <li> <a href="#commonStackRef.mustache">commonStackRef.mustache</a>: </li>
+
+    </ul> 
+
+</ul>
+
+## <a id="root.mustache"></a>root.mustache <a class='navigator' href='#top'>[top]</a>
+
+Starting point of template rendering.
+
+**Attributes**: context= `.`
+
+* `description`: description for the CF template
+* `parameters`: array of parameter sub-documents for CloudFormation Parameters -section
+* `resources`: array of resource sub-documents for CloudFormation Resources -section
+* `outputs`: array of output sub-documents for CloudFormation Outputs -section
+
++++close+++
+
+}}
+
+{{! +++fold-on+++ }}
+
+{
+  "AWSTemplateFormatVersion" : "2010-09-09",
+
+  "Description" : "{{description}}",
+
+  "Parameters" : {
+    {{# parameters }}{{> parameter }}{{/ parameters }}
+  },
+
+  "Mappings" : {
+    {{> mappings }}
+    {{# mappings.length }},{{/ mappings.length }}
+    {{# mappings }}{{> mapping }}{{/ mappings }}
+   },
+
+  "Resources" : {
+
+    {{> resources }}
+    {{# resources }}{{> resource }}{{/ resources }}
+
+  },
+
+  "Outputs" : {
+
+    {{# outputs }}{{> output }}{{/ outputs }}
+
+  }
+
+}
+
+{{! +++fold-off+++ }}
+
+
+
+{{! 
+
+==================================================================
+INCLUDED templates
+==================================================================
+
++++start+++
+
+> parameter
+> mappings
+> mapping
+> mappingSubnetConfig
+
+> resources
+> resource
+> resourceInstance
+
+> tag
+> resourceInstanceMetadata
+> resourceInstanceInitialize
+> initializeInstallChef
+> initializeInstallAwsCli
+> initializeProvisionChefZero
+> initializeCFtools
+
+> resourceSecurityGroup
+> resourceS3Bucket
+> resourceRole
+> resourceInstanceProfile
+> resourcePolicy
+> resourceStack
+> resourceWait
+> resourceVPC
+> resourceSubnet
+> resourceInternetGateway
+> resourceUser
+
+> output
+
+> commonDependsOn
+> commonInstanceType
+> commonCreationPolicy
+> commonCfnSignal
+> commonValue
+> commonKeyValue
+> commonStackRef
+
++++close+++
+
+}}
+
+

data/mustache/tag.mustache

@@ -0,0 +1,27 @@
+{{!
+
+
++++start+++
+
+## <a id="tag.mustache"></a>tag.mustache <a class='navigator' href='#top'>[top]</a>
+
+One key-value pair in EC2 instance Tags -array
+
+**Attributes**: context= `./resources/Instance/tags`
+
+* `Key`: of the tag entry
+* `Value`: of the tag entry
+
++++close+++
+
+
+
+}}
+
+{{! +++fold-on+++ }}
+
+{ "Key" : "{{Key}}",  "Value" : "{{Value}}"{{_comma}} }
+
+{{! +++fold-off+++ }}
+
+

metadata

@@ -0,0 +1,146 @@
+--- !ruby/object:Gem::Specification
+name: aws-must-templates
+version: !ruby/object:Gem::Version
+  version: 0.1.2
+platform: ruby
+authors:
+- jarjuk
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-08-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: aws-must
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.13
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.13
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 10.4.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 10.4.2
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.3.0
+- !ruby/object:Gem::Dependency
+  name: serverspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.21.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.21.1
+description: |2
+    Set of extensible templates for [aws-must](https://github.com/jarjuk/aws-must) tool to generate
+    CloudFormation JSON from a YAML configuration, and a
+    Test Runner for validating correctness of CloudFormation stacks provisioned.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/aws-must-templates.rb
+- lib/tasks/cross-ref.rb
+- lib/tasks/suite.rake
+- lib/test-suites/test_suites.rb
+- mustache/commonCfnSignal.mustache
+- mustache/commonCreationPolicy.mustache
+- mustache/commonDependsOn.mustache
+- mustache/commonInstanceType.mustache
+- mustache/commonKeyValue.mustache
+- mustache/commonStackRef.mustache
+- mustache/commonValue.mustache
+- mustache/initializeCFinit.mustache
+- mustache/initializeCFtools.mustache
+- mustache/initializeCfnInitHupFiles.mustache
+- mustache/initializeInstallAwsCli.mustache
+- mustache/initializeInstallChef.mustache
+- mustache/initializeProvisionChefZero.mustache
+- mustache/initializeStartCfnHup.mustache
+- mustache/mapping.mustache
+- mustache/mappingSubnetConfig.mustache
+- mustache/mappings.mustache
+- mustache/output.mustache
+- mustache/parameter.mustache
+- mustache/resource.mustache
+- mustache/resourceInstance.mustache
+- mustache/resourceInstanceInitialize.mustache
+- mustache/resourceInstanceMetadata.mustache
+- mustache/resourceInstanceProfile.mustache
+- mustache/resourceInternetGateway.mustache
+- mustache/resourcePolicy.mustache
+- mustache/resourceProvisionChef.mustache
+- mustache/resourceRole.mustache
+- mustache/resourceS3Bucket.mustache
+- mustache/resourceSecurityGroup.mustache
+- mustache/resourceStack.mustache
+- mustache/resourceSubnet.mustache
+- mustache/resourceUser.mustache
+- mustache/resourceVPC.mustache
+- mustache/resourceWait.mustache
+- mustache/resources.mustache
+- mustache/root.mustache
+- mustache/tag.mustache
+- pics/test-suites.jpg
+homepage: 
+licenses:
+- MIT
+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: Amazon Cloudformation templates for aws-must'
+test_files: []