『呪術廻戦ファントムパレード』をストレスなく楽しむためのマスタデータ基盤【CAGC2024】

『呪術廻戦ファントムパレード』をストレスなく楽しむためのマスタデータ基盤 1 サーバーサイドエンジニア / 呪術廻戦ファントムパレード岩上裕樹　Iwakami
Yuki

自己紹介 2 - 名前 - 岩上裕樹（Iwakami Yuki） - 経歴
- 2014年新卒でサイバーエージェントに入社 - ゲーム事業にてさまざまなスマホゲームの新規開発・運用・改善等を担当 - 『呪術廻戦ファントムパレード』 - バックエンドのテックリードとして開発に従事 - 基盤周りを担当することが多い

『呪術廻戦ファントムパレード』とは 3

『呪術廻戦ファントムパレードは、 2018年より「週刊少年ジャンプ」（集英社）にて連載中の芥見下々（あくたみげげ）氏による人気漫画を原作としたTVアニメ『呪術廻戦』を元にした、作品初のスマートフォンゲームです。 TVアニメ『呪術廻戦』の第1期の物語を追体験できるだけでなく、福岡を舞台にした
『ファンパレ』オリジナルのストーリーが楽しめるコマンドバトルRPGとなっています。 4

アジェンダ 5 - はじめに - マスタデータの入力 - マスタデータの環境への反映と配信

はじめに 6

マスタデータとは 7 - ゲーム内の静的な情報や設定値、バランス等を格納するデータ - キャラクタや敵の能力値などのゲームプレイに必要な情報が含まれる - 新キャラクターやイベントなどの追加はマスタデータを更新することで実現 ID 名前
HP 体術術式 1 虎杖悠仁 100 50 10 2 伏黒恵 90 40 30 ID イベント名開始日時終了日時 1 大討祓戦 2023-11-30 15:00:00 2023-12-09 14:59:59 2 望郷の境界線 2023-11-24 15:00:00 2023-12-10 14:59:59 character_masters event_masters ※このマスタデータはサンプルであり実際のマスタデータとは異なります

これから話すこと 8 『ファンパレ』においてのマスタデータの入力から環境への反映・配信までの工夫を紹介　配信　反映　入力

これから話すこと 9 ID イベント名開始日時終了日時 1 大討祓戦 2023-11-30 15:00:00
2023-12-09 14:59:59 event_masters ※このマスタデータはサンプルであり実際のマスタデータとは異なります　配信　反映　入力『ファンパレ』においてのマスタデータの入力から環境への反映・配信までの工夫を紹介

これから話すこと 10 ID イベント名開始日時終了日時 1 大討祓戦 2023-11-30 15:00:00
2023-12-09 14:59:59 2 望郷の境界線 2023-11-24 15:00:00 2023-12-10 14:59:59 event_masters ※このマスタデータはサンプルであり実際のマスタデータとは異なります　配信　反映　入力『ファンパレ』においてのマスタデータの入力から環境への反映・配信までの工夫を紹介

マスタデータの入力 11

マスタデータの入力の仕組みの設計思想 12 - マスタデータのバージョン管理にはGit管理をすることで解決 - GitHub上で差分確認、Pull Requestでレビュー - マスタの入力者はプランナーさんやレベルデザインを担当している方、 QAさんがほとんど
- 入力のほとんどが非エンジニアの方なので入力フローで Gitコマンドを使いたくない - やったとしてもGitHubのウェブページ上のボタン操作だけにしたい簡単な操作でマスタの入力・実機での動作確認・マージまでできる状態にしたい

マスタデータの入力の大まかな流れ 13 1. データの入力 2. 開発環境の作成 3. 開発環境への反映 4. 開発環境に接続して実機で動作確認
5. PR作成・レビュー・マージ 6. 開発環境の削除

マスタデータの入力の大まかな流れ〜データの入力 15 - スプレッドシートを利用して入力をしている - 複数人で同時に編集可能 - スプレッドシートの機能でログを追える。壊れたときに調査しやすい
- スプレッドシートの関数やプルダウンリストのような機能が充実

