Skip to content

A template for a Python AWS Lambda function deployed automatically using the Serverless framework on CircleCI.

License

Notifications You must be signed in to change notification settings

nyoungstudios/py-lambda-circleci

Repository files navigation

Python AWS Lambda Serverless CircleCI Template

This is a simple template to setup a Python cron job as an AWS CloudFormation stack with a Lambda function and automatically deploy it using the Serverless framework on CircleCI. If you prefer to use GitHub Actions, check out this template instead.

Features

This template uses a couple of Serverless plugins to make deploying the CloudFormation stack easier.

Additionally, I have setup a simple Python function so you can setup a logger for your project without getting double prints in AWS CloudWatch.

How to Setup?

  1. Create a new repository based off of this template. Here is the GitHub documentation about creating a repository from a template.
  2. Login to CircleCI and signin with your GitHub account.
  3. Click the Projects tab, and then click the blue Set Up Project button corresponding to the new repository you just created.
  4. In your AWS console, create a new IAM policy. If you are unsure what permissions to add to the policy, I've created a minimal IAM policy with all the necessary permissions that CircleCI needs to deploy your CloudFormation stack. You can simply copy this to the AWS IAM policy JSON editor. Within the IAM policy JSON file, change us-west-1 to whatever region you are using. Additionally change placeholder number 012345678901 to your AWS account number.
  5. Next, create a AWS User based off of this policy. Set the Access type to Programmatic access. And on the permissions page, select Attach existing policies directly and search for the policy you just created in step 4.
  6. Within the project on CircleCI, click the Project Settings button (on the top right side).
  7. Within the Project Settings, click on the tab Environment Variables and set the environment variables AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY from the AWS User that you just created. Additionally, you can set the AWS_DEFAULT_REGION too.
  8. And that's it! Now, whenever you push to your GitHub repository, your code will automatically be deployed as a CloudFormation stack.

Python Versions

This template uses Python 3.8, but if you prefer to use a different Python version, just change 3.8 in serverless.yml and config.yml to whatever version you like. Here are the supported AWS Lambda Python runtimes. Also, here are the CircleCI Python Docker images that you can for deploying.

About

A template for a Python AWS Lambda function deployed automatically using the Serverless framework on CircleCI.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages