初めてのAWSフルサーバーレス開発で困ったこととそこから得た知見

初めてのAWSフルサーバーレス開発で困ったこととそこから得た知見 1

自己紹介石橋勇二 Ishibashi Yuji @1484_yuji 2020年4月入社(新卒エンジニア) 2021年1月 CX事業本部MADチーム
神奈川県大和市在住好きなAWSサービス：AWS CDK 筋トレ・サウナ・お肉・寿司 2

3 今日話すこと AWSのフルーサーバーレス開発を経験した(している)中で、個人的に困ったこととそこから得た知見を共有します。サーバーレス開発へのオンボーディング・新人エンジニアの育成のフェーズにある方などに、役立つ知見を共有できれば幸いです。

4 アジェンダ • 背景 • 困ったこととそこから得た知見 ◦ プロジェクトへのオンボーディング ◦ サービス間の連携とデバッグ
◦ CDKスタックのデプロイ

5 背景 SBGift様既存システムのリプレース案件マイクロサービスアーキテクチャのフルサーバーレスアプリへの移行既存のプロジェクトに1月からJOIN [参考] SBギフト「AWS Amplify
Console + CDKを用いて短納期・少人数・フルリモートで作る管理画面」 #devio_showcase

6 プロジェクトへのオンボーディング困った点①

7 プロジェクトへのオンボーディング把握しておくべき情報、準備するべきこと顧客・自社の課題、開発の進捗、リリース計画プロジェクトの管理情報(Backlog, wiki, MTGの運用など) 開発環境の構築、リポジトリの構成の把握サーバーレス開発の考え方、利用するサービスの方針 AWS構成概略、アプリケーション設計思想の理解
デプロイ要件の把握、実際の開発の流れの把握

8 プロジェクトへのオンボーディングマインドマップによる情報の整理

9 複雑な情報を整理できる思考のプロセスが理解できる全体像を把握することができるメリット

10 サービス間の連携とデバッグ困った点②

11 今回のシステムのAWS構成図(一部) AWS CDK

12 今回のシステムのAWS構成図(一部) フロントエンド BFF サーバーサイド AWS CDK インフラ(IaC)

13 今回のシステムのAWS構成図(一部) フロントエンド BFF サーバーサイド AWS CDK インフラ(IaC) 機能に対するフルスタックな実装が可能

例) あるデータを取得してフロントの画面に表示する • Lambdaハンドラ・処理ロジックを書く • CDKでバックエンドのリソースを定義する ◦ API Gateway リソース、メソッド、マッピングテンプレート
◦ Lambda function • GraphQL Schemaの定義 • CDKでBFFのリソースを定義する ◦ AppSyncのリゾルバ(function)、データソース • Reactでフロントのコードを書く ◦ 必要なコンポーネントの作成 ◦ Apollo Clientを使ったGraphQLクエリ 14 実際の開発フロー CDK

例) あるデータを取得してフロントの画面に表示する • Lambdaハンドラ・処理ロジックを書く • CDKでバックエンドのリソースを定義する ◦ API Gateway リソース、メソッド、マッピングテンプレート
◦ Lambda function • GraphQL Schemaの定義 • CDKでBFFのリソースを定義する ◦ AppSyncのリゾルバ(function)、データソース • Reactでフロントのコードを書く ◦ 必要なコンポーネントの作成 ◦ Apollo Clientを使ったGraphQLクエリ 15 実際の開発フロー CDK デバッグ時にどこでエラーが起きているか把握する力が大事一つの機能実装でも複数のサービスを利用

16 具体的な動作確認とデバッグ CDK • Lambdaコンソールからテストイベントを作成し、Lambda関数を実行

17 CDK • Lambdaコンソールからテストイベントを作成し、Lambda関数を実行 • API Gatewayコンソールからテストイベントを作成し、メソッドのテストを実行具体的な動作確認とデバッグ

18 CDK • Lambdaコンソールからテストイベントを作成し、Lambda関数を実行 • API Gatewayコンソールからテストイベントを作成し、メソッドのテストを実行 • ローカルからcurlして、レスポンスとログを確認 (API
Gatewayの認証を含む) 具体的な動作確認とデバッグ

