CDKTFについてざっくり理解する！！～CloudFormationからCDKTFへ変換するツールも作ってみた～

2025.07.08（火）に開催した「Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画」の登壇資料です。

Github：https://github.com/MASAKIOKUDA-eng/convert-cloudformation-cdktf
connpass：https://opsjaws.connpass.com/event/356387/

Transcript

1. CDKTFについてざっくり理解する!! ～CloudFormationからCDKTFへ変換する ツールも作ってみた～ 2025.07.08（火） モブエンジニア（@mob_engineer） Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
2. LTのねらい・対象者 •LTのねらい • Terraformの概要について知ってもらう • CDKTFが持つメリットについて知ってもらう • CDKTFの変換機能を知ってもらう •対象者 • Terraform・CDKTFについて学んでいる方 • CDKTFの変換機能について知りたい方 2 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
3. お話しすること・お話ししないこと •お話しすること • Terraformの概要 • CDKTFの概要 • 作成した変換ツールの紹介 •お話ししないこと • CI/CD戦略 • Terraform・CDKTFに関する詳細説明 3 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
4. $WHOAMI • ペンネーム:モブエンジニア • 職業:某ソフトハウスのインフラエンジニア • 好きなサービス:VPC、CloudFront、S3 • JAWS-UG 彩の国埼玉支部 運営 • 業務ではTerraformをよく利用しています プロファイル 4 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
5. お品書き •Terraformについて •CDKTFについて •変換ツール作成のモチベーション •まとめ 5 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
6. Terraformについて 6 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
7. Terraformとは? https://developer.hashicorp.com/terraform/intro 7 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
8. 例）ユーザからEC2構築を依頼されたとき •EC2 1台であればコンソール上で操作して、構築 するのはそこまで苦労しないと思います。 •もし、EC2 100台をコンソール上で操作しながら構 築するとなると骨が折れると思います。 •そのうえで、各EC2の設定内容を1台1台テスト⇒ 結果をキャプチャすることを考えたら、途方もないと 思います。 8 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
9. Terraformを利用することで •AWSリソースをコードとして操作できるため、柔軟か つ拡張性を持たせることができる（≒人海戦術で 構築しなくていい） •コードで管理できるためレビューも容易に行える（≒ 構築時にダブルチェックしなくてもいい） •UIの変更に伴う手順書修正の手間を削減できる 9 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
10. Terraformを利用するステップ •Terraform公式ドキュメントに利用ステップがまとめ られています。 https://developer.hashicorp.com/terraform/tutorials/aws-get-started 10 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
11. 余談）TerraformはAPI実行ラッパー? • TF_LOG=Debugモードで起動することで実行時の詳 細ログが表示されます。（terraform initの例） 11 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
12. CDKTFについて 12 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
13. 一見便利なTerraformですが・・・ •HCL（Hashicorp Confguration Language）なる独自言語でリソースを定義して いるため学習コストが高い・・・ •分岐処理を入れるにしても、独特な記述が必要な ため実装がめんどくさい・・・ •実行するまでTypoなどの入力ミスに気付くことがで きない・・・ 13 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
14. CDKTFとは何か? https://developer.hashicorp.com/terraform/cdktf 14 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
15. AWS公式ブログからもGA発表がされています 15 https://aws.amazon.com/jp/blogs/news/cdk-for-terraform-on-aws-jp/ Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
16. CDKTFによる恩恵 •Python、TypeScriptなどの開発言語でリソース を定義できるため、開発者の学習コストを削減でき る •開発言語の機能を用いてTypoに気付くことができ、 実行時のエラーを防ぐことができる •とはいえ、すでにTerraformで運用している環境を CDKTFで再設計するのは大変ですが・・・ 16 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
17. 変換ツール作成のモチベーション 17 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
18. Convertコマンドへの興味 https://developer.hashicorp.com/terraform/cdktf/cli-reference/commands •ざっくり言えば、HCL言語で 記述しているリソースファイル を「普段利用している開発 言語」に変換する機能です。 18 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
19. 例）EC2用のTFファイルを変換した場合 19 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
20. そのうえで・・・ •変換ロジックを理解するために変換 ツールを自作してみよう!! •CloudFormationからCDKTFに変 換できるツールを作ってみよう 20 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
21. 変換ロジックを理解することで・・・ • AWS CDKで利用されているJsii（TypeScriptから他言語へ 変換する機能）について学習も行えます。 https://aws.github.io/jsii/#an-example-is-worth-a-thousand-words 21 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
22. 生成AIの力を借りてツールを作ってみました! https://github.com/MASAKIOKUDA-eng/convert-cloudformation-cdktf 22 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
23. まとめ 23 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
24. まとめ • Terraformを利用すれば、コンソール上で操作するとき に感じていたわずらわしさから解放される • 型安全・柔軟な処理を行うのであればCDK版 Terraform（CDKTF）を利用した方がよい • Terraformから任意の開発言語に変換するのであれば cdktf convertコマンドで実現可能 • Jsiiの変換機能の奥深さを感じたため、今後深掘りして いく（プロジェクトごとにカスタマイズも可能?） 24 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
25. 参考サイト • https://aws.github.io/jsii/#an-example-is-worth-a-thousand- words • https://go-to-k.hatenablog.com/entry/cdk-jsii • https://qiita.com/takengineer1216/items/09e1b840d564a16b 84eb • https://qiita.com/JHashimoto/items/81c938d1a0574f1fa34c • https://dev.classmethod.jp/articles/cdk-for-terraform- practice-1-introduction/ • https://developer.hashicorp.com/terraform/cdktf/concepts/cd ktf-architecture 25 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画
26. FIN 26 Ops-JAWS Meetup35 IaC CDK支部コラボレーション企画