@gradientedge/cdk-utils 9.25.0 → 9.26.1

package/dist/src/lib/aws/construct/application-configuration/main.d.ts

@@ -1,4 +1,4 @@
-import { CfnApplication, CfnConfigurationProfile, CfnDeploymentStrategy, CfnEnvironment, CfnHostedConfigurationVersion } from 'aws-cdk-lib/aws-appconfig';
+import { CfnApplication, CfnConfigurationProfile, CfnEnvironment, CfnHostedConfigurationVersion, IDeploymentStrategy } from 'aws-cdk-lib/aws-appconfig';
 import { Construct } from 'constructs';
 import { CommonConstruct } from '../../common';
 import { ApplicationConfigurationProps } from './types';
@@ -9,7 +9,7 @@ export declare class ApplicationConfiguration extends CommonConstruct {
     appConfigEnvironment: CfnEnvironment;
     appConfigProfile: CfnConfigurationProfile;
     appConfigVersion: CfnHostedConfigurationVersion;
-    appConfigDeploymentStrategy: CfnDeploymentStrategy;
+    appConfigDeploymentStrategy: IDeploymentStrategy;
     constructor(parent: Construct, id: string, props: ApplicationConfigurationProps);
     initResources(): void;
     protected createConfiguration(): void;

package/dist/src/lib/aws/construct/application-configuration/main.js

@@ -46,11 +46,21 @@ class ApplicationConfiguration extends common_1.CommonConstruct {
         });
     }
     createAppConfigDeploymentStrategy() {
-        this.appConfigDeploymentStrategy = new aws_appconfig_1.CfnDeploymentStrategy(this, `${this.id}-ac-deployment-strategy`, {
-            deploymentDurationInMinutes: this.props.appConfig.deploymentStrategy.deploymentDurationInMinutes,
-            growthFactor: this.props.appConfig.deploymentStrategy.growthFactor,
-            name: this.resourceNameFormatter.format(this.props.appConfig.deploymentStrategy.name, this.props.resourceNameOptions?.appconfig),
-            replicateTo: this.props.appConfig.deploymentStrategy.replicateTo,
+        if (!this.props.appConfig.deploymentStrategy)
+            return;
+        if (this.props.appConfig.deploymentStrategy?.deploymentStrategyArn) {
+            this.appConfigDeploymentStrategy = aws_appconfig_1.DeploymentStrategy.fromDeploymentStrategyArn(this, `${this.id}-ac-deployment-strategy`, this.props.appConfig.deploymentStrategy?.deploymentStrategyArn);
+            return;
+        }
+        this.appConfigDeploymentStrategy = new aws_appconfig_1.DeploymentStrategy(this, `${this.id}-ac-deployment-strategy`, {
+            ...this.props.appConfig.deploymentStrategy,
+            rolloutStrategy: this.props.appConfig.deploymentStrategy?.rolloutStrategy ??
+                aws_appconfig_1.RolloutStrategy.linear({
+                    growthFactor: 100,
+                    deploymentDuration: aws_cdk_lib_1.Duration.minutes(0),
+                    finalBakeTime: aws_cdk_lib_1.Duration.minutes(0),
+                }),
+            deploymentStrategyName: this.resourceNameFormatter.format(this.props.appConfig.deploymentStrategy.deploymentStrategyName ?? 'common-deployment-strategy', this.props.resourceNameOptions?.appconfig),
         });
     }
     createAppConfigDeployment() {
@@ -58,7 +68,7 @@ class ApplicationConfiguration extends common_1.CommonConstruct {
             applicationId: aws_cdk_lib_1.Fn.ref(this.appConfigApplication.logicalId),
             configurationProfileId: aws_cdk_lib_1.Fn.ref(this.appConfigProfile.logicalId),
             configurationVersion: aws_cdk_lib_1.Fn.ref(this.appConfigVersion.logicalId),
-            deploymentStrategyId: aws_cdk_lib_1.Fn.ref(this.appConfigDeploymentStrategy.logicalId),
+            deploymentStrategyId: this.appConfigDeploymentStrategy.deploymentStrategyId,
             environmentId: aws_cdk_lib_1.Fn.ref(this.appConfigEnvironment.logicalId),
         });
     }

package/dist/src/lib/aws/construct/event-handler/main.js

@@ -85,6 +85,8 @@ class EventHandler extends common_1.CommonConstruct {
      * @summary Method to create the event rule pattern.
      */
     createEventRulePattern() {
+        if (!this.props.eventRule)
+            return;
         this.handler.rulePattern = this.props.eventRule.eventPattern;
     }
     /**
@@ -111,7 +113,10 @@ class EventHandler extends common_1.CommonConstruct {
      */
     createEventArchive() {
         /* do not enable for scheduled events */
-        if (this.props.eventRule.schedule || this.props.eventRuleSchedule || !this.props.eventRuleArchiveEnabled)
+        if (!this.props.eventRule ||
+            this.props.eventRule.schedule ||
+            this.props.eventRuleSchedule ||
+            !this.props.eventRuleArchiveEnabled)
             return;
         this.handler.archive = new aws_events_1.Archive(this, `${this.id}-archive`, {
             archiveName: `${this.props.eventRule.ruleName}-${this.props.stage}`.replace(`${this.node.tryGetContext('stackName')}-`, ''),
@@ -125,6 +130,8 @@ class EventHandler extends common_1.CommonConstruct {
      * @summary Method to create the event rule.
      */
     createEventRule() {
+        if (!this.props.eventRule)
+            return;
         let schedule;
         if (this.props.eventRuleSchedule) {
             schedule = aws_events_1.Schedule.expression(this.props.eventRuleSchedule);

package/dist/src/lib/aws/construct/event-handler/types.d.ts

@@ -9,7 +9,7 @@ import { EventRuleProps, LogProps, QueueProps, SfnMapProps, SfnStateMachineProps
 export interface EventHandlerProps extends CommonStackProps {
     eventBusName: string;
     eventRetentionInDays: number;
-    eventRule: EventRuleProps;
+    eventRule?: EventRuleProps;
     eventRuleArchiveEnabled: boolean;
     eventRuleSchedule: string;
     eventSqs: QueueProps;

package/dist/src/lib/aws/services/appconfig/main.d.ts

@@ -1,4 +1,4 @@
-import { CfnApplication, CfnConfigurationProfile, CfnEnvironment } from 'aws-cdk-lib/aws-appconfig';
+import { CfnApplication, CfnConfigurationProfile, CfnEnvironment, DeploymentStrategy } from 'aws-cdk-lib/aws-appconfig';
 import { CommonConstruct } from '../../common';
 import { Architecture } from '../constants';
 import { AppConfigProps } from './types';
@@ -52,4 +52,12 @@ export declare class AppConfigManager {
      * @returns the appconfig configuration profile
      */
     createConfigurationProfile(id: string, scope: CommonConstruct, applicationId: string, props: AppConfigProps): CfnConfigurationProfile;
+    /**
+     * @summary Method to create an AppConfig Deployment Strategy
+     * @param id scoped id of the resource
+     * @param scope scope in which this resource is defined
+     * @param props
+     * @returns the appconfig deployment strategy
+     */
+    createDeploymentStrategy(id: string, scope: CommonConstruct, props: AppConfigProps): DeploymentStrategy;
 }

package/dist/src/lib/aws/services/appconfig/main.js

@@ -98,5 +98,26 @@ class AppConfigManager {
         (0, utils_1.createCfnOutput)(`${id}-configurationProfileName`, scope, profile.name);
         return profile;
     }
+    /**
+     * @summary Method to create an AppConfig Deployment Strategy
+     * @param id scoped id of the resource
+     * @param scope scope in which this resource is defined
+     * @param props
+     * @returns the appconfig deployment strategy
+     */
+    createDeploymentStrategy(id, scope, props) {
+        if (!props)
+            throw `AppConfig props undefined for ${id}`;
+        if (!props.deploymentStrategy)
+            throw `AppConfig deploymentStrategy props undefined for ${id}`;
+        const deploymentStrategy = new aws_appconfig_1.DeploymentStrategy(scope, `${id}`, {
+            ...props,
+            deploymentStrategyName: scope.resourceNameFormatter.format(props.deploymentStrategy.deploymentStrategyName ?? 'common-deployment-strategy', scope.props.resourceNameOptions?.appconfig),
+            rolloutStrategy: props.deploymentStrategy.rolloutStrategy ?? aws_appconfig_1.RolloutStrategy.ALL_AT_ONCE,
+        });
+        (0, utils_1.createCfnOutput)(`${id}-deploymentStrategyId`, scope, deploymentStrategy.deploymentStrategyId);
+        (0, utils_1.createCfnOutput)(`${id}-deploymentStrategyArn`, scope, deploymentStrategy.deploymentStrategyArn);
+        return deploymentStrategy;
+    }
 }
 exports.AppConfigManager = AppConfigManager;

package/dist/src/lib/aws/services/appconfig/types.d.ts

@@ -1,11 +1,17 @@
-import { CfnApplicationProps, CfnConfigurationProfileProps, CfnDeploymentProps, CfnDeploymentStrategyProps, CfnEnvironmentProps } from 'aws-cdk-lib/aws-appconfig';
+import { CfnApplicationProps, CfnConfigurationProfileProps, CfnDeploymentProps, CfnEnvironmentProps, DeploymentStrategyProps } from 'aws-cdk-lib/aws-appconfig';
+/**
+ *
+ */
+export interface AppConfigDeploymentStrategyProps extends DeploymentStrategyProps {
+    deploymentStrategyArn?: string;
+}
 /**
  */
 export interface AppConfigProps {
     application: CfnApplicationProps;
     configurationProfile: CfnConfigurationProfileProps;
     deployment: CfnDeploymentProps;
-    deploymentStrategy: CfnDeploymentStrategyProps;
+    deploymentStrategy: AppConfigDeploymentStrategyProps;
     environment: CfnEnvironmentProps;
     id: string;
 }

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@gradientedge/cdk-utils",
-  "version": "9.25.0",
+  "version": "9.26.1",
   "description": "Utilities for AWS CDK provisioning",
   "main": "dist/index.js",
   "engines": {
     "node": ">=16 <=20",
     "pnpm": "=9"
   },
-  "packageManager": "pnpm@8.15.8",
+  "packageManager": "pnpm@9.14.1+sha256.9978d5f40d4f376b054cf8c000cf8c326284344281e3c9bbf4e3d6f153b0e8de",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/gradientedge/cdk-utils.git"

package/src/lib/aws/construct/application-configuration/main.ts

@@ -1,11 +1,13 @@
-import { Fn } from 'aws-cdk-lib'
+import { Duration, Fn } from 'aws-cdk-lib'
 import {
   CfnApplication,
   CfnConfigurationProfile,
   CfnDeployment,
-  CfnDeploymentStrategy,
   CfnEnvironment,
   CfnHostedConfigurationVersion,
+  DeploymentStrategy,
+  IDeploymentStrategy,
+  RolloutStrategy,
 } from 'aws-cdk-lib/aws-appconfig'
 import { Construct } from 'constructs'
 import { CommonConstruct } from '../../common'
@@ -18,7 +20,7 @@ export class ApplicationConfiguration extends CommonConstruct {
   appConfigEnvironment: CfnEnvironment
   appConfigProfile: CfnConfigurationProfile
   appConfigVersion: CfnHostedConfigurationVersion
-  appConfigDeploymentStrategy: CfnDeploymentStrategy
+  appConfigDeploymentStrategy: IDeploymentStrategy
 
   constructor(parent: Construct, id: string, props: ApplicationConfigurationProps) {
     super(parent, id, props)
@@ -76,14 +78,30 @@ export class ApplicationConfiguration extends CommonConstruct {
   }
 
   protected createAppConfigDeploymentStrategy() {
-    this.appConfigDeploymentStrategy = new CfnDeploymentStrategy(this, `${this.id}-ac-deployment-strategy`, {
-      deploymentDurationInMinutes: this.props.appConfig.deploymentStrategy.deploymentDurationInMinutes,
-      growthFactor: this.props.appConfig.deploymentStrategy.growthFactor,
-      name: this.resourceNameFormatter.format(
-        this.props.appConfig.deploymentStrategy.name,
+    if (!this.props.appConfig.deploymentStrategy) return
+
+    if (this.props.appConfig.deploymentStrategy?.deploymentStrategyArn) {
+      this.appConfigDeploymentStrategy = DeploymentStrategy.fromDeploymentStrategyArn(
+        this,
+        `${this.id}-ac-deployment-strategy`,
+        this.props.appConfig.deploymentStrategy?.deploymentStrategyArn
+      )
+      return
+    }
+
+    this.appConfigDeploymentStrategy = new DeploymentStrategy(this, `${this.id}-ac-deployment-strategy`, {
+      ...this.props.appConfig.deploymentStrategy,
+      rolloutStrategy:
+        this.props.appConfig.deploymentStrategy?.rolloutStrategy ??
+        RolloutStrategy.linear({
+          growthFactor: 100,
+          deploymentDuration: Duration.minutes(0),
+          finalBakeTime: Duration.minutes(0),
+        }),
+      deploymentStrategyName: this.resourceNameFormatter.format(
+        this.props.appConfig.deploymentStrategy.deploymentStrategyName ?? 'common-deployment-strategy',
         this.props.resourceNameOptions?.appconfig
       ),
-      replicateTo: this.props.appConfig.deploymentStrategy.replicateTo,
     })
   }
 
@@ -92,7 +110,7 @@ export class ApplicationConfiguration extends CommonConstruct {
       applicationId: Fn.ref(this.appConfigApplication.logicalId),
       configurationProfileId: Fn.ref(this.appConfigProfile.logicalId),
       configurationVersion: Fn.ref(this.appConfigVersion.logicalId),
-      deploymentStrategyId: Fn.ref(this.appConfigDeploymentStrategy.logicalId),
+      deploymentStrategyId: this.appConfigDeploymentStrategy.deploymentStrategyId,
       environmentId: Fn.ref(this.appConfigEnvironment.logicalId),
     })
   }

package/src/lib/aws/construct/event-handler/main.ts

@@ -97,6 +97,7 @@ export class EventHandler extends CommonConstruct {
    * @summary Method to create the event rule pattern.
    */
   protected createEventRulePattern() {
+    if (!this.props.eventRule) return
     this.handler.rulePattern = this.props.eventRule.eventPattern
   }
 
@@ -130,7 +131,13 @@ export class EventHandler extends CommonConstruct {
    */
   protected createEventArchive() {
     /* do not enable for scheduled events */
-    if (this.props.eventRule.schedule || this.props.eventRuleSchedule || !this.props.eventRuleArchiveEnabled) return
+    if (
+      !this.props.eventRule ||
+      this.props.eventRule.schedule ||
+      this.props.eventRuleSchedule ||
+      !this.props.eventRuleArchiveEnabled
+    )
+      return
     this.handler.archive = new Archive(this, `${this.id}-archive`, {
       archiveName: `${this.props.eventRule.ruleName}-${this.props.stage}`.replace(
         `${this.node.tryGetContext('stackName')}-`,
@@ -147,6 +154,7 @@ export class EventHandler extends CommonConstruct {
    * @summary Method to create the event rule.
    */
   protected createEventRule() {
+    if (!this.props.eventRule) return
     let schedule
     if (this.props.eventRuleSchedule) {
       schedule = Schedule.expression(this.props.eventRuleSchedule)

package/src/lib/aws/construct/event-handler/types.ts

@@ -10,7 +10,7 @@ import { EventRuleProps, LogProps, QueueProps, SfnMapProps, SfnStateMachineProps
 export interface EventHandlerProps extends CommonStackProps {
   eventBusName: string
   eventRetentionInDays: number
-  eventRule: EventRuleProps
+  eventRule?: EventRuleProps
   eventRuleArchiveEnabled: boolean
   eventRuleSchedule: string
   eventSqs: QueueProps

package/src/lib/aws/services/appconfig/main.ts

@@ -1,5 +1,11 @@
 import { Fn } from 'aws-cdk-lib'
-import { CfnApplication, CfnConfigurationProfile, CfnEnvironment } from 'aws-cdk-lib/aws-appconfig'
+import {
+  CfnApplication,
+  CfnConfigurationProfile,
+  CfnEnvironment,
+  DeploymentStrategy,
+  RolloutStrategy,
+} from 'aws-cdk-lib/aws-appconfig'
 import { CommonConstruct } from '../../common'
 import { createCfnOutput } from '../../utils'
 import { Architecture } from '../constants'
@@ -120,4 +126,30 @@ export class AppConfigManager {
 
     return profile
   }
+
+  /**
+   * @summary Method to create an AppConfig Deployment Strategy
+   * @param id scoped id of the resource
+   * @param scope scope in which this resource is defined
+   * @param props
+   * @returns the appconfig deployment strategy
+   */
+  public createDeploymentStrategy(id: string, scope: CommonConstruct, props: AppConfigProps): DeploymentStrategy {
+    if (!props) throw `AppConfig props undefined for ${id}`
+    if (!props.deploymentStrategy) throw `AppConfig deploymentStrategy props undefined for ${id}`
+
+    const deploymentStrategy = new DeploymentStrategy(scope, `${id}`, {
+      ...props,
+      deploymentStrategyName: scope.resourceNameFormatter.format(
+        props.deploymentStrategy.deploymentStrategyName ?? 'common-deployment-strategy',
+        scope.props.resourceNameOptions?.appconfig
+      ),
+      rolloutStrategy: props.deploymentStrategy.rolloutStrategy ?? RolloutStrategy.ALL_AT_ONCE,
+    })
+
+    createCfnOutput(`${id}-deploymentStrategyId`, scope, deploymentStrategy.deploymentStrategyId)
+    createCfnOutput(`${id}-deploymentStrategyArn`, scope, deploymentStrategy.deploymentStrategyArn)
+
+    return deploymentStrategy
+  }
 }

package/src/lib/aws/services/appconfig/types.ts

@@ -4,16 +4,24 @@ import {
   CfnDeploymentProps,
   CfnDeploymentStrategyProps,
   CfnEnvironmentProps,
+  DeploymentStrategyProps,
 } from 'aws-cdk-lib/aws-appconfig'
 import { ResourceNameFormatterProps } from '../../common'
 
+/**
+ *
+ */
+export interface AppConfigDeploymentStrategyProps extends DeploymentStrategyProps {
+  deploymentStrategyArn?: string
+}
+
 /**
  */
 export interface AppConfigProps {
   application: CfnApplicationProps
   configurationProfile: CfnConfigurationProfileProps
   deployment: CfnDeploymentProps
-  deploymentStrategy: CfnDeploymentStrategyProps
+  deploymentStrategy: AppConfigDeploymentStrategyProps
   environment: CfnEnvironmentProps
   id: string
 }