Skip to main content

AWS CDK package that helps deploying a lambda function into CodeStar.

Project description

AWS CodeStar CDK

A package used to deploy a lambda function into AWS CodeStar via CDK.


This package creates a lambda function, editable via commits to AWS CodeCommit and fully monitored using AWS CodeStar. The function uses gradual code deployment Linear10PercentEvery3Minutes, which means any commits will gradually be deployed and 10 percent of the load will be sent to the new deployment every 3 minutes. If you want to change that, edit the line in


More info:

The function's runtime is specified to python3.6 and the lambda handler (initially called code within your function) is specified to manage.runner (manage is the file name, a.k.a and runner is the function name within the file). All that can also be changed by editing the template.yml file.

Deploying this package creates 4 CloudFormation stacks in total.

The first one uploads the files toolchain.yml and into AWS S3, in order to be accessed by CodeStar.

The second stack is the CDK stack, that creates the CodeStar project.

The third stack is the CodeStar stack, which specifies, what the project should create. It's contents can be edited by editing


The fourth stack is the lambda function stack, which can be edited by editing the template.yml file.


In order to operate the package, you must first install it, using

pip install aws-codestar-cdk

You also need to have an AWS account with a confugured AWS CLI. Here's how to do it:

How to use

Import the main file into your project and call the Main classes constructor.

The arguments for the constructor are the scope, your project name, name of s3 bucket to put function source code and toolchain to, list of subnet IDs where the function should be deployed, list of security group IDs for the function, function invocation event type and event type arguments.

The subnet IDs specify, what subnets your function will be deployed to. Make sure they have NAT gateways, in order to access the internet. Read more:

Function invocation event type can be "Api", "Schedule" or "None"

If the invocation type is schedule, argument schedule_expression is also required.

Is can be either:

rate(x units), meaning your function will be called every x units. e.g. rate(5 minutes), in which case the function will be invoked every 5 minutes.

cron(Minutes Hours Day-of-month Month Day-of-week Year) e.g. cron(0 0 * * ? *), which would mean, that the function will be invoked every day at midnight.

More info:

Parameters are split into 3 groups - VPC parameters, deployment parameters and Lambda type parameters. VPC parameters include subnet IDs and security group IDs.\n Lambda type parameters include event type and optionally schedule expressions.\n Deployment parameters include your project name and bucket name.

Your code should look something like this:

from aws_codestar_cdk.main import LambdaCodeStar
from aws_codestar_cdk.cdk_stack.parameters import VpcParameters, LambdaTypeParameters, DeploymentParameters

app = core.App()

deployment_params = DeploymentParameters('project_name', 'bucket_name')
lambda_params = LambdaTypeParameters(event_type="Schedule", schedule_expression="cron(0 0 * * ? *)")
vpc_params = VpcParameters(['subnet-1', 'subnet-2'], ['sg-1'])

main = LambdaCodeStar(app, vpc_params, deployment_params, lambda_params)


Release history


Version bump. Pascal cases for S3 buckets.


Add history file, update setup file.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for aws-codestar-cdk, version 1.0.4
Filename, size File type Python version Upload date Hashes
Filename, size aws_codestar_cdk-1.0.4-py3-none-any.whl (24.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size aws_codestar_cdk-1.0.4.tar.gz (11.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page