finchpowers / serverless-v3-aws-lambda-runtime-schema-override

Serverless V3 AWS Lambda Runtime Schema Override Plugin

serverless-v3-aws-lambda-runtime-schema-override

This is a plugin to override the default schema of the AWS Lambda runtime in the Serverless Framework v3. Since version 3 is unmaintained, this plugin can be used to circumvent the lack of updates to the runtime schema while keeping configValidationMode set to error.

This can be done by simply installing this plugin and adding it to the list of plugins to use in the serverless configuration.

plugins:
  - serverless-v3-aws-lambda-runtime-schema-override

At the time of writing, this pluging has the currently supported runtimes baked in. Should it fall behind, it can still be used to manually override the schema by providing a runtimes list under custom.awsLambdaRuntimeSchemaOverride.

custom:
  awsLambdaRuntimeSchemaOverride:
  - dotnet6
  - go1.x
  - java17
  - java21
  - nodejs18.x
  - nodejs20.x
  - provided
  - provided.al2
  - provided.al2023
  - python3.10
  - python3.11
  - python3.12
  - ruby2.7
  - ruby3.2

Note that only the runtimes that are being used need to be included in the list.

Notes

sls invoke local will not work with non core runtimes.

sls invoke local is unaffected by this plugin. This is because the plugin overrides the runtime schema, but the local invocation uses a baked in list that may prove challenging to override. Here is an example within serverless 3.38.0.