使用 CDK 工具包库执行编程操作 - AWS Cloud Development Kit (AWS CDK) v2

这是 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 工具包库的更多信息,请参阅以下内容: