pybuilder_aws_plugin 183

@Task: package_lambda_code

This task assembles the Zip-file (a.k.a. the lambda-zip) which will be uploaded to S3 with the task upload_zip_to_s3. This task consists of the following steps:

@Task: upload_zip_to_s3

This task uploads the generated zip to an S3 bucket. The bucket name is set in build.py:

project.set_property('bucket_name', 'my_lambda_bucket')

The default acl for zips to be uploaded is bucket-owner-full-control. But if you need another acl you can overwrite this as follows in build.py:

project.set_property('lambda_file_access_control', '<acl>')

Possible acl values are:

• private

• public-read

• public-read-write

• authenticated-read

• bucket-owner-read

• bucket-owner-full-control

Furthermore, the plugin assumes that you already have a shell with enabled AWS access (exported keys or .boto or …). afp-cli is a tool to provide temporary credentials for shell users.

The uploaded files will be placed in a directory with the version number like: v123/projectname.zip.

Use the property bucket_prefix to add a prefix to the uploaded files. For example:

project.set_property('bucket_prefix', 'my_lambda/')

This will upload the zip-file to the following key: my_lambda/v123/projectname.zip

On TeamCity you can enable setting a TeamCity build parameter with the key of the uploaded zip-file:

After uploading the zip-file to S3 the plugin will emit a

##teamcity[setParameter name='my_tc_parameter' value='my_lambda/v123/project-name.zip']

line which TeamCity can parse. You can then use the value in other build steps.

@Task: upload_cfn_to_s3

NOTE: This task is available for Python 2.7 and up, due to cfn-sphere dependencies not being available for Python 2.6.

This task converts and uploads the CFN-Sphere template YAML files as JSON to a S3 bucket. Set the bucket name in build.py:

project.set_property('bucket_name', 'my_template_bucket')

Define the CFN templates to upload via a list of tuples in the template_files property:

project.set_property('template_files',
    [
        ('path1','filename1.yaml'),
        ('path2','filename2.yaml'),
        ...
    ])

The uploaded files will be placed in a directory with the version number:

• v123/filename1.json

• v123/filename2.json

Use the property template_key_prefix to add a prefix to the uploaded files. For example:

project.set_property('template_key_prefix', 'my_template/')

This will upload the files to the following files:

• my_template/v123/filename1.json

• my_template/v123/filename2.json

The ACL for the JSON files is bucket-owner-full-control. Set another ACL in build.py:

project.set_property('template_file_access_control', '<acl>')

Possible acl values are:

• private

• public-read

• public-read-write

• authenticated-read

• bucket-owner-read

• bucket-owner-full-control

@Task: lambda_release, cfn_release

These tasks copy the lambda-zip or CFN template files from the versioned path to version independant path named latest. For Example:

• my_lambda/v123/my-project.zip is copied to my_lambda/latest/my-project.zip

• my_templates/v123/my-cfn.json is copied to my_templates/latest/my-cfn.json

This provides a simple release mechanism that follows the “latest greatest” principle. Users can rely on the files under latest to be the latest tested version.

@Task: upload_custom_resource, release_custom_resource

For CloudFormation custom resources backed by a Lambda function these two tasks provide convenience wrappers to implement an “Update - Test - Release” process:

#!/bin/bash
set -e
pyb upload_custom_resource
./run-integration-test.py
pyb release_custom_resource

The upload_custom_resource task bundles the upload_zip_to_s3 and the upload_cfn_to_s3 task. It is strongly recmomended to not use a bucket_prefix in order to keep the lambda-zip and CFN templates in the same direcory on S3.