Versioning policy
Overview¶
This document outlines the maintenance policy for Powertools for AWS Lambda and their underlying dependencies. AWS regularly provides Powertools for AWS Lambda with updates that may contain new features, enhancements, bug fixes, security patches, or documentation updates. Updates may also address changes with dependencies, language runtimes, and operating systems. Powertools for AWS Lambda is published to package managers (e.g. PyPi, NPM, Maven, NuGet), and are available as source code on GitHub.
We recommend users to stay up-to-date with Powertools for AWS Lambda releases to keep up with the latest features, security updates, and underlying dependencies. Continued use of an unsupported Powertools for AWS Lambda version is not recommended and is done at the user’s discretion.
For brevity, we will interchangeably refer to Powertools for AWS Lambda as "SDK" (Software Development Toolkit).
Versioning¶
Powertools for AWS Lambda release versions are in the form of X.Y.Z where X represents the major version. Increasing the major version of an SDK indicates that this SDK underwent significant and substantial changes to support new idioms and patterns in the language. Major versions are introduced when public interfaces (e.g. classes, methods, types, etc.), behaviors, or semantics have changed. Applications need to be updated in order for them to work with the newest SDK version. It is important to update major versions carefully and in accordance with the upgrade guidelines provided by AWS.
SDK major version lifecycle¶
The lifecycle for major Powertools for AWS Lambda versions consists of 5 phases, which are outlined below.
- Developer Preview (Phase 0) - During this phase, SDKs are not supported, should not be used in production environments, and are meant for early access and feedback purposes only. It is possible for future releases to introduce breaking changes. Once AWS identifies a release to be a stable product, it may mark it as a Release Candidate. Release Candidates are ready for GA release unless significant bugs emerge, and will receive full AWS support.
- General Availability (GA) (Phase 1) - During this phase, SDKs are fully supported. AWS will provide regular SDK releases that include support for new features, enhancements, as well as bug and security fixes. AWS will support the GA version of an SDK for at least 24 months, unless otherwise specified.
- Maintenance Announcement (Phase 2) - AWS will make a public announcement at least 6 months before an SDK enters maintenance mode. During this period, the SDK will continue to be fully supported. Typically, maintenance mode is announced at the same time as the next major version is transitioned to GA.
- Maintenance (Phase 3) - During the maintenance mode, AWS limits SDK releases to address critical bug fixes and security issues only. An SDK will not receive API updates for new or existing services, or be updated to support new regions. Maintenance mode has a default duration of 6 months, unless otherwise specified.
- End-of-Support (Phase 4) - When an SDK reaches end-of support, it will no longer receive updates or releases. Previously published releases will continue to be available via public package managers and the code will remain on GitHub. The GitHub repository may be archived. Use of an SDK which has reached end-of-support is done at the user’s discretion. We recommend users upgrade to the new major version.
Please note that the timelines shown below are illustrative and not binding
Dependency lifecycle¶
Most AWS SDKs have underlying dependencies, such as language runtimes, AWS Lambda runtime, or third party libraries and frameworks. These dependencies are typically tied to the language community or the vendor who owns that particular component. Each community or vendor publishes their own end-of-support schedule for their product.
The following terms are used to classify underlying third party dependencies:
- AWS Lambda Runtime: Examples include
nodejs20.x
,python3.12
, etc. - Language Runtime: Examples include Python 3.12, NodeJS 20, Java 17, .NET Core, etc.
- Third party Library: Examples include Pydantic, AWS X-Ray SDK, AWS Encryption SDK, Middy.js, etc.
Powertools for AWS Lambda follows the AWS Lambda Runtime deprecation policy cycle, when it comes to Language Runtime. This means we will stop supporting their respective deprecated Language Runtime (e.g., python37
) without increasing the major SDK version.
AWS reserves the right to stop support for an underlying dependency without increasing the major SDK version
Lambda layer lifecycle¶
Powertools for AWS Lambda provides public Lambda layers as an alternative method for including the Powertools SDK into your Lambda functions.
Unlike package indexers such as PyPi and NPMJS, which use semantic versioning (e.g., v1.2.3, v1.3.0), Lambda layers employs incrementing sequential versions (e.g., 1, 2, 3, 4). With each new release of the SDK, Powertools for AWS Lambda publishes an updated layer, including the SDK version in the layer description.
Powertools for AWS Lambda layers are immutable and remain available beyond their end-of-life dates.
Each Powertools for AWS Lambda layer adheres to the versioning policy outlined above.
Communication methods¶
Maintenance announcements are communicated in several ways:
- A pinned GitHub Request For Comments (RFC) issue indicating the campaign for the next major version. The RFC will outline the path to end-of-support, specify campaign timelines, and upgrade guidance.
- AWS SDK documentation, such as API reference documentation, user guides, SDK product marketing pages, and GitHub readme(s) are updated to indicate the campaign timeline and provide guidance on upgrading affected applications.
- Deprecation warnings are added to the SDKs, outlining the path to end-of-support and linking to the upgrade guide.
To see the list of available major versions of Powertools for AWS Lambda and where they are in their maintenance lifecycle, see version support matrix
Version support matrix¶
SDK | Major version | Current Phase | General Availability Date | Notes |
---|---|---|---|---|
Powertools for AWS Lambda (Python) | 2.x | Maintenance Announcement | 09/25/2024 | See announcement |
Powertools for AWS Lambda (Python) | 3.x | General Availability | 09/23/2024 | See Release notes |
Powertools for AWS Lambda (Python) | 3.x | Developer Preview | See RFC | |
Powertools for AWS Lambda (Python) | 2.x | General Availability | 10/24/2022 | See Release Notes |
Powertools for AWS Lambda (Python) | 1.x | End of Support | 06/18/2020 | See RFC and upgrade guide |