Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mesin Epic Unreal

Unreal Engine adalah alat pembuatan 3D real-time untuk visual fotoreal dan pengalaman imersif. Unreal Engine didukung oleh Deadline Cloud dengan submitter, paket conda, dan adaptor untuk meningkatkan kinerja rendering. Panduan ini memberikan petunjuk langkah demi langkah untuk menggunakan Deadline Cloud dengan Unreal Engine untuk membuat proyek Antrian Render Film Anda lebih cepat dengan mendistribusikan tugas rendering di beberapa mesin.

Ikhtisar Support

Unreal Engine didukung oleh komponen-komponen berikut:

Kompatibilitas versi Unreal Engine

Tabel berikut menunjukkan tingkat dukungan saat ini untuk versi Unreal Engine:

Batas Waktu Saluran Cloud Conda

Tabel berikut mencantumkan semua paket conda yang berlaku untuk Unreal Engine yang tersedia untuk Service-managed armada di saluran conda: deadline-cloud

Memulai

Prasyarat

Sebelum memasang submitter Unreal Engine, pastikan Anda memiliki yang berikut:

Memasang submitter

Pengirim Unreal Engine menambahkan fungsionalitas Deadline Cloud sebagai plugin ke Unreal Engine, memungkinkan Anda mengirimkan pekerjaan Antrian Render Film Anda langsung ke Deadline Cloud untuk dirender.

Memilih cabang Anda

Pilih cabang yang sesuai untuk penerapan Anda:

Membuat instans Windows Amazon EC2 baru untuk menginstal Unreal pada (opsional)

Jika Anda menyiapkan instans Windows Amazon Elastic Compute Cloud (Amazon EC2) baru sebagai pengirim Anda, instans g5.2xlarge dengan penyimpanan 200 GB adalah minimum yang wajar:

Jalur panjang Windows

Banyak langkah di bawah ini dapat membuat file yang melebihi panjang jalur maksimum Windows default. Sebelum Anda membangun dan menginstal pengirim atau adaptor Deadline Cloud for Unreal Engine pada mesin Windows, kami sarankan Anda mengaktifkan dukungan jalur panjang Windows. Untuk melakukan ini, ikuti instruksi pada halaman batasan jalur file maksimum, misalnya dengan menjalankan PowerShell perintah.

Ada juga masalah terbuka pada agen pekerja yang disebabkan oleh ketergantungan yang tidak dikirimkan dikonfigurasi untuk mendukung jalur panjang Windows. Saat menyiapkan pekerja, ikuti langkah-langkah solusi dalam masalah tertaut untuk sepenuhnya mendukung jalur panjang Windows hingga masalah teratasi.

Menginstal alat build

Plugin pengirim Unreal saat ini harus dikompilasi secara lokal.

Menginstal monitor Cloud Deadline

Monitor Deadline Cloud digunakan untuk mengelola kredensil Anda untuk mengirimkan pekerjaan ke Deadline Cloud dan memantau status pekerjaan Anda.

Pengaturan lingkungan

Tenggat waktu instalasi perangkat lunak Cloud

Kloning atau unduh deadline-cloud-for-unreal-engine dari cabang rilis atau jalur utama, tergantung pada apakah Anda menginginkan rilis teruji terbaru atau semua komit terbaru.

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

Opsional - Bangun dan instal plugin dengan skrip

Skrip pembantu di scripts/build_plugin.py opsional mengotomatiskan dua langkah berikutnya. Ini mencoba untuk menemukan versi terbaru Unreal, membangun plugin Anda dan dependensi Python, dan menginstalnya di lokasi yang benar. Anda dapat mengganti pengaturan seperti versi Unreal. Untuk melihat daftar bantuan lengkap, jalankan:

python scripts/build_plugin.py -h

Untuk membuat dan menginstal salinan Anda saat ini deadline-cloud-for-unreal-engine sebagai pengirim dengan instalasi Unreal Engine terbaru, jalankan:

python scripts/build_plugin.py --install

