開発フリートでビルド設定を使用する
注釈：本資料はAI技術を用いて翻訳されています。
はじめに
開発フリートは、開発専用サーバービルド設定（以下、ビルド設定と略します。AccelByte Gaming Services（AGS）Admin Portalでも同様）と連携して動作します。この記事では、ビルド設定の作成方法と、専用サーバークレームフローで開発フリートに関連付ける方法について説明します。
開発フリートの作成方法については、専用サーバーをデプロイするフリートの作成を参照してください。開発フリートの詳細については、フリートタイプを参照してください。
ビルドマシンやCI/CDパイプラインなどでビルド設定の作成を自動化する方法については、専用サーバーのアップロードとビルド設定の作成の自動化（Extend SDK）を参照してください。
開発フリートから専用サーバーをクレームする場合、本番フリートよりも時間がかかります。これは、開発フリートがデフォルトでREADY状態の専用サーバーのバッファを維持しないためです。代わりに、開発フリートは、セッションがクレームしようとする時点で各専用サーバーをオンデマンドで起動します。実行中の専用サーバーがないため、最初のクレームリクエストは失敗します（DSが8秒以内に起動しない限り）。ただし、一致する専用サーバーの起動はトリガーされます。セッションは60秒後に自動的にクレームを再試行し、新しく起動した専用サーバーを正常にクレームします。
ビルド設定を作成する
ビルド設定を作成するには、次の手順に従います。
-
AccelByte Admin Portalのゲームネームスペースに移動します。
-
サイドバーで、AMSを選択します。
-
AMSメニューの下で、Development Serversを展開し、Build Configurationsを選択します。Build Configurationsページが表示されます。
-
Create Configボタンにカーソルを合わせ、Create Newを選択します。Create Configフォームが表示されます。
-
Name & Imageセクションで、次の操作を行います。
- ビルド設定の名前を入力します。ネームスペース内で一意である必要があります。
ヒントセッション管理にAccelbyte Gaming Services（AGS）を使用する場合、ゲームクライアントがマッチメイキングチケットを送信するとき、またはゲームセッションを直接作成するときに
client_version属性に入れる文字列と同じ名前をビルド設定に付けることをお勧めします。これにより、セッションサービスによってクレームリクエストに自動的に追加される暗黙的なゲームクライアントバージョンクレームキーを利用できるため、各ビルド設定名を明示的なクレームキーとしてセッションテンプレートに追加する必要がありません。- ビルド設定の有効期限を入力します。この日付を過ぎると、ビルド設定は自動的に削除されます。
注記有効期限を指定しない場合、ビルド設定は30日後に自動的に削除されます。有効期限は後で更新して、ビルド設定の有効期間を延長または短縮できます。
- このビルド設定で実行する専用サーバーイメージを選択します。フリートはこのイメージに基づいて専用サーバーを起動します。イメージIDまたはイメージ名を使用してイメージを検索できます。
-
Nextをクリックして、Command Lineセクションに移動します。
- Commandボックスに、専用サーバーのコマンドライン引数を追加し、専用サーバーが目的の設定で実行するために必要な追加パラメータを指定します。
ビルド設定のコマンドライン引数は、関連する開発フリートのコマンドライン引数に追加されます。開発フリートのコマンドラインまたはビルド設定のコマンドラインのいずれにも必要なフラグが指定されていない場合、このビルド設定を使用するフリートの専用サーバーは正常に起動しません。コマンドライン引数の設定の詳細については、専用サーバーコマンドの構築を参照してください。
-
Nextをクリックして、Summaryセクションに移動します。
-
ビルド設定を確認し、Createボタンをクリックしてビルド設定の作成を完了します。
開発フリートでビルド設定を使用する
本番フリートと同様に、開発フリートに設定されたクレームキーと一致するクレームキーを含むようにクレームリクエストを設定する必要があります。セッション管理にAGSを使用している場合、これはセッションテンプレートで行われます。AccelByte Multiplayer Servers（AMS）から専用サーバーをクレームするセッションテンプレートの作成方法については、AMSから専用サーバーをクレームするようにSessionサービスを設定するを参照してください。フリートにクレームキーを設定する方法については、フリートにクレームキーを割り当てるを参照してください。
AGSマッチメーカーにマッチメイキングチケットを送信する場合、またはAGSセッションサービスでゲームセッションを直接作成する場合、ゲームクライアントは、リクエストのclient_version属性として目的のビルド設定の名前を使用します。これにより、一致する開発フリートがそのビルド設定を使用して専用サーバーを起動します。マッチチケットにclient_versionを追加する方法については、マッチチケットにバージョン番号を追加するを参照してください。
別のマッチメイキングまたはセッション管理ソリューションを使用している場合は、開発設定名を渡して、AMSへのDSクレームリクエストでクレームキーとして使用されるようにする方法を検討する必要があります。
開発フリートから専用サーバーをクレームする最初の試行は、起動したDSが8秒以内に起動して準備完了にならない限り失敗することを覚えておいてください。AGS Sessionサービスは短時間後に自動的に再試行します。別のセッション管理ソリューションを使用している場合は、システムの専用サーバークレームフローに再試行を組み込む必要があります。
AMSフリートから専用サーバーをクレームするの記事で説明されているように、専用サーバークレームリクエストは、リクエスト内のクレームキーのいずれかと一致するクレームキーを持つフリートを検索して、目的のフリートを見つけます。一致するフリートが開発フリートの場合、AMSは、リクエストのクレームキーのいずれかと一致する名前のビルド設定を使用して起動されたそのフリートの専用サーバーを探します。専用サーバーが見つからない場合、AMSはクレームキーのいずれかと一致する名前のビルド設定を探し、そのビルド設定を使用して新しい専用サーバーを起動します。これにより、クレームリクエストが再試行されたときにクレーム可能になります。
AGSマッチメイキングとセッションを使用する例
このサンプルセットアップでは、開発フリートを作成し、開発者とQAが専用サーバービルドをテストするために使用するように設定することを想定しています。
次の手順に従います。
-
開発フリートに
testクレームキーを追加します。 -
ゲームクライアントが使用するマッチプールで設定されているセッションテンプレートの優先（またはフォールバック）クレームキーに
testをクレームキーとして追加します。このセットアップにより、ゲームセッションは開発フリートから専用サーバーをクレームしようとします。次に、開発フリートを使用してテストしたい専用サーバービルドと一致するクライアントビルド
240506.2.mainがあると仮定します。 -
「240506.2.main」という名前のビルド設定を作成し、ビルド
240506.2.mainに対応するアップロードされた専用サーバーイメージを選択します。 -
240506.2.mainゲームクライアントが、マッチチケットのclient_versionとしてビルドバージョン「240506.2.main」を使用していることを確認します。240506.2.mainゲームクライアントは、開発フリートから専用サーバーをクレームしようとするセッションにマッチメイクされます。これにより、「240506.2.main」ビルド設定を使用した専用サーバーの起動がトリガーされ、その専用サーバーがセッションにクレームされます。上記の2つの手順を繰り返して、この開発フリートを使用してテストする各ビルドのビルド設定を作成できます。
ハイブリッド開発フリートと本番フリートの両方を使用する例
ハイブリッドセットアップでは、開発フリートと通常のフリートを組み合わせて使用することで、さまざまなビルドを実行する際のコストを節約しながら、使用頻度の高いビルドに対して高速なクレーム体験を提供できます。
このサンプルハイブリッドセットアップでは、次のことを想定しています。
- 「romp」ゲームモード用のセッションテンプレートを定義しており、DSを起動するために特定のコマンドラインパラメータセットを使用します。
- そのセッションテンプレートを複数のビルドで使用したいと考えています。
- 特定のビルドで毎日プレイテストを行っていますが、開発者とテスターが1日を通して他のビルドを使用することも想定しています。
このセットアップでは、プレイテストビルドを使用して準備完了サーバーのバッファを維持し、プレイヤーができるだけ早くDSを受け取れるようにします。このセットアップでは、他のビルドを使用するプレイヤーの待ち時間が長くなる可能性がありますが、最終的には各ビルドを起動するために必要なDSを取得できることが保証されます。
以下の例では、ビルド1242をプレイテストビルドとして使用します。
次の手順に従います。
-
ゲームクライアントコードを更新して、ゲームクライアントが「romp」ゲームモードのマッチチケットに対して
client_version文字列をromp_<build_number>として送信するようにします。 -
開発フリートを作成し、
romp_fallbackをクレームキーとして追加します。次に、バッファ値を少なくとも1に設定します。 -
「romp」セッションテンプレートのFallback Claim Keysリストに
romp_fallbackを追加します。 -
使用される各ビルドについて、
romp_<fleet name>の形式で名前を付けた開発設定を作成します（例：ビルド1245の場合はromp_1245）。 -
各プレイテストについて、毎日のプレイテストビルドを使用して通常のフリートを作成し、
romp_<fleet name>の形式でクレームキーを追加します（例：romp_1242）。プレイテストサイズに適したバッファを設定します
このセットアップでは：
- 毎日のプレイテスト（ビルド
1242）で「romp」をプレイしているクライアントで形成されたマッチは、最初にクレームキーromp_1242を使用して通常のフリートからDSをクレームしようとします。DSが利用できない場合、romp_fallbackクレームキーが開発フリートと一致するため、romp_1242設定を使用して開発フリートでDSが起動されます。 - ビルド1245で「romp」をプレイしているクライアントで形成されたマッチは、クレームキーが一致しないため、毎日のプレイテストフリートからDSをクレームせず、
romp_1245設定を使用して開発フリートでDSの起動をトリガーします。
次のステップ
開発フリート用のビルド設定ができたので、フリートから専用サーバーをクレームするようにプレイセッションを設定する準備が整いました。
また、さまざまな専用サーバークレームシナリオを探ることもできます。