在AWS CDK中优雅使用AWS SDK的优化方法咨询

你的问题确实戳中了AWS SDK异步特性在CDK声明式代码里的痛点——回调嵌套或者Promise链式调用会让代码变得臃肿，还容易破坏CDK的资源依赖管理逻辑。这里有几个逐步优化的方案，从代码简洁性到贴合CDK原生设计的方向来：

1. 用Async/Await替代Promise链式调用 #

首先最直接的优化是把回调风格的AWS SDK调用改成Async/Await，这能大幅简化代码结构，尤其是当你需要多个异步调用时，可读性会提升很多。

AWS SDK v2的方法可以通过.promise()转换为Promise，v3本身就是基于Promise的，修改后代码会变成这样：

import { DirectoryService } from 'aws-sdk';
import * as cdk from 'aws-cdk-lib';

async function getDirectoryDnsIps() {
  const ds = new DirectoryService();
  try {
    const data = await ds.describeDirectories({}).promise();
    if (data.DirectoryDescriptions?.[0]?.DnsIpAddrs) {
      return data.DirectoryDescriptions[0].DnsIpAddrs.toString();
    }
    throw new Error("Directory DNS addresses not found");
  } catch (err) {
    throw new Error(`Failed to fetch directory: ${err}`);
  }
}

// 在CDK应用中封装主逻辑
async function main() {
  const app = new cdk.App();
  // 假设networking是已定义好的网络资源栈
  const dnsAddresses = await getDirectoryDnsIps();
  
  const subs = {
    "#{DNS_ADDRESSES}": dnsAddresses,
    "#{SECRET_ID}": directory.directorySecret.secretArn
  };
  let domainJoinScript = // 你的原始PowerShell脚本内容
  Object.entries(subs).forEach( ([key, value]) => {
    domainJoinScript = domainJoinScript.replace(key, String(value));
  });
  
  new cdk.Stack(app, 'instances', {
    vpc: networking.vpc,
    domainJoinScript: domainJoinScript
  });
  
  app.synth();
}

main().catch(err => console.error(err));

这种方式把异步逻辑封装成独立函数，用Async/Await让代码线性化，比Promise链式调用清晰很多，多SDK调用的话也能按顺序编写，不用嵌套。

2. 优先使用CDK原生的资源引用（最佳实践） #

如果你的目录服务是在同一个CDK应用中创建的，那完全不需要调用AWS SDK！CDK的核心优势就是声明式管理资源依赖，你可以直接从目录资源对象中获取DNS IP地址，CDK会自动处理资源创建顺序和值的传递：

import * as ds from 'aws-cdk-lib/aws-directoryservice';
import * as cdk from 'aws-cdk-lib';

// 假设你是这样创建目录的
const directory = new ds.CfnDirectory(this, 'MyDirectory', {
  name: 'example.com',
  password: 'your-secure-password',
  directorySize: 'Small',
  // 其他必要配置参数
});

// 直接引用目录的DNS IP属性，CDK会自动处理依赖
const dnsAddresses = directory.attrDnsIpAddresses;

// 直接在脚本中使用该属性，CDK会自动替换为实际值
const domainJoinScript = `
# 你的PowerShell脚本内容
Add-Computer -DomainName example.com -DomainCredential (Get-Credential) -Server ${dnsAddresses}
`;

// 创建实例栈时直接传递，CDK会确保目录先创建完成，再创建实例
new cdk.Stack(app, 'instances', {
  vpc: networking.vpc,
  domainJoinScript: domainJoinScript
});

这种方式完全避免了手动异步调用，因为CDK会在synth阶段自动解析资源的输出属性，并且保证资源创建的顺序（目录先创建，再创建需要它DNS地址的实例），这才是CDK的正确使用方式，代码简洁且不易出错。

3. 处理跨栈或预创建的目录 #

如果目录是在其他CDK栈中创建的或者是提前手动创建的，除了用Async/Await调用SDK，还可以用CDK的CustomResource来封装SDK调用，这样能把异步逻辑整合到CDK的依赖管理中：

import { CustomResource } from 'aws-cdk-lib';
import * as cr from 'aws-cdk-lib/custom-resources';

// 创建自定义资源来获取目录DNS地址
const getDirectoryDns = new CustomResource(this, 'GetDirectoryDns', {
  serviceToken: cr.Provider.getOrCreate(this, 'DirectoryServiceProvider'),
  properties: {
    DirectoryId: 'your-existing-directory-id'
  },
  resourceType: 'Custom::DirectoryDns',
  onCreate: {
    service: 'DirectoryService',
    action: 'describeDirectories',
    parameters: {
      DirectoryIds: ['your-existing-directory-id']
    },
    physicalResourceId: cr.PhysicalResourceId.of('DirectoryDns'),
    outputPath: 'DirectoryDescriptions.0.DnsIpAddrs'
  }
});

// 从自定义资源中获取DNS地址
const dnsAddresses = getDirectoryDns.getAttString('DnsIpAddrs');

// 后续的脚本替换和实例创建逻辑和之前一致

自定义资源的好处是，它会在CDK部署阶段执行SDK调用，并且和其他资源一样受CDK的依赖管理控制，不会出现因为目录还没创建完成就去获取地址的问题，比手动调用SDK更可靠。

总结一下：

• 优先用CDK原生的资源属性引用，这是最简洁可靠的方式；
• 必须调用SDK时，用Async/Await替代回调和Promise链式调用；
• 跨栈或预创建资源的场景，用CustomResource整合异步逻辑到CDK生命周期中。

内容的提问来源于stack exchange，提问作者Carling Knight