設定の移行のワークフロー

Last updated on February 4, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要

この記事では、AccelByte Gaming Services（AGS）管理ポータルでの設定移行ワークフローについて説明します。

設定移行ワークフロー

設定移行プロセスは3つの段階で構成されています：

1. 設定のエクスポート：ソースのネームスペースまたは環境から設定が抽出されます。この段階は4つのステップに分けられます：

   1. 設定移行ウィザードの開始
   2. ソースの選択
   3. エクスポートサマリー
   4. ターゲットの選択

2. 差分処理：インポートプロセスが実行される前に、設定変更の包括的なレビューを行います。差分処理を参照してください。

3. 設定のインポート：設定が正常にエクスポートされ、状態の変更が確認されると、インポートジョブが開始されます。

これらの3つの基本的なステップに従うことで、設定移行はネームスペースまたは環境間で設定を複製するプロセスを簡素化し、ゲーム開発者が一貫性と効率性を確保できるようにします。

ステップ1：設定移行ウィザードの開始

設定移行ウィザードには、管理ポータルで2つの方法でアクセスできます：

1. ネームスペース一覧ページ：移行ドロップダウンをクリックし、次の2つのオプションのいずれかを選択します：

   • ネームスペースの移行：既存のネームスペースにネームスペースを移行します。
   • 新しいネームスペースへの移行：新しいネームスペースに移行します。このオプションは、アカウントに新しいネームスペースを作成する権限がある場合にのみ利用できます。

   

2. 管理ポータルの設定移行メニューから：AGS管理ポータルで、設定移行メニューを開きます。移行履歴ページが表示されます。次に、移行を開始ボタンをクリックします。

   

設定移行フォームが表示されます。続行するには、ステップ2：ソースの選択に進みます。

ステップ2：ソースの選択

設定移行ウィザードを開始すると、設定移行フォームのソースの選択セクションで、移行ソースとエクスポートするサービスを選択するよう求められます。

次の手順に従います：

1. 設定名フィールドに、移行の名前を入力します。英数字を使用できます。

2. ソース環境とソースネームスペースフィールドで、移行のソースとなる環境とネームスペースを選択します。ソース環境とネームスペースを選択すると、サービスリストにソース内の既存のサービスが表示されます。ソース環境フィールドの下に、選択した環境へのリンクも表示されます。クリックすると、新しいタブで環境を表示できます。

3. サービスリストで、移行に含めるサービスとモジュールを選択します。サービスモジュールからエクスポートする設定データを選択する際には、2つのオプションがあります：

   • すべてのデータ：このオプションを使用して、サービスモジュールからすべての設定データをエクスポートします。

   • エクスポートルール：サービスモジュールで利用可能な場合、エクスポートルールを使用して、サービスモジュールから事前に選択されたデータのみをエクスポートします。次の例では、コマースサービスの通貨モジュールで「仮想通貨のみ」という名前のエクスポートルールが選択可能です。選択すると、エクスポートルールはサービスモジュールから仮想通貨の設定データのみをエクスポートします。

     

   エクスポートルールの詳細については、エクスポートルールを参照してください。

   注記

   • 別のサービスと連携または依存するサービスを選択すると、後者のサービスのチェックボックスが自動的に選択されます。
   • 移行にExtendアプリが含まれている場合、この段階で追加の設定オプションを実行できます。詳細については、Extendアプリの移行ガイドラインを参照してください。

4. エクスポートをクリックして、エクスポートサマリーセクションに移動します。続行するには、ステップ3：エクスポートサマリーに進みます。

ステップ3：エクスポートサマリー

このステップでは、移行ウィザードがステップ2：ソースの選択で選択したサービスをエクスポートします。

警告

エクスポートプロセスを中断しないように、ウィザードの実行中はページを更新したり、別のページに移動したりしないでください。

エクスポートは次のいずれかのシナリオになる可能性があります：

• エクスポートテスト成功。選択したすべてのサービスが正常にエクスポートされ、インポートの準備ができています。選択したサービスを含む環境のスナップショットをダウンロードするオプションもあります。

  

  続行をクリックして、ターゲットの選択またはネームスペースの作成セクションに移動します。

• 一部のサービスのエクスポートに失敗。このシナリオでは、特定のエラーのため、選択したサービスの一部をエクスポートできません。

  

  これを解決するには、エクスポートに失敗した各サービス（赤色で強調表示）を展開します。ソースネームスペースで解決する必要がある特定のエラーのリストが表示されます。ソースネームスペースでエラーに対処して解決します。その後、再試行をクリックしてエクスポートを再試行します。エクスポートが成功したら、続行をクリックしてターゲットの選択またはネームスペースの作成セクションに移動します。