マスタデータの入力の大まかな流れ〜開発環境の作成と削除 17 - 作業単位ごとに開発環境を作れるようにしている [環境の作成] - feature/dev-xxxxxという命名規則でブランチを作成すると dev-xxxxxという名前の環境が作成される
- xxxxxは[A-Za-z0-9-]+ [環境の削除] - ブランチを削除すると対象の開発環境も削除されるブランチの作成・削除はGitHubのウェブページ上でできるのでGitコマンドが不要！非エンジニアでもできる！

マスタデータの入力の大まかな流れ〜開発環境への反映 19 Slackからデプロイコマンドを実行して反映処理をしている [指定内容] - どのマスタを反映させるか - どのバージョンまでのデータを反映させるか
- どの環境に反映させるか [処理内容] 1. スプレッドシートからマスタデータをダウンロード 2. 対象の環境に反映 3. 同時にマスタバリデーションチェック処理の実行 4. 作業ブランチにコミット（feature/dev-xxxxx）

マスタデータの入力の大まかな流れ〜開発環境への反映 20 1．スプレッドシートからマスタデータをダウンロード - スプレッドシートに入力されているマスタデータをCSVとしてダウンロード - GAS（Google Apps
Scripts）を使わない - スプレッドシートはデータ入力に特化 - 独立したプログラムからデータを抽出する - スプレッドシートとGASとの依存性を排除した Google Sheets APIを用いてデータを取得 CSVとして出力 CodeBuild

マスタデータの入力の大まかな流れ〜開発環境への反映 1．スプレッドシートからマスタデータをダウンロードダウンロードするマスタの指定方法 - 作業ごとに管理しているダウンロードリストというものがある - ダウンロードリストで☑を入れているマスタ群をダウンロードする -
Slackから指定するときにダウンロードリストを指定する event_masters event_item_masters ︙ イベントマスタシート ☑カード □ガチャ ☑イベントマスタ　　︙ ダウンロードリスト ※このマスタデータはサンプルであり実際のマスタデータとは異なります 21

2．対象の環境に反映 - サーバサイドで参照するDBに追加 - クライアントで参照するS3に配置マスタデータの入力の大まかな流れ〜開発環境への反映 22 S3
Aurora CodeBuild

3．同時にマスタバリデーションチェック処理の実行 - リレーションチェック - 数値の範囲チェック - 文字数チェック - などなど... 結果をSlackに投稿
マスタデータの入力の大まかな流れ〜開発環境への反映 23

4．作業ブランチにコミット（feature/dev-xxxxx） - CI上でダウンロードしたマスタデータをGitコミットマスタデータの入力の大まかな流れ〜開発環境への反映 24

- 動作確認 - 問題なければPRを作成 - レビューでダブルチェック - OKであればマージするマスタデータの入力の大まかな流れ〜
動作確認からマージまで 26

- 入力者の作業内容はシンプルにできた - 新しくジョインした人にも教えやすい - Slackのログを追えばどの環境にどういうマスタを反映したかがわかる - アプリが動かない等の問題が起きても調査しやすい - 1人で環境作成から反映、動作確認までできるので他の人の作業を待たない
- バリデーションチェックもしているので入力ミスも自己解決できる - エンジニアの手を介さなくなったマスタデータの入力のまとめ 27

マスタデータの環境への反映と配信 28

マスタデータの種類 29 1. サーバサイドのみ参照するマスタデータ 2. クライアントのみ参照するマスタデータ 3. サーバサイドとクライアントのどちらからも参照するマスタデータ S3 Aurora
CodeBuild

マスタデータの反映・配信の設計思想 30 - サムザップの過去プロジェクトの課題 - APIサーバからマスタデータをクライアントに返していた - APIサーバの負荷にもなる - 静的なデータなので、S3に配置してCloudFront(CDN)を介して返し
たい - 同じマスタデータを何度もダウンロードしている - 変更がない限りは再ダウンロードさせたくない - ユーザ様の端末のデータ通信量をなるべく少なくしてあげたい - 複数のマスタデータを並列ダウンロードしてより早くホーム画面にたどり着かせたい - ダウンロード画面の待ち時間を減らしたい

マスタデータの設計の工夫 31 工夫していることを紹介 - テキストマスタ - マスタのグルーピング

