Add macro deploy

macro/Makefile

@@ -0,0 +1,10 @@
+BUCKET=macro-template-default-831650818513-us-east-1
+
+macro:
+ pip install -r source/requirements.txt -t source
+ aws cloudformation package --template-file template.yaml --s3-bucket $(BUCKET) --output-template-file template.output
+ aws cloudformation deploy --template-file template.output --stack-name TroposphereMacro --capabilities CAPABILITY_IAM
+ rm -rf template.output
+
+sample:
+ aws cloudformation deploy --stack-name template-macro-example --template-file example.py --parameter-overrides InstanceName=NewName

macro/README.md

@@ -0,0 +1,76 @@
+# Troposphere Macro
+
+The `Troposphere` macro adds the ability to create CloudFormation resources from troposphere stacks.
+
+# How to install and use the Macro in your AWS account
+
+## Deploying
+
+1. You will need an S3 bucket to store the CloudFormation artifacts:
+ * If you don't have one already, create one with `aws s3 mb s3://<bucket name>`
+
+2. Install all python requirements
+
+ ```shell
+ pip install -r source/requirements.txt -t source
+ ```
+
+3. Package the CloudFormation template. The provided template uses [the AWS Serverless Application Model](https://aws.amazon.com/about-aws/whats-new/2016/11/introducing-the-aws-serverless-application-model/) so must be transformed before you can deploy it.
+
+ ```shell
+ aws cloudformation package \
+ --template-file template.yaml \
+ --s3-bucket <your bucket name here> \
+ --output-template-file template.output
+ ```
+
+4. Deploy the packaged CloudFormation template to a CloudFormation stack:
+
+ ```shell
+ aws cloudformation deploy \
+ --stack-name troposphere-macro \
+ --template-file template.output \
+ --capabilities CAPABILITY_IAM
+ ```
+
+5. To test out the macro's capabilities, try launching the provided example template:
+
+ ```shell
+ aws cloudformation deploy \
+ --stack-name template-macro-example \
+ --template-file example.py
+ ```
+
+## Usage
+
+Just add your resources to macro_template object, the template object is created by macro itself.
+You can provide your troposphere code in Troposphere tag.
+
+```
+Transform: [Troposhere]
+Description: Example Macro Troposhere.
+
+Parameters:
+ InstanceName:
+ Type: String
+ Default: "MyInstance"
+ ImageId:
+ Type: String
+ Default: "ami-951945d0"
+ InstanceType:
+ Type: String
+ Default: "t1.micro"
+
+Troposhere: |
+ from troposphere import Ref
+ import troposphere.ec2 as ec2
+
+ instance = ec2.Instance('MyInstance')
+
+ instance.ImageId = Ref('ImageId')
+ instance.InstanceType = Ref('InstanceType')
+ instance.Tags = ec2.Tags(Name = Ref('InstanceName'))
+
+ macro_template.add_resource(instance)
+```
+

macro/example.py

@@ -0,0 +1,30 @@
+Transform: [Troposhere]
+Description: Example Macro Troposhere.
+
+Parameters:
+ InstanceName:
+ Type: String
+ Default: "MyInstance"
+ ImageId:
+ Type: String
+ Default: "ami-eb0c7791"
+ InstanceType:
+ Type: String
+ Default: "t1.micro"
+
+Troposhere: |
+ from troposphere import Ref
+ import troposphere.ec2 as ec2
+
+ list_instances = ["One", "Two", "Three", "Four"]
+
+ instance_name = macro_parameters["InstanceName"]
+
+ for el in list_instances:
+ instance = ec2.Instance('MyInstance{}'.format(el))
+
+ instance.ImageId = Ref('ImageId')
+ instance.InstanceType = Ref('InstanceType')
+ instance.Tags = ec2.Tags(Name = instance_name + el)
+
+ macro_template.add_resource(instance)

macro/source/macro.py

@@ -0,0 +1,33 @@
+from troposphere.template_generator import TemplateGenerator
+import traceback
+
+def handle_template(event):
+ template = event['fragment']
+ macro_parameters = event['templateParameterValues']
+
+ troposphere_code = template["Troposhere"]
+ del template["Troposhere"]
+
+ macro_template = TemplateGenerator(template)
+ exec(troposphere_code)
+
+ return macro_template.to_dict()
+
+def handler(event, context):
+ request_id = event['requestId']
+
+ macro_response = {
+ 'status': 'success',
+ 'requestId': request_id
+ }
+
+ try:
+ macro_response['fragment'] = handle_template(event)
+ except Exception as e:
+ traceback.print_exc()
+ macro_response['status'] = 'failure'
+ macro_response['errorMessage'] = str(e)
+
+ return macro_response
+
+

macro/source/requirements.txt

@@ -0,0 +1 @@
+troposphere[policy]

macro/template.yaml

@@ -0,0 +1,40 @@
+Transform: AWS::Serverless-2016-10-31
+
+Resources:
+ TransformExecutionRole:
+ Type: AWS::IAM::Role
+ Properties:
+ AssumeRolePolicyDocument:
+ Version: 2012-10-17
+ Statement:
+ - Effect: Allow
+ Principal:
+ Service: 
+ - lambda.amazonaws.com
+ Action: 
+ - 'sts:AssumeRole'
+ Path: /
+ Policies:
+ - PolicyName: root
+ PolicyDocument:
+ Version: 2012-10-17
+ Statement:
+ - Effect: Allow
+ Action: 
+ - 'logs:*'
+ Resource: 'arn:aws:logs:*:*:*'
+
+ MacroFunction:
+ Type: AWS::Serverless::Function
+ Properties:
+ Runtime: python3.6
+ CodeUri: source/
+ Handler: macro.handler
+ Role: !GetAtt TransformExecutionRole.Arn
+ Timeout: 300
+
+ Macro:
+ Type: AWS::CloudFormation::Macro
+ Properties:
+ Name: Troposhere
+ FunctionName: !GetAtt MacroFunction.Arn