続行するには、ステップ4：ターゲットの選択またはネームスペースの作成に進みます。

ステップ4：ターゲットの選択またはネームスペースの作成

ステップ1：設定移行ウィザードの開始で選択した移行アクションに応じて、既存のネームスペースを選択するか、移行のターゲットとして新しいネームスペースを作成するよう求められます。

ターゲットの選択（既存のネームスペース）

移行のターゲット環境とネームスペースを選択するには、必要な情報を入力します：

• ターゲット環境：これが移行の環境のターゲットになります。移行のターゲットとして選択できる利用可能な環境のリストが表示されます。
• ターゲットネームスペース：これが移行のネームスペースのターゲットになります。移行のターゲットネームスペースとして選択できるネームスペースのリストが表示されます。

続行をクリックして、差分処理セクションに移動します。ステップ5：差分処理に進みます。

ネームスペースの作成

新しいターゲットネームスペースフィールドに、新しいネームスペースの名前を入力します。次に、続行をクリックして差分処理セクションに進みます。ステップ5：差分処理に進みます。

ステップ5：差分処理

差分処理セクションでは、移行データをターゲットネームスペースの現在の設定データと比較できます。追加、更新されるデータ、およびターゲットネームスペース内で影響を受けない追加データを確認できます。

インポートに含めたくないデータ変更の選択を解除するオプションもあります。これを行うには、サービスを展開してモジュールとデータリストを表示します。

注記

• 一部のサービスには青いi（情報）アイコンが付いている場合があります。これは、続行する前に確認する必要があるサービスまたはモジュールに関連する重要なメッセージがあることを示しています。
• 移行にExtendアプリが含まれている場合は、Extendアプリの移行ガイドラインセクションを参照して、各Extendモジュールの設定方法を確認してください。

設定を確認し、適切なインポートデータが選択されていることを確認したら、続行をクリックしてインポート確認セクションに移動します。

ステップ6：インポート確認

これが最後のインポート確認ステップです。ソースとターゲットのネームスペースからスナップショットをダウンロードするオプションがあります。ダウンロードしたファイルには、両方のネームスペースからエクスポートされたすべてのサービスが含まれています。

インポートをクリックして、インポートプロセスを開始します。インポートサマリーセクションにリダイレクトされます。

ステップ7：インポートサマリー

警告

インポートプロセスを中断しないように、ウィザードの実行中はページを更新したり、別のページに移動したりしないでください。

インポートは次のいずれかのシナリオになる可能性があります：

• インポート成功。インポートプロセスが正常に完了しました。インポートサマリーページで、各サービスでインポートされたデータの詳細を確認できます。完了ボタンをクリックしてプロセスを完了します。

  

• インポートプロセス失敗。このシナリオでは、特定のエラーのため、一部のデータをインポートできませんでした。

  

  これを解決するには、インポートに失敗した各サービス（赤色で強調表示）を展開します。ソースネームスペースで解決する必要がある特定のエラーのリストが表示されます。ターゲットネームスペースでエラーに対処して解決します。その後、再試行をクリックしてインポートを再試行します。インポートが成功したら、完了をクリックしてプロセスを完了します。

移行は設定移行履歴に追加されます。

Extendアプリの移行ガイドライン

移行にExtendアプリが含まれている場合、ソースの選択と差分処理のステップで、次のような追加の設定オプションが提供されます：

ソースの選択段階

Extendサービスを展開し、移行に含めるモジュールを選択します。デフォルトでは、次のモジュールが自動的に選択されます：

• Extendアプリ
• Extendアプリイメージ
• Extendアプリ環境変数設定
• Extendアプリ環境シークレット設定

差分処理段階

このステップでは、各Extendモジュールの移行データを次のように設定できます：

注記

ソースのExtendアプリのいずれかがターゲットネームスペースのアプリと名前が一致する場合、アプリIDが異なっていても一致するアプリと見なされます。ターゲットネームスペースの一致するアプリは、同じ名前のソースのアプリに基づいて更新されます。

Extendアプリ

追加されるデータ

このセクションには、ターゲットネームスペースに一致するものがないソースネームスペースのExtendアプリが表示され、そこに作成されます。対応するチェックボックスをオンにして、移行するアプリを選択します。デフォルトでは、選択したアプリの環境変数とシークレットが移行に含まれますが、後でターゲットネームスペースでこれらを変更できます。

更新されるデータ

このセクションには、ソースとターゲットのネームスペース間で一致するExtendアプリが表示されます。このセクションでは、アプリの説明のみを更新できます。各アプリ名の対応するチェックボックスを選択または選択解除することで、ソースネームスペースからの説明を受け入れるか拒否できます。

