CloudFormation Template Generator

Simple Scala DSL to create AWS CloudFormation (CFN) templates. The library allows for easier creation of the AWS CloudFormation JSON by writing Scala code to describe the AWS resources. Lets say we have a handful of CFN templates we want to maintain, and all of those templates use the same AMI. Instead of copying that information into all the templates, lets create an AMI component instead, and then load it into the actual templates.

Why not just write JSON? Because, who in their right mind would want to write all AWS resources in JSON?

Documentation

See the intro blog post here: http://engineering.monsanto.com/2015/07/10/cloudformation-template-generator/

You must add the following resolver to your build.sbt to use this library.

resolvers ++= Seq(Resolver.jcenterRepo)

See the Scaladoc for detailed documentation and examples.

Components

Create a Template instance of resources and check out VPCWriter to help write it to a file.

Misc Features

NEW since the blog post, say you have a topology with subnets across multiple AZ's and you want to specify an autoscaling group that spans them, using our fancy Builders methods. Well this is cross-cutting, so its not strictly nested, so you can use an evil evil var, or now you can use our Template.lookupResource[R <: Resource[R]](name: String) method on previous template parts to extract resources by name. Note this will produce a generation-time error if you lookup something that does not exist or has the wrong type (unfortunately not a generation-time compiler error as most of our other features):

describe("Template Lookup") {
  it("Should lookup resources with the correct type") {

    val expected = `AWS::EC2::VPC`(
      name = "TestVPC",
      CidrBlock = CidrBlock(0,0,0,0,0),
      Tags = Seq.empty[AmazonTag]
    )
    val template = Template.fromResource(expected)
  
    assert(expected === template.lookupResource[`AWS::EC2::VPC`]("TestVPC"))
}

Currently supported AWS resource types

• AWS::AutoScaling::AutoScalingGroup
• AWS::AutoScaling::LaunchConfiguration
• AWS::AutoScaling::ScalingPolicy
• AWS::CloudWatch::Alarm
• AWS::EC2::EIP
• AWS::EC2::Instance
• AWS::EC2::InternetGateway
• AWS::EC2::KeyPair::KeyName
• AWS::EC2::Route
• AWS::EC2::RouteTable
• AWS::EC2::SecurityGroup
• AWS::EC2::SecurityGroupEgress
• AWS::EC2::SecurityGroupIngress
• AWS::EC2::Subnet
• AWS::EC2::SubnetRouteTableAssociation
• AWS::EC2::VPC
• AWS::EC2::VPCGatewayAttachment
• AWS::EC2::Volume
• AWS::EC2::VolumeAttachment
• AWS::ElasticLoadBalancing::LoadBalancer
• AWS::IAM::AccessKey
• AWS::IAM::Group
• AWS::IAM::InstanceProfile
• AWS::IAM::ManagedPolicy
• AWS::IAM::Policy
• AWS::IAM::Role
• AWS::IAM::User
• AWS::RDS::DBInstance::Engine
• AWS::RDS::DBInstance::StorageType
• AWS::RDS::DBInstance
• AWS::RDS::DBParameterGroup
• AWS::RDS::DBSecurityGroup
• AWS::RDS::DBSubnetGroup
• AWS::Redshift::Cluster
• AWS::Redshift::ClusterSecurityGroup
• AWS::Redshift::ClusterSecurityGroupIngress
• AWS::Redshift::ClusterParameterGroup (along with helper RedshiftClusterParameter type)
• AWS::Redshift::ClusterSubnetGroup
• AWS::Route53::HostedZone
• AWS::Route53::RecordSet
• AWS::S3::Bucket
• AWS::S3::BucketPolicy