マスタデータの設計の工夫〜テキストマスタ 32 - マスタデータのテキスト部分 - クライアント側でユーザ様に見せるだけの情報 - サーバサイドでは使わない情報で参照する必要がない
- テキスト部分を分離 - テキストを入れ替えれば別の言語で扱うことも可能

マスタデータの設計の工夫〜テキストマスタ - event_mastersとevent_text_mastersに分離 - サーバサイドのロジックではevent_mastersのみ参照すれば良い ID イベント名 1
大討祓戦 2 望郷の境界線 event_text_masters ※このマスタデータはサンプルであり実際のマスタデータとは異なります ID 開始日時終了日時 1 2023-11-30 15:00:00 2023-12-09 14:59:59 2 2023-11-24 15:00:00 2023-12-10 14:59:59 event_masters ID イベント名開始日時終了日時 1 大討祓戦 2023-11-30 15:00:00 2023-12-09 14:59:59 2 望郷の境界線 2023-11-24 15:00:00 2023-12-10 14:59:59 event_masters 33

マスタデータの設計の工夫〜マスタのグルーピング 34 - いくつかのマスタをグルーピングして1ファイルに結合してS3にアップロード - 適度にファイル数を減らしてネットワークの接続コストを減らす目的 - なるべく同じアップデートで一緒に更新されるマスタを
グルーピングすると効率が良い event_text_masters event_masters ︙ 1つのマスタデータファイル player_level_masters event_masters ︙ 関係ないマスタの例

マスタデータの環境への反映と配信 35 - マスタデータをS3に配置し、ユーザ様へ配信するまでの話 CloudFront S3 （マスタデータ）

マスタデータの環境への反映と配信 36 - 事前に新旧複数のバージョンをアップロードしておく必要がある - ユーザがアクセスした時点のバージョンのマスタデータを取得できるシステムを構築する必要がある - 同じマスタファイルで複数のバージョン管理ができるようにS3のバージョニング機能を利用する
- https://docs.aws.amazon.com/ja_jp/AmazonS3/latest/userguide/Ver sioning.html - バージョン管理はAWS側に任せる

S3のバージョニング機能 37 - S3にファイルを配置したときバージョンIDが生成される - 同じファイル名のものを上書きすると異なるバージョンIDの状態で保持してくれる - バージョンIDをパラメータに付けてGETするとそのバージョンのデータが取得できる
マスタデータの配置マスタデータの取得 https://docs.aws.amazon.com/ja_jp/AmazonS3/latest/userguide/RetrievingObjectVersions.html

マスタデータの環境への反映 38 CodeBuild S3 Aurora Slack GitHub ※説明のために実際の処理とは異なるところがあります ①コマンド実行 ②マスタデータのDL
③マスタデータのアップロード ④バージョンIDの取得 ③マスタデータの追加 ⑤必要な情報の追加

①コマンド実行マスタデータの環境への反映 39 CodeBuild S3 Aurora Slack GitHub ※説明のために実際の処理とは異なるところがあります ②マスタデータのDL

マスタデータの配信 44 Aurora ※説明のために実際の処理とは異なるところがあります Fargate ①APIリクエスト ②DBからデータ取得 ③マスタのファイルの情報を返す ④マスタデータの取得
（バージョンID付き） CloudFront S3

②DBからデータ取得マスタデータの配信 46 Aurora ※説明のために実際の処理とは異なるところがあります Fargate ①APIリクエスト ③マスタのファイルの情報を返す ④マスタデータの取得

マスタデータの反映と配信のまとめ 49 - マスタデータはCDNを利用してS3から配信されるため、負荷をあまり意識しなくても良い - 並列ダウンロードも実現できダウンロード速度が早い（体感） - バージョンごとの反映・配信はシンプルにできた

『呪術廻戦 ファントムパレード』をストレスなく楽しむためのマスタデータ基盤【CAGC2024】

『呪術廻戦 ファントムパレード』をストレスなく楽しむためのマスタデータ基盤【CAGC2024】

More Decks by CyberAgent

Featured

Transcript

『呪術廻戦ファントムパレード』をストレスなく楽しむためのマスタデータ基盤【CAGC2024】

『呪術廻戦ファントムパレード』をストレスなく楽しむためのマスタデータ基盤【CAGC2024】