Serverless Framework V2

Sep 21, 2020

We recently released our first (minimal) set of breaking changes in the Serverless Framework, in over 4 years, prompted by deprecating support for old Node.js versions. These breaking changes are included in the new v2 release.

Here is a quick article to detail the breaking changes and how they may impact you.

Deprecating Support for Node.js Version 6 and 8

You will now need Node.js v10 or higher installed locally to use the Serverless Framework. At the time of this release, AWS Lambda supports only Node.js v10 or higher as well. Dropping old Node.js versions allows us to upgrade dependencies with potential security vulnerabilities, making the Serverless Framework more secure.

Run the Locally Installed Version by Default

If you have the Serverless Framework CLI installed locally within your Service (i.e. project) folder, that version of the Framework will be run, instead of a globally installed version.

Otherwise, if the Framework is not installed loclly, but is installed globally, it will default to that.

AWS HTTP API, Lambda Integration

Amazon's new API Gateway product, "HTTP API", has updated its initial payload format (v1.0) for its AWS Lambda integration. We've decided to use the new payload format (v2.0) as the default format.

More info here:

AWS ALB Config Change

Support for providers.alb.authorizers[].allowUnauthenticated setting was removed. Please now rely on providers.alb.authorizers[].onUnauthenticatedRequest instead.

Moving Forward

Generally, we have avoided breaking changes to avoid creating unnecessary churn. We continue to feel this way.

At the same time, we have decided to adopt true semantic versioning for the Serverless Framework. Again, we don't intend to make large, breaking changes in the future. But we want to be more clear when that is the case.

As always, many thanks to our community for their continued support. Continue making amazing serverless applications!

Learn more about the V2 release here

Subscribe to our newsletter to get the latest product updates, tips, and best practices!

Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.