┌───┬─────────────────────────────────┬────────┬─────────────────┬───────────────────────────┬─────────────────────────────────────────────────────────────────┐
│   │ Resource                        │ Effect │ Action          │ Principal                 │ Condition                                                       │
├───┼─────────────────────────────────┼────────┼─────────────────┼───────────────────────────┼─────────────────────────────────────────────────────────────────┤
│ - │ ${CdkWorkshopQueue50D9D426.Arn} │ Allow  │ sqs:SendMessage │ Service:sns.amazonaws.com │ "ArnEquals": {                                                  │
│   │                                 │        │                 │                           │   "aws:SourceArn": "${CdkWorkshopTopicD368A42F}"                │
│   │                                 │        │                 │                           │ }                                                               │
└───┴─────────────────────────────────┴────────┴─────────────────┴───────────────────────────┴─────────────────────────────────────────────────────────────────┘
(NOTE: There may be security-related changes not in this list. See https://github.com/aws/aws-cdk/issues/1299)

Resources
[-] AWS::SQS::Queue CdkWorkshopQueue50D9D426 destroy
[-] AWS::SQS::QueuePolicy CdkWorkshopQueuePolicyAF2494A5 destroy
[-] AWS::SNS::Subscription CdkWorkshopQueueCdkWorkshopStackCdkWorkshopTopicD7BE96438B5AD106 destroy
[-] AWS::SNS::Topic CdkWorkshopTopicD368A42F destroy

差分を確認して、cdk deployすると、コードから消したリソースがAWSからも消える。

Hello Lambda

lambdaにjsのコードをあげてみる。
書きながら、どんなリソースを作ろうとしているのか理解していく。
lambdaの作成は手順に従っていけばすんなりできる。

このページで、簡単にcdkのsdkで提供しているクラスの概念的なものを説明している。
cdkのsdkで提供されているクラスはconstruct(何かの要素を組み合わせてできたもの、というイメージ?)であると説明している。
constructを組み合わせたものがconstructを構成するという、入れ子なイメージ。
また、各クラスのコンストラクタが(scope, id, props)というシグニチャを持っており、それらが何を意図しているか説明している。

scopeはそのconstructが作成されたscope(scopeとは？という気持ちになるが我慢して進める。コンテキスト、みたいなイメージか？)を指し示す。基本的にthisを渡す。
idはconstruct内で一意になる値を渡す。
propsは各constructの性質によって取りうる値が異なる。lambda.Functionならruntime,code,handlerなど

CDK Watch

lambdaのコードだけ変えるのに、cdk deployするのだと時間かかってしょうがないよね。。？みたいな問題提起からこの章は始まる。
cdk deploy --hotswapを使えば、cloud formationを経由せずにデプロイできるため、デプロイ時間短縮につながる。

実際、この章でやってるコマンドを私の環境でやってみたところ、普通のcdk deployだと40s近かったが、cdk deploy --hotswapだと10秒くらいで完了した。

そして、CDKではcdk watchコマンドなるものを用意している。
手元でcdk watchコマンドを流しておけば、コードの変更を勝手に検知して、AWSリソースに変更を加えてくれる。
コードに変更を加えた際にhotswapで変更可能(cloud formationを介さくても良い変更)であればhotswapでデプロイし、そうでなければcloud formationでデプロイする。

手元でcdk watchを試してみたところ、lambdaにあげているjsファイルを変更した際にはhotswapでのデプロイが走り、lambdaのhandler名を変えた場合にはcloud formationを介したデプロイが走った。

API Gateway

API Gatewayを上で作成したLambdaの前段に置いてあげましょう、という章。
コードを記述してcdk deployすると、標準出力に

Outputs:
CdkWorkshopStack.Endpoint~~~~~~~~ = https://~~~~~~~~~~~~.execute-api.ap-northeast-1.amazonaws.com/prod/

みたいな感じでエンドポイントが表示されるのでcurlなりブラウザなりでアクセスできる。

Writing constructs

これまでの構成要素にDynamoDBを加えて、URLをアクセスした回数をカウントするようにする。

Define the HitCounter API

HitCounter.javaなるクラスと、HitCounterProps.javaなるインターフェースを作成する。

Hit counter Lambda handler

hitcounter.jsなるLambdaにあげるファイルを作成する。
hitcounter.jsを記述するにあたって必要なLambdaの識別子、DynamoDBの接続先はdeployの際に確定するので、コード上は環境変数としている。
これらはconstructのコード(Javaのコード)に記述していく。

Define resources

HitCounter.javaにDynamoDBのリソース定義とLambdaのリソース定義を記述している。
１つ前の章で言及した環境変数は、ここで注入するためのコードを書いている。

Use the hit counter

CdkWorkshopStack.javaにHitCounter.javaというconstructを利用する旨を記述する。
API Gatewayからはhitcounter.jsを携えたlambdaを呼ぶようにする。

この状態でcdk deployしたものにアクセスすると502 Bad Gatewayになる。

CloudWatch Logs

CloudWatchにエラーをみにいく方法が書いてある。DynamoDBに書き込みにいく権限が無さげなエラーが出ていることがわかる。
(Lambdaあまり使ってない勢からするとこういうエラー解析の説明はかなり助かる)

Granting permissions

hitcounterのLambdaから、DynamoDBとhelloのLambdaを叩く権限を与える。
すると、200が返るようになる。

Test the hit counter

色々なパスにアクセスして、DynamoDBのコンソールから正しくカウントされていることを確認する。

また、HitCounterは再利用可能で、maven centralにあげて、誰でも容易に同じようなことができるよ、と言及している。

Using construct libraries

cdk-dynamo-table-viewerというconstructのライブラリを利用して、Webページからhitcounterのテーブル情報をみれるようにする。

Learning about the Table Viewer construct

cdk-dynamo-table-viewerの紹介。
ざっとみた感じ、DynamoDBから情報を取得し、それを元にhtmlを組み立て返すLambdaを作成しているようだった。
(TypeScriptで記述されているっぽいが、これをどうやってJavaのライブラリとして固めているんだ、、？jsiiがよしなにやってくれるのだろうか)

あと、これは権限制御とかせずにDynamoDBの中身が見れちゃうので本番では使うなよ、と。