这是 AWS CDK v2 开发者指南。旧版 CDK v1 于 2022 年 6 月 1 日进入维护阶段,并于 2023 年 6 月 1 日终止支持。
本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用 CDK 工具包库执行编程操作
了解 CDK 工具包库
CDK 工具包库允许您通过代码以编程方式执行 CDK 操作,而不必使用 CLI 命令。您可以使用此库创建自定义工具、构建专门的 CLI 应用程序,以及将 CDK 功能集成到您的开发工作流程中。
- 通过编程控制管理基础架构生命周期
-
CDK 工具包库为以下 CDK 操作提供编程接口:
-
合成-生成 AWS CloudFormation 模板和部署工件。
-
部署-使用 CloudFormation 模板配置或更新基础架构。
-
列表-查看有关堆栈及其依赖关系的信息。
-
Watch-监控 CDK 应用程序的本地更改。
-
回滚-将堆栈恢复到上一个稳定状态。
-
销毁-移除 CDK 堆栈和相关资源。
-
- 增强和自定义您的基础架构管理
-
-
通过代码进行控制-将基础架构管理直接集成到您的应用程序中,并构建响应式部署管道。
-
管理云程序集-在部署之前创建、检查和转换您的基础架构定义。
-
自定义部署-根据您的要求配置参数、回滚行为和监控。
-
精确处理错误-使用详细的诊断信息实现结构化错误处理。
-
定制通信-配置自定义进度指示器并记录
IoHost
实现情况。 -
Connect with AWS -以编程方式配置配置文件、区域和身份验证流程。
-
选择何时使用 CDK 工具包库
当您需要执行以下操作时,CDK 工具包库特别有用:
-
作为 CI/CD 管道的一部分,自动部署基础架构。
-
根据组织需求构建定制的部署工具。
-
将 CDK 操作集成到现有应用程序或平台中。
-
使用自定义验证或批准步骤创建专门的部署工作流程。
-
在多个环境中实施高级基础架构管理模式。
使用 CDK 工具包库
以下示例说明如何使用 CDK 工具包库创建和部署简单的 S3 存储桶:
// Import required packages import { Toolkit } from '@aws-cdk/toolkit-lib'; import { App, Stack } from 'aws-cdk-lib'; import * as s3 from 'aws-cdk-lib/aws-s3'; // Create and configure the CDK Toolkit const toolkit = new Toolkit(); // Create a cloud assembly source with an inline app const cloudAssemblySource = await toolkit.fromAssemblyBuilder(async () => { const app = new App(); const stack = new Stack(app, 'SimpleStorageStack'); // Create an S3 bucket in the stack new s3.Bucket(stack, 'MyFirstBucket', { versioned: true }); return app.synth(); }); // Deploy the stack await toolkit.deploy(cloudAssemblySource);
- 接下来你能做什么
-
-
自动部署-以编程方式触发部署并添加部署前/后步骤。
-
与系统集成-使用 CI/CD 工作流程、定制工具和监控解决方案连接。
-
控制部署细节-为堆栈选择和多环境部署配置精细的选项。
-
增强可靠性-实施生产就绪错误处理和部署进度跟踪。
-
后续步骤
要开始使用 CDK 工具包库,请参阅 CDK 工具包库入门。
了解更多
要了解有关 CDK 工具包库的更多信息,请参阅以下内容:
-
ReadMe
在 @aws-cdk/toolkit-lib 包 npm
中。