Merge pull request #609 from aws-solutions/feature/v7.0.8

release v7.0.8

Author: jangidms

CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [7.0.8] - 2025-10-07
+
+### Added
+
+- Added deprecation notice for S3 Object Lambda architecture usage
+
 ## [7.0.7] - 2025-09-22
 
 ### Security

README.md

@@ -26,15 +26,17 @@ For more information and a detailed deployment guide, visit the [Dynamic Image T
 
 # Architecture Diagram
 
-Dynamic Image Transformation for Amazon CloudFront supports two architectures, one using an Amazon API Gateway REST API, and another using S3 Object Lambda. The Amazon API Gateway REST API architecture maintains the structure used in v6.3.3 and below of the Dynamic Image Transformation for Amazon CloudFront. The S3 Object Lambda architecture maintains very similar functionality, while also allowing for images larger than 6 MB to be returned. For more information, refer to the [Architecture Overview](https://docs.aws.amazon.com/solutions/latest/serverless-image-handler/architecture-overview.html) in the implementation guide.
+Dynamic Image Transformation for Amazon CloudFront supports two architectures, one using an Amazon API Gateway REST API, and another using S3 Object Lambda. The Amazon API Gateway REST API architecture maintains the structure used in v6.3.3 and below of the Dynamic Image Transformation for Amazon CloudFront. **The S3 Object Lambda architecture has been deprecated and will no longer be open to new customers starting on November 7, 2025. If you were not an existing user of S3 Object Lambda before November 7, 2025, select ‘No“ for EnableS3ObjectLambdaParameter. For more information, please visit https://docs.aws.amazon.com/AmazonS3/latest/userguide/amazons3-ol-change.html.** The S3 Object Lambda architecture maintains very similar functionality, while also allowing for images larger than 6 MB to be returned. For more information, refer to the [Architecture Overview](https://docs.aws.amazon.com/solutions/latest/serverless-image-handler/architecture-overview.html) in the implementation guide.
 
 The AWS CloudFormation template deploys an Amazon CloudFront distribution, Amazon API Gateway REST API/S3 Object Lambda, and an AWS Lambda function. Amazon CloudFront provides a caching layer to reduce the cost of image processing and the latency of subsequent image delivery. The Amazon API Gateway/S3 Object Lambda provides endpoint resources and triggers the AWS Lambda function. The AWS Lambda function retrieves the image from the customer's Amazon Simple Storage Service (Amazon S3) bucket and uses Sharp to return a modified version of the image. Additionally, the solution generates a CloudFront domain name that provides cached access to the image handler API. There is limited use of CloudFront functions for consistency and cache hit rate purposes.
 
 ## Default Architecture
 
 ![Architecture Diagram (Default Architecture)](./default_architecture.png)
 
-## S3 Object Lambda Architecture
+## S3 Object Lambda Architecture (DEPRECATED)
+
+**⚠️ DEPRECATED: This architecture has been deprecated and should not be used for new deployments. Use the Default Architecture instead.**
 
 ![Architecture Diagram (S3 Object Lambda Architecture)](./object_lambda_architecture.png)
 

VERSION.txt

@@ -1 +1 @@
-7.0.7
+7.0.8

source/constructs/lib/serverless-image-stack.ts

@@ -167,11 +167,22 @@ export class ServerlessImageHandlerStack extends Stack {
     const enableS3ObjectLambdaParameter = new CfnParameter(this, "EnableS3ObjectLambdaParameter", {
       type: "String",
       description:
-        "Enable S3 Object Lambda to improve the maximum response size of image requests beyond 6 MB. If enabled, an S3 Object Lambda Access Point will replace the API Gateway proxying requests to your image handler function. **Important: Modifying this value after initial template deployment will delete the existing CloudFront Distribution and create a new one, providing a new domain name and clearing the cache**",
+        "Deprecated: This option has been deprecated. Amazon S3 Object Lambda will no longer be open to new customers starting on November 7, 2025. If you were not an existing user of S3 Object Lambda before November 7, 2025, select 'No'. For more information, please visit https://docs.aws.amazon.com/AmazonS3/latest/userguide/amazons3-ol-change.html. **Important: Modifying this value after initial template deployment will delete the existing CloudFront Distribution and create a new one, providing a new domain name and clearing the cache**.",
       allowedValues: ["Yes", "No"],
       default: "No",
     });
 
+   
+    console.warn("\n" + "=".repeat(80));
+    console.warn("⚠️  S3 Object Lambda Feature Deprecation Notice");
+    console.warn("=".repeat(80));
+    console.warn("The EnableS3ObjectLambdaParameter has been DEPRECATED.");
+    console.warn("");
+    console.warn("❌ For NEW deployments: Do NOT set EnableS3ObjectLambdaParameter=Yes");
+    console.warn("✅ For EXISTING deployments: You can continue using this feature");
+    console.warn("📋 Default value is 'No' - recommended for all new deployments");
+    console.warn("=".repeat(80) + "\n");
+
     const useExistingCloudFrontDistribution = new CfnParameter(this, "UseExistingCloudFrontDistributionParameter", {
       type: "String",
       description:
@@ -377,7 +388,7 @@ export class ServerlessImageHandlerStack extends Stack {
         ],
         ParameterLabels: {
           [enableS3ObjectLambdaParameter.logicalId]: {
-            default: "Enable S3 Object Lambda",
+            default: "Enable S3 Object Lambda (DEPRECATED)",
           },
           [corsEnabledParameter.logicalId]: { default: "CORS Enabled" },
           [corsOriginParameter.logicalId]: { default: "CORS Origin" },

source/constructs/package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "constructs",
-  "version": "7.0.7",
+  "version": "7.0.8",
   "description": "Dynamic Image Transformation for Amazon CloudFront Constructs",
   "license": "Apache-2.0",
   "author": {

source/constructs/package.json

@@ -287,7 +287,7 @@ exports[`Dynamic Image Transformation for Amazon CloudFront Stack Snapshot 1`] =
           "default": "Enable Default Fallback Image",
         },
         "EnableS3ObjectLambdaParameter": {
-          "default": "Enable S3 Object Lambda",
+          "default": "Enable S3 Object Lambda (DEPRECATED)",
         },
         "EnableSignatureParameter": {
           "default": "Enable Signature",
@@ -522,7 +522,7 @@ exports[`Dynamic Image Transformation for Amazon CloudFront Stack Snapshot 1`] =
         "No",
       ],
       "Default": "No",
-      "Description": "Enable S3 Object Lambda to improve the maximum response size of image requests beyond 6 MB. If enabled, an S3 Object Lambda Access Point will replace the API Gateway proxying requests to your image handler function. **Important: Modifying this value after initial template deployment will delete the existing CloudFront Distribution and create a new one, providing a new domain name and clearing the cache**",
+      "Description": "Deprecated: This option has been deprecated. Amazon S3 Object Lambda will no longer be open to new customers starting on November 7, 2025. If you were not an existing user of S3 Object Lambda before November 7, 2025, select 'No'. For more information, please visit https://docs.aws.amazon.com/AmazonS3/latest/userguide/amazons3-ol-change.html. **Important: Modifying this value after initial template deployment will delete the existing CloudFront Distribution and create a new one, providing a new domain name and clearing the cache**.",
       "Type": "String",
     },
     "EnableSignatureParameter": {

source/constructs/test/__snapshots__/constructs.test.ts.snap

@@ -1,6 +1,6 @@
 {
   "name": "custom-resource",
-  "version": "7.0.7",
+  "version": "7.0.8",
   "private": true,
   "description": "Dynamic Image Transformation for Amazon CloudFront custom resource",
   "license": "Apache-2.0",