如何通过AWS CDK将AWS构造信息传递给Vite/React容器构建？

CDK 的 DockerImageAsset 构建操作是在合成（synth）阶段执行的，这时候像 ALB DNS、Cognito 用户池 ID/应用客户端 ID 这类动态生成的 AWS 资源属性还只是 Token（占位符），并未解析为实际值。而 Docker 构建要求所有 buildArgs 在部署前必须是确定的字符串，这就是你遇到报错的核心原因——哪怕先部署了依赖栈，CDK synth 前端栈时仍会将 CfnImportValue 视为 Token，无法直接传入 buildArgs。

1. 运行时注入环境变量（推荐） #

放弃在构建阶段注入动态值，改为容器启动时注入，绕过 Token 限制：

• 在 React 项目中创建一个全局配置文件（比如 public/config.js），内容为读取全局变量的模板：

  window.APP_CONFIG = {
    API_URL: '__API_URL__',
    COGNITO_USER_POOL_ID: '__COGNITO_USER_POOL_ID__',
    COGNITO_CLIENT_ID: '__COGNITO_CLIENT_ID__'
  };
  

• 编写容器启动脚本 start.sh，读取容器环境变量并替换配置文件中的占位符：

  #!/bin/sh
  sed -i "s/__API_URL__/$REACT_APP_API_URL/g" /usr/share/nginx/html/config.js
  sed -i "s/__COGNITO_USER_POOL_ID__/$REACT_APP_COGNITO_USER_POOL_ID/g" /usr/share/nginx/html/config.js
  sed -i "s/__COGNITO_CLIENT_ID__/$REACT_APP_COGNITO_CLIENT_ID/g" /usr/share/nginx/html/config.js
  nginx -g 'daemon off;'
  

• Dockerfile 中添加启动脚本，并设置执行权限：

  COPY start.sh /start.sh
  RUN chmod +x /start.sh
  CMD ["/start.sh"]
  

• CDK 代码中，将动态资源值注入容器环境变量：

  const container = taskDefinition.addContainer('Frontend', {
    image: ecs.ContainerImage.fromDockerImageAsset(asset),
    environment: {
      REACT_APP_API_URL: alb.loadBalancerDnsName,
      REACT_APP_COGNITO_USER_POOL_ID: userPool.userPoolId,
      REACT_APP_COGNITO_CLIENT_ID: userPoolClient.userPoolClientId
    }
  });
  

2. 分阶段手动传递参数 #

先部署依赖栈，将动态资源值存入 SSM 参数存储或 CloudFormation 导出，再在前端栈 synth 时读取实际值传入 buildArgs：

• 部署依赖栈后，通过 CLI 导出资源值到 SSM：

  aws ssm put-parameter --name "/frontend/api-url" --type "String" --value "$(aws cloudformation describe-stacks --stack-name BackendStack --query "Stacks[0].Outputs[?OutputKey=='AlbDnsName'].OutputValue" --output text)"
  

• 前端栈 CDK 代码中读取 SSM 参数（此时为实际字符串，而非 Token）：

  const apiUrl = ssm.StringParameter.fromStringParameterName(this, 'ApiUrlParam', '/frontend/api-url').stringValue;
  
  const asset = new DockerImageAsset(this, 'FrontendImage', {
    directory: './frontend',
    buildArgs: {
      REACT_APP_API_URL: apiUrl
    }
  });
  

• 缺点：需要手动分步骤部署，无法一键完成全栈部署，适合小型项目或测试场景。

3. 用 CDK Pipeline 实现构建部署分离 #

通过 CDK Pipeline 将依赖栈部署、前端镜像构建、前端栈部署拆分为不同阶段，确保构建阶段能拿到实际资源值：

1. 第一阶段：部署依赖栈（Cognito、ALB），将资源属性输出为 Pipeline 环境变量。
2. 第二阶段：使用 Pipeline 环境变量中的实际值作为 buildArgs，构建前端 Docker 镜像。
3. 第三阶段：部署前端栈，使用刚构建的镜像。
   这种方式能自动化完成全栈部署，同时避免 Token 问题，适合生产环境。

你用 CfnImportValue 传递值的方式无效，因为 CDK synth 是静态分析过程，不会主动查询 CloudFormation 的实际导出值，仍会将其视为 Token。只有当 buildArgs 在 synth 时是确定的字符串（比如硬编码值、已存在的 SSM 参数值），才能正常传入 Docker 构建。

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