serverless-prune-plugin

Serverless 1.x plugin to reap unused versions of deployed functions from AWS

Github星跟踪图

Serverless Prune Plugin

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 targets Serverless 1.x.

Serverless
Build Status
Coverage Status

Installation

Install with npm:

npm install --save-dev serverless-prune-plugin

And then add the plugin to your serverless.yml file:

plugins:
  - serverless-prune-plugin

Alternatively, install with the Serverless plugin command (Serverless Framework 1.22 or higher):

sls plugin install -n serverless-prune-plugin

Usage

In the project root, run:

sls prune -n <number of version to keep>

This will delete all but the n-most recent versions of each function deployed. Versions referenced by an alias are automatically preserved.

Single Function

A single function can be targeted for cleanup:

sls prune -n <number of version to keep> -f helloWorld

Region/Stage

The previous usage examples prune the default stage in the default region. Use --stage and --region to specify:

sls prune -n <number of version to keep> --stage production --region eu-central-1

Automatic Pruning

This plugin can also be configured to run automatically, following a deployment. Configuration of automatic pruning is within the custom property of serverless.yml. For example:

custom:
  prune:
    automatic: true
    number: 3

To run automatically, the automatic property of prune must be set to true and the number of versions to keep must be specified.

Layers

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, includeLayers:

custom:
  prune:
    automatic: true
    includeLayers: true
    number: 3

Dry Run

A dry-run will preview the deletion candidates, without actually performing the pruning operations:

sls prune -n <number of version to keep> --dryRun

Additional Help

See:

sls prune --help

See Also

The Serverless Autoprune Plugin by arabold performs a similar role, but targets Serverless 0.5.x projects.

License

See the included LICENSE for rights and limitations under the terms of the MIT license.

主要指标

概览
名称与所有者claygregory/serverless-prune-plugin
主编程语言JavaScript
编程语言JavaScript (语言数: 1)
平台
许可证MIT License
所有者活动
创建于2017-01-14 02:05:36
推送于2025-02-18 01:04:17
最后一次提交2024-10-16 00:54:12
发布数27
最新版本名称v.2.1.0 (发布于 )
第一版名称v1.0.0 (发布于 )
用户参与
星数366
关注者数9
派生数34
提交数117
已启用问题?
问题数38
打开的问题数9
拉请求数34
打开的拉请求数4
关闭的拉请求数3
项目设置
已启用Wiki?
已存档?
是复刻?
已锁定?
是镜像?
是私有?