Clanforge ウェブインターフェース#

ゲームイメージのバイナリ (ビルド) を更新する主な方法として、Clanforge API を使用する方法と、Clanforge ウェブインターフェースを使用する方法の 2 つがあります。このトピックでは、Clanforge ウェブインターフェースを使用して更新するプロセスについて詳しく説明します。

前提条件

• • Clanforge の インテグレーションプロセス を完了していること。
  • ビルドマシンへのアクセス権を持っていること。
  • フリートにデプロイする準備ができている、更新された ゲームイメージ があること。
  • サービス識別子のドキュメント があること。

ここで示す手順は、Steam で新しいゲームビルドを準備済みであり、S3 バケットまたは Google Cloud バケットを持っていることを前提としています。Clanforge サポートチームに手動でゲームビルドをジャンプマシンにインストールしてもらうことを選択した場合は、ビルドマシンに更新をデプロイする をスキップできます。

ステップ 1:  ビルドマシンに更新をデプロイする#

更新されたゲームビルドの準備ができたら、次のステップは、更新されたゲームイメージをビルドマシンにデプロイすることです。

1. ブラウザーウィンドウで、https://clanforge.multiplay.co.uk/ に移動します。ここで、 はアカウントサービス ID です。

2. Dev Tools パネルで、Game Updates をクリックします。
   

3. Game Image Updates ページで、Update Game Image をクリックします。
   

4. Update Game Image ダイアログの各フィールドに入力します。
   

   • Game: 更新するゲームをドロップダウンメニューから選択します。 
   • Image: 更新するイメージバージョンをドロップダウンメニューから選択します。 
   • マシン /Machine: ジャンプマシンをドロップダウンメニューから選択します。このリストは柔軟な設定が可能であり、複数のジャンプマシンや、更新を生成できる通常のマシンが含まれる場合もあります。 
   • URL: Clanforge で使用するために生成したゲームイメージリポジトリ (例えば Steam、S3、Google Cloud など) の URL を入力します。イメージ更新の作成 URL のパラメーター を参照してください。 
   • Description (説明): 更新の簡単な説明を入力します。 

5. Update Game Image をクリックします。これにより、ゲームリポジトリの URL からジャンプマシンにイメージがインストールされます。

ステップ 2:  ビルドマシンで更新をテストする#

最新バージョンのゲームビルドをジャンプマシンにインストールしたら、テストゲームサーバーを作成して、すべてが期待どおりに動作することを確認します。このゲームサーバーは、更新したゲームイメージバージョンにリンクされているプロファイルを使用して作成する必要があります。

1. Clanforge パネルから、ビルドマシンに移動します。
2. Add Server をクリックして、ゲームサーバーインスタンスを作成します。これにより、テスト専用に使用できる、フリートの残りの部分から切り離されたゲームサーバーが起動します。
3. サーバーが正しく起動し、エラーが発生しないことを確認します。
4. サーバーをテストして、更新が正しく動作することを確認します。

ステップ 3:  差分分析を作成する#

ビルドマシンで更新のテストが成功したら、次のステップは、ジャンプマシンのゲームイメージに加えた変更から差分分析を作成することです。差分分析では、必要な (変更された) ファイルのみを含むパッチを作成できるため、イメージのサイズが小さくなり、フルイメージよりも高速にフリートの残りの部分にインストールすることができます。差分分析を生成したら、完全または部分的な (パッチ) 更新のいずれかを選んで作成し、残りのマシンにプッシュできます。

1. ブラウザーウィンドウで、https://clanforge.multiplay.co.uk/ に移動します。ここで、 はアカウントサービス ID です。

2. Dev Tools パネルで、Diff Analysis をクリックします。
   

3. Game Image Difference Analysis ダイアログの各フィールドに入力します。

   • Game: 前のセクションで更新を作成したゲームを選択します。 
   • Image: 前のセクションで更新を作成したイメージバージョンを選択します。 
   • マシン /Machine: ジャンプマシン (前のセクションでゲームビルドの最新バージョンをインストールしたマシン) を選択します。

4. View Differences をクリックします。 
   

5. 差分を調べて、予期しない変更がないことを確認します。すべて正しければ、Accept Diff をクリックします。

ステップ 4:  フリートマシンに更新をデプロイする#

Clanforge の GUI を使用して差分分析の差分を承認すると、Create New Image Version (新しいイメージバージョンの作成) ダイアログが表示されます。ここで、フルイメージをロールアウトする (Make this image a full image (このイメージをフルイメージにする) チェックボックスをオンにする) か、この更新と前回の更新との間の差分をロールアウトするかを選択します。

1. フルイメージを作成する場合は、Make this image a full image の右側のチェックボックスをオンにします。それ以外の場合は、このチェックボックスをオフのままにします。マシンにインストールされるゲームイメージのサイズを小さくできるため、3 回目の更新ごとに更新のフルイメージを作成することをお勧めします。 

2. After creating the image: 選択フォームからオプションを 1 つ選択して、更新のインストール後にサーバーで実行する処理を選択します。 

   1. Install it and restart affected servers: ゲームの更新をミラーネットワークにグローバルにプッシュし、各マシンにファイルをインストールし、各ゲームサーバーインスタンスを再起動して変更を適用するには、このオプションを選択します。このオプションを選択した場合、ダウンタイムなしのパッチ処理 の実装を使用していない限り、プレイヤーのプレイが中断されることに注意してください。 
   2. Install it without restarting: ゲームの更新をミラーネットワークにグローバルにプッシュし、ゲームサーバーインスタンスを再起動せずにファイルを各マシンにインストールするには、このオプションを選択します。このオプションは、更新にアセットファイルへの変更のみが含まれている場合に適しています。更新に現在のゲームサーバーがアクティブに使用しているファイルへの変更が含まれている場合、それらのファイルはアクティブなプロセスによってロックされているため、更新が失敗します。 
   3. **Do nothing:**更新をミラーネットワークにグローバルにプッシュするが、どのマシンにもインストールしない場合は、このオプションを選択します。このオプションは、更新を後で手動でマシンにプッシュしたい場合に便利です。

3. Create Image Version をクリックします。

4. Clanforge がイメージの更新の作成を完了すると、各マシンでのイメージの現在のインストール状況を示した Installations (インストール) ビューが表示されます。Installations ビューのリストには、正常に完了したインストールは表示されないことに注意してください。