@cdkd/cli

中文文档
0.335.0发布于 2026/11/09Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 4410

已存在的 CDK 应用程序的 CDK CLI - 最多 15x 通过直接的 AWS SDK 调用以更快的部署

中文使用文档
文档目录12 节
  1. AWS CDK的部署速度最快.
  2. 安装
  3. 快速启动
  4. 使用 AI 编码代理
  5. 克劳德代码
  6. 其他剂(Codex、光标等)
  7. 贡献者
  8. 文档
  9. 基准
  10. vs CloudFormation 快捷模式: 最多9x更快
  11. vs Terraform: cdkd 部署更快
  12. 许可证

cdkd logo

cdkd (CDK 直接) (中文(简体) )

npm version Downloads License: Apache-2.0

AWS CDK的部署速度最快.

已存在的 CCDK apps 的 Drop-in CDK CLI——通过直接的 AWS SDK 调用,而不是 CloudFormation , 最高可有15x的更快部署.

* 文档: cdkd.dev (英语)


  • CDK 下放兼容性: 您现有的 CDK app 代码按- 运行; 只替换 cdk deploy 与 cdkd deploy。 。 。 .
  • 最多15个快速部署:直接SDK呼叫,主动平行,以及 --no-wait 避免缓慢稳定等待; 比Terraform 和 Cloud Formation 快捷模式更快 也 (参见 基准) (中文(简体) ).

cdk deploy vs cdkd deploy — side-by-side, 35s recording, real AWS deploy. cdkd finishes while cdk is still creating its CloudFormation changeset.

cdkd补充了AWS CDK CLI,而不是替换. 在dev/测试中使用cdkd进行快速迭代;在生产中使用AWS CDK CLI用于全云格式工具. 将 cdkd 安装在已有的旁边 cdk deploy 工作流程:不需要迁移。 你也可以这样 导入 已存在堆栈为 cdkd 或 导出 随时回云阵.

自然适合AI驱动的发展. AI编码代理器在紧凑的自旋/被撕裂的回路中相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相接相 cdkd destroy 直接删除 SDK 的电话 而不是投票的 Cloud Formation 堆叠删除.

从你部署的堆栈处死. cdkd local 运行您的函数、 API 和 ECS 任务。 它能从您实际部署的堆栈中解析 Env vars, 秘密和资源引用: 无手写 .env 文件,没有手播测试数据(参见 当地执行) (中文(简体) ).

