翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

エピック Unreal エンジン

Unreal Engine は、フォトリアルなビジュアルと没入型エクスペリエンスのためのリアルタイムの 3D 作成ツールです。Unreal Engine は、送信者、conda パッケージ、レンダリングパフォーマンスを向上させるアダプターを備えた Deadline Cloud でサポートされています。このガイドでは、Deadline Cloud と Unreal Engine を使用して、レンダリングタスクを複数のマシンに分散することで、映画レンダリングキュープロジェクトをより迅速にレンダリングするためのstep-by-stepの手順を示します。

サポートの概要

Unreal Engine は、次のコンポーネントでサポートされています。

Unreal Engine バージョンの互換性

次の表は、Unreal Engine バージョンの現在のサポートレベルを示しています。

Deadline Cloud Conda チャネル

次の表に、conda チャネルのサービスマネージドフリートで使用できる Unreal Engine に適用されるすべての deadline-cloud conda パッケージを示します。

開始方法

前提条件

Unreal Engine 送信者をインストールする前に、以下があることを確認してください。

送信者のインストール

Unreal Engine 送信者は Deadline Cloud 機能を Unreal Engine のプラグインとして追加し、映画レンダリングキュージョブを Deadline Cloud に直接送信してレンダリングできるようにします。

ブランチの選択

デプロイに適したブランチを選択します。

Unreal をインストールする新しい Windows Amazon EC2 インスタンスの作成 (オプション)

新しい Windows Amazon Elastic Compute Cloud (Amazon EC2) インスタンスを送信者として設定する場合、200 GB のストレージを持つ g5.2xlarge インスタンスは妥当な最小値です。

Windows のロングパス

以下の手順の多くは、デフォルトの Windows 最大パス長を超えるファイルを作成する場合があります。Deadline Cloud for Unreal Engine 送信者またはアダプターを Windows マシンにビルドしてインストールする前に、Windows のロングパスサポートを有効にすることをお勧めします。これを行うには、「ファイルパスの最大数の制限」ページの手順に従います。たとえば、PowerShell コマンドを実行します。

Windows のロングパスをサポートするように設定されていない依存関係が原因でワーカーエージェントに未解決の問題もあります。ワーカーを設定するときは、リンクされた問題の回避策ステップに従って、問題が解決されるまで Windows のロングパスを完全にサポートします。

ビルドツールのインストール

現在、Unreal 送信者プラグインはローカルでコンパイルする必要があります。

Deadline Cloud Monitor のインストール

Deadline Cloud モニターは、Deadline Cloud にジョブを送信するための認証情報を管理し、ジョブのステータスをモニタリングするために使用されます。

環境設定

Deadline Cloud ソフトウェアのインストール

最新のテスト済みリリースが必要か、最新のコミットのすべてが必要かに応じて、リリースブランチまたはメインラインdeadline-cloud-for-unreal-engineからクローンまたはダウンロードします。

git clone https://github.com/aws-deadline/deadline-cloud-for-unreal-engine.git
cd deadline-cloud-for-unreal-engine
git switch release

オプション - スクリプトを使用してプラグインを構築およびインストールする

のヘルパースクリプトはscripts/build_plugin.py、オプションで次の 2 つのステップを自動化します。Unreal の最新バージョンの検索を試み、プラグインと Python の依存関係を構築し、正しい場所にインストールします。Unreal バージョンなどの設定を上書きできます。完全なヘルプリストを表示するには、以下を実行します。

python scripts/build_plugin.py -h

最新の Unreal Engine インストールを使用して の現在のコピーを送信者deadline-cloud-for-unreal-engineとしてビルドおよびインストールするには、以下を実行します。

python scripts/build_plugin.py --install

このスクリプトで を正常にインストールした場合は、「」に進むことができますフリートの作成。

プラグインの構築

Unreal のインストール場所と のインストール場所に基づいて、以下の最初の 2 つのパスを調整しますdeadline-cloud-for-unreal-engine。

