AWS AppSyncと仲良くするためのTips

Classmethod Odyssey Online 2024/07/09 に発表した「AWS AppSyncと仲良くするためのTips」のスライド#cm_odyssey

Transcript

1. AWS AppSyncと 仲良くするためのTips 2024.07.09 フリーランスエンジニア 岡 春奈
2. Xへの投稿の際は、 ハッシュタグ #cm_odyssey でお願いいたします。 2 お願い
3. ⾃⼰紹介 3 岡 春奈 / Haruna Oka バックエンドエンジニア   @OkaHaruna
4. 本⽂タイトル • 話すこと ◦ 今使っている案件でのAppSyncの話 • 話さないこと ◦ フロントの話 ◦ Amplifyの話(Gen2) 4
5. 全体構成 5
7. AppSyncを1年使ってみた 7
8. アジェンダ • 構成を変えたところ • それぞれの難点‧利点 • まとめ 8
9. 構成を変えた部分 9
10. 構成を変えた部分 • リゾルバーの使い分けを⾒直した • オニオンアーキテクチャの導⼊ • APIの認証⽅式を変えた • バリデーションスキーマを⾃動⽣成 10
11. リゾルバーの種類 • ユニットリゾルバー • パイプラインリゾルバー • Lambdaリゾルバー 11
12. ユニットリゾルバー 12 公式Docs: AWS AppSync リゾルバー
13. パイプラインリゾルバー 13 公式Docs: AWS AppSync リゾルバー
14. Lambdaリゾルバー 14 正確にはLambdaをデータソースとし たユニットリゾルバー 公式Docs: AWS AppSync リゾルバー
15. リゾルバーの使い分け 15
16. 元々の使い分け 16
17. 開発進める中での問題点 17
18. 開発進める中での問題点 • JSリゾルバーの制約が⾟い ◦ 組み込み関数が多々使えない • Pipelineリゾルバーのメンテがしづらい • コードサイズ制限に引っかかる 18
19. リゾルバーの使い分け（現状） 19
20. リゾルバーの使い分け（現状） • Mutation系はLambdaに統⼀ ◦ middyの導⼊ • Pipelineリゾルバーを辞めた ◦ (管理コストを下げるため) 20
21. リゾルバーの使い分け（現状） • 結論 ◦ Lambdaの同時実⾏数を気にしてJSリゾ ルバーに寄せていたが、Lambdaの同時 実⾏数を気にするようなアクセス数に なった時はAppSync⾃体を剥がしたほう が良さそう 21
22. オニオンアーキテクチャの導⼊ 22
23. オニオンアーキテクチャの導⼊ • Lambdaリゾルバーに寄せたことで共通化 がしやすくなった • 将来的にDBが変わる可能性も考慮してディ レクトリ構成を全体的に⾒直した 23
24. オニオンアーキテクチャの導⼊ • /core ◦ /domain ◦ /infrastructure • /graphql ◦ スキーマとcodegenで⽣成したファイル 24
25. オニオンアーキテクチャの導⼊ 25
26. APIの認証⽅式を変えた 26
27. APIの認証⽅式を変えた • APIは3つ ◦ 管理者向け: Admin API ◦ ユーザー向け: Customer API ◦ ゲストユーザー向け: Public API 27
28. APIの認証⽅式を変えた • Admin API ◦ Cognitoユーザープール(グループ) • Customer API ◦ Cognitoユーザープール • Public API ◦ APIキー 28
29. APIの認証⽅式を変えた • Admin API ◦ Cognitoユーザープール(グループ) • Customer API ◦ Cognitoユーザープール • Public API ◦ APIキー → IAM認証に切り替えた 29
30. APIの認証⽅式を変えた 30
31. APIの認証⽅式を変えた 31
32. APIの認証⽅式を変えた 32
33. APIの認証⽅式を変えた 33
34. バリデーションスキーマの⽣成 34
35. バリデーションスキーマの⽣成 • zodを導⼊ • codegenのプラグイン ◦ typescript-validation-schema ◦ @constraintに最⼤⽂字数等を指定 35
36. バリデーションスキーマの⽣成 36
37. バリデーションスキーマの⽣成 37
38. 他開発ツール 38
39. 他開発ツール周り • npm → pnpm にして扱いやすくなった • APIドキュメントの⾃動⽣成 ◦ magidocで⽣成 → Cloudflare Pagesで公開 • CDKTFの導⼊ 39
40. CDKTFの導⼊ • CDK for Terraformを導⼊ • ⼀部のリソースでCloudflareを使っている ◦ CDN, DNS等 • 元々はterraformでやる想定だった • CDKに合わせてCDKTFでやることに 40
41. CDKTFの導⼊ • ⼀部のリソースでCloudflareを使っている ◦ CDN, DNS等 • 元々はterraformでやる想定だった • CDKに合わせてCDKTFでやることに 41 →Typescriptで統⼀できて管理コストが下がった
42. 反省点 42
43. 反省点 • 初⼿RDSにしておくべきだった • DB設計にもっと時間をかけるべきだった • そもそもAppSyncが適していなかったかも 43
44. まとめ • AppSyncの開発効率を最⼤限に活⽤するな らやはりAmplifyと使うのが有⽤ • GraphQL + monorepo = 相性良し • ⾔語をtypescriptで統⼀できた(CDKTF) 44