~Everything as Codeを諦めない~ 後からCDK

JAWS-UG 茨城 #11 CDK支部コラボ回

https://jawsug-ibaraki.connpass.com/event/379428/

Transcript

1. #jawsugibaraki #jawsug_cdk ~Everything as Codeを諦めない ~ 後からCDK 株式会社シーズ - Yuta Nakamura / よ〜ん JAWS-UG 茨城 #11 CDK支部コラボ回
2. #jawsugibaraki #jawsug_cdk 京都出身・京都在住 株式会社シーズ クラウドソリューション事業部 Twitter(X) @tesla_yoon 好き AWS Step Functions / AWS CDK Amazon Lightsail / 🉐 カミナリ(芸人) 2 Yuta Nakamura / よ〜ん
3. #jawsugibaraki #jawsug_cdk 後からCDKに対するモチベーション 最初からCDK(IaC)で管理してないと辛い...🫠 → 激しく同意 → KiroやClaude Codeといった最高のツールがあるじゃないか
4. #jawsugibaraki #jawsug_cdk 今からお話しすること • (ざっくり)Everything as Codeとは • 後からCDKの恩恵を知っていただく ◦ サンプル構成について軽く説明 ◦ 後からCDKで取り込む ▪ L1からL2へのリファクタリング ◦ AIにトラブルシュートしてもらう ▪ CDKがない時😢 ▪ CDKがある時(L1 Construct)🤣 ▪ CDKがある時(L2 Construct)🤣
5. #jawsugibaraki #jawsug_cdk お持ち帰りしていただきたいこと • 後からCDK(IaC)はアリ、むしろやるべき • 今ある環境をIaCにするのはAI Agentに任せても良さそう
6. #jawsugibaraki #jawsug_cdk Everything as Code https://docs.aws.amazon.com/wellarchitected/latest/devops-guidance/everything-as-code.html https://pages.awscloud.com/rs/112-TZM-766/images/AWS-57_Development_AWS-Summit-JP-2025.pdf
7. #jawsugibaraki #jawsug_cdk サンプル構成
8. #jawsugibaraki #jawsug_cdk [一応] サンプル構成 デプロイフロー
9. #jawsugibaraki #jawsug_cdk サンプル構成 この構成を CDKで取り込んでいく
10. #jawsugibaraki #jawsug_cdk (ざっくり) IaCジェネレーターのスキャンを実施
11. #jawsugibaraki #jawsug_cdk (ざっくり) IaCジェネレーターのスキャンを実施
12. #jawsugibaraki #jawsug_cdk (ざっくり) IaCジェネレーターのスキャンを実施
13. #jawsugibaraki #jawsug_cdk cdk migrate --stack-name sample-dev --from-path \ ./sample-dev.yaml --language typescript テンプレートを CDKに取り込む (CDK migrate) https://docs.aws.amazon.com/ja_jp/cdk/v2/guide/ref-cli-cdk-migrate.htm
14. #jawsugibaraki #jawsug_cdk L1 constructからL2 constructへ (CloudFront Distributionの例) const distribution = new cloudfront.CfnDistribution(this, 'CloudFrontDistribution', { distributionConfig: { enabled: true, comment: '??? official website ????', defaultRootObject: 'index.html', httpVersion: 'http2', ipv6Enabled: true, priceClass: 'PriceClass_All', webAclId: webAcl.attrArn, origins: [ { id: config.originId, domainName: bucket.attrRegionalDomainName, originAccessControlId: originAccessControl.attrId, connectionAttempts: 3, connectionTimeout: 10, originCustomHeaders: [], originPath: '', originShield: { enabled: false, }, s3OriginConfig: { originAccessIdentity: '', }, }, ], defaultCacheBehavior: { targetOriginId: config.originId, viewerProtocolPolicy: 'redirect-to-https', cachePolicyId: MANAGED_CACHING_OPTIMIZED, compress: true, allowedMethods: ['HEAD', 'GET'], cachedMethods: ['HEAD', 'GET'], smoothStreaming: false, functionAssociations: [], lambdaFunctionAssociations: [], trustedSigners: [], trustedKeyGroups: [], fieldLevelEncryptionId: '', }, viewerCertificate: { cloudFrontDefaultCertificate: true, minimumProtocolVersion: 'TLSv1', }, restrictions: { geoRestriction: { restrictionType: 'none', locations: [], }, }, logging: { bucket: '', includeCookies: false, prefix: '', }, aliases: [], cacheBehaviors: [], customErrorResponses: [], originGroups: { quantity: 0, items: [], }, staging: false, continuousDeploymentPolicyId: '', }, }); const distribution = new cloudfront.Distribution(this, 'CloudFrontDistribution', { comment: '??? official website ????', defaultRootObject: 'index.html', httpVersion: cloudfront.HttpVersion.HTTP2, enableIpv6: true, priceClass: cloudfront.PriceClass.PRICE_CLASS_ALL, webAclId: webAcl.attrArn, enabled: true, defaultBehavior: { origin: s3Origin, viewerProtocolPolicy: cloudfront.ViewerProtocolPolicy.REDIRECT_TO_HTTPS, cachePolicy: cloudfront.CachePolicy.CACHING_OPTIMIZED, compress: true, allowedMethods: cloudfront.AllowedMethods.ALLOW_GET_HEAD, cachedMethods: cloudfront.CachedMethods.CACHE_GET_HEAD, smoothStreaming: false, }, minimumProtocolVersion: cloudfront.SecurityPolicyProtocol.TLS_V1, });
15. #jawsugibaraki #jawsug_cdk Resources [~] AWS::CloudFront::Distribution CloudFrontDistribution CloudFrontDistribution └─ [~] DistributionConfig ├─ [-] Removed: .Aliases ├─ [-] Removed: .CacheBehaviors ├─ [-] Removed: .ContinuousDeploymentPolicyId ├─ [-] Removed: .CustomErrorResponses ├─ [~] .DefaultCacheBehavior: │ ├─ [~] .AllowedMethods: L1 constructからL2 constructへ
16. #jawsugibaraki #jawsug_cdk Resources [~] AWS::CloudFront::Distribution CloudFrontDistribution CloudFrontDistribution └─ [~] DistributionConfig ├─ [-] Removed: .Aliases ├─ [-] Removed: .CacheBehaviors ├─ [-] Removed: .ContinuousDeploymentPolicyId ├─ [-] Removed: .CustomErrorResponses ├─ [~] .DefaultCacheBehavior: │ ├─ [~] .AllowedMethods: L1 constructからL2 constructへ 立ちはだかる大量の diff
17. #jawsugibaraki #jawsug_cdk AIに揃えさせる
18. #jawsugibaraki #jawsug_cdk AIに揃えさせる 答え(既存環境)があってそれに合わせる →AIが得意なタスク
19. #jawsugibaraki #jawsug_cdk AIに揃えさせる 答え(既存環境)があってそれに合わせる →AIが得意な奴やん Stack sample-dev There were no differences 5分ぐらいで no differencesになった
20. #jawsugibaraki #jawsug_cdk L1(Before) → L2(After)
21. #jawsugibaraki #jawsug_cdk L1(Before) → L2(After) 211行から174行まで削減
22. #jawsugibaraki #jawsug_cdk AIにトラブルシュートしてもらう - 検証条件 新人のフロントエンドエンジニアさん • developmentやmainにマージしたらgithub actionsが走ることは知ってる。 • AWSは全く知らないとする。 • ネットワーク関連の知識についても全く知らない。 • AIに指示されたことはできるとする。 ◦ Chromeの開発者モードを見る。 ◦ GitHub Actionsが成功しているか見る。 ◦ ただし、AWSのマネージドコンソールにはアクセスできない。
23. #jawsugibaraki #jawsug_cdk AIにトラブルシュートしてもらう - 検証条件 新人のフロントエンドエンジニアさん • developmentやmainにマージしたらgithub actionsが走ることは知ってる。 • AWSは全く知らないとする。 • ネットワーク関連の知識についても全く知らない。 • AIに指示されたことはできるとする。 ◦ Chromeの開発者モードを見る。 ◦ GitHub Actionsが成功しているか見る。 ◦ ただし、AWSのマネージドコンソールにはアクセスできない。 この条件でよ〜んがロールプレイします
24. #jawsugibaraki #jawsug_cdk AIにトラブルシュートしてもらう - 解決したい事象 Developmentブランチへのマージを行ったが、開発環境でエラーが発生 → よ〜んのPCが許可IPに入ってない などが原因
25. #jawsugibaraki #jawsug_cdk AIにトラブルシュートしてもらう - 共通条件 一発目のプロンプト developmentにマージしたんだけど、何も表示されない。 使用したエディタ Kiro 使用したモデル Claude Opus 4.5 One-shotでやります。
26. #jawsugibaraki #jawsug_cdk AIにトラブルシュートしてもらう - 共通条件 一発目のプロンプト developmentにマージしたんだけど、何も表示されない。 使用したエディタ Kiro 使用したモデル Claude Sonnet 4.5 One-shotでやります。 やり取りの回数・トークンの消費率で見ていきます
27. #jawsugibaraki #jawsug_cdk AIにトラブルシュートしてもらう - 各条件 IaCがない時 CDKがある時(L2) CDKがある時(L1) . ├── .github │ └── workflows │ └── deploy-to-s3.yml ├── iac │ └── sample-l1 │ ├── bin │ ├── cdk.json │ ├── lib │ ├── migrate.json │ ├── package-lock.json │ ├── package.json │ ├── README.md │ ├── test │ └── tsconfig.json └── src └── index.html . ├── .github │ └── workflows │ └── deploy-to-s3.yml ├── iac │ └── sample-l2 │ ├── bin │ ├── cdk.json │ ├── lib │ ├── migrate.json │ ├── package-lock.json │ ├── package.json │ ├── README.md │ ├── test │ └── tsconfig.json └── src └── index.html . ├── .github │ └── workflows │ └── deploy-to-s3.yml └── src └── index.html
28. #jawsugibaraki #jawsug_cdk AIにトラブルシュートしてもらう - IaCがない時
29. #jawsugibaraki #jawsug_cdk AIにトラブルシュートしてもらう - IaCがない時
30. #jawsugibaraki #jawsug_cdk AIにトラブルシュートしてもらう - IaCがない時
31. #jawsugibaraki #jawsug_cdk AIにトラブルシュートしてもらう - IaCがない時 どう足掻いてもマネコンに誘導される
32. #jawsugibaraki #jawsug_cdk AIにトラブルシュートしてもらう - CDKがある時(L2)
33. #jawsugibaraki #jawsug_cdk AIにトラブルシュートしてもらう - CDKがある時(L2) 一発
34. #jawsugibaraki #jawsug_cdk AIにトラブルシュートしてもらう - CDKがある時(L1)
35. #jawsugibaraki #jawsug_cdk AIにトラブルシュートしてもらう - CDKがある時(L1) 一発
36. #jawsugibaraki #jawsug_cdk AIにトラブルシュートしてもらう - 結果まとめ IaCがない時 CDKがある時(L2) CDKがある時(L1) やり取り回数 10↑ 1 1 トークン消費率 23% 12% 13% 解決できたか 未解決❌ 解決✅ 解決✅
37. #jawsugibaraki #jawsug_cdk AIにトラブルシュートしてもらう - 結果まとめ IaCがある時 CDKがある時(L2) CDKがある時(L1) やり取り回数 10↑ 1 1 トークン消費率 23% 12% 13% 解決できたか 未解決❌ 解決✅ 解決✅ 今回の条件下では L1とL2に有意差はなかった
38. #jawsugibaraki #jawsug_cdk まとめ • 手段を問わずIaCすることが重要 ◦ L2 Constructで記述した方が、人間もわかりやすい 。 ▪ 機能追加があった時、インフラに手を加えやすい(はず) • 既存の環境をCDKの管理下におく作業 ◦ 答え合わせがしやすい。 ▪ cdk diffして、変更がなければOKのため • AIにやらせる。 ◦ 手放しで走らせるためにポリシーの設定だけやる
39. #jawsugibaraki #jawsug_cdk まとめ • 手段を問わずIaCすることが重要 ◦ L2 Constructで記述した方が、人間もわかりやすい 。 ▪ 機能追加があった時、インフラに手を加えやすい(はず) • 既存の環境をCDKの管理下におく作業 ◦ 答え合わせがしやすい。 ▪ cdk diffして、変更がなければOKのため • AIにやらせる。 ◦ 手放しで走らせるためにポリシーの設定だけやる 後からCDK(IaC)アリ、むしろやるべき
40. #jawsugibaraki #jawsug_cdk 参考 AI Agent 時代のソフトウェア開発の型 〜 Everything as Code で叡智を伝える 〜 https://pages.awscloud.com/rs/112-TZM-766/images/AWS-57_Development_AWS- Summit-JP-2025.pdf Everything as code - DevOps Guidance https://docs.aws.amazon.com/ja_jp/wellarchitected/latest/devops-guidance/everythi ng-as-code.html cdk migrate - AWS クラウド開発キット (AWS CDK) v2 https://docs.aws.amazon.com/ja_jp/cdk/v2/guide/ref-cli-cdk-migrate.html
41. #jawsugibaraki #jawsug_cdk 🀄🀄AWS麻雀を復活させています！ぜひお祭りブースへ 🀄🀄
42. #jawsugibaraki #jawsug_cdk ありがとうございました • 後からCDKに対するモチベーション • Everything as Code • 後からCDKによる恩恵 ◦ サンプル構成について ◦ サンプル構成をCDK管理下に ◦ L1 ConstructからL2 Constructへ ◦ トラブルシュートのシミュレーション • まとめ