这是 AWS CDK v2 开发者指南。较旧的 CDK v1 于 2022 年 6 月 1 日进入维护阶段,并于 2023 年 6 月 1 日终止支持。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
cdk synthesize
合成CDK应用程序以生成云程序集,包括每个堆栈的 AWS CloudFormation 模板。
云程序集是包含将应用程序部署到 AWS 环境所需的所有内容的文件。例如,它包括应用程序中每个堆栈的 CloudFormation 模板,以及文件资产的副本或 Docker 您在应用程序中引用的图片。
如果您的应用程序包含单个堆栈或提供单个堆栈作为参数,则 CloudFormation 模板也将以YAML格式显示在标准输出 (stdout
) 中。
如果您的应用程序包含多个堆栈,则cdk synth
会将云程序集合成到。cdk.out
使用量
$
cdk synthesize
<arguments>
<options>
参数
- CDK堆栈 ID
-
您的应用中要合成的CDK堆栈的构造 ID。
类型:字符串
必需:否
Options
查看适用于所有选项的全局选项列表 CDK CLI 命令,请参阅全球期权。
--exclusively, -e
BOOLEAN
-
仅合成请求的堆栈,不包括依赖关系。
--help, -h
BOOLEAN
-
显示命令的
cdk synthesize
命令参考信息。 --quiet, -q
BOOLEAN
-
不要将 CloudFormation 模板输出到
stdout
。可以在CDK项目
cdk.json
文件中配置此选项。以下是 示例:{ "quiet": true }
默认值:
false
--validation
BOOLEAN
-
合成后通过执行其他检查来验证生成的 CloudFormation 模板。
您也可以通过
validateOnSynth
属性或CDK_VALIDATION
环境变量配置此选项。默认值:
true
示例
为具有逻辑 ID 的CDK堆栈合成云程序集, MyStackName 然后将 CloudFormation 模板输出到 stdout
$
cdk synth MyStackName
合成CDK应用程序中所有堆栈的云端程序集并将其保存到 cdk.out
$
cdk synth
合成云程序集 MyStackName,但不包括依赖关系
$
cdk synth MyStackName --exclusively
合成云程序集 MyStackName,但不要将 CloudFormation 模板输出到 stdout
$
cdk synth MyStackName --quiet