CDK Toolkit Library の開始方法 - AWS クラウド開発キット (AWS CDK) v2
前提条件ステップ 1: CDK Toolkit Library をインストールするステップ 2: CDK Toolkit Library を初期化するステップ 3: CDK アプリのクラウドアセンブリソースを作成するステップ 4: CDK アプリのプログラムアクションを定義するステップ 5: CDK Toolkit をさらにカスタマイズする追加リソース

これは AWS CDK v2 デベロッパーガイドです。旧版の CDK v1 は 2022 年 6 月 1 日にメンテナンスを開始し、2023 年 6 月 1 日にサポートを終了しました。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

CDK Toolkit Library の開始方法

AWS CDK Toolkit Library を使用して、合成やデプロイなどの CDK アクションをプログラムでコードで実行します。

前提条件

  1. サポートされているバージョンの Node.js がインストールされました。

  2. AWS 認証情報が設定されました。

  3. AWS CDK の基本的な知識。

詳細については、AWS 「CDK の前提条件」を参照してください。

ステップ 1: CDK Toolkit Library をインストールする

以下を実行して、プロジェクトの開発環境に CDK Toolkit Library パッケージをインストールします。

npm install --save @aws-cdk/toolkit-lib

ステップ 2: CDK Toolkit Library を初期化する

CDK Toolkit インスタンスを作成して、CDK アプリケーションでプログラムによるアクションを実行します。

import { Toolkit } from '@aws-cdk/toolkit-lib';

const toolkit = new Toolkit({
    // Optional configuration options go here
});

CDK Toolkit インスタンスは、作成時にカスタマイズできます。手順については、「CDK Toolkit インスタンスの設定」を参照してください。

ステップ 3: CDK アプリのクラウドアセンブリソースを作成する

クラウドアセンブリソースは、CDK アプリから CloudFormation テンプレートを生成する手順を提供します。1 つは複数の方法で作成できます。以下に、いくつかの例を示します。

  1. インラインアセンブリビルダー関数：

    import * as cdk from 'aws-cdk-lib';

const cloudAssemblySource = await toolkit.fromAssemblyBuilder(async () => {
  const app = new cdk.App();
  new MyStack(app, 'MyStack');
  return app.synth();
});

  2. 既存の CDK アプリファイル：

    const cloudAssemblySource = await toolkit.fromCdkApp("ts-node app.ts");

詳細については、「クラウドアセンブリソースの設定」を参照してください。

ステップ 4: CDK アプリのプログラムアクションを定義する

CDK Toolkit インスタンスとクラウドアセンブリソースを作成したら、プログラムによるアクションの定義を開始できます。MyStack スタックのデプロイを作成する基本的な例を次に示します。

import { StackSelectionStrategy } from '@aws-cdk/toolkit-lib';

await toolkit.deploy(cloudAssemblySource, {
  stacks: {
    strategy: StackSelectionStrategy.PATTERN_MUST_MATCH, // Deploy only stacks that exactly match the provided patterns
    patterns: ["MyStack"],
  },
});

ステップ 5: CDK Toolkit をさらにカスタマイズする

ニーズに合わせて CDK Toolkit をさらに設定およびカスタマイズできます。

  • メッセージとインタラクション - CDK Toolkit がユーザーやアプリケーションと通信する方法を設定します。メッセージとインタラクションの設定を参照してください。

  • エラー処理 - CDK オペレーションの構造化エラー処理を実装します。「エラー処理の設定」を参照してください。

追加リソース

CDK Toolkit Library npmパッケージの詳細については、@aws-cdk/toolkit-lib npmパッケージの ReadMe を参照してください。

API リファレンス情報については、CDK Toolkit Library API リファレンスを参照してください。