Jika Anda telah berhasil menginstal dengan skrip ini, Anda dapat melompat keMembuat armada.

Bangun plugin

Sesuaikan dua jalur pertama di bawah ini berdasarkan di mana instalasi Unreal Anda hidup, dan di mana Anda menginstaldeadline-cloud-for-unreal-engine.

Dari folder Unreal Install Batchfiles (packageparameternya bisa berupa direktori baru, namun Anda ingin dipanggil UnrealDeadlineCloudService nanti):

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"

Salin folder “paket” di atas ke folder Plugin instalasi Unreal Anda (misalnya,C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService).

Dependensi Python

Ada 4 cara untuk menginstal dependensi Python yang diperlukan.

1. Jika Anda telah membangun dan menginstal plugin dari cabang rilis di atas, Anda dapat menginstal dari pip. Gunakan perintah instal berikut, sesuaikan jalur ke instalasi Unreal Anda:

"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. Atau dalam .uplugin file Anda (dalam langkah-langkah di atas ini akan hidup diC:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService\UnrealDeadlineCloudService.uplugin) Anda dapat menambahkan PythonRequirements bagian yang cocok dengan rilis terbaru deadline-cloud-for-unreal-engine di GitHub/PyPI, misalnya:

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

Anda mungkin ingin menonaktifkan fitur “hash ketat” di pengaturan Python Unreal, atau menambahkan pengaturan hash untuk versi pustaka dan ketergantungan tertentu yang ingin Anda konsumsi.

3. Jika Anda menarik dari arus utama, Anda mungkin memiliki dependensi Python yang belum dirilis ke PyPI - Anda harus membangun dan menginstal salinan lokal Anda yang dapat dilakukan dengan hatch. .whlFile perlu diubah untuk mencerminkan versi yang dihasilkan oleh hatch build:

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. Terakhir, dependensi Python dapat diinstal oleh penginstal submitter. Ini mungkin kedaluwarsa dengan kode Anda di atas dari rilis atau cabang jalur utama, dan metode ini saat ini tidak lebih disukai.

Perbarui pemberitahuan

Plugin submitter secara otomatis memeriksa rilis yang lebih baru pada GitHub saat Unreal Editor dimulai. Jika pembaruan tersedia, dialog akan meminta Anda untuk mengunjungi halaman rilis.

Untuk menonaktifkan pemberitahuan pembaruan, hapus centang Tampilkan pemberitahuan pembaruan pengirim di bawah Pengaturan Umum di panel Pengaturan Cloud Batas Waktu (Edit > Pengaturan Proyek > Plugins> Awan Batas Waktu).

Atau, Anda dapat menggunakan CLI:

deadline config set settings.submitter_update_notification false

Untuk mengaktifkan kembali:

deadline config set settings.submitter_update_notification true

Membuat armada

Jika Anda sudah memiliki armada Windows dan tidak perlu menyiapkan armada baru, Anda dapat melompat ke bawahMengirimkan render pengujian.

Membuat armada yang dikelola layanan (SMF)

Ikuti panduan pengguna armada yang dikelola layanan untuk membuat SMF jika Anda belum memilikinya. Pada armada yang dikelola layanan (SMF), Unreal Engine dan adaptor tersedia secara otomatis menggunakan saluran deadline-cloud conda dengan lingkungan antrian default. Anda siap untuk memulai rendering. Lanjutkan dengan Mengirimkan render pengujian di bawah ini untuk mengirimkan pekerjaan render tes.

Membuat armada yang dikelola pelanggan (CMF)

Mengirimkan render pengujian

Contoh ini menggunakan Demo Meerkat dari Unreal Marketplace:

Menyiapkan pekerja armada yang dikelola pelanggan (CMF)

Bagian ini memandu Anda untuk menyiapkan instans Amazon EC2 sebagai pekerja CMF untuk Deadline Cloud dengan Unreal Engine.

Ikhtisar

Berikut ini adalah perbedaan utama antara CMF dan SMF:

Memilih cabang Anda

Pilih cabang yang sesuai untuk penerapan Anda:

Penyiapan instans Amazon EC2

Berikut ini adalah konfigurasi instance yang direkomendasikan:

Instalasi perangkat lunak

1. Instal Unreal Engine:

2. Instal driver NVIDIA GRID:

Menginstal alat build

Plugin Unreal saat ini harus dikompilasi secara lokal.

Tenggat waktu instalasi perangkat lunak Cloud

Kloning atau unduh deadline-cloud-for-unreal-engine dari cabang rilis atau jalur utama. Pastikan pustaka versi pekerja Anda kompatibel dengan versi yang digunakan dari pengirim Anda.

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

Opsional - Bangun dan instal plugin dan dependensi dengan skrip:

Skrip pembantu ada scripts/build_plugin.py yang dapat mengotomatiskan langkah-langkah instalasi yang tersisa. Ini mencoba menemukan versi terbaru Unreal, membangun dependensi plugin dan python Anda, dan menginstalnya di lokasi yang benar. Pengaturan seperti versi Unreal yang akan digunakan dapat diganti. Untuk melihat daftar bantuan lengkap, jalankan:

python scripts/build_plugin.py -h

Untuk membuat dan menginstal salinan Anda saat ini deadline-cloud-for-unreal-engine sebagai pekerja dengan instalasi Unreal Engine terbaru, jalankan:

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

Konfigurasikan agen pekerja Deadline Cloud dengan menjalankan:

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

Jika Anda telah menginstal dengan skrip ini dan mengonfigurasi agen pekerja berhasil, Anda dapat melompat keMemulai layanan agen pekerja Deadline Cloud.

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

Versi adaptor yang benar harus diinstal tergantung pada versi pengirim yang digunakan. Jika Anda menggunakan versi pengirim dari cabang rilis di GitHub, Anda cukup menginstal dengan pip:

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

Jika Anda menggunakan mainline atau versi custom in-development dari submitter, untuk menghindari masalah kompatibilitas, sebaiknya Anda membuat dan menginstal dari versi kode yang sama atau mentransfer .whl file dari build submitter Anda:

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

Membangun plugin

Sesuaikan dua jalur pertama di bawah ini berdasarkan di mana instalasi Unreal Anda hidup, dan di mana Anda menginstaldeadline-cloud-for-unreal-engine.

Dari folder Unreal Install Batchfiles (packageparameternya bisa berupa direktori baru, namun Anda ingin dipanggil UnrealDeadlineCloudService nanti):

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"

Salin folder “paket” di atas ke folder Plugin instalasi Unreal Anda (misalnya,C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService).

pywin32

Versi Python Unreal akan membutuhkan pywin32. Pip install menggunakan salinan instalasi Python pihak ketiga Unreal:

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

Memulai layanan agen pekerja Deadline Cloud

Pada instance pekerja CMF Anda:

Perforce manajemen kredensial

Bagian ini mencakup manajemen kredensi yang aman untuk mengintegrasikan Perforce dengan pekerja Deadline Cloud.

Ikhtisar

Ada beberapa pendekatan untuk mengonfigurasi kredensi Perforce untuk pekerja Deadline Cloud. Setiap metode memiliki implikasi keamanan dan kasus penggunaan yang berbeda:

Dasar-dasar kredensi P4

Untuk mengambil pengaturan koneksi, termasuk URL dan port server Perforce, nama pengguna, dan kata sandi, Perforce mengikuti prioritas berikut:

Dengan prioritas ini, jika Anda memiliki pengaturan berikut:

Koneksi Perforce yang dihasilkan adalah:

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

Secrets Manager (disarankan)

Secrets Manager menyediakan solusi yang paling aman dan terukur untuk penerapan CMF dan SMF.

Pendekatan ini memberikan manfaat sebagai berikut:

Langkah 1: Buat rahasia di Secrets Manager