Unreal Install Batchfiles フォルダから ( packageパラメータは任意の新しいディレクトリにすることができますが、UnrealDeadlineCloudService後で呼び出す必要があります）。

cd C:\Program Files\Epic Games\UE_5.5\Engine\Build\BatchFiles
runuat.bat BuildPlugin -plugin="C:\deadline\deadline-cloud-for-unreal-engine\src\unreal_plugin\UnrealDeadlineCloudService.uplugin" -package="C:\UnrealDeadlineCloudService"

上記の「パッケージ」フォルダを Unreal インストールのプラグインフォルダ (例: ) にコピーしますC:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService。

Python の依存関係

必要な Python 依存関係をインストールする方法は 4 つあります。

1. 上記のリリースブランチからプラグインを構築してインストールした場合は、pip から をインストールできます。次の install コマンドを使用して、Unreal インストールへのパスを調整します。

"C:\Program Files\Epic Games\UE_5.5\Engine\Binaries\ThirdParty\Python3\Win64\python" -m pip install deadline-cloud-for-unreal-engine --target "C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService\Content\Python\libraries"

2. または、 .uplugin ファイル (上記のステップでは に存在しますC:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService\UnrealDeadlineCloudService.uplugin) に、GitHub/PyPI deadline-cloud-for-unreal-engineの の最新リリースに一致するPythonRequirementsセクションを追加できます。次に例を示します。

"PythonRequirements":
[
    {
        "Platform": "All",
        "Requirements":
        [
            "deadline-cloud-for-unreal-engine>=0.5.0"
        ]
    }
]

Unreal の Python 設定で「厳密なハッシュ」機能を無効にしたり、使用する特定のライブラリと依存関係バージョンにハッシュ設定を追加したりできます。

3. メインラインからプルする場合、Python 依存関係がまだ PyPI にリリースされていない可能性があります。ローカルコピーを構築してインストールする必要があります。これは、ハッチで実行できます。.whl ファイルは、ハッチビルドによって出力されるバージョンを反映するように変更する必要があります。

pip install hatch
hatch build
"C:\Program Files\Epic Games\UE_5.5\Engine\Binaries\ThirdParty\Python3\Win64\python" -m pip install dist\deadline_cloud_for_unreal_engine-0.2.2.post21-py3-none-any.whl --target "C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService\Content\Python\libraries"

4. 最後に、Python 依存関係は送信者インストーラによってインストールできます。これらはリリースブランチまたはメインラインブランチの上記のコードでは古くなっている可能性があるため、この方法は現時点では推奨されません。

通知の更新

送信者プラグインは、Unreal Editor の起動時に GitHub で新しいリリースを自動的に確認します。更新が利用可能な場合、リリースページにアクセスするように求めるダイアログが表示されます。

更新通知を無効にするには、「Deadline Cloud settings」パネルの「General Settings」(Edit > Project Settings > Plugins > Deadline Cloud) で「Show submitter update notifications」のチェックボックスをオフにします。

または、 CLI を使用することもできます。

deadline config set settings.submitter_update_notification false

を再度有効にするには:

deadline config set settings.submitter_update_notification true

フリートの作成

すでに Windows フリートがあり、新しいフリートを設定する必要がない場合は、 にスキップできますテストレンダーの送信。

サービスマネージドフリート (SMF) の作成

まだ SMF がない場合は、サービスマネージドフリートユーザーガイドに従って SMF を作成します。サービスマネージドフリート (SMFs) では、Unreal Engine とアダプターは、デフォルトのキュー環境の deadline-cloud conda チャネルを使用して自動的に使用できます。レンダリングを開始する準備が整いました。テストレンダージョブを送信するには、テストレンダーの送信以下に進みます。

カスタマーマネージドフリート (CMF) の作成

テストレンダーの送信

この例では、Unreal Marketplace の Meerkat デモを使用しています。

カスタマーマネージドフリート (CMF) ワーカーのセットアップ

このセクションでは、Unreal Engine を使用した Deadline Cloud の CMF ワーカーとして Amazon EC2 インスタンスを設定する手順について説明します。

概要

CMF と SMF の主な違いは次のとおりです。

ブランチの選択

デプロイに適したブランチを選択します。

Amazon EC2 インスタンスのセットアップ

推奨されるインスタンス設定は次のとおりです。

ソフトウェアのインストール

1. Unreal Engine のインストール:

2。NVIDIA GRID ドライバーをインストールします。

ビルドツールのインストール

現在、Unreal プラグインはローカルでコンパイルする必要があります。

Deadline Cloud ソフトウェアのインストール

リリースブランチまたはメインラインdeadline-cloud-for-unreal-engineからクローンを作成するか、ダウンロードします。ワーカーバージョンのライブラリが、送信者が使用しているバージョンと互換性があることを確認します。

git clone https://github.com/aws-deadline/deadline-cloud-for-unreal-engine.git
cd deadline-cloud-for-unreal-engine
git switch release

オプション - スクリプトを使用してプラグインと依存関係を構築およびインストールします。

残りのインストールステップを自動化scripts/build_plugin.pyできるヘルパースクリプトが にあります。Unreal の最新バージョンを見つけ、プラグインと Python の依存関係を構築し、正しい場所にインストールしようとします。使用する Unreal バージョンなどの設定は上書きできます。完全なヘルプリストを表示するには、以下を実行します。

python scripts/build_plugin.py -h

最新の Unreal Engine インストールを使用して、ワーカーdeadline-cloud-for-unreal-engineとして の現在のコピーを構築してインストールするには、以下を実行します。

python scripts/build_plugin.py --install --worker

以下を実行して Deadline Cloud ワーカーエージェントを設定します。

install-deadline-worker ^
  --farm-id FARM_ID ^
  --fleet-id FLEET_ID ^
  --region REGION ^
  --allow-shutdown

このスクリプトで をインストールし、ワーカーエージェントを正常に設定した場合は、「」に進むことができますDeadline Cloud ワーカーエージェントサービスの開始。

python -m pip install deadline-cloud-worker-agent

使用する送信者のバージョンに応じて、正しいバージョンのアダプターをインストールする必要があります。GitHub のリリースブランチから送信者のバージョンを使用している場合は、pip を使用して をインストールできます。

python -m pip install deadline-cloud-for-unreal-engine

送信者のメインラインまたはカスタム開発中バージョンを使用している場合は、互換性の問題を避けるため、同じバージョンのコードからビルドしてインストールするか、送信者ビルドから .whl ファイルを転送することをお勧めします。

pip install hatch
hatch build
python -m pip install dist\my-built-wheel.whl

プラグインの構築

Unreal のインストール場所と のインストール場所に基づいて、以下の最初の 2 つのパスを調整しますdeadline-cloud-for-unreal-engine。

Unreal Install Batchfiles フォルダから ( packageパラメータは任意の新しいディレクトリにすることができますが、UnrealDeadlineCloudService後で呼び出す必要があります）。

cd C:\Program Files\Epic Games\UE_5.5\Engine\Build\BatchFiles
runuat.bat BuildPlugin -plugin="C:\deadline\deadline-cloud-for-unreal-engine\src\unreal_plugin\UnrealDeadlineCloudService.uplugin" -package="C:\UnrealDeadlineCloudService"

上記の「パッケージ」フォルダを Unreal インストールのプラグインフォルダ (例: ) にコピーしますC:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService。

pywin32

Unreal のバージョンの Python には pywin32 が必要です。Unreal のサードパーティー Python インストールのコピーを使用して Pip インストールします。

"C:\Program Files\Epic Games\UE_5.5\Engine\Binaries\ThirdParty\Python3\Win64\python" -m pip install pywin32

Deadline Cloud ワーカーエージェントサービスの開始

CMF ワーカーインスタンスの場合:

認証情報管理を実施する

このセクションでは、Perforce を Deadline Cloud ワーカーと統合するための安全な認証情報管理について説明します。

概要

Deadline Cloud ワーカーの Perforce 認証情報を設定する方法はいくつかあります。各方法には、さまざまなセキュリティ上の影響とユースケースがあります。

P4 認証情報の基本

Perforce サーバーの URL とポート、ユーザー名、パスワードなどの接続設定を取得するには、Perforce は次の優先度に従います。

これらの優先順位で、次の設定がある場合:

結果の Perforce 接続は次のとおりです。

Port = ssl:perforce.from.env:1666
User = user.from.registry
Password = password.from.connection

Secrets Manager (推奨)

Secrets Manager は、CMF と SMF の両方のデプロイに対して最も安全でスケーラブルなソリューションを提供します。

このアプローチには以下の利点があります。

ステップ 1: Secrets Manager でシークレットを作成する

Perforce 接続パラメータを含むシークレットを作成します。

必要なキーと値のペア:

シークレットの例:

{
   "P4PORT": "ssl:your-perforce-server.com:1666",
   "P4USER": "your-perforce-username",
   "P4PASSWD": "your-perforce-password"
}

シークレットを作成するには:

ステップ 2: ワーカーにシークレットへのアクセスを許可する

ワーカーはシークレットにアクセスするためのアクセスsecretsmanager:GetSecretValue許可が必要です。これは、Windows ジョブのユーザーシークレットの管理と同じパターンに従います。

アクセスを許可するには:

ジョブの環境変数

接続認証情報は、p4_sync_smf_environment、ugs_sync_smf_environment、または CMF の同様の環境など、ワークスペースの作成が行われるジョブ環境内で渡すことができます。または、新しい環境テンプレートを作成し、ジョブに付加します。

name: P4Credentials
variables:
  P4PORT: ssl:my-perforce.com:1666
  P4USER: j.doe
  P4PASSWD: MyVeRyS3cretP4ssW0rd

このアプローチには、次のセキュリティリスクがあります。

キュー環境変数

Deadline Cloud ユーザーガイドによると、キュー環境を使用して、ソフトウェアアプリケーション、環境変数、その他のリソースをキュー内のジョブに提供できます。キュー環境のサンプルは、 deadline-cloud-samples の queue_environments フォルダにあります。

Deadline Cloud モニターまたはコンソールを使用してキュー環境を追加する

CLI を使用してキュー環境を追加する

Windows レジストリ (CMF のみ)

Windows レジストリは、ワーカーマシンにローカル認証情報ストレージを提供します。このメソッドは、認証情報が保存されている標準の Perforce 優先度システムを使用します。

このアプローチは、ワーカーマシンの設定に直接アクセスできる CMF デプロイにのみ適しています。

事前設定された管理者ユーザー (CMF のみ)

有効期限が切れていない接続を持つレンダーノード専用の P4 ユーザーを作成し、ユーザー名やパスワードなどのシークレットデータを渡す必要がなくなります。この場合、1 人の専用 P4 ユーザーを使用して、プロジェクトデポにアクセスできるコミット (マスター) サーバーやエッジサーバーなど、すべての P4 サーバーに接続できます。

したがって、デフォルトがワーカーで設定されていない場合は、接続先のポートを渡すだけで済みます。これは、上記の手順と同様に、ジョブ環境またはキュー環境に以下を追加することで実現できます。

name: P4Sync
variables:
  P4PORT: ssl:my-perforce.com:1666

Perforce レンダリングジョブの作成

このセクションでは、Perforce 統合レンダージョブデータアセットを設定して、Perforce 統合レンダージョブを Unreal Engine から Deadline Cloud に送信できるようにする方法について説明します。

前提条件

Perforce リポジトリで Unreal Engine から映画レンダリングキュー (MRQ) ジョブを送信する前に:

Unreal プロジェクトのセットアップ:

Deadline Cloud のセットアップ:

Perforce の要件:

レンダリングジョブアーキテクチャを実行する

P4 レンダリングジョブは、Perforce 同期機能を使用して標準レンダリングジョブを拡張します。

Deadline Cloud Perforce render job
├── Environments
│   ├── Apply Perforce Credentials from Secrets Manager
│   ├── Sync Perforce Environment (CMF/SMF)
│   │   └── Initializes Perforce workspace and syncs repository on workers
│   └── Launch UE Environment
│       └── Starts Unreal Engine with Perforce workspace paths
└── Steps
    └── Render Step
        └── Executes Movie Render Queue process

標準ジョブとの主な違い:

Perforce レンダリングジョブコンポーネントのセットアップ

Perforce 統合レンダージョブに必要なデータアセットを作成するには、次の手順に従います。

1. Apply Perforce 認証情報データアセットを作成する

Secrets Manager から Perforce 認証情報を取得し、Perforce 接続に適用するための OpenJD 環境を設定します。

設定手順:

2. Perforce 同期環境データアセットを作成する

Perforce ワークスペースを作成し、Perforce サーバーからファイルを同期し、レンダリング後にワークスペースをクリーンアップするための OpenJD 環境を設定します。

設定手順:

3. Perforce Launch UE 環境データアセットを作成する

Perforce 統合で Unreal Engine を起動するための OpenJD 環境を設定します。これにより、同期環境によって作成された Perforce ワークスペースが自動的に参照されます。

設定手順:

4. Perforce レンダリングステップデータアセットを作成する

レンダリングプロセスを実行するための OpenJD レンダリングステップを設定します。

設定手順:

5. Perforce レンダリングジョブデータアセットを作成する

レンダリングワークフロー全体をオーケストレーションする OpenJD レンダリングジョブを設定します。

設定手順:

ベストプラクティス

送信前チェックリスト

パフォーマンスの最適化

チャンクサイズ設定:

以下の追加の最適化を検討してください。

モニタリングとデバッグ

トラブルシューティング

一般的な の問題と解決策

デバッグステップ

カスタムホストの要件

このセクションでは、Unreal Engine で Deadline Cloud レンダリングのカスタムホスト要件を作成して使用する方法について説明します。

概要

ホスト要件は、特定のレンダリングステップを実行する資格があるフリートを定義します。UDeadlineCloudHostRequirements これらはアセット内に保存され、DeadlineCloudRenderStepアセットによって参照されます。

ステップ 1: ホスト要件アセットを作成する

ステップ 2: デフォルトの YAML テンプレートをロードする

これにより、CPU、メモリ、GPU、OS、アーキテクチャなどの基本要件がロードされます。

ステップ 3: 基本 (システム) 要件を設定する

Max = 0 の場合、その要件の上限はありません。

ステップ 4: カスタム金額要件を追加する

要件が数値 (ライセンス数、同時実行数の制限など) の場合に使用されます。

ステップ 5: カスタム属性要件を追加する

タグとラベルに基づいてワーカーをフィルタリングするために使用されます。

ステップ 6: MRQ での可視性 (オプション)

各要件エントリには目のアイコンがあります。

この設定は、技術的な制約を維持しながらアーティストの UI を簡素化するのに役立ちます。

ステップ 7: レンダリングステップに要件をアタッチする

このステップを使用するすべての MRQ 送信で、ホスト選択ロジックが強制されるようになりました。

概要

ホスト要件アセットを使用すると、次のことができます。

この設定により、ジョブのルーティングの一貫性が向上し、正しいハードウェアでレンダリングが行われるようになります。

詳細設定

サービスマネージドフリートとカスタマーマネージドフリート

サービスマネージドフリート (SMF)

サービスマネージドフリートでは、Unreal Engine とアダプターは、デフォルトのキュー環境の deadline-cloud conda チャネルを使用して自動的に使用できます。この設定は、最も簡単なエクスペリエンスを提供します。

カスタマーマネージドフリート (CMF)

カスタマーマネージドフリートの場合、Unreal Engine とアダプターをワーカーホストに手動でインストールする必要があります。この設定は、より多くの制御を提供し、Perforce 統合などの追加機能をサポートします。詳細な手順については、「カスタマーマネージドフリート (CMF) ワーカーのセットアップ」を参照してください。

Unreal Engine レンダリング機能

Unreal Engine のレンダリングシステムは、以下を包括的にサポートします。

すべてのレンダリング機能は、Unreal Engine 統合送信者によって自動的に検出および設定されます。アダプターは適切な依存関係処理を維持し、Unreal Engine を再起動せずに効率的なマルチショットレンダリングをサポートします。

オープンソースリソース

送信者とアダプターはオープンソースであり、GitHub で入手できます。