フリートを無効化して削除する
注釈:本資料はAI技術を用いて翻訳されています。
概要
この記事では、AccelByte Gaming Services(AGS)Admin Portal または AGS CLI を使用して、AccelByte Multiplayer Servers(AMS)フリートを無効化および削除する方法について説明します。
前提条件
このガイドを開始する前に、次の条件を満たしていることを確認してください。
- 専用サーバーの割り当てを管理するフリートを作成している。
- AGS CLI の手順に従う場合は、AGS CLI をインストールし、これらの機能にアクセスできるアカウントでサインインしている。インストールとサインインを参照してください。例では Bash シェルを使用しています。
フリートを無効化する
フリートの無効化は、プレイヤーに影響を与えないスケーリングのために設計されており、通常は本番環境で使用されます。ドレインを開始すると、専用サーバー(DS)にシグナルが送信され、ログのフラッシュや統計の更新などの進行中のプロセスを適切に処理できるようになります。コード例については、ドレインシグナルをリッスンするを参照してください。定義されたドレインアイドルタイムアウト(Admin Portalで設定可能)の後、専用サーバーは強制的に終了されます。
- Admin Portal
- AGS CLI
フリートを無効化するには、次の手順に従います。
-
AccelByte Admin Portalでゲームのネームスペースに移動します。
-
サイドバーで、AccelByte Multiplayer Serversメニューを開き、Fleet ManagerまたはFleetsを選択します。Fleetsページには、AMSアカウント内のフリートのリストが表示されます。
-
リストから、無効化したいフリートを見つけて開きます。
-
フリートの詳細ページで、名前の下にFleet Statusトグルが表示されます。トグルをオフに切り替えます。Deactivate Fleetポップアップが表示されます。
-
ポップアップで、無効化を確認するためにフリートの名前を入力し、Deactivateをクリックします。フリートは直ちに無効化されます。
AGS CLI を使用してフリートを無効化するには、次の手順に従います。
-
無効化するフリートの ID を確認します。
<YourNamespace>をゲームのネームスペースに置き換えてください。ags ams fleets list --namespace <YourNamespace> -
フリートの現在の設定をファイルに保存します。
<FleetId>をフリートの ID に置き換えてください。ags ams fleets get --namespace <YourNamespace> --fleet-id <FleetId> --format json > fleet-current.json -
fleet-current.jsonで、"active": trueを"active": falseに変更します。更新を実行すると、フリートの設定全体がリクエストボディの内容で置き換えられるため、その他のフィールドは変更しないでください。 -
設定を送信してフリートを無効化します。
ags ams fleets update --namespace <YourNamespace> --fleet-id <FleetId> --json @fleet-current.json
フリートを削除する
フリートの削除は即座の終了を保証し、コストを管理するために開発シナリオでよく使用されます。実行中のすべてのDSインスタンスを強制的に終了します。
終了したDSインスタンスからログとアーティファクトは収集されず、すべてのフリートリソースの即座の終了を反映します。
- Admin Portal
- AGS CLI
フリートを削除するには、次の手順に従います。
-
AccelByte Admin Portalでゲームのネームスペースに移動します。
-
サイドバーで、AccelByte Multiplayer Serversメニューを開き、Fleet ManagerまたはFleetsを選択します。Fleetsページには、AMSアカウント内のフリートのリストが表示されます。
-
フリートを削除するには2つの方法があります。
- フリートリストから:削除したいフリートを見つけ、Actions列の下にある対応する削除(ゴミ箱アイコン)ボタンをクリックします。
- 詳細ページから:削除したいフリートを見つけて開きます。詳細ページで、Deleteをクリックします。
Delete Fleetポップアップが表示されます。
-
ポップアップで、削除を確認するためにフリートの名前を入力し、Deleteをクリックします。フリートは直ちに削除されます。
AGS CLI を使用してフリートを削除するには、次の手順に従います。
-
削除するフリートの ID を確認します。
<YourNamespace>をゲームのネームスペースに置き換えてください。ags ams fleets list --namespace <YourNamespace> -
フリートを削除します。
<FleetId>をフリートの ID に置き換えてください。ags ams fleets delete --namespace <YourNamespace> --fleet-id <FleetId>複数のフリートを一度に削除するには、
fleetIdsにそれらの ID を列挙します。ags ams fleets bulk-delete --namespace <YourNamespace> --json '{"fleetIds": ["<FleetId1>", "<FleetId2>"]}'出力には、削除されたフリートの数(
successCount)と、削除できなかったフリートの一覧(errors)が表示されます。