cdk synthesize - AWS Cloud Development Kit (AWS CDK) v2

这是 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