cfndsl 0.1.16 → 0.1.17

data/sample/autoscale.template

@@ -0,0 +1,176 @@
+{
+  "AWSTemplateFormatVersion" : "2010-09-09",
+
+  "Description" : "Create a multi-az, load balanced, Auto Scaled sample web site. The Auto Scaling trigger is based on the CPU utilization of the web servers. The AMI is chosen based on the region in which the stack is run. This example creates a web service running across all availability zones in a region. The instances are load balanced with a simple health check. The web site is available on port 80, however, the instances can be configured to listen on any port (8888 by default). **WARNING** This template creates one or more Amazon EC2 instances. You will be billed for the AWS resources used if you create a stack from this template.",
+
+  "Parameters" : {
+    "InstanceType" : {
+      "Description" : "Type of EC2 instance to launch",
+      "Type" : "String",
+      "Default" : "m1.small"
+    },
+    "WebServerPort" : {
+      "Description" : "The TCP port for the Web Server",
+      "Type" : "String",
+      "Default" : "8888"
+    },
+    "KeyName" : {
+      "Description" : "The EC2 Key Pair to allow SSH access to the instances",
+      "Type" : "String"
+    }
+  },
+
+  "Mappings" : {
+    "AWSInstanceType2Arch" : {
+      "t1.micro"    : { "Arch" : "64" },
+      "m1.small"    : { "Arch" : "32" },
+      "m1.large"    : { "Arch" : "64" },
+      "m1.xlarge"   : { "Arch" : "64" },
+      "m2.xlarge"   : { "Arch" : "64" },
+      "m2.2xlarge"  : { "Arch" : "64" },
+      "m2.4xlarge"  : { "Arch" : "64" },
+      "c1.medium"   : { "Arch" : "32" },
+      "c1.xlarge"   : { "Arch" : "64" },
+      "cc1.4xlarge" : { "Arch" : "64" }
+    },
+    "AWSRegionArch2AMI" : {
+      "us-east-1" : { "32" : "ami-6411e20d", "64" : "ami-7a11e213" },
+      "us-west-1" : { "32" : "ami-c9c7978c", "64" : "ami-cfc7978a" },
+      "eu-west-1" : { "32" : "ami-37c2f643", "64" : "ami-31c2f645" },
+      "ap-southeast-1" : { "32" : "ami-66f28c34", "64" : "ami-60f28c32" },
+      "ap-northeast-1" : { "32" : "ami-9c03a89d", "64" : "ami-a003a8a1" }
+    }
+  },
+
+  "Resources" : {
+    "WebServerGroup" : {
+      "Type" : "AWS::AutoScaling::AutoScalingGroup",
+      "Properties" : {
+        "AvailabilityZones" : { "Fn::GetAZs" : ""},
+        "LaunchConfigurationName" : { "Ref" : "LaunchConfig" },
+        "MinSize" : "1",
+        "MaxSize" : "3",
+        "LoadBalancerNames" : [ { "Ref" : "ElasticLoadBalancer" } ]
+      }
+   },
+
+    "LaunchConfig" : {
+      "Type" : "AWS::AutoScaling::LaunchConfiguration",
+      "Properties" : {
+        "KeyName" : { "Ref" : "KeyName" },
+        "ImageId" : { "Fn::FindInMap" : [ "AWSRegionArch2AMI", { "Ref" : "AWS::Region" },
+                                          { "Fn::FindInMap" : [ "AWSInstanceType2Arch", { "Ref" : "InstanceType" },
+                                          "Arch" ] } ] },
+        "UserData" : { "Fn::Base64" : { "Ref" : "WebServerPort" }},
+        "SecurityGroups" : [ { "Ref" : "InstanceSecurityGroup" } ],
+        "InstanceType" : { "Ref" : "InstanceType" }
+      }
+    },
+
+    "WebServerScaleUpPolicy" : {
+      "Type" : "AWS::AutoScaling::ScalingPolicy",
+      "Properties" : {
+        "AdjustmentType" : "ChangeInCapacity",
+        "AutoScalingGroupName" : { "Ref" : "WebServerGroup" },
+        "Cooldown" : "60",
+        "ScalingAdjustment" : "1"
+      }
+    },
+    "WebServerScaleDownPolicy" : {
+      "Type" : "AWS::AutoScaling::ScalingPolicy",
+      "Properties" : {
+        "AdjustmentType" : "ChangeInCapacity",
+        "AutoScalingGroupName" : { "Ref" : "WebServerGroup" },
+        "Cooldown" : "60",
+        "ScalingAdjustment" : "-1"
+      }
+    },
+
+    "CPUAlarmHigh": {
+     "Type": "AWS::CloudWatch::Alarm",
+     "Properties": {
+        "AlarmDescription": "Scale-up if CPU > 90% for 10 minutes",
+        "MetricName": "CPUUtilization",
+        "Namespace": "AWS/EC2",
+        "Statistic": "Average",
+        "Period": "300",
+        "EvaluationPeriods": "2",
+        "Threshold": "90",
+        "AlarmActions": [ { "Ref": "WebServerScaleUpPolicy" } ],
+        "Dimensions": [
+          {
+            "Name": "AutoScalingGroupName",
+            "Value": { "Ref": "WebServerGroup" }
+          }
+        ],
+        "ComparisonOperator": "GreaterThanThreshold"
+      }
+    },
+    "CPUAlarmLow": {
+     "Type": "AWS::CloudWatch::Alarm",
+     "Properties": {
+        "AlarmDescription": "Scale-down if CPU < 70% for 10 minutes",
+        "MetricName": "CPUUtilization",
+        "Namespace": "AWS/EC2",
+        "Statistic": "Average",
+        "Period": "300",
+        "EvaluationPeriods": "2",
+        "Threshold": "70",
+        "AlarmActions": [ { "Ref": "WebServerScaleDownPolicy" } ],
+        "Dimensions": [
+          {
+            "Name": "AutoScalingGroupName",
+            "Value": { "Ref": "WebServerGroup" }
+          }
+        ],
+        "ComparisonOperator": "LessThanThreshold"
+      }
+    },
+
+    "ElasticLoadBalancer" : {
+      "Type" : "AWS::ElasticLoadBalancing::LoadBalancer",
+      "Properties" : {
+        "AvailabilityZones" : { "Fn::GetAZs" : "" },
+        "Listeners" : [ {
+          "LoadBalancerPort" : "80",
+          "InstancePort" : { "Ref" : "WebServerPort" },
+          "Protocol" : "HTTP"
+        } ],
+        "HealthCheck" : {
+          "Target" : { "Fn::Join" : [ "", ["HTTP:", { "Ref" : "WebServerPort" }, "/"]]},
+          "HealthyThreshold" : "3",
+          "UnhealthyThreshold" : "5",
+          "Interval" : "30",
+          "Timeout" : "5"
+        }
+      }
+    },
+
+    "InstanceSecurityGroup" : {
+      "Type" : "AWS::EC2::SecurityGroup",
+      "Properties" : {
+        "GroupDescription" : "Enable SSH access and HTTP access on the inbound port",
+        "SecurityGroupIngress" : [ {
+          "IpProtocol" : "tcp",
+          "FromPort" : "22",
+          "ToPort" : "22",
+          "CidrIp" : "0.0.0.0/0"
+        },
+        {
+          "IpProtocol" : "tcp",
+          "FromPort" : { "Ref" : "WebServerPort" },
+          "ToPort" : { "Ref" : "WebServerPort" },
+          "SourceSecurityGroupOwnerId" : {"Fn::GetAtt" : ["ElasticLoadBalancer", "SourceSecurityGroup.OwnerAlias"]},
+          "SourceSecurityGroupName" : {"Fn::GetAtt" : ["ElasticLoadBalancer", "SourceSecurityGroup.GroupName"]}
+        } ]
+      }
+    }
+  },
+
+  "Outputs" : {
+    "URL" : {
+      "Description" : "The URL of the website",
+      "Value" :  { "Fn::Join" : [ "", [ "http://", { "Fn::GetAtt" : [ "ElasticLoadBalancer", "DNSName" ]}]]}
+    }
+  }
+}

