Diversion と Horde のセットアップ（Windows、UE5 ソース）

​

前提条件

• Horde Server および Horde Agent マシン（Windows）への管理者アクセス。
• Epic↔GitHub のリンクされたアカウントを通じた GitHub 上の UE ソース へのアクセス。 これは Horde 全般の要件であり、Horde のビルドステップではエンジンソースと UAT や UBT などのツールへのアクセスが必要になるためです。

​

1) Diversion をインストールしサインインする（Server + Agents）

1. Horde Server と すべての Horde Agent で、Diversion for Windows インストーラーを実行します。
2. Server と Agent の両方で Diversion を起動してサインインし、連携が UE5 ソースリポジトリに適切にアクセスできるようにします。

​

2) Diversion で UE5 ソースリポジトリを準備する（Windows）

​

2.1 Unreal Engine ソースをクローンする

• UE on GitHub
• Downloading Unreal Engine Source Code

​

2.2 クローンした UE リポジトリから .gitignore ファイルを削除する

for /r %f in (.gitignore) do @del "%f"

​

2.3 .dvignore を作成する（Diversion 初期化前）

# Epic's .dvignore file (converted from gitignore)
# Note: Diversion tracks directories as well as files
# - Uses same glob patterns as gitignore
# - ** pattern for recursive directory matching
# - Patterns are relative to .dvignore location

# Ignore root Visual Studio solution files only
*.sln

.p4sync.txt

# Visual Studio temp files
*.suo
*.opensdf
*.sdf

# Engine DerivedDataCache
/Engine/DerivedDataCache/*
**/DerivedDataCache/Boot.ddc
**/DerivedDataCache/**/*.udd

# Ignore all Intermediate and Saved directories
**/Intermediate/
**/Saved/

# UBT configuration
/Engine/Programs/UnrealBuildTool/
*.uatbuildrecord
*.tmp

# Build output
**/obj/
*.csprojAssemblyReference.cache

# UBT log files
/Engine/Programs/UnrealBuildTool/*.txt

# Python cache
*.pyc
__pycache__/

# JetBrains IDE
.idea/
!.idea/runConfigurations/
.gradle/

# HoloLens WMRInterop autogenerated files
/Engine/Source/ThirdParty/WindowsMixedRealityInterop/packages/
/Engine/Source/ThirdParty/WindowsMixedRealityInterop/MixedRealityInteropHoloLens/Generated Files/
/Engine/Source/ThirdParty/WindowsMixedRealityInterop/MixedRealityInteropHoloLens/x64/
/Engine/Source/ThirdParty/WindowsMixedRealityInterop/MixedRealityInteropHoloLens/ARM64/
/Engine/Source/ThirdParty/WindowsMixedRealityInterop/MixedRealityInterop/x64/
/Engine/Source/ThirdParty/WindowsMixedRealityInterop/MixedRealityInterop/ARM64/

# macOS Finder files
.DS_Store

# VS Code workspace files
*.code-workspace

.vs

​

2.4 UE のセットアップスクリプトを実行する（Windows）

Setup.bat
GenerateProjectFiles.bat

​

2.5 UE 用の Diversion リポジトリを初期化する

1. UE リポジトリのルートで Diversion リポジトリを初期化します（Diversion CLI または UI）。
2. .dvignore が適用されていることを確認します（キャッシュ / 中間ファイルが追跡対象外のままであること）。

​

2.6 このソースツリーに UE プロジェクト を追加する

​

3) Horde ストリームを Diversion リポジトリ/ブランチに向ける

• C:\\ProgramData\\Epic\\Horde\\Server\\

// Diversion‑required: set the repo id and branch name
"name": "//<repo-id>/<branch>"

構成が分割されている場合（globals → project → stream）、name は UE ソースストリームを表す stream JSON に配置してください。

​

4) UE ソースストリーム用に Horde を構成する

1. Horde 設定ファイルが C:\\ProgramData\\Epic\\Horde\\Server\\ 配下にあることを確認します。
2. プロジェクト（*.project.json）がストリーム（*.stream.json）を参照していることを確認します。
3. ストリーム JSON で、Diversion リポジトリとブランチのマッピングを設定し（セクション 3 参照）、適切なジョブテンプレート（BuildGraph）とその他の Horde の一般要件を定義します。
4. パイプラインが正しく設定されたことを検証するため、まずは最小限のエディター専用の BuildGraph ジョブから始めます。

Horde の設定スタックは Globals → Projects → Streams の順です。.project.json/.stream.json 拡張子を使用することで、JSON スキーマツールを有効にできます。

​

5) スモークテスト

• 構成を保存した後、Horde を再起動またはホットリロードします。
• Horde ダッシュボードでプロジェクト/ストリームを開き、既存の構成に基づく小さな BuildGraph ジョブをキューに投入し、エージェントが Diversion から同期してビルドできることを確認します。

​

クイックリファレンス（Windows）

• Git の無視ファイルを削除する（UE リポジトリのルートから）:
  for /r %f in (.gitignore) do @del "%f"
  
• UE セットアップ
  Setup.bat
  GenerateProjectFiles.bat
  

​

参考資料

• UE on GitHub — Epic↔GitHub アカウントの連携
• Download UE Source — 公式ガイド
• Build UE from Source — Windows 向けの注意事項
• Horde（概要） — 概要ドキュメント
• Horde Orientation — スキーマサーバー、構成
• Horde Build Automation（概要） — ビルド自動化の概要
• Horde Build Automation（チュートリアル） — ビルド自動化のチュートリアル