aws-must 0.0.2

data/demo/6/root.mustache

@@ -0,0 +1,133 @@
+{{!
+
+     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;
+} 
+</style>
+
+++close++
+
+
+==================================================================
+CONTENT section
+==================================================================
+
+++start++
+
+# <a id="top">aws-must demo 6 templates</a>
+
+This document is generated automically from `aws-must` -demo
+templates. 
+
+
+Output contains markdown syntax between
+**&plus;&plus;start&plus;&plus;** and
+**&plus;&plus;close&plus;&plus;** -tags from the template files. For
+each template, it
+
+* gives a general description of the template
+
+* documents the attribute context e.g. `.` or `./resources/Instance`,
+  and attributes references of the template
+
+* lists template actions, i.e.  output from template, or template
+  inclusion
+
+### Table of contents
+<ul>
+
+<li><a href="#root.mustache">root.mustache</a>: root template =
+starting point of template rendering</li>
+
+<li><a href="#mappings.mustache">mappings.mustache</a>matches a key to
+a corresponding set of named values</li>
+
+<li>Resources</li>
+
+<ul>
+
+<li><a href="#resources.mustache">resources.mustache</a>: fixed
+resources</li>
+
+<li><a href="#resource.mustache">resource.mustache</a>: dispatch
+resource based on resource type</li> <li><a
+href="#resourceInstance.mustache">resourceInstance.mustache</a>create
+an EC2 instance</li>
+
+</ul><li><a href="#output.mustache">output.mustache</a>:values in
+response to describe stack calls </li> </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
+
+**Actions**:
+
+* **Description**: `description`
+* **include** <a href="#mappings.mustache">mappings.mustache</a>
+* **include** <a href="#resources.mustache">resources.mustache</a>
+* **for** `resource` **in** `resource` **include** <a href="#resource.mustache">resource.mustache</a>
+* **for** `output` **in** `outputs` **include** <a href="#output.mustache">output.mustache</a>
+
+
+> mappings
+> resources
+> resource
+> output
+
+
+++close++
+
+}}
+
+{
+  "AWSTemplateFormatVersion" : "2010-09-09",
+
+  "Description" : "{{description}}",
+
+  "Mappings" : {
+    {{> mappings }}
+   },
+
+  "Resources" : {
+
+    {{> resources }}
+    {{# resources }}{{> resource }}{{/ resources }}
+
+  },
+
+  "Outputs" : {
+
+    {{# outputs }}{{> output }}{{/ outputs }}
+
+  }
+
+}

data/demo/7/conf.yaml

@@ -0,0 +1,54 @@
+-- demo/2 : added description property
+
+
+description: "demo/7 - A simple Amazon EC2 instance created using aws-must tool
+             - Minimum Viable Solution to Manage CloudFormation
+             Templates. This adds support for EC2 intance tags, parameters, and security group"
+
+parameters:
+
+        -  Name: InstanceType
+           Type: String
+           Description: EC2 reousrce instance type
+           Value: &Param_InstanceType t2.micro
+
+        -  Name: &Param_KeyName KeyName
+           Type: "AWS::EC2::KeyPair::KeyName"
+           Description: Name of an existing EC2 KeyPair to enable SSH access to the instance
+           Value: demo-key
+
+        -  Name: &Param_SSHLocation  SSHLocation
+           Type: String
+           Description: The IP address range that can be used to SSH to the EC2 instances
+           Value: "0.0.0.0/0"
+
+
+resources:
+
+        - InstanceSecurityGroup:
+                 Name: &DefaultSG MyDefaultSecurityGroup
+                 IngressRef: *Param_SSHLocation
+
+        -  Instance: 
+                 Name: &Resource_1 MyEC2Instance
+                 InstanceType: *Param_InstanceType
+                 KeyName: *Param_KeyName
+                 SecurityGroup: *DefaultSG
+                 tags:
+                    - Key: demotag1
+                      Value: demotag1 value
+
+
+outputs:
+
+        -  Name: Instance1
+           Description: InstanceId of the newly created EC2 instance
+           Ref:  *Resource_1
+
+
+        -  Name: IP1
+           Description: Public IP address of the newly created EC2 instance
+           Attr: 
+                 Ref: *Resource_1
+                 Name: PublicIp
+

data/demo/7/mappings.mustache

@@ -0,0 +1,67 @@
+{{!
+
+++start++
+
+## <a id="mappings.mustache"></a>mappings.mustache <a class='navigator' href='#top'">[top]</a>
+
+
+Create fixed lookup tables `AWSInstanceType2Arch` and
+`AWSRegionArch2AMI` implementing the table below
+
+<code><pre>
+ap-northeast-1    trusty    14.04 LTS    amd64    hvm:ebs-ssd    20150528    ami-90815290    hvm
+ap-southeast-1    trusty    14.04 LTS    amd64    hvm:ebs-ssd    20150528    ami-0accf458    hvm
+ap-southeast-2    trusty    14.04 LTS    amd64    hvm:ebs-ssd    20150528    ami-1dc8b127    hvm
+cn-north-1        trusty    14.04 LTS    amd64    hvm:ebs-ssd    20150528    ami-eae27fd3    hvm
+eu-central-1      trusty    14.04 LTS    amd64    hvm:ebs-ssd    20150528    ami-3248712f    hvm
+eu-west-1         trusty    14.04 LTS    amd64    hvm:ebs-ssd    20150528    ami-d74437a0    hvm
+sa-east-1         trusty    14.04 LTS    amd64    hvm:ebs-ssd    20150528    ami-0f6ced12    hvm
+us-east-1         trusty    14.04 LTS    amd64    hvm:ebs-ssd    20150528    ami-83c525e8    hvm
+us-gov-west-1     trusty    14.04 LTS    amd64    hvm:ebs-ssd    20150528    ami-51513172    hvm
+us-west-1         trusty    14.04 LTS    amd64    hvm:ebs-ssd    20150528    ami-61b25925    hvm
+us-west-2         trusty    14.04 LTS    amd64    hvm:ebs-ssd    20150528    ami-57e8d767    hvm
+</pre></code>
+
+
+**Attributes**: context=  `.`
+
+* none
+
+
+**Actions**:
+
+* **AWSInstanceType2Arch**: fixed key/value mapping, currently only
+    **t2.micro** --> **64bit**
+
+* **AWSRegionArch2AMI**: fixed key/value mapping created, currently
+    architectures only for **64bits**
+
+
+++close++
+
+
+==================================================================
+The template
+==================================================================
+
+}}
+
+
+
+      "AWSInstanceType2Arch" : {
+      "t2.micro"    : { "Arch" : "64" }
+      },
+      "AWSRegionArch2AMI" : {
+           "ap-northeast-1" : { "64" : "ami-90815290" },
+           "ap-southeast-1" : { "64" : "ami-0accf458" },
+           "ap-southeast-2" : { "64" : "ami-1dc8b127" },
+           "cn-north-1" : { "64" : "ami-eae27fd3" },
+           "eu-central-1" : { "64" : "ami-3248712f" },
+           "eu-west-1" : { "64" : "ami-d74437a0" },
+           "sa-east-1" : { "64" : "ami-0f6ced12" },
+           "us-east-1" : { "64" : "ami-83c525e8" },
+           "us-west-1" : { "64" : "ami-61b25925" },
+           "us-gov-west-1" : { "64" : "ami-51513172" },
+           "us-west-2" : { "64" : "ami-57e8d767" }
+      }
+

data/demo/7/output.mustache

@@ -0,0 +1,40 @@
+{{!
+
+
+++start++
+
+## <a id="output.mustache"></a>output.mustache <a class='navigator' href='#top'">[top]</a>
+
+Create one output entry to CloudFormation JSON output section
+
+**Attributes**: context= `./outputs`
+
+* `Name` : of the ouput entry
+* `Description`: of the output entry
+* `Ref`: name of refernece
+* `Attr`
+  * `Ref`: name of attribute reference
+  * `Name`: name of the attribute
+
+
+
+**Actions**:
+
+* **Name**: `Name`
+* **Description**: `Description`
+* **Value**: **Ref** if `Ref`
+* **Value**: `Attr.Ref`, `Attr.Name` if `Attr`
+
+
+
+++close++
+
+}}
+
+
+    "{{Name}}": {
+      "Description" : "{{Description}}"
+      {{#Ref}}, "Value" : { "Ref" : "{{Ref}}" }{{/Ref}}
+      {{#Attr}}, "Value" : { "Fn::GetAtt" : [ "{{Ref}}", "{{Name}}" ] }{{/Attr}}
+    }{{_comma}}
+

data/demo/7/parameter.mustache

@@ -0,0 +1,38 @@
+{{!
+
+
+++start++
+
+## <a id="parameter.mustache"></a>parameter.mustache <a class='navigator' href='#top'">[top]</a>
+
+Create one parameter entry to CloudFormation JSON parameter section
+
+**Attributes**: context= `./parameters`
+
+* `Name` : of the ouput entry
+* `Description`: of the parameter entry
+* `Type`: The data type of [CloudFormation
+  Parameter](http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html),
+  e.g. `String`, `AWS::EC2::KeyPair::KeyName`
+* `Value`: value of the parameter
+
+
+**Actions**:
+
+* **Name**: `Name`
+* **Description**: `Description`
+* **Type**: `Type`
+* **Default**: `Value`
+
+++close++
+
+}}
+
+
+
+
+    "{{Name}}": {
+      "Description" : "{{Description}}{{^Description}}No description given{{/Description}}",
+      "Type": "{{Type}}",
+      "Default" : "{{Value}}"
+    }{{_comma}}

data/demo/7/resource.mustache

@@ -0,0 +1,38 @@
+{{!
+
+    resource.mustache
+
+++start++
+
+## <a id="resource.mustache"></a>resource.mustache <a class='navigator' href='#top'">[top]</a>
+
+
+Dispatches resource sub-type templates based resource Type propertys
+
+**Attributes**: context=  `./resources`
+
+* `Instance`: sub-document defining an EC instance
+* `SecurityGroup`: sub-document defining an <a href="http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-security-group.html">AWS::EC2::SecurityGroup</a>
+
+
+**Actions**:
+
+* **include** <a href="#resourceInstance.mustache">resourceInstance.mustache</a> **if** `Instance` 
+* **include** <a href="#resourceSecurityGroup.mustache">resourceSecurityGroup.mustache</a> **if** `SecurityGroup` 
+
+
+**Included resources**
+
+* `resourceInstance`
+
+> resourceInstance
+> resourceSecurityGroup.mustache
+
+++close++
+
+
+
+}}
+
+{{# Instance }}{{> resourceInstance}}{{/ Instance }}
+{{# InstanceSecurityGroup }}{{> resourceSecurityGroup}}{{/ InstanceSecurityGroup }}

data/demo/7/resourceInstance.mustache

@@ -0,0 +1,45 @@
+{{!
+
+
+++start++
+
+
+## <a id="resourceInstance.mustache"></a>resourceInstance.mustache <a class='navigator' href='#top'">[top]</a>
+
+Create an EC2 instance
+
+**Attributes**: context=  `./resources/Instance`
+
+* `Name`: name of the EC2 instance to create
+* `InstanceType` : The instance type, such as t2.micro. 
+* `tags` : array of tag sub-documents for EC2 instance
+
+
+**Actions**:
+
+* **Name**:  `Name`
+* **Type**: 'AWS::EC2::Instance'
+* **for** `tag` **in** `tags` **include**  <a href="#tag.mustache">tag.mustache</a>
+* **SecurityGroups.Ref**: `SecurityGroup` if `SecurityGroup`
+* **ImageId**: **AWSRegionArch2AMI**( 'AWS::Region', **AWSInstanceType2Arch**(`InstanceType`))
+* **KeyName**: `KeyName` if `KeyName`
+
+> tag
+
+
+++close++
+
+}}
+
+
+    "{{Name}}" : {
+      "Type" : "AWS::EC2::Instance",
+      "Properties" : {
+        "ImageId" : { "Fn::FindInMap" : [ "AWSRegionArch2AMI", { "Ref" : "AWS::Region" },
+	 	    { "Fn::FindInMap" : [ "AWSInstanceType2Arch", "{{InstanceType}}", "Arch" ] } ] }
+        , "InstanceType" : "{{InstanceType}}"
+        , "Tags" : [ {{#tags}}{{>tag}}{{/tags}} ]
+        {{#SecurityGroup}}, "SecurityGroups" : [ { "Ref" : "{{SecurityGroup}}" } ]{{/SecurityGroup}}
+        {{#KeyName}}, "KeyName" : { "Ref" : "{{KeyName}}" }{{/KeyName}}
+      } {{! Propertites }}
+    }{{_comma}}

data/demo/7/resourceSecurityGroup.mustache

@@ -0,0 +1,37 @@
+{{!
+
+
+++start++
+
+
+## <a id="resourceSecurityGroup.mustache"></a>resourceSecurityGroup.mustache <a class='navigator' href='#top'">[top]</a>
+
+Create an EC2 Security Group
+
+**Attributes**: context=  `./resources/InstanceSecurityGroup`
+
+* `Name` : of the security group
+* `IngressRef`: A refernce to parameter, which defined CIDR for to inbound traffic (ingress)
+
+**Actions**:
+
+* **Name**:  `Name`
+* **Type**: "AWS::EC2::SecurityGroup"
+* **Properties.SecurityGroupIngress[0].CidrIp**: `IngressRef`
+
+++close++
+
+}}
+
+    "{{Name}}" : {
+      "Type" : "AWS::EC2::SecurityGroup",
+      "Properties" : {
+        "GroupDescription" : "Enable SSH access via port 22",
+        "SecurityGroupIngress" : [ {
+          "IpProtocol" : "tcp",
+          "FromPort" : "22",
+          "ToPort" : "22",
+          "CidrIp" : { "Ref" : "{{IngressRef}}"}
+        } ]
+      }
+    }{{_comma}}

data/demo/7/resources.mustache

@@ -0,0 +1,35 @@
+{{! 
+
+++start++
+
+## <a id="resources.mustache"></a>resources.mustache <a class='navigator' href='#top'">[top]</a>
+
+Empty template.
+
+**Attributes**: context=  `.`
+
+* none
+
+
+**Actions**:
+
+* no action (i.e. empty template)
+
+
+++close++
+
+
+}}
+{{! 
+
+    Moved to YAML
+
+    "MyEC2Instance" : {
+      "Type" : "AWS::EC2::Instance",
+      "Properties" : {
+        "ImageId" : "ami-00dae61d",
+        "InstanceType" : "t2.micro"
+      }
+    }
+
+}}

data/demo/7/root.mustache

@@ -0,0 +1,157 @@
+{{!
+
+     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;
+} 
+</style>
+
+++close++
+
+
+==================================================================
+CONTENT section
+==================================================================
+
+++start++
+
+# <a id="top">aws-must demo 7 templates</a>
+
+This document is generated automically from `aws-must` -demo
+templates. 
+
+
+Output contains markdown syntax between
+**&plus;&plus;start&plus;&plus;** and
+**&plus;&plus;close&plus;&plus;** -tags from the template files. For
+each template, it
+
+* gives a general description of the template
+
+* documents the attribute context e.g. `.` or `./resources/Instance`,
+  and attributes referenced within the template
+
+* lists template actions, i.e.  output from template, or template
+  inclusion
+
+### 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>Resources</li>
+
+<ul>
+
+<li><a href="#resources.mustache">resources.mustache</a>: fixed
+resources</li>
+
+<li><a href="#resource.mustache">resource.mustache</a>: dispatch
+resource based on resource type</li>
+
+<ul> <li><a
+href="#resourceSecurityGroup.mustache">resourceSecurityGroup.mustache.mustache</a>:
+create an security group for accessing EC2 instances</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><ul>
+
+</ul></ul></ul></ul>
+
+<li><a href="#output.mustache">output.mustache</a>: values in
+response to describe stack calls </li> </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
+
+
+**Actions**:
+
+* **Description**: `description`
+* **for** `parameter` **in** `parameters`  **include** <a href="#parameter.mustache">parameter.mustache</a>
+* **include** <a href="#mappings.mustache">mappings.mustache</a>
+* **include** <a href="#resources.mustache">resources.mustache</a>
+* **for** `resource` **in** `resource` **include** <a href="#resource.mustache">resource.mustache</a>
+* **for** `output` **in** `outputs` **include** <a href="#output.mustache">output.mustache</a>
+
+
+> parameter
+> mappings
+> resources
+> resource
+> output
+
+
+++close++
+
+}}
+
+{
+  "AWSTemplateFormatVersion" : "2010-09-09",
+
+  "Description" : "{{description}}",
+
+  "Parameters" : {
+    {{# parameters }}{{> parameter }}{{/ parameters }}
+  },
+
+  "Mappings" : {
+    {{> mappings }}
+   },
+
+  "Resources" : {
+
+    {{> resources }}
+    {{# resources }}{{> resource }}{{/ resources }}
+
+  },
+
+  "Outputs" : {
+
+    {{# outputs }}{{> output }}{{/ outputs }}
+
+  }
+
+}

data/demo/7/tag.mustache

@@ -0,0 +1,30 @@
+{{!
+
+
+++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
+
+**Actions**:
+
+* **Key**: `Name`
+* **Value**: `Value`
+
+
+
+++close++
+
+
+
+}}
+
+{ "Key" : "{{Key}}",  "Value" : "{{Value}}"{{_comma}} }
+
+