Skip to content

Serverless Framework Plugin to easily deploy lambda@edge functions to an existing CloudFront Distribution

License

Notifications You must be signed in to change notification settings

foxxor/serverless-cloudfront-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Serverless CloudFront - Lambda@edge Plugin

NPM version serverless

This is a Serverless Framework Plugin to easily deploy Lambda@Edge functions to an existing CloudFront Distribution. This Plugin doesn't require the CloudFront Distribution to be under the same CloudFormation Stack. But it does require for the Serverless user role to have permissions to modify the target Distribution.

If the CloudFront Distribution is in the same CloudFormation stack and is being managed by other Serverless plugin, maybe this other plugin is better for you.

Note: In it's current state this plugin overwrites the Lambda Associations and the whitelisted cookies if configured. Please take this into account to prevent overwriting previous configurations.

Installation

Install as a Dev. Dependency using NPM:

$ npm install --save-dev serverless-cloudfront-plugin

Or manually link the plugin project to your project:

How to use?

In your serverless.yml file, configure the deployment rules of the Lambda@Edge functions on CloudFront.

  1. Add the Plugin to the plugins configuration.
  2. In the custom field, add a cloudfront object, with a distributionId and behaviors fields.
  3. Use the same function name in the behaviors section, as specified in the functions configuration.
service: my-awesome-service
plugins:
  ...
  - serverless-cloudfront-plugin
...
functions:
  function1:
    handler: function1.run
    ...
  function2:
    handler: function2.run
    ...
custom:
  ...
  cloudfront:
    distributionId: EABC123DEF456
    behaviors: 
      foo/bar:
        cookies:
         - cookie1
         - cookie2
        lambdaAssociations:
          viewerRequest : function1
          viewerResponse: function2
      foo/bar/lol:
        lambdaAssociations:
          viewerRequest : function1
      foo/*:
        cookies:
         - cookie3
        lambdaAssociations:
          viewerResponse: function2
      DefaultCacheBehavior:
        lambdaAssociations:
          viewerResponse: function3

To-Do

  • Allow to pass other Cloudfront behavior configurations
    • Headers
    • Query strings
    • Etc.
  • Specify multiple distributions

License

MIT

About

Serverless Framework Plugin to easily deploy lambda@edge functions to an existing CloudFront Distribution

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published