chore(toolkit): programmatic hotswap property overrides (#33227)

Hotswap property overrides can be added to programmatic deploy

### Checklist
- [x] My code adheres to the [CONTRIBUTING GUIDE](https://github.com/aws/aws-cdk/blob/main/CONTRIBUTING.md) and [DESIGN GUIDELINES](https://github.com/aws/aws-cdk/blob/main/docs/DESIGN_GUIDELINES.md)

----

*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*

Author: kaizencc

packages/@aws-cdk/toolkit/lib/actions/deploy/index.ts

@@ -244,4 +244,39 @@ export interface DeployOptions extends BaseDeployOptions {
    * @deprecated Implement in IoHost instead
    */
   readonly progress?: StackActivityProgress;
+
+  /**
+   * Represents configuration property overrides for hotswap deployments.
+   * Currently only supported by ECS.
+   *
+   * @default - no overrides
+   */
+  readonly hotswapProperties?: HotswapProperties;
+}
+
+/**
+ * Property overrides for ECS hotswaps
+ */
+export interface EcsHotswapProperties {
+  /**
+   * The lower limit on the number of your service's tasks that must remain
+   * in the RUNNING state during a deployment, as a percentage of the desiredCount.
+   */
+  readonly minimumHealthyPercent: number;
+
+  /**
+   * The upper limit on the number of your service's tasks that are allowed
+   * in the RUNNING or PENDING state during a deployment, as a percentage of the desiredCount.
+   */
+  readonly maximumHealthyPercent: number;
+}
+
+/**
+ * Property overrides for hotswap deployments.
+ */
+export interface HotswapProperties {
+  /**
+   * ECS specific hotswap property overrides
+   */
+  readonly ecs: EcsHotswapProperties;
 }

packages/@aws-cdk/toolkit/lib/actions/deploy/private/helpers.ts

@@ -1,5 +1,5 @@
-import { DeployOptions } from '..';
-import { Deployments, WorkGraph } from '../../../api/aws-cdk';
+import { DeployOptions, HotswapProperties } from '..';
+import { Deployments, EcsHotswapProperties, HotswapPropertyOverrides, WorkGraph } from '../../../api/aws-cdk';
 
 export function buildParameterMap(parameters?: Map<string, string | undefined>): { [name: string]: { [name: string]: string | undefined } } {
   const parameterMap: {
@@ -33,3 +33,13 @@ export async function removePublishedAssets(graph: WorkGraph, deployments: Deplo
     stackName: assetNode.parentStack.stackName,
   }));
 }
+
+/**
+ * Create the HotswapPropertyOverrides class out of the Interface exposed to users
+ */
+export function createHotswapPropertyOverrides(hotswapProperties: HotswapProperties): HotswapPropertyOverrides {
+  return new HotswapPropertyOverrides(new EcsHotswapProperties(
+    hotswapProperties.ecs.minimumHealthyPercent,
+    hotswapProperties.ecs.maximumHealthyPercent,
+  ));
+}

packages/@aws-cdk/toolkit/lib/api/aws-cdk.ts

@@ -28,6 +28,7 @@ export { WorkGraph } from '../../../../aws-cdk/lib/util/work-graph';
 export type { Concurrency } from '../../../../aws-cdk/lib/util/work-graph';
 export { WorkGraphBuilder } from '../../../../aws-cdk/lib/util/work-graph-builder';
 export type { AssetBuildNode, AssetPublishNode, StackNode } from '../../../../aws-cdk/lib/util/work-graph-types';
+export { HotswapPropertyOverrides, EcsHotswapProperties } from '../../../../aws-cdk/lib/api/hotswap/common';
 
 // @todo Cloud Assembly and Executable - this is a messy API right now
 export { CloudAssembly, sanitizePatterns, StackCollection, ExtendedStackSelection } from '../../../../aws-cdk/lib/api/cxapp/cloud-assembly';

packages/@aws-cdk/toolkit/lib/toolkit/toolkit.ts

@@ -5,7 +5,7 @@ import * as chokidar from 'chokidar';
 import * as fs from 'fs-extra';
 import { ToolkitServices } from './private';
 import { AssetBuildTime, type DeployOptions, RequireApproval } from '../actions/deploy';
-import { type ExtendedDeployOptions, buildParameterMap, removePublishedAssets } from '../actions/deploy/private';
+import { type ExtendedDeployOptions, buildParameterMap, createHotswapPropertyOverrides, removePublishedAssets } from '../actions/deploy/private';
 import { type DestroyOptions } from '../actions/destroy';
 import { type DiffOptions } from '../actions/diff';
 import { diffRequiresApproval } from '../actions/diff/private';
@@ -242,15 +242,6 @@ export class Toolkit extends CloudAssemblySourceBuilder implements AsyncDisposab
       ].join('\n')));
     }
 
-    // @TODO
-    // let hotswapPropertiesFromSettings = this.props.configuration.settings.get(['hotswap']) || {};
-
-    // let hotswapPropertyOverrides = new HotswapPropertyOverrides();
-    // hotswapPropertyOverrides.ecsHotswapProperties = new EcsHotswapProperties(
-    //   hotswapPropertiesFromSettings.ecs?.minimumHealthyPercent,
-    //   hotswapPropertiesFromSettings.ecs?.maximumHealthyPercent,
-    // );
-
     const stacks = stackCollection.stackArtifacts;
 
     const stackOutputs: { [key: string]: any } = {};
@@ -370,7 +361,7 @@ export class Toolkit extends CloudAssemblySourceBuilder implements AsyncDisposab
             rollback,
             hotswap: hotswapMode,
             extraUserAgent: options.extraUserAgent,
-            // hotswapPropertyOverrides: hotswapPropertyOverrides,
+            hotswapPropertyOverrides: options.hotswapProperties ? createHotswapPropertyOverrides(options.hotswapProperties) : undefined,
             assetParallelism: options.assetParallelism,
           });
 

packages/@aws-cdk/toolkit/test/actions/deploy.test.ts

@@ -135,6 +135,32 @@ describe('deploy', () => {
         notificationArns: [arn],
       })).rejects.toThrow(/Notification arn arn:aws:sqs:us-east-1:1111111111:resource is not a valid arn for an SNS topic/);
     });
+
+    test('hotswap property overrides', async () => {
+      // WHEN
+      const cx = await builderFixture(toolkit, 'stack-with-role');
+      await toolkit.deploy(cx, {
+        hotswapProperties: {
+          ecs: {
+            maximumHealthyPercent: 100,
+            minimumHealthyPercent: 0,
+          },
+        },
+      });
+
+      // THEN
+      // passed through correctly to Deployments
+      expect(mockDeployStack).toHaveBeenCalledWith(expect.objectContaining({
+        hotswapPropertyOverrides: {
+          ecsHotswapProperties: {
+            maximumHealthyPercent: 100,
+            minimumHealthyPercent: 0,
+          },
+        },
+      }));
+
+      successfulDeployment();
+    });
   });
 
   describe('deployment results', () => {