Buat rahasia yang berisi parameter koneksi Perforce Anda.

Pasangan nilai kunci yang diperlukan:

Contoh rahasia:

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

Untuk membuat rahasia:

Langkah 2: Berikan akses pekerja ke rahasia

Pekerja membutuhkan secretsmanager:GetSecretValue izin untuk mengakses rahasia. Ini mengikuti pola yang sama seperti mengelola rahasia pengguna pekerjaan Windows.

Untuk memberikan akses:

Variabel lingkungan kerja

Anda dapat meneruskan kredensil koneksi dalam lingkungan pekerjaan tempat pembuatan ruang kerja terjadi, misalnya di p4_sync_smf_environment, ugs_sync_smf_environment, atau lingkungan serupa untuk CMF. Atau, buat template lingkungan baru dan tambahkan ke pekerjaan Anda.

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

Pendekatan ini memiliki risiko keamanan berikut:

Variabel lingkungan antrian

Sesuai panduan pengguna Deadline Cloud, Anda dapat menggunakan lingkungan antrian untuk menyediakan aplikasi perangkat lunak, variabel lingkungan, dan sumber daya lainnya untuk pekerjaan dalam antrian. Sampel lingkungan antrian dapat ditemukan di folder queue_environment di deadline-cloud-samples.

Tambahkan lingkungan antrian menggunakan monitor atau konsol Deadline Cloud

Tambahkan lingkungan antrian menggunakan CLI

Registri Windows (hanya CMF)

Registri Windows menyediakan penyimpanan kredensi lokal pada mesin pekerja. Metode ini menggunakan sistem prioritas Perforce standar di mana kredensil disimpan di:

Pendekatan ini hanya cocok untuk penerapan CMF di mana Anda memiliki akses langsung untuk mengonfigurasi mesin pekerja.

Pre-configured pengguna admin (hanya CMF)

Buat pengguna P4 khusus untuk node render dengan koneksi yang tidak kedaluwarsa untuk menghilangkan kebutuhan untuk meneruskan data rahasia seperti nama pengguna dan kata sandi. Dalam hal ini, satu pengguna P4 khusus dapat digunakan untuk terhubung ke semua server P4, termasuk server Commit (Master) dan Edge tempat depot proyek dapat diakses.

Oleh karena itu, Anda hanya perlu melewati port untuk terhubung, jika default tidak dikonfigurasi pada pekerja. Ini dapat dicapai dengan menambahkan yang berikut di lingkungan kerja atau lingkungan antrian yang mirip dengan langkah-langkah yang didokumentasikan di atas:

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

Membuat pekerjaan render Perforce

Bagian ini memandu Anda melalui konfigurasi aset data pekerjaan Perforce-integrated render sehingga Anda dapat mengirimkan pekerjaan Perforce-integrated render ke Deadline Cloud dari Unreal Engine.

Prasyarat

Sebelum mengirimkan pekerjaan Movie Render Queue (MRQ) dari Unreal Engine di repositori Perforce:

Pengaturan proyek yang tidak nyata:

Tenggat waktu penyiapan Cloud:

Persyaratan kinerja:

Arsitektur pekerjaan render perforce

Pekerjaan render P4 memperpanjang pekerjaan render standar dengan kemampuan sinkronisasi 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

Perbedaan utama dari pekerjaan standar:

Menyiapkan komponen pekerjaan render Perforce

Ikuti langkah-langkah ini untuk membuat aset data yang diperlukan untuk pekerjaan Perforce-integrated render.

1. Buat aset data Apply Perforce Credentials

Siapkan lingkungan OpenJD untuk mengambil kredensi Perforce dari Secrets Manager dan menerapkannya ke koneksi Perforce.

Langkah-langkah konfigurasi:

2. Buat aset data lingkungan sinkronisasi Perforce

Siapkan lingkungan OpenJD untuk membuat ruang kerja Perforce, menyinkronkan file dari server Perforce, dan membersihkan ruang kerja setelah rendering.

Langkah-langkah konfigurasi:

