aws-must-templates 0.1.6 → 0.2.1

data/mustache/commonDependsOn.mustache

@@ -10,7 +10,19 @@ Common template to output key and value for `DependsOn`
 
 **Attributes**: 
 
-* `DependsOn` : resource name on which dependency defined
+* `DependsOn` : resource name/array on which dependency defined
+
+Example depends on `resource1`
+
+       DependsOn: resource1
+
+
+Example depends on `resource1`, `resource2`
+
+       DependsOn: 
+	       - resource1
+   	       - resource2
+	   
 
 +++close+++
 
@@ -18,8 +30,18 @@ Common template to output key and value for `DependsOn`
 
 {{! +++fold-on+++ }}
 
+{{! Array context define 'any?' }}
+{{# DependsOn.any? }} 
+   , "DependsOn" :  {{{DependsOn}}}
+{{/ DependsOn.any? }} 
+
 
-{{# DependsOn }}, "DependsOn" : "{{DependsOn}}"  {{/ DependsOn }} 
+{{! String does not define 'any?' }}
+{{^ DependsOn.any? }} 
+{{# DependsOn }} 
+   , "DependsOn" :  "{{{DependsOn}}}"  
+{{/ DependsOn }} 
+{{/ DependsOn.any? }} 
 
 
 {{! +++fold-off+++ }}

data/mustache/commonRef.mustache

@@ -0,0 +1,22 @@
+{{!
+
+
++++start+++
+
+## <a id="commonRef.mustache"></a>commonRef.mustache<a class='navigator' href='#top'>[top]</a>
+
+Common template to output reference (in context)
+
+**Attributes**: 
+
+* `.`: referenece in context
+
++++close+++
+
+}}
+
+{{! +++fold-on+++ }}
+
+{ "Ref": "{{.}}" }
+
+{{! +++fold-off+++ }}

data/mustache/commonValue.mustache

@@ -26,7 +26,7 @@ Common template to output value (Value/Ref/Attr/StackRef)
 
 
 {{#Value}}"{{Value}}"{{/Value}}
-{{#Ref}}{ "Ref": "{{Ref}}" }{{/Ref}}
+{{#Ref}} {{> commonRef }} {{/Ref}}
 {{#Attr}}{ "Fn::GetAtt" : [ "{{Ref}}", "{{Name}}" ] }{{/Attr}}
 {{#StackRef}}{ "Fn::GetAtt": [ "{{Stack}}", "Outputs.{{Output}}"] }{{/StackRef}}
 

data/mustache/commonXGressRule.mustache

@@ -0,0 +1,31 @@
+{{!
+
+
++++start+++
+
+## <a id="commonXGressRule.mustache"></a>commonXGressRule.mustache<a class='navigator' href='#top'>[top]</a>
+
+Common template to output SecurityGroupIngress or SecurityGroupEgress rules.
+
+**Attributes**: 
+
+* `IpProtocol`: default tcp
+* `FromPort`: default to `Port`
+* `ToPort`: defaults to `Port`
+* CidrIp given as commonValue, [commonValue.mustache](#commonValue.mustache)
+
++++close+++
+
+}}
+
+{{! +++fold-on+++ }}
+
+{
+   "IpProtocol" : {{#IpProtocol}}"{{IpProtocol}}"{{/IpProtocol}}{{^IpProtocol}}"tcp"{{/IpProtocol}},
+   "FromPort" : "{{#FromPort}}{{FromPort}}{{/FromPort}}{{^FromPort}}{{Port}}{{/FromPort}}",
+   "ToPort" : "{{#ToPort}}{{ToPort}}{{/ToPort}}{{^ToPort}}{{Port}}{{/ToPort}}",
+   "CidrIp" : {{> commonValue }}
+}
+
+
+{{! +++fold-off+++ }}

data/mustache/mapping.mustache

@@ -11,7 +11,8 @@ Dispatches mapping sub-type templates based mapping Type propertys
 
 **Attributes**: context=  `./mappings`
 
-* `SubnetConfig`: 
+* `SubnetConfig`: output [mappingSubnetConfig.mustache](#mappingSubnetConfig.mustache)
+* `AmazonVpcNat`: output [mappingAmazonVpcNat.mustache](#mappingAmazonVpcNat.mustache)
 
 +++close+++
 
@@ -22,6 +23,7 @@ Dispatches mapping sub-type templates based mapping Type propertys
 {{! +++fold-on+++ }}
 
 {{# SubnetConfig }}{{> mappingSubnetConfig }}{{/ SubnetConfig }}
+{{# AmazonVpcNat }}{{> mappingAmazonVpcNat }}{{/ AmazonVpcNat }}
 
 
 {{! +++fold-off+++ }}

data/mustache/mappingAmazonVpcNat.mustache

@@ -0,0 +1,38 @@
+{{!
+
++++start+++
+
+## <a id="mappings.mustache"></a>mappings.mustache <a class='navigator' href='#top'>[top]</a>
+
+Mapping table `region-->ami` with `root-device=ebs`,
+`architecture,Values=x86_64`, and `--owners amazon` 
+
+
++++close+++
+
+
+==================================================================
+The template
+==================================================================
+
+}}
+
+
+{{! +++fold-on+++ }}
+
+
+
+"{{Name}}" : {
+      "us-east-1"      : { "AMI" : "ami-184dc970" },
+      "us-west-1"      : { "AMI" : "ami-a98396ec" },
+      "us-west-2"      : { "AMI" : "ami-290f4119" },
+      "eu-west-1"      : { "AMI" : "ami-14913f63" },
+      "eu-central-1"   : { "AMI" : "ami-ae380eb3" },
+      "sa-east-1"      : { "AMI" : "ami-8122969c" },
+      "ap-southeast-1" : { "AMI" : "ami-6aa38238" },
+      "ap-southeast-2" : { "AMI" : "ami-893f53b3" },
+      "ap-northeast-1" : { "AMI" : "ami-27d6e626" }
+}{{_comma}}
+
+
+{{! +++fold-off+++ }}

data/mustache/resource.mustache

@@ -23,6 +23,8 @@ Dispatches resource sub-type templates based resource Type propertys
 * `InternetGateway`: 
 * `Subnet`: 
 * `User`: creates [User](#resourceUser.mustache)
+* `RouteTable`: creates [resourceRouteTable.mustache](#resourceRouteTable.mustache)
+* `Route`: creates [resourceRoute.mustache](#resourceRoute.mustache)
 
 
 +++close+++
@@ -45,6 +47,8 @@ Dispatches resource sub-type templates based resource Type propertys
 {{# Subnet }}{{> resourceSubnet }}{{/ Subnet }}
 {{# InternetGateway }}{{> resourceInternetGateway }}{{/ InternetGateway }}
 {{# User }}{{> resourceUser  }}{{/ User }}
+{{# RouteTable }}{{> resourceRouteTable  }}{{/ RouteTable }}
+{{# Route }}{{> resourceRoute  }}{{/ Route }}
 
 
 

data/mustache/resourceInstance.mustache

@@ -14,8 +14,16 @@ Create an EC2 instance
 * Instance type (mandatory)
   * `InstanceType` : The instance type, such as t2.micro. 
   * `InstanceTyperef` : Reference to instance type
-* `tags` : array of tag sub-documents for EC2 instance
+* `MapRegionToImageId` : alternative name of map for mapping region to
+  AMI => imageid, if not defined use default [mappings.mustache](#mappings.mustache)
+* `Tags` :  { "Key": "Name", "Name": ``} + array of tag Key- value subdocuments
+* `DependsOn`: see [commonDependsOn.mustache](#commonDependsOn.mustache)
 * `SecurityGroupIds`: array of [commonValue.mustache](#commonValue.mustache)
+* `SourceDestCheck`: String, (defaults: "true") Controls whether
+   source/destination checking is enabled on the instance. Also
+   determines if an instance in a VPC will perform network address
+   translation (NAT). For the instance to perform NAT, the value must
+   be "false".
 
 
 +++close+++
@@ -27,15 +35,26 @@ Create an EC2 instance
     "{{Name}}" : {
       "Type" : "AWS::EC2::Instance"
       {{> commonCreationPolicy }}
-	  , "Metadata": {
-	        {{> resourceInstanceMetadata }}
+      {{> commonDependsOn }}
+      , "Metadata": {
+            {{> resourceInstanceMetadata }}
 
-	  } {{! metadata }}
+      } {{! metadata }}
       , "Properties" : {
-          "ImageId" : { "Fn::FindInMap" : [ "AWSRegionArch2AMI", { "Ref" : "AWS::Region" },
-                      { "Fn::FindInMap" : [ "AWSInstanceType2Arch", {{> commonInstanceType }}, "Arch" ] } ] }
+          "ImageId" : 
+                       {{^ MapRegionToImageId }}
+                       { "Fn::FindInMap" : [ "AWSRegionArch2AMI", { "Ref" : "AWS::Region" },
+                                   { "Fn::FindInMap" : [ "AWSInstanceType2Arch", {{> commonInstanceType }}, "Arch" ] } ] }
+                       {{/ MapRegionToImageId }}
+                        {{# MapRegionToImageId }}
+						{ "Fn::FindInMap" : [ "{{MapRegionToImageId}}", { "Ref" : "AWS::Region" }, "AMI" ] }
+                       {{/ MapRegionToImageId }}            		  
+
           , "InstanceType" : {{> commonInstanceType}} {{! InstanceType OR InstanceTypeRef }}
-          , "Tags" : [ {{#tags}}{{>tag}}{{/tags}} ]
+          , "Tags" : [ { "Key":  "Name", "Value": "{{Name}}" }
+                       {{# Tags }},{{> commonKeyValue }}{{_comma}}{{/ Tags }}
+            ]
+          ,  "SourceDestCheck": {{# SourceDestCheck }}{{SourceDestCheck}}{{/ SourceDestCheck }}{{^ SourceDestCheck }}true{{/ SourceDestCheck }}
           , "SecurityGroupIds" : [ 
                 {{# SecurityGroupIds }}
                     {{> commonValue }}{{_comma}}

data/mustache/resourceInternetGateway.mustache

@@ -14,9 +14,12 @@ access on `Vpc` && `Subnet`
 **Attributes**: context=  `./resources/InstanceSecurityGroup`
 
 * `Name` : of the Internet Gateway
-   * `Vpc`: reference to VPC where to atttace
    * `Subnet`: reference to VPC where to attach route to InternetGateway
    * `Tags`: (optional) as [commonKeyValue.mustache](#commonKeyValue.mustache)
+   * `Attachment` : sub document defining attachment to vpc
+       * `AttachmentName` of the attachment resource
+       * `Vpc`: reference to VPC where to atttace
+
 
 
 +++close+++
@@ -25,58 +28,69 @@ access on `Vpc` && `Subnet`
 
 {{! +++fold-on+++ }}
 
-
 {{! Create internet gateway }}
 "{{Name}}" : {
     "Type" : "AWS::EC2::InternetGateway",
     "Properties" : {
-       "Tags" : [ {{# Tags }}{{> commonKeyValue }}{{_comma}}{{/ Tags }}]
+     	"Tags" : [ { "Key":  "Name", "Value": "{{Name}}" }
+                     {{# Tags }},{{> commonKeyValue }}{{_comma}}{{/ Tags }}
+            ]
     }
- },
+ }
 
+
+{{# Attachment }}
 {{! Attache the internet gateway created to VPC }}
-"Attach{{Vpc}}" : {
+, "{{AttachmentName}}" : {
       "Type" : "AWS::EC2::VPCGatewayAttachment",
       "Properties" : {
         "VpcId" : { "Ref" : "{{Vpc}}" },
-        "InternetGatewayId" : { "Ref" : "{{Name}}" }
+		{{! reference to internet gateway name }}
+        "InternetGatewayId" : {{# .. }} {{# Name }} {{> commonRef }}{{/ Name }}{{/ .. }}
     }
-}, 
+} 
+{{/ Attachment }}
+
 
 
 {{! Create a route table for VPC }}
 
-"RouteTable{{Vpc}}" : {
+, "RouteTable{{Name}}" : {
       "Type" : "AWS::EC2::RouteTable",
       "Properties" : {
+{{# Attachment }}	  
         "VpcId" : { "Ref" : "{{ Vpc }}" },
+{{/ Attachment }}		
         "Tags" : [ 
-		           {"Key": "Name", "Value" : "RouteTable{{Vpc}}" }
+		           {"Key": "Name", "Value" : "RouteTable{{Name}}" }
 		         , {"Key" : "Application", "Value" : { "Ref" : "AWS::StackId"} } 
 				 ]
       }
-    },
+}
+
 
 
 {{! Add a route to internet gateway created }}
 
-"Route{{Vpc}}" : {
+, "Route{{Vpc}}" : {
     "Type" : "AWS::EC2::Route",
-     "DependsOn" : "Attach{{Vpc}}",
+{{# Attachment }}
+     "DependsOn" : "{{AttachmentName}}",
+ {{/ Attachment }}
       "Properties" : {
-          "RouteTableId" : { "Ref" : "RouteTable{{Vpc}}" }
+          "RouteTableId" : { "Ref" : "RouteTable{{Name}}" }
           , "DestinationCidrBlock" : "0.0.0.0/0"
           , "GatewayId" : { "Ref" : "{{Name}}" }
      }
-},
+}
 
 {{! Associates a subnet with a route table. }}
 
-"RouteTableAssociation{{Subnet}}" : {
+, "RouteTableAssociation{{Subnet}}" : {
     "Type" : "AWS::EC2::SubnetRouteTableAssociation"
    , "Properties" : {
          "SubnetId" : { "Ref" : "{{Subnet}}" }
-       , "RouteTableId" : { "Ref" : "RouteTable{{Vpc}}" }
+       , "RouteTableId" : { "Ref" : "RouteTable{{Name}}" }
      }
 }
 

data/mustache/resourceRoute.mustache

@@ -0,0 +1,50 @@
+{{!
+
+
++++start+++
+
+## <a id="resourceRoute.mustache"></a>resourceRoute.mustache <a class='navigator' href='#top'>[top]</a>
+
+**Attributes**:
+
+* `Name` : of the route -resource
+
+* `DependsOn` : [commonDependsOn.mustache](#commonDependsOn.mustache)
+
+* `RouteTableId`: The ID of the route table where the route will be
+  added, [commonRef.mustache](#commonRef.mustache)
+
+* `DestinationCidrBlock`: The CIDR address block used for the
+  destination match. For example, "0.0.0.0/0". Routing decisions are
+  based on the most specific match.
+  
+* You must specify only one of the following properties: `GatewayId`,
+  `InstanceId`, `NetworkInterfaceId`, or `VpcPeeringConnection`
+
+   * `GatewayId`: The ID of an Internet gateway or virtual private
+      gateway that is attached to your VPC
+	  
+   * `InstanceId`: The ID of a NAT instance in your VPC. For example, "i-1a2b3c4d".
+
+
+
++++close+++
+
+}}
+
+{{! +++fold-on+++ }}
+
+"{{Name}}" : {
+    "Type" : "AWS::EC2::Route"
+    {{> commonDependsOn }}
+   ,    "Properties" : {
+             "RouteTableId" : {{#RouteTableId}}{{> commonRef }}{{/RouteTableId}}
+	    , "DestinationCidrBlock" : "{{DestinationCidrBlock}}"
+              {{! one of }}
+                 {{#GatewayId}}, "GatewayId" : {{> commonRef }}{{/GatewayId}}
+                 {{#InstanceId}}, "InstanceId" : {{> commonRef }}{{/InstanceId}}
+				 
+    } 
+}{{ _comma }}
+
+{{! +++fold-off+++ }}

data/mustache/resourceRouteTable.mustache

@@ -0,0 +1,67 @@
+{{!
+
+
++++start+++
+
+## <a id="resourceRouteTable.mustache"></a>resourceRouteTable.mustache <a class='navigator' href='#top'>[top]</a>
+
+A `route table` contains a set of rules, called routes, that are used
+to determine where network traffic is directed.  Thi template creates
+a new route table within a VPC. After you create a new route table,
+you can add routes and associate the table with a subnet.
+
+The following are the
+[basic things](http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Route_Tables.html)
+that you need to know about route tables:
+
+* Your VPC has an implicit router.
+
+* Your VPC automatically comes with a main route table that you can
+  modify.
+
+* You can create additional custom route tables for your VPC.
+
+* Each subnet must be associated with a route table, which controls
+   the routing for the subnet. If you don't explicitly associate a
+   subnet with a particular route table, the subnet uses the main
+   route table.
+
+* You can replace the main route table with a custom table that you've
+  created (so that this table is the default table each new subnet is
+  associated with).
+
+* Each route in a table specifies a destination CIDR and a target (for
+  example, traffic destined for 172.16.0.0/12 is targeted for the
+  virtual private gateway); we use the most specific route that
+  matches the traffic to determine how to route the traffic.
+
+
+**Attributes**:
+
+* `Name` : of the route-table
+* `Vpc`: reference to VPC where attached, [commonRef.mustache](#commonRef.mustache)
+* `Subnet`: reference to VPC where to attach route to InternetGateway
+* `DependsOn` : [commonDependsOn.mustache](#commonDependsOn.mustache)
+* `Tags`: (optional) as [commonKeyValue.mustache](#commonKeyValue.mustache)
+* `Routes`: an array of routes processed in  []()
+
+
++++close+++
+
+}}
+
+{{! +++fold-on+++ }}
+
+"{{Name}}" : {
+      "Type" : "AWS::EC2::RouteTable"
+      {{> commonDependsOn }}
+      , "Properties" : {
+            "VpcId" : {{#Vpc}}{{> commonRef }}{{/Vpc}}
+         ,  "Tags" : [ 
+               {"Key": "Name", "Value" : "{{Name}}" }
+               {{# Tags }},{{> commonKeyValue }}{{_comma}}{{/ Tags }}
+             ]
+      }
+}{{ _comma }}
+
+{{! +++fold-off+++ }}

data/mustache/resourceSecurityGroup.mustache

@@ -8,15 +8,13 @@
 
 Create an EC2 Security Group
 
-**Attributes**: context=  `./resources/SecurityGroup`
+**Attributes**: 
 
 * `Name` : of the security group
 * `VpcId`: The Reference name physical ID of the VPC.  given as commonValue, [commonValue.mustache](#commonValue.mustache)
-* `SecurityGroupIngress`: Arrays in a SecurityGroupIngr
-   * `IpProtocol`: default tcp
-   * `FromPort`: default to `Port`
-   * `ToPort`: defaults to `Port`
-   * CidrIp given as commonValue, [commonValue.mustache](#commonValue.mustache)
+* `SecurityGroupIngress`: create array of ingress rules with [commonXGressRule.mustache](#commonXGressRule.mustache)
+* `SecurityGroupEgress`: create array of ingress rules with [commonXGressRule.mustache](#commonXGressRule.mustache) template
+* `Tags` :  { "Key": "Name", "Name": ``} + array of tag Key- value subdocuments
 
 
 +++close+++
@@ -30,14 +28,17 @@ Create an EC2 Security Group
       "Properties" : {
         "GroupDescription" : "Enable SSH access via port 22"
         {{# VpcId }}, "VpcId": {{> commonValue }} {{/ VpcId }}
+        , "Tags" : [ { "Key":  "Name", "Value": "{{Name}}" }
+                     {{# Tags }},{{> commonKeyValue }}{{_comma}}{{/ Tags }}
+          ]
+        , "SecurityGroupEgress" : [ 
+                {{# SecurityGroupEgress }}
+                     {{> commonXGressRule }}{{_comma}}
+                {{/ SecurityGroupEgress }}
+        ]
         , "SecurityGroupIngress" : [ 
                 {{# SecurityGroupIngress }}
-                     {
-                         "IpProtocol" : {{#IpProtocol}}"{{IpProtocol}}"{{/IpProtocol}}{{^IpProtocol}}"tcp"{{/IpProtocol}},
-                         "FromPort" : "{{#FromPort}}{{FromPort}}{{/FromPort}}{{^FromPort}}{{Port}}{{/FromPort}}",
-                         "ToPort" : "{{#ToPort}}{{ToPort}}{{/ToPort}}{{^ToPort}}{{Port}}{{/ToPort}}",
-                         "CidrIp" : {{> commonValue }}
-                    } {{_comma}}
+                     {{> commonXGressRule }}{{_comma}}
                 {{/ SecurityGroupIngress }}
         ]
       }

data/mustache/resourceSubnet.mustache

@@ -11,12 +11,13 @@ Creates a subnet in an existing VPC.
 **Attributes**: 
 
 * `Name` : of the VPC resource
-   * `CidrBlock` or as [commonKeyValue.mustache](#commonKeyValue.mustache)
-   * `VpcId`: resource name of VPC
-   * `MapPublicIpOnLaunch`: Indicates whether instances that are
-     launched in this subnet receive a public IP address. By default,
-     the value is `false`.
-   * `Tags`: (optional) as [commonKeyValue.mustache](#commonKeyValue.mustache)
+* `CidrBlock` or as [commonKeyValue.mustache](#commonKeyValue.mustache)
+* `VpcId`: resource name of VPC
+* `MapPublicIpOnLaunch`: Indicates whether instances that are
+   launched in this subnet receive a public IP address. By default,
+  the value is `false`.
+* `Tags`: (optional) as [commonKeyValue.mustache](#commonKeyValue.mustache)
+* `RoutetableAssociation`: Associates a subnet with a route table.
 
 
 +++close+++
@@ -33,9 +34,20 @@ Creates a subnet in an existing VPC.
          "CidrBlock" : "{{CidrBlock}}"
        , "Tags" : [ {{# Tags }}{{> commonKeyValue }}{{_comma}}{{/ Tags }}]
        , "MapPublicIpOnLaunch" : {{^MapPublicIpOnLaunch}}false{{/ MapPublicIpOnLaunch}}{{# MapPublicIpOnLaunch}}{{MapPublicIpOnLaunch}}{{/ MapPublicIpOnLaunch}}
-       , "VpcId" : { "Ref" : "{{VpcId}}" }
+       , "VpcId" : {{#VpcId}} {{> commonRef }} {{/VpcId}}
    }
-}{{_comma}}
+}
+
+{{# RoutetableAssociation }}
+, "{{Name}}RouteTableAssociation" : {
+     "Type" : "AWS::EC2::SubnetRouteTableAssociation",
+     "Properties" : {
+         "RouteTableId" : {{> commonRef }}
+      ,   "SubnetId" : {{# ..}}{{# Name}}{{> commonRef }}{{/ Name }}{{/ .. }}
+   }
+}
 
+{{/ RoutetableAssociation }}
+{{_comma}}
 
 {{! +++fold-off+++ }}

data/mustache/root.mustache

@@ -64,10 +64,18 @@ Templates for `aws-must` tool.
     <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>
+  
+    <ul>
 
-    <li><a href="#mappings.mustache">mappings.mustache</a>: matches a key to a corresponding set of named values</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="#mappingSubnetConfig.mustache">mappingSubnetConfig.mustache</a>: subnet config mapping to map VPC/Public/Private key to CIDR subnet block.</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="#mappingAmazonVpcNat.mustache">mappingAmazonVpcNat.mustache</a>: mapping for vpc-nat instances</li>
+
+    </ ul>
 
     <li><a href="#resource.mustache">resource.mustache</a>: dispatch resource based on resource type</li>
 
@@ -121,20 +129,24 @@ Templates for `aws-must` tool.
 
     <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="#commonCfnSignal.mustache">commonCfnSignal.mustache</a>: </li>
 
-        <li><a href="#commonKeyValue.mustache">commonKeyValue.mustache</a>: Common template output key value pairs</li> 
+        <li> <a href="#commonCreationPolicy.mustache">commonCreationPolicy.mustache</a>: </li>
 
         <li> <a href="#commonDependsOn.mustache">commonDependsOn.mustache</a>: </li>
 
-        <li> <a href="#commonCreationPolicy.mustache">commonCreationPolicy.mustache</a>: </li>
+        <li><a href="#commonInstanceType.mustache">commonInstanceType.mustache</a>: Output value for `InstanceType` -attribute</li> 
 
-        <li> <a href="#commonCfnSignal.mustache">commonCfnSignal.mustache</a>: </li>
+        <li><a href="#commonKeyValue.mustache">commonKeyValue.mustache</a>: Common template output key value pairs</li> 
+
+        <li> <a href="#commonRef.mustache">commonRef.mustache</a>: reference</li>
 
         <li> <a href="#commonStackRef.mustache">commonStackRef.mustache</a>: </li>
 
+        <li><a href="#commonValue.mustache">commonValue.mustache</a>: Common template to output value (Value/Ref/Attr/StackRef)</li> 
+
+        <li> <a href="#commonXGressRule.mustache">commonXGressRule.mustache</a>: SecurityGroupIngress/SecurityGroupEgress rules</li>
+
     </ul> 
 
 </ul>
@@ -202,6 +214,7 @@ INCLUDED templates
 > mappings
 > mapping
 > mappingSubnetConfig
+> mappingAmazonVpcNat
 
 > resources
 > resource
@@ -229,13 +242,15 @@ INCLUDED templates
 
 > output
 
+> commonCfnSignal
+> commonCreationPolicy
 > commonDependsOn
 > commonInstanceType
-> commonCreationPolicy
-> commonCfnSignal
-> commonValue
 > commonKeyValue
+> commonRef
 > commonStackRef
+> commonValue
+> commonXGressRule
 
 +++close+++
 

data/spec/aws-must-templates/AllwaysOk/AllwaysOk_spec.rb

@@ -0,0 +1,35 @@
+=begin
+
++++start+++
+
+## <a id="AllwaysOk"></a>AllwaysOk<a class='navigator' href='#top'>[top]</a>
+
+Make at least one test succeed.
+
++++close+++
+
+=end
+
+# +++fold-on+++
+
+require 'spec_helper'
+
+
+current_test = File.basename File.dirname  __FILE__ 
+
+describe  current_test do 
+
+
+  # ------------------------------------------------------------------
+  # Test paramters defined
+
+  describe "Success" do
+
+    it "#works" do
+      expect( 1 ).to eql( 1 )
+    end
+  end
+    
+end
+
+# +++fold-off+++