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

AWS AppSyncと仲良くするためのTips 2024.07.09 フリーランスエンジニア岡春奈

Xへの投稿の際は、ハッシュタグ #cm_odyssey でお願いいたします。 2 お願い

⾃⼰紹介 3 岡春奈 / Haruna Oka バックエンドエンジニア @OkaHaruna

本⽂タイトル • 話すこと ◦ 今使っている案件でのAppSyncの話 • 話さないこと ◦ フロントの話 ◦
Amplifyの話(Gen2) 4

全体構成 5

AppSyncを1年使ってみた 7

アジェンダ • 構成を変えたところ • それぞれの難点‧利点 • まとめ 8

構成を変えた部分 9

構成を変えた部分 • リゾルバーの使い分けを⾒直した • オニオンアーキテクチャの導⼊ • APIの認証⽅式を変えた • バリデーションスキーマを⾃動⽣成 10

リゾルバーの種類 • ユニットリゾルバー • パイプラインリゾルバー • Lambdaリゾルバー 11

ユニットリゾルバー 12 公式Docs: AWS AppSync リゾルバー

パイプラインリゾルバー 13 公式Docs: AWS AppSync リゾルバー

Lambdaリゾルバー 14 正確にはLambdaをデータソースとしたユニットリゾルバー公式Docs: AWS AppSync リゾルバー

リゾルバーの使い分け 15

元々の使い分け 16

開発進める中での問題点 17

開発進める中での問題点 • JSリゾルバーの制約が⾟い ◦ 組み込み関数が多々使えない • Pipelineリゾルバーのメンテがしづらい • コードサイズ制限に引っかかる 18

リゾルバーの使い分け（現状） 19

リゾルバーの使い分け（現状） • Mutation系はLambdaに統⼀ ◦ middyの導⼊ • Pipelineリゾルバーを辞めた ◦ (管理コストを下げるため) 20

リゾルバーの使い分け（現状） • 結論 ◦ Lambdaの同時実⾏数を気にしてJSリゾルバーに寄せていたが、Lambdaの同時実⾏数を気にするようなアクセス数になった時はAppSync⾃体を剥がしたほうが良さそう 21

オニオンアーキテクチャの導⼊ 22

オニオンアーキテクチャの導⼊ • Lambdaリゾルバーに寄せたことで共通化がしやすくなった • 将来的にDBが変わる可能性も考慮してディレクトリ構成を全体的に⾒直した 23

オニオンアーキテクチャの導⼊ • /core ◦ /domain ◦ /infrastructure • /graphql ◦
スキーマとcodegenで⽣成したファイル 24

オニオンアーキテクチャの導⼊ 25

APIの認証⽅式を変えた 26

APIの認証⽅式を変えた • APIは3つ ◦ 管理者向け: Admin API ◦ ユーザー向け: Customer
API ◦ ゲストユーザー向け: Public API 27

APIの認証⽅式を変えた • Admin API ◦ Cognitoユーザープール(グループ) • Customer API ◦
Cognitoユーザープール • Public API ◦ APIキー 28

APIの認証⽅式を変えた • Admin API ◦ Cognitoユーザープール(グループ) • Customer API ◦
Cognitoユーザープール • Public API ◦ APIキー → IAM認証に切り替えた 29

バリデーションスキーマの⽣成 34

バリデーションスキーマの⽣成 • zodを導⼊ • codegenのプラグイン ◦ typescript-validation-schema ◦ @constraintに最⼤⽂字数等を指定 35

他開発ツール 38

他開発ツール周り • npm → pnpm にして扱いやすくなった • APIドキュメントの⾃動⽣成 ◦ magidocで⽣成
→ Cloudﬂare Pagesで公開 • CDKTFの導⼊ 39

CDKTFの導⼊ • CDK for Terraformを導⼊ • ⼀部のリソースでCloudﬂareを使っている ◦ CDN, DNS等
• 元々はterraformでやる想定だった • CDKに合わせてCDKTFでやることに 40

CDKTFの導⼊ • ⼀部のリソースでCloudﬂareを使っている ◦ CDN, DNS等 • 元々はterraformでやる想定だった • CDKに合わせてCDKTFでやることに
41 →Typescriptで統⼀できて管理コストが下がった

反省点 42

反省点 • 初⼿RDSにしておくべきだった • DB設計にもっと時間をかけるべきだった • そもそもAppSyncが適していなかったかも 43

まとめ • AppSyncの開発効率を最⼤限に活⽤するならやはりAmplifyと使うのが有⽤ • GraphQL + monorepo = 相性良し
• ⾔語をtypescriptで統⼀できた(CDKTF) 44

More Decks by Haruna Oka