[大 cdkd只用于dev/测试工作流程——开发初期,尚未做好生产准备.

安装

npm i -g @cdkd/cli            # latest release
npm i -g @cdkd/cli@<version>  # pin to a specific version

安装的二进制是 cdkd它需要节点js 22.12 或以后.

cdkd 先前作为 @go-to-k/cdkd; 该软件包已贬值 不得再被释放。 两个软件包都安装相同 cdkd 二进制,在安装新元前删除旧元:

npm rm -g @go-to-k/cdkd && npm i -g @cdkd/cli

快速启动

第一次设置: 运行 cdkd bootstrap 每个 AWS 账户在任何账户之前一次 其他命令; 替换 cdk bootstrap,则cdkd不需要 (详见 开始) (中文(简体) ).

# Bootstrap (creates S3 state bucket + asset storage — one-time setup per AWS account)
cdkd bootstrap

# List stacks in the CDK app
cdkd list

# Deploy your CDK app
cdkd deploy

# Deploy at maximum speed: skip slow stabilization waits
cdkd deploy --no-wait

# Check what would change
cdkd diff

# Tear down
cdkd destroy

使用 AI 编码代理

这个寄存器是 cdkd 技能 教AI编码代理安全使用cdkd(AI 代理指南) (中文(简体) ).

克劳德代码

通过在 Claude 代码会话中运行这些设备, 将其安装为插件( 一次性设置) :

/plugin marketplace add go-to-k/cdkd
/plugin install cdkd-skills@cdkd

然后请克洛德部署一个带有 cdkd 的 dev/test CDK 堆栈——技能 自动触发——或直接以 /cdkd。 。 。 .

其他剂(Codex、光标等)

任何支持 SKILL.md 格式的代理可以使用该技能. 安装它 与 GitHub 缩写 (v2.90+)或 (v npx skills数字 :

gh skill install go-to-k/cdkd cdkd
# or
npx skills add go-to-k/cdkd --skill cdkd

贡献者

要测试当前对另一个 CDK 项目的检出, 请复制此选项 存储并添加到 Claude 代码会话中—— 工程范围 /use-cdkd 技术覆盖建筑和 连接检出 :

claude --add-dir /path/to/cdkd

文档

完整文档生活于 cdkd.dev (英语)数字 :

基准

cdkd 部署最多 15 个比 AWS CDK 更快( CloudFormation) 在SDK-Provider处理的堆栈上;每堆速度随大小和平行性而扩大.

Deploy race on a VPC + CloudFront + Lambda stack: AWS CDK (CloudFormation) 599 s, cdkd 96 s (~6x faster), cdkd --no-wait 40 s (15.0x faster). Deploy phase only.

vs CloudFormation 快捷模式: 最多9x更快

云阵 快捷模式 是一个快速部署选项, 它跳过资源稳定等待, 在精神上类似于 cdkd's --no-wait即使如此,Cdkd的速度 也比快 几乎每堆,还有 --no-wait 它在以合成资源为主的堆栈上 大幅领先.

堆栈正常( CFn)快递(简体中文)(简体中文) --no-wait
VPC + Lambda + SQS + 云纹562 (韩语)366 (韩语)96 (韩语)第40条
迪纳摩DB页:1页:1第 19 条15个
迪纳摩DB + KMS页:1第55条27个27个
欧共体2第44条31个27个第 26 条
兰布达第55条页:1第23条22个
第3条页:122个第23条24个
质量83个22个第9条第9条
SQS + 云表第87条第44条30个31个

最佳3跑,部署阶段 仅秒, us-west-2。 。 。 .

vs Terraform: cdkd 部署更快

我们还对Terraform进行了cdkd比赛:同样的逻辑堆栈既表现为CDK应用,也表现为Terraform HCL,被部署在了真正的AWS上. cdkd在四种情景中明显更快——1.23x至2.31x,完全分离运行分布——其余则在统计上捆绑.

假设堆栈(简体中文)地形云阵(简体中文) --no-wait
宽48个独立资源(S3 / DynamoDB / SQS / SNS / SSM / Logs,各有8个)20.0 (韩语)第46.1条89.1 国家21.1 国家
无服务器Lambda×3 + HTTP API + DynamoDB + SNS / SQS + EventBridge25.9 国家57.5 (中文(简体) )127.1 国家24.6 联合国
ec2 数字VPC+子网+SG+IAM角色+EC2实例×329.1 (中文(简体) )35.9 联合国193.9 联合国22.0
网络应用VPC + NAT + 子网 + DynamoDB + SQS + S3 + Lambda ×2 + HTTP API第109.7条127.3 请检查date=中的日期值 (帮助)166.1 (中文(简体) )23.4 联合国
ecs——稳定状态VPC x2 AZ + 远门集群/任务/服务 + ALB176.2 (中文(简体) )228.9 (中文(简体) )wait_for_steady_state = true(中文(简体) )276.7 (英语)34.5 国家
云锋-所创造(火与忘)S3 原产地 + CloudFront + OAC第11.1条10.3 (中文(简体) )wait_for_deployment = false(中文(简体) )无此模式10.4 国家
云锋- DeployedS3 原产地 + CloudFront + OAC174.0 (中文(简体) )--full-wait(中文(简体) )166.4 联合国232.3 (中文(简体) )无

冷的端到端的墙钟 包括合成 / 计划,中位数为7跑,秒, us-east-1. ecs cdkd 和 Terraform 的细胞来自晚于其他表的圆.

完整的方法,分布分析,每个运行的数据,以及完整的套件(SDK Proferver路径,Cloud Control回落路径,15x头行堆栈): cdkd.dev/基准/标。 。 。 .

许可证

Apache 2.0 (英语)

版本与发布记录

@cdkd/cli 共发布 24 个版本,首次发布于 2026/11/03;过去 12 个月发布了 24 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.335.0latest2026/11/09今天
0.334.32026/11/081 天前
0.334.22026/11/081 天前
0.334.12026/11/081 天前
0.334.02026/11/071 天前
0.333.12026/11/072 天前

关于 @cdkd/cli 的常见问题

@cdkd/cli 是什么?

已存在的 CDK 应用程序的 CDK CLI - 最多 15x 通过直接的 AWS SDK 调用以更快的部署

如何安装 @cdkd/cli?

在项目目录运行 npm install @cdkd/cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 cdkd,可以用 npx cdkd 直接运行。

@cdkd/cli 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@cdkd/cli 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@cdkd/cli 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.12.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@cdkd/cli 可以商用吗?

@cdkd/cli 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@cdkd/cli 的下载量有多少?

根据 npm 官方下载统计,@cdkd/cli 在 2026/10/10 – 2026/11/08 这 30 天内被下载 4,410 次,日均约 147 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@cdkd/cli 还在维护吗?

最新版本 0.335.0 发布于 2026/11/09(今天);至今共发布 24 个版本,其中过去 12 个月发布了 24 个;首次发布于 2026/11/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。