To disable specific deprecations set SLS_DEPRECATION_DISABLE
environment variable. Setting SLS_DEPRECATION_DISABLE=*
will disable all deprecations. If you want to disable specific deprecations set SLS_DEPRECATION_DISABLE=CODE1,CODE2
. Alternatively, you can also use disabledDeprecations
in your serverless.yml
in the following manner:
service: myService
disabledDeprecations:
- CODE_1 # To disable specific deprecation with code "CODE_1"
- '*' # To disable all deprecation messages
Deprecation code: AWS_API_GATEWAY_NON_APPLICABLE_SETTINGS
When external API Gateway resource is used and imported via provider.apiGateway.restApiId
setting, both provider.logs.restApi
and provider.tracing.apiGateway
will be ignored. These settings are applicable only if API Gateway resource is provisioned by Serverless Framework.
Deprecation code: CLI_OPTIONS_SCHEMA'
Internal handling of CLI arguments was improved with type awareness for options. Now each option definition is expected have type
defined in its settings.
Possible values are string
, boolean
and multiple
. Check Defining options documentation for more info.
If you rely on a plugin which does not set types (yet) please report the issue at its issue tracker.
Starting with v3.0.0 any option extensions which does not have type
defined will be communicated with a thrown error
Deprecation code: NEW_PACKAGE_PATTERNS
Please use package.patterns
. package.include
and package.exclude
will be removed with v3.0.0
Deprecation code: UNSUPPORTED_CLI_OPTIONS
So far Framework ignored any not recognized CLI options as passed with a CLI command. Still such handling is error prone, as due to e.g. accidental typos, important information may not be passed to the command and lead to unwanted results.
Starting with v3.0.0, Serverless will report unrecognized options with a thrown error.
Note: If you've used such options to aid dynamic resolution of service configuration (passing custom values to ${opt:..}
resolvers).
We suggest to rely on environment variables instead. Setup of environment variables is also way more
convenient since we've added support for .env
files.
Deprecation code: CLI_OPTIONS_BEFORE_COMMAND
Starting with v3.0.0, Serverless will not support putting options before command, e.g. sls -v deploy
will no longer be recognized as deploy
command.
Ensure to always format CLI command as sls [command..] [options...]
Deprecation code: CONFIG_VALIDATION_MODE_DEFAULT
Starting with v3.0.0, Serverless will throw on configuration errors by default. This is changing from the previous default, configValidationMode: warn
Learn more about configuration validation here: http://slss.io/configuration-validation
Deprecation code: AWS_API_GATEWAY_SCHEMAS
Starting with v3.0.0, http.request.schema
property will be replaced by http.request.schemas
. In addition to supporting functionalities such as model name definition and reuse of existing schemas, http.request.schemas
also supports the same notation as http.request.schema
, so you can safely migrate your existing configuration to the new property. For more details about the new configuration, please refer to the API Gateway Event
Deprecation code: AWS_EVENT_BRIDGE_CUSTOM_RESOURCE
Starting with v3.0.0 AWS EventBridge lambda event triggers and all associated EventBridge resources will be deployed using native CloudFormation resources instead of a custom resource that used a lambda to deploy them via the AWS SDK/API.
Adapt to this behavior now by setting provider.eventBridge.useCloudFormation: true
.
Deprecation code: NEW_VARIABLES_RESOLVER
Framework was updated with a new implementation of variables resolver.
It supports very same variable syntax, and is being updated with support for same resolution sources. Still as it has improved internal resolution rules (which leave no room for ambiguity) in some edge cases it may report errors on which old parser passed by.
It's recommended to expose all errors that eventually new resolver may report (those will be an unconditional errors in v3). You can turn that behavior on by adding variablesResolutionMode: 20210326
to service configuration
Deprecation code: AWS_HTTP_API_USE_PROVIDER_TAGS
Starting with v3.0.0, provider.tags
will be applied to Http Api Gateway by default
Set provider.httpApi.useProviderTags
to true
to adapt to the new behavior now.
Deprecation code: MISSING_COMMANDS_OR_OPTIONS_AT_CONSTRUCTION
Note: Applies only to eventual programmatic usage of the Framework
Serverless
constructor was refactored to depend on CLI commands and arguments, to be resolved externally and passed to its constructor with config.commands
and config.options
. Starting from v3.0.0 CLI arguments will not be resolved internally.
Deprecation code: MISSING_SERVICE_CONFIGURATION
Note: Applies only to eventual programmatic usage of the Framework
Serverless
constructor was refactored to depend on service configuration being resolved externally and passed to its constructor with following options:
configuration
- Service configuration (JSON serializable plain object)serviceDir
- Directory in which service is placed (All path references in service configuration will be resolved against this path)configurationFilename
- Name of configuration file (e.g.serverless.yml
).
Starting from v3.0.0 configuration data will not be resolved internally, and if Serverless
is invoked in service context, all three options will have to be provided
Deprecation code: NESTED_CUSTOM_CONFIGURATION_PATH
Note: Applies only to eventual programmatic usage of the Framework
Service configuration in all cases should be put at root folder of a service. All paths in this configuration are resolved against service directory, and it's also the case if configuration is nested in sub directory.
To avoid confusing behavior starting with v3.0.0 Framework will no longer permit to rely on configurations placed in sub directories
Deprecation code: MISSING_SERVICE_CONFIGURATION_PATH
Note: Applies only to eventual programmatic usage of the Framework
Serverless
constructor was refactored to depend on service configuration being resolved externally and passed to its constructor with following options:
configuration
- Service configuration (JSON serializable plain object)serviceDir
- Directory in which service is placed (All path references in service configuration will be resolved against this path)configurationFilename
- Name of configuration file (e.g.serverless.yml
).
Starting from v3.0.0 configuration data will not be resolved internally, and if Serverless
is invoked in service context, all three options will have to be provided
Deprecation code: VARIABLES_ERROR_ON_UNRESOLVED
Starting with v3.0.0, references to variables that cannot be resolved will result in an error being thrown.
Adapt to this behaviour now by adding unresolvedVariablesNotificationMode: error
to service configuration.
Deprecation code: PROVIDER_IAM_SETTINGS
Staring with v3.0.0, all IAM-related settings of provider including iamRoleStatements
, iamManagedPolicies
, role
and cfnRole
will be grouped under iam
property. Refer to theIAM Guide.
provider.role
->provider.iam.role
provider.rolePermissionsBoundary
->provider.iam.role.permissionsBoundary
provider.iamRoleStatements
->provider.iam.role.statements
provider.iamManagedPolicies
->provider.iam.role.managedPolicies
provider.cfnRole
->provider.iam.deploymentRole
In addition, a prior update had documented the new Permissions Boundary property as iam.role.permissionBoundary
. This
has now been deprecated in favor of iam.role.permissionsBoundary
to match the CloudFormation property.
Deprecation code: AWS_API_GATEWAY_SPECIFIC_KEYS
Please use provider.apiGateway.apiKeys
instead of provider.apiKeys
.
Please use provider.apiGateway.resourcePolicy
instead of provider.resourcePolicy
.
Please use provider.apiGateway.usagePlan
instead of provider.usagePlan
.
Starting with v3.0.0, API Gateway-specific configuration keys apiKeys
, resourcePolicy
and usagePlan
will be relocated from provider
to provider.apiGateway
.
Org, app, service, stage, and region are required to resolve variables when logged in, variable resolution will not function without plaintext value. You may override values in serverless.yml
for stage
and region
with command line arguments --stage
and --region
. The rest must be plain text.
Deprecation code: LAMBDA_HASHING_VERSION_V2
Resolution of lambda version hashes was improved with better (fixed deterministism issues) algorithm, which will be used starting with v3.0.0
You can adapt your services to use it now, by setting provider.lambdaHashingVersion
to 20201221
.
Notice: If you apply this on already deployed service without any changes to lambda code, you might encounter an error similar to the one below:
Serverless Error ---------------------------------------
An error occurred: FooLambdaVersion3IV5NZ3sE5T2UFimCOai2Tc6eCaW7yIYOP786U0Oc - A version for this Lambda function exists ( 11 ). Modify the function to create a new version..
It is an expected behavior. AWS complains here that received a different hash for very same lambda configuration. To workaround that, you need to modify your function(s) code and try to redeploy it again. One common approach is to modify an utility function that is used by all/most of your Lambda functions.
Deprecation code: LOAD_VARIABLES_FROM_ENV_FILES
Starting with v3.0.0, environment variables will be automatically loaded from .env
and .env.{stage}
files if they're present. In addition, .env
files will be excluded from package in order to avoid uploading sensitive data as a part of the package by mistake.
Adapt to this behavior now by adding useDotenv: true
to service configuration.
Note that env vars are handled differently than with serverless-dotenv-plugin, check documentation for more info.
Deprecation code: SERVICE_OBJECT_NOTATION
Starting with v3.0.0, object notation for service
property will no longer be recognized. Set service
property directly with service name.
Deprecation code: CLOUDFRONT_CACHE_BEHAVIOR_FORWARDED_VALUES_AND_TTL
Cloudfront cache behavior ForwardedValues
, MinTTL
, MaxTTL
and DefaultTTL
fields are deprecated. We recommend that you use a cache policy instead of this field. Please follow cache policy documentation for implementation details.
Deprecation code: AWS_API_GATEWAY_NAME_STARTING_WITH_SERVICE
Note: This deprecation notice has been removed and the behavior won't be enforced with next major. Below you can find original description of the deprecation. You can still continue using shouldStartNameWithService
property to adapt to the new convention of API Gateway name.
Starting with v3.0.0, API Gateway naming will be changed from ${stage}-${service}
to ${service}-${stage}
.
Adapt to this convention now by setting provider.apiGateway.shouldStartNameWithService
to true
.
Eventually if you have a strong reason to stick to current convention, you may ensure it's kept after upgrading by setting: provider.apiName: ${sls:stage}
Deprecation code: ALEXA_SKILL_EVENT_WITHOUT_APP_ID
Starting with v3.0.0, support for alexaSkill
event without appId
provided will be removed.
Deprecation code: AWS_KMS_KEY_ARN
Please use provider.kmsKeyArn
and functions[].kmsKeyArn
. service.awsKmsKeyArn
and functions[].awsKmsKeyArn
will be removed with v3.0.0
Deprecation code: RESOURCES_EXTENSIONS_REFERENCE_TO_NONEXISTENT_RESOURCE
Starting with v3.0.0, extensions to nonexistent resources in resources.extensions
will throw an error instead of passing silently.
Deprecation code: DISABLE_LOCAL_INSTALLATION_FALLBACK_SETTING
Starting with v3.0.0, framework will unconditionally run service local installation of serverless
if it's found.
Deprecation code: LOCAL_INSTALLATION_FALLBACK
Starting with v2.0.0, globally installed CLI will by default run (fallback to) service local installation of serverless
if it's found.
Adapt to this behavior now by adding enableLocalInstallationFallback: true
to service configuration. Alternatively you may opt-out by setting it to false
(note that'll be ineffective starting from v3.0.0, where support for this setting will be dropped, and CLI will unconditionally favor locally installed serverless
installations when found)
Deprecation code: AWS_HTTP_API_TIMEOUT
provider.httpApi.timeout
and functions[].events[].httpApi.timeout
settings will no longer be recognized with v2.0.0.
Endpoints are configured to automatically follow timeout setting as configured on functions (with extra margin needed to process HTTP request on AWS side)
Deprecation code: SLSS_CLI_ALIAS
Support for slss
command will be removed with v2.0.0. Use sls
or serverless
instead.
Deprecation code: AWS_FUNCTION_DESTINATIONS_ASYNC_CONFIG
maximumEventAge
and maximumRetryAttempts
should be defined directly at function level. Support for those settings on destinations
level, will be removed with v2.0.0
Deprecation code: AWS_HTTP_API_VERSION
Default HTTP API Payload version will be switched to 2.0 with next major release (For more details see payload format documentation)
Configure httpApi.payload
explicitly to ensure seamless migration.
Deprecation code: OUTDATED_NODEJS
Support for Node.js v6 and v8 will be dropped with v2.0.0 release
Ensure to rely on at least Node.js v10 (It's recommended to use LTS version, as listed at https://nodejs.org/en/)
Deprecation code: AWS_ALB_ALLOW_UNAUTHENTICATED
Please use onUnauthenticatedRequest
instead. allowUnauthenticated
will be removed with v2.0.0
Deprecation code: BIN_SERVERLESS
Please use bin/serverless.js
instead. bin/serverless
will be removed with v2.0.0