Serverless plugin to reap unused versions of deployed functions from AWS
Following deployment, the Serverless Framework does not purge previous versions of functions from AWS, so the number of deployed versions can grow out of hand rather quickly. This plugin allows pruning of all but the most recent version(s) of managed functions from AWS. This plugin is compatible with Serverless 1.x and higher.
Install with npm:
sh npm install --save-dev serverless-prune-plugin
And then add the plugin to your
yaml plugins: - serverless-prune-plugin
Alternatively, install with the Serverless plugin command (Serverless Framework 1.22 or higher):
sh sls plugin install -n serverless-prune-plugin
In the project root, run:
sh sls prune -n
This will delete all but the
n-most recent versions of each function deployed. Versions referenced by an alias are automatically preserved.
A single function can be targeted for cleanup:
sh sls prune -n -f helloWorld
The previous usage examples prune the default stage in the default region. Use
sh sls prune -n --stage production --region eu-central-1
This plugin can also be configured to run automatically, following a deployment. Configuration of automatic pruning is within the
serverless.yml. For example:
custom: prune: automatic: true number: 3
To run automatically, the
prunemust be set to
numberof versions to keep must be specified. It is possible to set
0. In this case, the plugin will delete all the function versions (except $LATEST); this is useful when disabling function versioning for an already-deployed stack.
This plugin can also prune Lambda Layers in the same manner that it prunes functions. You can specify a Lambda Layer, or add the flag,
custom: prune: automatic: true includeLayers: true number: 3
A dry-run will preview the deletion candidates, without actually performing the pruning operations:
sh sls prune -n --dryRun
sh sls prune --help
To run this plugin, the user will need to be allowed the following permissions in AWS: -
How do I set up different pruning configurations per region/stage?
Several suggestions are available in this thread.
Can I just disable versioning entirely?
Absolutely. While Serverless Framework has it enabled by default, versioning can be disabled.