data/sample/autoscale2.rb

@@ -0,0 +1,231 @@
+
+# We start things off by calling the CloudFormation function.
+CloudFormation {
+  # Declare the template format version
+  AWSTemplateFormatVersion "2010-09-09"
+
+  # As the DSL is really ruby, we get all of the different
+  # ways to quote strings that come with ruby.
+  Description %Q/
+Create a multi-az, load balanced, Auto Scaled sample web site. The
+Auto Scaling trigger is based on the CPU utilization of the web
+servers. The AMI is chosen based on the region in which the stack is
+run. This example creates a web service running across all
+availability zones in a region. The instances are load balanced with a
+simple health check. The web site is available on port 80, however,
+the instances can be configured to listen on any port (8888 by
+default).
+
+**WARNING** This template creates one or more Amazon EC2
+instances. You will be billed for the AWS resources used if you create
+a stack from this template.
+/
+
+  # We can declare Parameters anywhere in the CloudFormation
+  # block - these will get rolled up into the Parameters container
+  # in the output.
+  Parameter("InstanceType") {
+      Description "Type of EC2 instance to launch"
+      Type "String"
+      Default "m1.small"
+  }
+
+  Parameter( "WebServerPort") {
+    Description "The TCP port for the Web Server"
+    Type "String"
+    Default "8888"
+  }
+  Parameter("KeyName") {
+    Description "The EC2 Key Pair to allow SSH access to the instances"
+    Type "String"
+  }
+
+  # The same kind of thing for parameters works for mappings, 
+  # except that there is not a special object declared for mappings,
+  # so we just have to build a hash of hashes which will be turned
+  # directly into json.
+
+  Mapping("AWSRegionArch2AMI", {
+            "us-east-1" => { "32" => "ami-6411e20d", "64" => "ami-7a11e213" },
+            "us-west-1" => { "32" => "ami-c9c7978c", "64" => "ami-cfc7978a" },
+            "eu-west-1" => { "32" => "ami-37c2f643", "64" => "ami-31c2f645" },
+            "ap-southeast-1" => { "32" => "ami-66f28c34", "64" => "ami-60f28c32" },
+            "ap-northeast-1" => { "32" => "ami-9c03a89d", "64" => "ami-a003a8a1" }
+    })
+
+
+  # We can also write arbitrary ruby code
+
+  # Here we build up a ruby hash
+  architectures = {}
+  [ "t1.micro", "m1.large", "m1.xlarge", "m2.xlarge",
+    "m2.2xlarge", "m2.4xlarge", "c1.xlarge", "cc1.4xlarge" 
+  ].each do |arch|
+    # Iterate through the 64 bit machines to build a mapping for
+    # 64 bit architecture
+    architectures[arch] = { "Arch" => "64" }
+  end
+
+  [ "m1.small", "c1.medium"
+  ].each do |arch|
+    # iterate throught he 32 bit machine to build a mapping for
+    # 32 bit architectures
+    architectures[arch] = { "Arch" => "32" }
+  end
+  
+  Mapping("AWSInstanceType2Arch", architectures )
+  # This will add a mapping entry equivalent to the following to the
+  # template:
+  #
+  # "AWSInstanceType2Arch" : {
+  #   "m2.4xlarge" :  { "Arch" : "64" },
+  #   "c1.xlarge" :   { "Arch" : "64" },
+  #   "c1.medium" :   { "Arch" : "32" },
+  #   "m1.xlarge" :   { "Arch" : "64" },
+  #   "m1.large" :    { "Arch" : "64" },
+  #   "t1.micro" :    { "Arch" : "64" },
+  #   "m1.small" :    { "Arch" : "32" },
+  #   "m2.2xlarge" :  { "Arch" : "64" },
+  #   "m2.xlarge" :   { "Arch" : "64" },
+  #   "cc1.4xlarge" : { "Arch" : "64" }
+  # }
+
+  # Resources work similar to Parameters
+  AutoScalingGroup("WebServerGroup") {
+    UpdatePolicy("AutoScalingRollingUpdate", {
+                 "MinInstancesInService" => "1",
+                 "MaxBatchSize"          => "1",
+                 "PauseTime"             => "PT15M"
+                 })
+    AvailabilityZones FnGetAZs("")
+    LaunchConfigurationName Ref("LaunchConfig")
+    MinSize 1
+    MaxSize 3
+    LoadBalancerNames Ref( "ElasticLoadBalancer" )
+  }
+
+  # You can use either strings or symbols for
+  # Resource/Parameter/Mapping/Output names
+  LaunchConfiguration( :LaunchConfig ) {
+    KeyName Ref("KeyName")
+    ImageId FnFindInMap( "AWSRegionArch2AMI", 
+                         Ref("AWS::Region"),
+                         FnFindInMap( "AWSInstanceType2Arch", Ref("InstanceType"),"Arch") )
+
+    UserData FnBase64( Ref("WebServerPort"))
+    SecurityGroup Ref("InstanceSecurityGroup")
+    InstanceType Ref("InstanceType")
+  }
+
+
+  Resource( "WebServerScaleUpPolicy" ) {
+    Type "AWS::AutoScaling::ScalingPolicy"
+    Property("AdjustmentType", "ChangeInCapacity")
+    Property("AutoScalingGroupName", Ref( "WebServerGroup") )
+    Property("Cooldown", "60")
+    Property("ScalingAdjustment", "1")
+  }
+   
+  Resource("WebServerScaleDownPolicy") {
+    Type "AWS::AutoScaling::ScalingPolicy"
+    Property("AdjustmentType", "ChangeInCapacity")
+    Property("AutoScalingGroupName", Ref( "WebServerGroup" ))
+    Property("Cooldown", "60")
+    Property("ScalingAdjustment", "-1")
+  }
+  
+
+  # You can use ruby language constructs to keep from repeating
+  # yourself
+
+  # declare an aray - we are going to use it to collect some
+  # resources that we create
+  alarms = [];
+
+  # When we declare a resource with "Resource", we are 
+  # actually calling a method on CfnDsl::CloudFormationTemplate
+  # that sets up the resource, and then returns it. We can use
+  # the return value for other means.
+  alarms.push Resource("CPUAlarmHigh") {
+    Type "AWS::CloudWatch::Alarm"
+    Property("AlarmDescription", "Scale-up if CPU > 90% for 10 minutes")
+    Property("Threshold", "90")
+    Property("AlarmActions", [ Ref("WebServerScaleUpPolicy" ) ])
+    Property("ComparisonOperator", "GreaterThanThreshold")
+  }
+
+  # Declare a second alarm resource and add it to our list
+  alarms.push Resource("CPUAlarmLow") {
+    Type "AWS::CloudWatch::Alarm"
+    Property("AlarmDescription", "Scale-down if CPU < 70% for 10 minutes")
+    Property("Threshold", "70")
+    Property("AlarmActions", [ Ref("WebServerScaleDownPolicy" ) ])
+    Property("ComparisonOperator", "LessThanThreshold")
+  }
+
+  # Ok, the alarms that we previously declared actually share a bunch
+  # of property declarations. Here we iterate through the alarms and
+  # call declare on each one, passing in a code block. This works the 
+  # same as the declarations placed in the code blocks that went along 
+  # with the call to Resource that was used to create the resouce above.
+  alarms.each do |alarm|
+    alarm.declare {
+      Property("MetricName", "CPUUtilization")
+      Property("Namespace", "AWS/EC2")
+      Property("Statistic", "Average")
+      Property("Period", "300")
+      Property("EvaluationPeriods", "2")
+      Property("Dimensions", [
+                              {
+                                "Name" => "AutoScalingGroupName",
+                                "Value" => Ref("WebServerGroup" )
+                              }
+                             ])
+
+    }
+  end
+
+
+  Resource( "ElasticLoadBalancer" ) {
+    Type "AWS::ElasticLoadBalancing::LoadBalancer"
+    Property( "AvailabilityZones", FnGetAZs(""))
+    Property( "Listeners" , [ {
+                                "LoadBalancerPort" => "80",
+                                "InstancePort" => Ref( "WebServerPort" ),
+                                "Protocol" => "HTTP"
+                              } ] )
+    Property( "HealthCheck" , {
+                # FnFormat replaces %0, %1, etc with passed in parameters
+                # Note that it renders to a call to Fn::Join in the json.
+                "Target" => FnFormat("HTTP:%0/", Ref( "WebServerPort" ) ),
+                "HealthyThreshold" => "3",
+                "UnhealthyThreshold" => "5",
+                "Interval" => "30",
+                "Timeout" => "5"
+              })
+  }
+  
+  Resource("InstanceSecurityGroup" ) {
+    Type "AWS::EC2::SecurityGroup"
+    Property("GroupDescription" , "Enable SSH access and HTTP access on the inbound port")
+    Property("SecurityGroupIngress", [ {
+          "IpProtocol" => "tcp",
+          "FromPort" => "22",
+          "ToPort" => "22",
+          "CidrIp" => "0.0.0.0/0"
+        },
+        {
+          "IpProtocol" => "tcp",
+          "FromPort" => Ref( "WebServerPort" ),
+          "ToPort" => Ref( "WebServerPort" ),
+          "SourceSecurityGroupOwnerId" => FnGetAtt("ElasticLoadBalancer", "SourceSecurityGroup.OwnerAlias"),
+          "SourceSecurityGroupName" => FnGetAtt("ElasticLoadBalancer", "SourceSecurityGroup.GroupName")
+        } ])
+  }
+
+  Output( "URL" ) {
+    Description "The URL of the website"
+    Value FnJoin( "", [ "http://", FnGetAtt( "ElasticLoadBalancer", "DNSName" ) ] )
+  }
+
+}

