はじめに

皆さん、こんにちは。

私は業務でデータ利活用基盤を取り扱っているため、dbtやIceberg、そしてAWS GenUに取り組む必要があると考えています。特に AWS Japan Top Engineer として、GenUを扱い、その活用を広めることが責務だと感じています。

しかし、私はこれまで CloudFormation を好んで使っており、（逆張り思考も重なって）Cfn テンプレートをシンプルかつ汎用性・拡張性の高い形で作ることに注力してきました。そのため、改めてGenU の CDK コードを読もうとしても、なかなか理解が進みませんでした。

そこで、CDK を学びながら、その過程を記事としてまとめることにしました。

CDK の動作確認

前回は CDK のセットアップを行いました。で今回は CDK の動作確認をしたいと思います。

CDK の記法（レイヤー）について

CDK にはレイヤーという概念があります。

L1は CloudFormation 相当の記述です。
L2は L1 から CloudFormation 構文の共通的な記載を排除し、よりユーザライクでわかりやすい記述となります。最も広く使用されているレイヤータイプとのことです。
L3は特定のユースケースに即した、複数の AWS リソースを構築する記法と読み取りました。

動作確認用 CDK ファイルの定義

以下は L2 での S3 バケット作成の記載例です。
lib/cdk_tutorial-stack.ts に、以下のように S3 バケットを定義します。

lib/cdk_tutorial-stack.ts

import * as cdk from 'aws-cdk-lib';
import * as s3 from 'aws-cdk-lib/aws-s3';
import { Construct } from 'constructs';

export class CdkTutorialStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    const accountId = cdk.Stack.of(this).account; // AWSアカウントID

    new s3.Bucket(this, 'MyBucket', {
      bucketName: `my-cdk-app-bucket-${accountId}`,
      versioned: true, // バージョニングを有効化
      removalPolicy: cdk.RemovalPolicy.DESTROY, // スタック削除時にバケットを削除
      autoDeleteObjects: true, // バケット削除時に中身を削除
    });
  }
}

CDK の動作確認

バケットを AWS にデプロイするには、以下のコマンドを実行します。

cdk synth # or npm run cdk synth
cdk deploy # or npm run cdk deploy

cdk deploy でエラーが発生しました。

current credentials could not be used to assume 'arn:aws:iam::xxxxxxxxxxxx:role/cdk-hnb659fds-deploy-role-xxxxxxxxxxxx-ap-northeast-1', but are for the right account. Proceeding anyway.

AWS CDK のブートストラップができていなかったようです。

aws cloudformation list-stacks --query "StackSummaries[?StackName=='CDKToolkit']" # 空
cdk bootstrap aws://[AWSアカウントID]/ap-northeast-1

CDKToolkit スタックが作成されました。

再度cdk deploy を行ったところ、AWS アカウント ID が取得できていないというエラーが発生しました。
env を明示的に指定します。

bin/cdk_tutorial.ts

#!/usr/bin/env node
import * as cdk from 'aws-cdk-lib';
import { CdkTutorialStack } from '../lib/cdk_tutorial-stack';

const app = new cdk.App();
new CdkTutorialStack(app, 'CdkTutorialStack', {
  /* If you don't specify 'env', this stack will be environment-agnostic.
   * Account/Region-dependent features and context lookups will not work,
   * but a single synthesized template can be deployed anywhere. */
  /* Uncomment the next line to specialize this stack for the AWS Account
   * and Region that are implied by the current CLI configuration. */
  env: {
    account: process.env.CDK_DEFAULT_ACCOUNT,
    region: process.env.CDK_DEFAULT_REGION,
  },
  /* Uncomment the next line if you know exactly what Account and Region you
   * want to deploy the stack to. */
  // env: { account: '123456789012', region: 'us-east-1' },
  /* For more information, see https://docs.aws.amazon.com/cdk/latest/guide/environments.html */
});

再度cdk deploy を行ったところ、エラーが解消しました。
無事に CdkTutorialStack が作成されています。

aws s3 ls | grep my-cdk-app-bucket # my-cdk-app-bucket-${accountId}

これにて動作確認は終了です。