aws-must 0.0.2

data/demo/4/root.mustache

@@ -0,0 +1,95 @@
+{{!
+
+     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;
+   }
+body {
+    background-color: #b0c4de;
+} 
+</style>
+
+++close++
+
+
+==================================================================
+CONTENT section
+==================================================================
+
+++start++
+
+# <a id="top">aws-must demo 4 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
+
+## <a id="root.mustache"></a>root.mustache <a class='navigator' href='#top'">[top]</a>
+
+
+Root template 
+
+
+**Attributes**: context= `.`
+
+* `description`: description for the CF template
+
+
+**Actions**:
+
+* **Description**: `description`
+* **include** <a href="#resources.mustache">resources.mustache</a>
+* **for** `resource` **in** `resource` **include** <a href="#resource.mustache">resource.mustache</a>
+
+> resources
+> resource
+
+++close++
+
+}}
+
+{
+  "AWSTemplateFormatVersion" : "2010-09-09",
+
+  "Description" : "{{description}}",
+
+
+
+  "Resources" : {
+
+    {{> resources }}
+    {{# resources }}{{> resource }}{{/ resources }}
+
+  }
+
+}

data/demo/5/conf.yaml

@@ -0,0 +1,32 @@
+-- demo/2 : added description property
+
+
+description: "demo/5: A simple Amazon EC2 instance created using aws-must tool
+             - Minimum Viable Solution to Manage CloudFormation
+             Templates. This version adds Output section with references
+             to InstanceId and PublicId of the newly created EC2 instance'."
+
+
+parameters:
+
+        -  Name: InstanceType
+           Type: String
+           Description: EC2 reousrce instance type
+           Value: &Param_InstanceType t2.micro
+
+
+resources:
+
+        -  Instance: 
+                 Name: &Resource_1 MyEC2Instance
+                 ImageId: ami-00dae61d
+                 InstanceType: *Param_InstanceType
+
+
+outputs:
+
+        -  Name: InstanceId1
+           Description: InstanceId of the newly created EC2 instance
+           Ref:  *Resource_1
+
+

data/demo/5/output.mustache

@@ -0,0 +1,39 @@
+{{!
+
+
+++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/5/resource.mustache

@@ -0,0 +1,26 @@
+{{!
+
+    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
+
+**Actions**:
+
+* include <a href="#resourceInstance.mustache">resourceInstance.mustache</a> if `Instance` 
+
+> resourceInstance
+
+++close++
+
+
+}}
+
+{{# Instance }}{{> resourceInstance}}{{/ Instance }}

data/demo/5/resourceInstance.mustache

@@ -0,0 +1,35 @@
+{{!
+
+
+++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. 
+
+**Actions**:
+
+
+* **Name**:  `Name`
+* **Type**: 'AWS::EC2::Instance'
+* **ImageId**: `ImageId`
+
+++close++
+
+}}
+
+
+    "{{Name}}" : {
+      "Type" : "AWS::EC2::Instance",
+      "Properties" : {
+        "ImageId" : "{{ImageId}}",
+        "InstanceType" : "{{InstanceType}}"
+      } {{! Propertites }}
+    }{{_comma}}

data/demo/5/resources.mustache

@@ -0,0 +1,25 @@
+{{! 
+
+++start++
+
+## resources.mustache
+
+Nothing created here
+
+++close++
+
+
+}}
+{{! 
+
+    Moved to YAML
+
+    "MyEC2Instance" : {
+      "Type" : "AWS::EC2::Instance",
+      "Properties" : {
+        "ImageId" : "ami-00dae61d",
+        "InstanceType" : "t2.micro"
+      }
+    }
+
+}}

data/demo/5/root.mustache

@@ -0,0 +1,100 @@
+{{!
+
+     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;
+   }
+body {
+    background-color: #b0c4de;
+} 
+</style>
+
+++close++
+
+
+==================================================================
+CONTENT section
+==================================================================
+
+++start++
+
+# <a id="top">aws-must demo 5 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
+
+
+## <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="#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>
+
+
+> resources
+> resource
+> output
+
+++close++
+
+}}
+
+{
+  "AWSTemplateFormatVersion" : "2010-09-09",
+
+  "Description" : "{{description}}",
+
+  "Resources" : {
+
+    {{> resources }}
+    {{# resources }}{{> resource }}{{/ resources }}
+
+  },
+
+  "Outputs" : {
+
+    {{# outputs }}{{> output }}{{/ outputs }}
+
+  }
+
+}

data/demo/6/conf.yaml

@@ -0,0 +1,31 @@
+-- demo/2 : added description property
+
+
+description: "demo/6 - A simple Amazon EC2 instance created using aws-must tool
+             - Minimum Viable Solution to Manage CloudFormation
+             Templates. This version uses AWSInstanceType2Arch and AWSRegionArch2AMI 
+             to define 64bit hmv 't2.micro' instances AMIs for several Amazon regions."
+
+
+parameters:
+
+        -  Name: InstanceType
+           Type: String
+           Description: EC2 reousrce instance type
+           Value: &Param_InstanceType t2.micro
+
+
+resources:
+
+        -  Instance: 
+                 Name: &Resource_1 MyEC2Instance
+                 InstanceType: *Param_InstanceType
+
+
+outputs:
+
+        -  Name: InstanceId1
+           Description: InstanceId of the newly created EC2 instance
+           Ref:  *Resource_1
+
+

data/demo/6/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/6/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/6/resource.mustache

@@ -0,0 +1,29 @@
+{{!
+
+    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
+
+
+**Actions**:
+
+* include <a href="#resourceInstance.mustache">resourceInstance.mustache</a> if `Instance` 
+
+> resourceInstance
+
+++close++
+
+
+
+}}
+
+{{# Instance }}{{> resourceInstance}}{{/ Instance }}

data/demo/6/resourceInstance.mustache

@@ -0,0 +1,35 @@
+{{!
+
+
+++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. 
+
+
+**Actions**:
+
+* **Name**:  `Name`
+* **Type**: 'AWS::EC2::Instance'
+* **ImageId**: **AWSRegionArch2AMI**( 'AWS::Region', **AWSInstanceType2Arch**(`InstanceType`))
+
+++close++
+
+}}
+
+
+    "{{Name}}" : {
+      "Type" : "AWS::EC2::Instance",
+      "Properties" : {
+        "ImageId" : { "Fn::FindInMap" : [ "AWSRegionArch2AMI", { "Ref" : "AWS::Region" },
+	 	    { "Fn::FindInMap" : [ "AWSInstanceType2Arch", "{{InstanceType}}", "Arch" ] } ] },
+        "InstanceType" : "{{InstanceType}}"
+      } {{! Propertites }}
+    }{{_comma}}

data/demo/6/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"
+      }
+    }
+
+}}