AWS CDK流水线部署栈时--parameters传参报错问题排查

• 你对--parameters参数的作用域理解有误：不带栈名前缀的--parameters <参数名>=<值>写法，会让CDK CLI尝试把这个参数传递给本次待部署的所有栈。CloudFormation本身要求所有传入模板的参数必须提前在模板的Parameters段声明，只要本次部署的任意一个栈没有定义同名参数，就会抛出Parameters: [uploadBucketName] do not exist in the template错误。你虽然在某一个栈里加了CfnParameter定义，但流水线是一次部署多组栈，其余未定义该参数的栈会直接触发报错，这就是你加了参数定义还是没解决问题的核心原因。
• 你存在配置逻辑的混淆：你手动在cdk-toolkit的CFN模板里声明的S3桶X，CDK不会自动识别为自身的资产上传桶。CDK Bootstrap生成的Toolkit栈对资产存储桶有固定的资源标识、权限策略、输出字段要求，手动往模板里加的同名单桶不满足这些隐式要求，CDK CLI自然不会把部署过程中生成的模板、资产文件自动上传到这个桶里。
• 你疑惑的「为什么命令行传参还要提前在栈代码里定义」是CloudFormation的底层规则：CDK最终会把栈代码编译为标准CloudFormation模板，所有传入栈的参数必须先在模板的Parameters块中声明，否则CloudFormation服务会直接拒绝部署请求，这个限制不是CDK额外设置的。

• 第一步：修正cdk-toolkit栈的资产桶配置
  先删掉你之前手动在cdk-toolkit的yaml模板里添加的S3桶X资源，不要手动修改Toolkit栈的资源结构，直接用CDK官方的bootstrap命令指定自定义资产桶名，让CLI自动完成符合规范的资源创建和权限配置，命令如下：

  cdk bootstrap --toolkit-stack-name my-toolkit --bootstrap-bucket-name X
  

  执行完成后，CDK会自动创建命名为X的资产存储桶，配置好对应的读写权限，并且把桶信息写入Toolkit栈的输出字段，后续所有cdk deploy操作都会自动从Toolkit栈读取这个桶的信息作为资产上传目标，不需要你手动通过--parameters传值。
• 第二步：修正参数传递规则（仅当你确实需要给业务栈传自定义参数时使用）
  如果你确实需要给指定业务栈传递自定义参数，必须在参数前加上目标栈名前缀，明确告诉CDK这个参数要传给哪个栈，不要用全局传参的写法，示例命令如下：

  cdk deploy --toolkit-stack-name my-toolkit --parameters MyFirstStack:uploadBucketName=X --ci --require-approval never
  

  这种写法下，CDK只会把uploadBucketName参数传给名为MyFirstStack的栈，不会要求其他待部署栈也定义这个参数，就不会触发参数不存在的报错。
• 第三步：清理冗余代码
  如果你之前在栈代码里添加的uploadBucketNameCfnParameter只是为了指定CDK资产上传桶，这部分代码可以直接删除。CDK资产上传是CLI层面的部署逻辑，和业务栈本身的参数没有关系，不需要在业务栈里定义相关参数接收。

注意：不要手动修改CDK Toolkit栈的资源和模板内容，CDK CLI对Toolkit栈的结构有固定校验逻辑，手动改动很容易引发权限不足、资产上传失败、版本不兼容等部署问题。

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