Serverless Lambda Edge PreExisting CloudFront
A Serverless Framework plugin which associates Lambda@Edge against pre-existing CloudFront distributions.
Install
You can install this plugin from npm registry.
$ npm install --save-dev serverless-lambda-edge-pre-existing-cloudfront
How it works
Configure serverless.yml
functions:
viewerRequest:
handler: lambdaEdge/viewerRequest.handler
events:
- preExistingCloudFront:
distributionId: xxxxxxx
eventType: viewer-request
pathPattern: '*'
includeBody: false
stage: dev
plugins:
- serverless-lambda-edge-pre-existing-cloudfront
Run deploy
$ serverless deploy
You can specify additional configurations a lambdaEdgePreExistingCloudFront
value in the custom section of your serverless.yml file.
A validStages
value allows you to specify valid stage names for deploy Lambda@Edge.
lambdaEdgePreExistingCloudFront:
validStages:
- staging
- production
How validStages
and stage
properties work
This plugin will first check for validStages
property defined in the custom
section. If validStages
is used, then all the preExistingCloudFront
events are only possible to be updated at the validStages
. If not used, all the preExistingCloudFront
events are possible to be updated at any stage.
Then at all valid stages, the plugin checks - for each preExistingCloudFront
event - if the provider's stage is the same as the stage
property defined for each preExistingCloudFront
event. If they match, then that particular preExistingCloudFront
event will be updated.
If stage
is not used for a preExistingCloudFront
event, then that event will be updated at all validStages
or all stages if validStages
is not used.