ターゲット内で影響を受けない追加データ

このセクションには、ソースネームスペースのアプリと一致しないターゲットネームスペースの既存のExtendアプリが表示され、移行によって変更されません。

Extendアプリイメージ

このモジュールには、ターゲットとソース間で一致するアプリのイメージバージョンが表示されます。一致するアプリが見つからない場合、このモジュールは通常、設定から無効になり、移行または影響を受けるデータがゼロであることが表示されます。

各セクションでアプリイメージを次のように設定します：

備考

サンプルの目的で、このセクションの手順では、両方のネームスペースで一致する1つのExtendアプリを使用し、「Extendアプリ A」と呼びます。

追加されるデータ

このセクションには、ターゲットのExtendアプリ Aに存在しないソースのExtendアプリ Aのイメージバージョンが表示されます。ターゲットアプリに追加するイメージバージョンを選択します。

ターゲット内で影響を受けない追加データ

このセクションには、移行によって影響を受けないアプリイメージが表示されます：

• 一致するイメージタグに基づいて、ソースとターゲットの両方のExtendアプリ Aに存在するイメージバージョン。
• ソースのExtendアプリ Aに存在しないターゲットのExtendアプリ Aのイメージバージョン。

Extendアプリ環境変数設定

このモジュールは、ソースとターゲットの両方のネームスペースに一致するアプリがある場合に設定可能です。一致するものが見つからない場合、モジュールは無効になり、移行または影響を受けるデータがないことが示されます。

各セクションで環境変数を次のように設定します：

備考

サンプルの目的で、このセクションの手順では、両方のネームスペースで一致する1つのExtendアプリを使用し、「Extendアプリ A」と呼びます。

追加されるデータ

このセクションには、ターゲットのExtendアプリ Aに存在しないソースのExtendアプリ Aの環境変数が表示されます。ターゲットのExtendアプリ Aに追加する変数を選択します。

更新されるデータ

警告

ソースとターゲットの環境は多くの場合異なる設定を持っているため、次の移行は避けてください：

• AB_BASE_URL
• AB_NAMESPACE
• BASE_PATH
• ENABLE_REQUEST_SIZE_LIMIT
• OTEL_EXPORTER_ZIPKIN_ENDPOINT
• OTEL_METRICS_EXPORTER
• OTEL_PROPAGATORS
• OTEL_SERVICE_NAME
• OTEL_TRACES_EXPORTER

このセクションには、ソースとターゲットの両方のExtendアプリ Aに存在するが、値が異なる環境変数が表示されます。各変数の横にあるチェックボックスを選択または選択解除することで、ソースのExtendアプリ Aからの更新を受け入れるか拒否できます。

ターゲット内で影響を受けない追加データ

このセクションには、移行によって影響を受けない環境変数が表示されます：

• 同様の値を持つソースのExtendアプリ Aと一致するターゲットのExtendアプリ Aの環境変数。
• ソースのExtendアプリ Aに存在しないターゲットのExtendアプリ Aの環境変数。

Extendアプリ環境シークレット設定

このモジュールには、ターゲットとソース間で一致するアプリの環境シークレットデータが表示されます。一致するアプリが見つからない場合、このモジュールは通常、設定から無効になり、移行または影響を受けるデータがゼロであることが表示されます。

各セクションで環境変数を次のように設定します：

備考

サンプルの目的で、このセクションの手順では、両方のネームスペースで一致する1つのExtendアプリを使用し、「Extendアプリ A」と呼びます。

追加されるデータ

このセクションには、ターゲットのExtendアプリ Aに存在しないソースのExtendアプリ Aの環境シークレットが表示されます。ターゲットのExtendアプリ Aに追加するシークレットを選択します。

更新されるデータ

警告

AB_CLIENT_IDとAB_CLIENT_SECRETは移行しないでください。これらの認証情報は通常、ソースとターゲットの環境に固有であり、それらの間で互換性がない可能性があります。

このセクションには、ソースとターゲットの両方のExtendアプリ Aに存在するが、値が異なる環境シークレットが表示されます。各シークレットの横にあるチェックボックスを選択または選択解除することで、ソースのExtendアプリ Aからの更新を受け入れるか拒否できます。

ターゲット内で影響を受けない追加データ

このセクションには、移行によって影響を受けない環境シークレットが表示されます：

• 同様の値を持つソースのExtendアプリ Aと一致するターゲットのExtendアプリ Aの環境シークレット。
• ソースのExtendアプリ Aに存在しないターゲットのExtendアプリ Aの環境シークレット。