data/sample/circular.rb

@@ -0,0 +1,33 @@
+
+CloudFormation {
+  AWSTemplateFormatVersion "2010-09-09"
+
+  Description "Circular Reference"
+
+  Parameter("InstanceType") {
+      Description "Type of EC2 instance to launch"
+      Type "String"
+      Default "m1.small"
+  }
+
+  Resource("WebServerGroup") {
+    Type "AWS::AutoScaling::AutoScalingGroup"
+    Property("AvailabilityZones", FnGetAZs("") )
+    Property("LaunchConfigurationName", Ref( "LaunchConfig") )
+    Property("MinSize", "1")
+    Property("MaxSize", "3")
+  }
+
+
+  Resource( "LaunchConfig" ) {
+    Type "AWS::AutoScaling::LaunchConfiguration"
+    DependsOn ["WebServerGroup"]
+    Property("InstanceType",   Ref("InstanceType") )
+  }
+
+
+  Output( "URL" ) {
+    Description "The URL of the website"
+    Value FnJoin( "", [ "http://", FnGetAtt( "LaunchConfig", "DNSName" ) ] )
+  }
+}

data/sample/t1.rb

@@ -0,0 +1,16 @@
+CloudFormation {
+
+  DESCRIPTION ||= "default description"
+  MACHINES ||= 1
+
+  Description DESCRIPTION
+
+  (1..MACHINES).each do |i|
+    name = "machine#{i}"
+    Instance(name) {
+      ImageId "ami-12345678"
+      Type "t1.micro"
+    }
+  end
+  
+}