​

PlayFab での Linux 専用サーバーのセットアップ

​

要件

• Unreal Linux 前提条件 をインストールします
• Docker for Windows をインストールします

​

手順

• Unreal Linux 前提条件 から、インストールされている Unreal Engine 用のツールチェーンをダウンロードし、実行可能ファイルを実行します。これらのガイドの多くの部分と同様、これらの手順は Unreal Engine がソースからビルドされている場合にのみ機能することに注意してください。
  • インストールが完了したら、Windows の環境変数を調べて、以下のシステム変数が存在することを確認します: LINUX_MULTIARCH_ROOT。
• Unreal Engine のソースディレクトリで:
  • 再実行: Setup.bat
  • 再実行: GenerateProjectFiles.bat
• 自分のプロジェクトに戻ります:
  • {ProjectName}.uproject ファイルを右クリックし、Generate Visual Studio project files を選択します
  • Visual Studio で {ProjectName}.sln ファイルを開きます
  • 構成を Development Editor に設定します
  • Unreal Editor をビルドおよび実行します
• この時点で、プロジェクトを任意のディレクトリに Linux サーバー用にパッケージ化できるはずです。
  • Unreal Engine 5 の場合、Editor で画面右上のパッケージオプションを選択すると、Linux オプションが選択可能になっているはずです。UE 4.26 と UE 4.27 の場合、パッケージオプションは File タブの下にあります。
  • Server と Shipping の構成を確認し、Linux をビルド対象として選択し、出力ディレクトリを選択します。

​

Linux サーバーの Docker イメージを作成する

• Linux サーバーを作成したので、そのディレクトリに移動します (Windows エクスプローラー、または任意のターミナル)
• 次の名前で新しいファイルを作成します: Dockerfile
• 任意のエディタ (notepad、vim、emacs など) でファイルを編集します
• 以下に示す内容をコピー＆ペーストします。[YourProjectNameServer].sh を、実際の Linux サーバー実行ファイルの名前 (同じディレクトリ内) に置き換えてください

FROM ubuntu:18.04

# Unreal refuses to run as root user, so we must create a user to run as
# Docker uses root by default
RUN useradd --system ue
USER ue

EXPOSE 7777/udp

WORKDIR /server

COPY --chown=ue:ue . /server
USER root
CMD chown -R ue.ue $PF_SERVER_LOG_DIRECTORY && su ue -c ./YourGameNameServer.sh

• 任意のターミナルを使用して、Linux サーバーディレクトリに移動します
  • Windows ユーザーは通常 cmd または powershell を使用しますが、サードパーティツールまたは WSL 経由の bash も利用可能です
  • Mac と Linux のユーザーは通常 bash を使用します
• docker build -t "[imageName]:[tag]" . を実行します。imageName と tag は任意のオプションです。
  • これらの名前は後で再度使用するので覚えておいてください
  • 例としては、それぞれ YourProjectNameServer と 01 が挙げられます
  • tag 要素は通常、サーバーインスタンスのバージョン管理に使用されます
  • これらのタグは後の手順で使用されます
  • 忘れた場合はターミナルで docker images と入力して imageName と tag を取得できます
• ターミナルで docker images と入力し、docker イメージが正常に作成されたことを確認します。
• このターミナルウィンドウは開いたままにして脇に置いてください。後でさらにコマンドを実行します
  • (後の手順では [Docker terminal] と表記)

​

PlayFab Azure レジストリにコンテナイメージをアップロードする

• PlayFab 開発者ポータル に移動します
• タイトルを選択します
• 左側の Multiplayer タブを選択します
• 画面右側の New Build を選択します。
• 名前を選択します
• VM タイプを選択します。ThirdPersonMP プロジェクトの場合、Dasv4 (2 cores) で十分です
• Server Details で、Server Type を Container、Operating System を Linux に設定します。
• Upload to container registry を選択します。
• 表示されるウィンドウで:
  • このウィンドウから [AzureUsername] を覚えておいてください。次の手順で複数回使用します
  • Copy Docker Login Command を選択します
• {Docker terminal} ウィンドウに戻ります
  • Docker Login コマンドを [Docker terminal] に貼り付けます。このコマンドは、PlayFab で使用される Azure Registry にログインします。
  • 入力: docker tag [imageName]:[tag] [AzureUsername].azurecr.io/[imageName]:[tag]
  • 入力: docker push [AzureUsername].azurecr.io/[imageName]:[tag]
  • AzureUsername は PlayFab 開発者ポータルに表示され、imageName と tag は前に自分で選択したものです。
• PlayFab の Web サイトに戻り、New Build ページの Server Details で、Container image の横にある Refresh を選択します。
• 矢印ボタンをクリックすると、アップロードした docker イメージと該当タグを確認して選択できるはずです。
• Regions ブロックで、近くのリージョンを選択し、Standby と Max の両方を 1 に設定します (テストのため)
• Network ブロックで、Port Name フィールドを gameport に設定します
  • ゲームサーバーへの接続に使用するポートを定義することは必須です
  • Unreal GSDK には、このポートを自動的に読み取り、この値に従って Unreal サーバーのホストポートを内部的にオーバーライドするコードが含まれています
  • このポートの名前は gameport である必要があります
• Add Build を選択し、ビルドステータスが Deployed になるのを待ちます

​

次のステップ