feat(opensearchservice): add useLatestServiceSoftwareForBlueGreen support

packages/@aws-cdk-testing/framework-integ/test/aws-opensearchservice/test/integ.opensearch.software-update-options.ts

@@ -0,0 +1,28 @@
+import type { StackProps } from 'aws-cdk-lib';
+import { App, RemovalPolicy, Stack } from 'aws-cdk-lib';
+import type { Construct } from 'constructs';
+import * as opensearch from 'aws-cdk-lib/aws-opensearchservice';
+import { IntegTest } from '@aws-cdk/integ-tests-alpha';
+
+class TestStack extends Stack {
+  constructor(scope: Construct, id: string, props?: StackProps) {
+    super(scope, id, props);
+
+    new opensearch.Domain(this, 'Domain', {
+      version: opensearch.EngineVersion.OPENSEARCH_2_17,
+      removalPolicy: RemovalPolicy.DESTROY,
+      enableAutoSoftwareUpdate: true,
+      useLatestServiceSoftwareForBlueGreen: true,
+      capacity: {
+        multiAzWithStandbyEnabled: false,
+      },
+    });
+  }
+}
+
+const app = new App();
+const stack = new TestStack(app, 'cdk-integ-opensearch-software-update-options');
+
+new IntegTest(app, 'OpenSearchSoftwareUpdateOptionsInteg', {
+  testCases: [stack],
+});

packages/aws-cdk-lib/aws-opensearchservice/README.md

@@ -575,6 +575,7 @@ The domain can be configured to use service software updates.
 const domain = new Domain(this, 'Domain', {
   version: EngineVersion.OPENSEARCH_1_3,
   enableAutoSoftwareUpdate: true,
+  useLatestServiceSoftwareForBlueGreen: true,
 });
 ```
 

packages/aws-cdk-lib/aws-opensearchservice/lib/domain.ts

@@ -728,6 +728,17 @@ export interface DomainProps {
    */
   readonly enableAutoSoftwareUpdate?: boolean;
 
+  /**
+   * Specifies whether the domain should use the latest service software version during a blue/green deployment.
+   * If enabled, the domain will automatically use the latest available service software when a blue/green
+   * deployment is triggered.
+   *
+   * @see https://docs.aws.amazon.com/opensearch-service/latest/developerguide/service-software.html
+   *
+   * @default - false
+   */
+  readonly useLatestServiceSoftwareForBlueGreen?: boolean;
+
   /**
    * Specify either dual stack or IPv4 as your IP address type.
    * Dual stack allows you to share domain resources across IPv4 and IPv6 address types, and is the recommended option.
@@ -2124,8 +2135,9 @@ export class Domain extends DomainBase implements IDomain, ec2.IConnectable {
           },
         },
       } : undefined,
-      softwareUpdateOptions: props.enableAutoSoftwareUpdate !== undefined ? {
+      softwareUpdateOptions: (props.enableAutoSoftwareUpdate !== undefined || props.useLatestServiceSoftwareForBlueGreen !== undefined) ? {
         autoSoftwareUpdateEnabled: props.enableAutoSoftwareUpdate,
+        useLatestServiceSoftwareForBlueGreen: props.useLatestServiceSoftwareForBlueGreen,
       } : undefined,
       ipAddressType: props.ipAddressType,
       aimlOptions: props.s3VectorsEngineEnabled !== undefined ? {

packages/aws-cdk-lib/aws-opensearchservice/test/domain.test.ts

@@ -2698,6 +2698,47 @@ each(testedOpenSearchVersions).describe('offPeakWindow and softwareUpdateOptions
     });
   });
 
+  test('with useLatestServiceSoftwareForBlueGreen', () => {
+    new Domain(stack, 'Domain', {
+      version: engineVersion,
+      useLatestServiceSoftwareForBlueGreen: true,
+    });
+
+    Template.fromStack(stack).hasResourceProperties('AWS::OpenSearchService::Domain', {
+      SoftwareUpdateOptions: {
+        UseLatestServiceSoftwareForBlueGreen: true,
+      },
+    });
+  });
+
+  test('with useLatestServiceSoftwareForBlueGreen set to false', () => {
+    new Domain(stack, 'Domain', {
+      version: engineVersion,
+      useLatestServiceSoftwareForBlueGreen: false,
+    });
+
+    Template.fromStack(stack).hasResourceProperties('AWS::OpenSearchService::Domain', {
+      SoftwareUpdateOptions: {
+        UseLatestServiceSoftwareForBlueGreen: false,
+      },
+    });
+  });
+
+  test('with both enableAutoSoftwareUpdate and useLatestServiceSoftwareForBlueGreen', () => {
+    new Domain(stack, 'Domain', {
+      version: engineVersion,
+      enableAutoSoftwareUpdate: true,
+      useLatestServiceSoftwareForBlueGreen: true,
+    });
+
+    Template.fromStack(stack).hasResourceProperties('AWS::OpenSearchService::Domain', {
+      SoftwareUpdateOptions: {
+        AutoSoftwareUpdateEnabled: true,
+        UseLatestServiceSoftwareForBlueGreen: true,
+      },
+    });
+  });
+
   test('with invalid offPeakWindowStart', () => {
     expect(() => {
       new Domain(stack, 'Domain1', {