Gatewayの認証を含む) • AppSyncコンソールから、クエリを実行具体的な動作確認とデバッグ

Gatewayの認証を含む) • AppSyncコンソールから、クエリを実行 • クライアント側からのリクエストとレスポンスの確認具体的な動作確認とデバッグ

Gatewayの認証を含む) • AppSyncコンソールから、クエリを実行 • クライアント側(Apollo Client)からのリクエストとレスポンスの確認具体的な動作確認とデバッグ

22 AppSync リゾルバデータソースに対するリクエスト・レスポンスの処理を記述する関数リクエストマッピングテンプレートとレスポンスマッピングテンプレートで構成パイプラインリゾルバ複数のリゾルバを関数として束ねて実行できるリゾゾルバ

23 AppSyncコンソールでのデバッグパイプラインリゾルバが設定された Queryを実行

24 パイプラインリゾルバのデバッグパイプラインリゾルバが設定された Queryを実行

25 パイプラインリゾルバのデバッグパイプラインリゾルバが設定された Queryを実行 CloudWatch Logsでログの確認が可能

26 パイプラインリゾルバのデバッグ詳細なログモニタリングの設定 https://docs.aws.amazon.com/ja_jp/appsync/latest/devguide/monitoring.html#cwl

27 パイプラインリゾルバのデバッグ詳細なログモニタリングの設定リクエストレベルログ、フィールドレベルログ

28 CDKスタックのデプロイ困った点③

29 開発におけるデプロイ戦略 ITG ステージバックエンド動作確認用手元から直接デプロイ可 CodePipeline DEV ステージフロントの開発の際利用する環境
パイプライン経由でのデプロイ

30 ある日行った作業 CDK • フロント側で扱いたいデータを整理 • 既存のクエリにアタッチされたパイプラインリゾルバ • ユニットリゾルバで十分データを取得できる •
パイプラインリゾルバの削除、ユニットリゾルバを作成

31 想定していた挙動・パイプラインリゾルバの記述を削除・ユニットリゾルバの記述を追加 cdk deploy クエリデータソースデータソースパイプラインリ
ゾルバデータソースユニットリゾルバクエリ変更

32 上書きに失敗・パイプラインリゾルバの記述を削除・ユニットリゾルバの記述を追加 cdk deploy クエリデータソースデータソースパイプラインリ
ゾルバデータソースユニットリゾルバクエリリソースの上書き(削除・作成)に失敗する

33 AppSyncのCDKコンストラクタ cdk-constructsはEXPERIMENTAL https://docs.aws.amazon.com/cdk/api/latest/docs/aws-appsync-readme.html

34 対応措置・パイプラインリゾルバの記述を削除 cdk deploy クエリデータソースデータソースパイプラインリゾルバ
データソースユニットリゾルバクエリ・ユニットリゾルバの記述を追加 cdk deploy 削除作成 ① ②

35 開発におけるデプロイ戦略 ITG ステージバックエンド動作確認用手元から直接デプロイ可 DEV ステージフロントの開発等で利用する環境パイプライン経由でのデプロイ
CodePipeline 対応措置 push

CodePipeline 対応措置通常のデプロイ

38 わかったこと • EXPERIMENTALのコンストラクタは、挙動の確認が必要。 ◦ Low Level コンストラクタ(CFN-)の利用も【AWS CDK】CDK標準の3種類のConstructを使って、AWSリソースをデプロイしてみた
• stg/prodなどの環境のCI/CDパイプラインには、　　　承認アクションがあったほうがベター。 ◦ 継続的デリバリーか、継続的デプロイメントか。

39 まとめ • 案件情報の整理にマインドマップが便利だった • サービス内のコンポーネント・サービス間の連携を把握してデバッグできると開発のスピードが上がる • CDKのデプロイに際して、コンストラクタの挙動確認・選定が必要になることも

初めてのAWSフルサーバーレス開発で困ったこととそこから得た知見

初めてのAWSフルサーバーレス開発で困ったこととそこから得た知見

Other Decks in Technology

Featured

Transcript