如何在测试AWS CDK模板时避免实际创建Docker镜像

方案1：全局禁用资产构建（适用于所有资产类型） #

CDK原生支持在测试场景下关闭资产的实际构建流程，仅生成资产的元数据占位，不会触发Docker build、文件打包等操作，大幅缩短单元测试耗时。
配置方式：在单元测试中初始化CDK App/Stack实例时，传入assetStaging: false参数即可：

// TypeScript环境示例，其他语言逻辑一致
import { App } from 'aws-cdk-lib';
import { Template } from 'aws-cdk-lib/assertions';
import { MyStack } from '../lib/my-stack';

test('stack snapshot test', () => {
  const app = new App({
    assetStaging: false // 关闭所有资产的实际构建流程
  });
  const stack = new MyStack(app, 'test-stack');
  const template = Template.fromStack(stack);
  // 后续正常编写断言逻辑即可
});

该配置对Docker镜像资产、S3文件资产等所有CDK资产类型都生效，只会校验资产配置的语法正确性，不会执行实际的构建动作。

方案2：单独Mock Docker镜像资产（适用于仅需跳过Docker构建的场景） #

如果你需要保留其他资产的构建逻辑，仅跳过Docker镜像的构建，可以手动替换Docker镜像资产的实现为Mock对象，使用固定的占位镜像地址代替实际构建的镜像：

// 手动Mock Docker镜像资产示例
import * as lambda from 'aws-cdk-lib/aws-lambda';
import { DockerImageAsset } from 'aws-cdk-lib/aws-ecr-assets';

// 在测试用例中重写Docker镜像资产的实例化逻辑
jest.mock('aws-cdk-lib/aws-ecr-assets', () => {
  return {
    DockerImageAsset: jest.fn().mockImplementation(() => {
      return {
        imageUri: 'mock-ecr-image:latest'
      };
    })
  };
});

test('lambda function config is correct', () => {
  const app = new App();
  const stack = new MyStack(app, 'test-stack');
  const template = Template.fromStack(stack);
  // 校验Lambda的镜像配置正常生成即可，不需要实际构建镜像
  template.hasResourceProperties('AWS::Lambda::Function', {
    PackageType: 'Image',
    Code: {
      ImageUri: 'mock-ecr-image:latest'
    }
  });
});

注意事项 #

• 上述两种方案仅适用于单元测试（即校验CDK生成的CloudFormation模板是否符合预期的场景），如果你需要运行集成测试、部署到真实AWS环境做验证，还是需要正常构建Docker镜像。
• 如果你使用的是CDK v1版本，对应的配置参数为@aws-cdk/core:assetStaging上下文参数，传入方式为new App({ context: { '@aws-cdk/core:assetStaging': false } })。

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