3. Buat aset data lingkungan Perforce Launch UE

Siapkan lingkungan OpenJD untuk meluncurkan Unreal Engine dengan integrasi Perforce. Ini secara otomatis mereferensikan ruang kerja Perforce yang dibuat oleh lingkungan sinkronisasi.

Langkah-langkah konfigurasi:

4. Buat aset data langkah render Perforce

Siapkan langkah render OpenJD untuk menjalankan proses rendering.

Langkah-langkah konfigurasi:

5. Buat aset data pekerjaan render Perforce

Siapkan pekerjaan render OpenJD yang mengatur seluruh alur kerja rendering.

Langkah-langkah konfigurasi:

Praktik terbaik

Pre-submission daftar periksa

Optimalisasi kinerja

Konfigurasi ukuran potongan:

Pertimbangkan optimasi tambahan berikut:

Pemantauan dan debugging

Pemecahan masalah

Masalah dan solusi umum

Langkah debug

Persyaratan host khusus

Bagian ini menjelaskan cara membuat dan menggunakan persyaratan host khusus untuk rendering Deadline Cloud di Unreal Engine.

Ikhtisar

Persyaratan host menentukan armada mana yang memenuhi syarat untuk menjalankan langkah render tertentu. Mereka disimpan di dalam UDeadlineCloudHostRequirements aset, yang kemudian direferensikan oleh DeadlineCloudRenderStep aset.

Langkah 1: Buat aset persyaratan host

Langkah 2: Muat template YAMAL default

Ini memuat persyaratan dasar seperti CPU, Memori, GPU, OS, dan arsitektur.

Langkah 3: Konfigurasikan persyaratan dasar (sistem)

Jika Max = 0, maka tidak ada batas atas untuk persyaratan itu.

Langkah 4: Tambahkan persyaratan jumlah khusus

Digunakan ketika persyaratan numerik (misalnya, jumlah lisensi, batas konkurensi).

Langkah 5: Tambahkan persyaratan atribut khusus

Digunakan untuk memfilter pekerja berdasarkan tag dan label.

Langkah 6: Visibilitas di MRQ (opsional)

Setiap entri persyaratan memiliki ikon mata.

Pengaturan ini berguna untuk menyederhanakan UI bagi artis sambil mempertahankan kendala teknis.

Langkah 7: Lampirkan persyaratan ke langkah render

Semua pengiriman MRQ menggunakan langkah ini sekarang menerapkan logika pemilihan host Anda.

Ringkasan

Dengan menggunakan aset persyaratan host, Anda dapat:

Pengaturan ini meningkatkan konsistensi perutean pekerjaan dan memastikan rendering terjadi pada perangkat keras yang benar.

Konfigurasi lanjutan

Service-managed armada vs armada yang dikelola pelanggan

Service-managed armada (SMF)

Pada armada yang dikelola layanan, Unreal Engine dan adaptor tersedia secara otomatis menggunakan saluran deadline-cloud conda dengan lingkungan antrian default. Pengaturan ini memberikan pengalaman termudah.

Customer-managed armada (CMF)

Untuk armada yang dikelola pelanggan, Unreal Engine dan adaptor harus dipasang secara manual pada host pekerja. Pengaturan ini memberikan lebih banyak kontrol dan mendukung fitur tambahan seperti integrasi Perforce. Untuk petunjuk mendetail, lihat Menyiapkan pekerja armada yang dikelola pelanggan (CMF).

Fitur rendering Unreal Engine

Sistem rendering Unreal Engine memberikan dukungan komprehensif untuk:

Semua fitur rendering secara otomatis terdeteksi dan dikonfigurasi oleh pengirim terintegrasi Unreal Engine. Adaptor mempertahankan penanganan dependensi yang tepat dan mendukung rendering multi-shot yang efisien tanpa memulai ulang Unreal Engine.

Sumber daya sumber terbuka

Pengirim dan adaptor bersifat open source dan tersedia di: GitHub