Skip to content

Document updating a pinned frameworkVersion in the v4 upgrade guide#417

Merged
GrahamCampbell merged 1 commit into
4.xfrom
document-frameworkversion-upgrade
Jul 1, 2026
Merged

Document updating a pinned frameworkVersion in the v4 upgrade guide#417
GrahamCampbell merged 1 commit into
4.xfrom
document-frameworkversion-upgrade

Conversation

@GrahamCampbell

Copy link
Copy Markdown
Contributor

A serverless.yml that pins frameworkVersion to a v3 range causes every osls command to fail immediately with FRAMEWORK_VERSION_MISMATCH once osls v4 is installed, since the installed version no longer satisfies the pinned range. This is a common configuration because upstream Serverless Framework v3 templates shipped frameworkVersion set to 3, yet the upgrade guide never mentioned it. This adds a breaking-changes section explaining that the pin must be updated to a v4 range and noting that the check runs before configuration validation and so cannot be relaxed with configValidationMode.

@GrahamCampbell GrahamCampbell force-pushed the document-frameworkversion-upgrade branch from 4640b4f to 7b5006f Compare July 1, 2026 17:47
@GrahamCampbell GrahamCampbell merged commit e9f1af4 into 4.x Jul 1, 2026
8 checks passed
@GrahamCampbell GrahamCampbell deleted the document-frameworkversion-upgrade branch July 1, 2026 17:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant