Unreal Engine にあるすべてのコンテナ イメージにはビルド済みのバージョンがあり、GitHub Container Registry からダウンロードできます。Unreal Engine のカスタム バージョンの開発イメージを作成する場合、またはイメージのソースコードに変更を加える場合、ソースからイメージをビルドする必要があります。
要件
Unreal Engine に含まれている Linux コンテナ イメージをビルドするには、コンピュータが「ハードウェアおよびソフトウェア要件」ページの Linux コンテナ セクションに記載されているハードウェアとソフトウェアの要件を満たしている必要があります。
Windows のソースからの Linux コンテナ イメージのビルドはサポートされません。Windows 10 および Windows 11 の Docker Desktop または WSL2 のいずれかを使用して画像をビルドすることは可能ですが、正しい動作のためには追加の構成およびトラブルシューティングが必要です。その代わりに、仮想マシンにインストールされたマシン、またはホスト マシン上で直接、Linux で Linux コンテナ イメージをビルドする必要があります。
Docker をインストールする
Unreal Engine に含まれているコンテナ イメージをビルドおよび実行するには、Docker がおすすめです。Docker をインストールする手順は、使用しているオペレーティングシステムによって異なります。以下のリンクでは、利用可能な各プラットフォームでインストールを行う方法について説明しています。
-
Linux: 適切な手順に従って、特定の Linux ディストリビューション用の Docker Engine をインストールします。
公式エンジン リリース用のイメージをビルドする
ソースコードを GitHub からダウンロードした場合、エンジンをソースからビルドする場合と同じ要領で、エンジンのバイナリ依存関係をダウンロードするためにソースツリーのルートから Setup.sh (Windows あるいは Setup.sh (他のプラットフォーム) が必要になります。このステップを行わないと、コンテナ画像の作成に必要なファイルが欠如します。
Unreal Engine ソースコードの次のサブディレクトリに移動します。
Engine/Extras/Containers/Dockerfiles/linux
Linux コンテナ イメージのビルド スクリプトは、「username.txt」、「password.txt」と呼ばれるファイルで Git の資格情報を検索します。
-
「
username.txt」ファイルを作成し、GitHub ユーザー名を入力します。 -
「
password.txt」ファイルを作成し、GitHub 個人用アクセストークンを入力します。
Unreal Engine の特定のリリース用の Linux コンテナ イメージをビルドするには、Bash シェルで以下に示すコマンドを実行し、ENGINE_RELEASE を適切なリリース番号 (「4.27.0」など) に置き換えます。
./build.sh ENGINE_RELEASE
これにより、Linux のランタイム イメージと Linux の開発イメージの両方がビルドされます。その後、 Pixel Streaming などの特定のユースケース用のイメージも続けてビルドされます。開発イメージは、GitHub から Unreal Engine ソースコードをダウンロードし、エンジンの インストール済みビルド を作成することから、ビルドに最も時間がかかります。
エンジンのカスタム バージョンのイメージをビルドする
ビルド スクリプトは、Git からの Unreal Engine ソースコードの取得のみをサポートしています。Perforce などの他のバージョン管理システムはサポートされていません。開発イメージの Dockerfiles を手動で変更することにより、他のバージョン管理システムを使用することは可能です。しかし、Epic Games はその方法をサポートしていません。
Linux コンテナ イメージのビルド スクリプトは、公式の GitHub リポジトリの使用ではなく、Unreal Engine ソースコードを取得するカスタム Git リポジトリとブランチの指定をサポートしています。カスタム リポジトリには、公式の Unreal Engine リポジトリの GitHub フォークや、組織で内部使用するために維持されているオンプレミスの Git サーバーに保存されたプライベート リポジトリが含まれる場合があります。
「username.txt」および「password.txt」ファイルに Git の資格情報を入力する方法は、使用されている Git リポジトリのタイプによって異なります。
-
GitHub フォーク:
- GitHub のユーザー名と個人用アクセストークンを使用します。
-
カスタム Git サーバー:
- 「
username.txt」ファイルに Git のユーザー名を入力します。
「
password.txt」ファイルに Git のパスワードを入力します。 - 「
Git リポジトリの特定のブランチ用の Linux コンテナ イメージをビルドするには、Bash シェルで以下に示すコマンドを実行し、BRANCH をブランチ名、REPOSITORY を Git のリポジトリ (例: 「https://github.com/EpicGames/UnrealEngine.git」) に置き換えます。
./build.sh BRANCH REPOSITORY
高度なビルド パラメータの変更を行う
ビルド スクリプト「build.sh」には、手動によるファイル編集で変更可能な次の高度なビルドパラメータが含まれています。
BASEIMAGE:*BASEIMAGE：開発イメージをビルドするときに使用される Linux ベース イメージを指定する文字列です。この値のデフォルトは、OpenGL 開発ヘッダを含む NVIDIA が提供する Ubuntu ベース イメージです。