Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Epic Unreal Engine

Unreal Engine es una herramienta de creación 3D en tiempo real para imágenes fotorrealistas y experiencias inmersivas. Deadline Cloud es compatible con Unreal Engine e incluye remitentes, paquetes conda y un adaptador para aumentar el rendimiento del renderizado. Esta guía proporciona instrucciones paso a paso para usar Deadline Cloud con Unreal Engine para renderizar tus proyectos de Movie Render Queue de forma más rápida distribuyendo las tareas de renderizado entre varios equipos.

Descripción general de Support

Unreal Engine es compatible con los siguientes componentes:

Compatibilidad con las versiones de Unreal Engine

La siguiente tabla muestra los niveles de soporte actuales para las versiones de Unreal Engine:

Canal Deadline Cloud Conda

La siguiente tabla muestra todos los paquetes conda aplicables a Unreal Engine disponibles para Service-managed las flotas del canal conda: deadline-cloud

Introducción

Requisitos previos

Antes de instalar el remitente de Unreal Engine, asegúrate de tener lo siguiente:

Instalación del remitente

El remitente de Unreal Engine añade la funcionalidad de Deadline Cloud como complemento a Unreal Engine, lo que te permite enviar tus trabajos de Movie Render Queue directamente a Deadline Cloud para su renderización.

¿Cómo elegir tu sucursal?

Seleccione la sucursal adecuada para su implementación:

Crear una nueva instancia Amazon EC2 de Windows para instalar Unreal (opcional)

Si estás configurando una instancia nueva de Windows Amazon Elastic Compute Cloud (Amazon EC2) como remitente, una instancia g5.2xlarge con 200 GB de almacenamiento es un mínimo razonable:

Rutas largas de Windows

Muchos de los pasos que se indican a continuación pueden crear archivos que superen la longitud de ruta máxima predeterminada de Windows. Antes de crear e instalar el remitente o adaptador de Deadline Cloud para Unreal Engine en un equipo con Windows, le recomendamos que habilite la compatibilidad con Windows long Path. Para ello, sigue las instrucciones de la página Limitación máxima de rutas de archivo, por ejemplo, ejecutando el PowerShell comando.

También hay un problema pendiente en el agente de trabajo causado por una dependencia que no se envía configurada para admitir rutas largas de Windows. Cuando configure sus trabajadores, siga los pasos de solución alternativa del problema vinculado para que sean totalmente compatibles con las rutas largas de Windows hasta que se resuelva el problema.

Instalación de herramientas de compilación

Actualmente, el complemento de envío de Unreal debe compilarse localmente.

Instalación del monitor Deadline Cloud

El monitor de Deadline Cloud se usa tanto para administrar sus credenciales para enviar trabajos a Deadline Cloud como para monitorear el estado de sus trabajos.

Configuración del entorno

Instalación del software Deadline Cloud

Clona o descarga deadline-cloud-for-unreal-engine desde la rama de lanzamiento o desde la línea principal, dependiendo de si quieres la versión probada más reciente o todas las confirmaciones más recientes.

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

Opcional: crea e instala el plugin con un script

scripts/build_plugin.pyOpcionalmente, un script auxiliar automatiza los dos pasos siguientes. Intenta encontrar la última versión de Unreal, crea tu complemento y las dependencias de Python y las instala en las ubicaciones correctas. Puedes anular ajustes como la versión de Unreal. Para ver la lista de ayuda completa, ejecuta:

python scripts/build_plugin.py -h

Para compilar e instalar tu copia actual de deadline-cloud-for-unreal-engine como remitente con la última instalación de Unreal Engine, ejecuta:

python scripts/build_plugin.py --install

Si has realizado la instalación con este script correctamente, puedes pasar a. Crear una flota

Crea el complemento

Ajusta las dos primeras rutas que aparecen a continuación en función de dónde se encuentre tu instalación de Unreal y dónde la hayas instaladodeadline-cloud-for-unreal-engine.

Desde la carpeta Unreal Install Batchfiles (el package parámetro puede ser cualquier directorio nuevo, pero querrás que se llame más adelante): 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"

Copia la carpeta «paquete» de arriba a la carpeta de complementos de tu instalación de Unreal (por ejemplo,). C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService

Dependencias de Python

Hay 4 formas de instalar las dependencias de Python requeridas.

1. Si has creado e instalado el plugin desde la rama de versiones anterior, puedes instalarlo desde pip. Usa el siguiente comando de instalación para ajustar las rutas a tu instalación de 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. Como alternativa, en tu .uplugin archivo (en los pasos anteriores se ubicaría C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService\UnrealDeadlineCloudService.uplugin aquí) puedes añadir una PythonRequirements sección que coincida con la última versión de deadline-cloud-for-unreal-engine in GitHub/PyPI, por ejemplo:

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

Es posible que desees desactivar la función de «hash estricto» en la configuración de Python de Unreal o añadir una configuración de hash para las versiones específicas de bibliotecas y dependencias que desees consumir.

3. Si utilizas la versión principal, es posible que tengas dependencias de Python que aún no estén disponibles en PyPI; tendrás que crear e instalar tu copia local, lo que se puede hacer con hatch. Será necesario cambiar el .whl archivo para que refleje la versión que genera 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. Por último, el instalador remitente puede instalar las dependencias de Python. Es posible que no estén actualizados con el código anterior de la versión o de la rama principal, y actualmente no debería preferirse este método.

Actualiza las notificaciones

El complemento remitente comprueba automáticamente si hay versiones más recientes GitHub cuando se inicia Unreal Editor. Si hay una actualización disponible, aparecerá un cuadro de diálogo en el que se te pedirá que visites la página de lanzamiento.

Para desactivar las notificaciones de actualización, desmarca Mostrar las notificaciones de actualización del remitente en la sección Configuración general del panel de configuración de Deadline Cloud (Edición > Configuración del proyecto > Plugins > Deadline Cloud).

Como alternativa, puede usar la CLI:

deadline config set settings.submitter_update_notification false

Para volver a habilitarla:

deadline config set settings.submitter_update_notification true

Crear una flota

Si ya tiene una flota de Windows y no necesita configurar una nueva, puede ir directamente aEnviar un renderizado de prueba.

Crear una flota gestionada por servicios (SMF)

Sigue la guía del usuario de flotas gestionadas por servicios para crear una SMF si aún no tienes una. En las flotas gestionadas por servicios (SMF), el Unreal Engine y el adaptador están disponibles automáticamente mediante el canal conda con el entorno de colas predeterminado. deadline-cloud Ya está listo para empezar a renderizar. Continúe con lo Enviar un renderizado de prueba siguiente para enviar un trabajo de renderizado de prueba.

Creación de una flota gestionada por el cliente (CMF)

Enviar un renderizado de prueba

En este ejemplo se utiliza la demo de Meerkat de Unreal Marketplace:

Configurar un empleado de una flota gestionada por el cliente (CMF)

En esta sección, se explica cómo configurar una instancia de Amazon EC2 como servidor de CMF para Deadline Cloud con Unreal Engine.

Descripción general de

Las principales diferencias entre CMF y SMF son las siguientes:

¿Cómo elegir tu sucursal

Seleccione la sucursal adecuada para su implementación:

Configuración de instancias de Amazon EC2

La siguiente es la configuración de instancias recomendada:

Instalar el software

1. Instale Unreal Engine:

2. Instale los controladores NVIDIA GRID:

Instalación de herramientas de compilación

Actualmente, el complemento Unreal debe compilarse localmente.

Instalación del software Deadline Cloud

Clona o descarga deadline-cloud-for-unreal-engine desde la rama de lanzamiento o desde la línea principal. Asegúrese de que su versión de trabajo de las bibliotecas sea compatible con la versión que utilizan los remitentes.

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

Opcional: crea e instala el complemento y las dependencias con un script:

Existe un script auxiliar scripts/build_plugin.py que puede automatizar el resto de los pasos de instalación. Intenta encontrar la última versión de Unreal, crear tu complemento y las dependencias de Python e instalarlas en las ubicaciones correctas. Se pueden anular ajustes como la versión de Unreal que se va a utilizar. Para ver la lista de ayuda completa, ejecuta:

python scripts/build_plugin.py -h

Para compilar e instalar tu copia actual de deadline-cloud-for-unreal-engine como usuario con la última instalación de Unreal Engine, ejecuta:

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

Configura el agente de trabajo de Deadline Cloud ejecutando:

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

Si lo instalaste con este script y configuraste el agente de trabajo correctamente, puedes pasar aInicio del servicio de agentes de trabajo de Deadline Cloud.

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

Se debe instalar la versión correcta del adaptador en función de la versión del remitente que se utilice. Si está utilizando la versión del remitente de la rama de lanzamiento de GitHub, simplemente puede instalarla con pip:

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

Si utilizas la versión principal o una versión personalizada en desarrollo del remitente, para evitar problemas de compatibilidad, te recomendamos que compiles e instales desde la misma versión de código o que transfieras el .whl archivo desde la compilación del remitente:

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

Compilando el complemento

Ajusta las dos primeras rutas que aparecen a continuación en función de dónde se encuentre tu instalación de Unreal y dónde la hayas instaladodeadline-cloud-for-unreal-engine.

Desde la carpeta Unreal Install Batchfiles (el package parámetro puede ser cualquier directorio nuevo, pero querrás que se llame más adelante): 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"

Copia la carpeta «paquete» de arriba a la carpeta de complementos de tu instalación de Unreal (por ejemplo,). C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService

pywin32

La versión de Python de Unreal necesitará pywin32. Instalación de Pip mediante una copia de la instalación de Python de terceros de Unreal:

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

Inicio del servicio de agentes de trabajo de Deadline Cloud

En tu instancia de CMF Worker:

Administración de credenciales de Perforce

Esta sección trata sobre la gestión segura de credenciales para integrar Perforce con los trabajadores de Deadline Cloud.

Descripción general de

Existen varios enfoques para configurar las credenciales de Perforce para los trabajadores de Deadline Cloud. Cada método tiene diferentes implicaciones de seguridad y casos de uso:

Conceptos básicos sobre las credenciales P4

Para recuperar la configuración de conexión, incluidos la URL y el puerto del servidor Perforce, el nombre de usuario y la contraseña, Perforce sigue las siguientes prioridades:

Con estas prioridades, si tiene la siguiente configuración:

La conexión Perforce resultante será:

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

Secrets Manager (recomendado)

Secrets Manager proporciona la solución más segura y escalable para despliegues de CMF y SMF.

A continuación, se enumeran las ventajas de este enfoque:

Paso 1: Crear un secreto en Secrets Manager

Cree un secreto que contenga los parámetros de conexión de Perforce.

Pares clave-valor necesarios:

Ejemplo de secreto:

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

Para crear el secreto:

Paso 2: Otorgue al trabajador acceso al secreto

Los trabajadores necesitan secretsmanager:GetSecretValue permiso para acceder al secreto. Esto sigue el mismo patrón que la administración de los secretos de los usuarios de los trabajos de Windows.

Para conceder el acceso:

Variables de entorno de los trabajos

Puede transferir las credenciales de conexión al entorno de trabajo en el que se crea el espacio de trabajo, por ejemplo, en p4_sync_smf_environment, ugs_sync_smf_environment o entornos similares para CMF. Como alternativa, cree una nueva plantilla de entorno y añádala a su trabajo.

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

Este enfoque presenta los siguientes riesgos de seguridad:

Variables de entorno de cola

Según la guía del usuario de Deadline Cloud, puede usar entornos de colas para proporcionar aplicaciones de software, variables de entorno y otros recursos a los trabajos en cola. Puedes encontrar ejemplos de entornos de colas en la carpeta queue_environments de deadline-cloud-samples.

Añada un entorno de colas mediante el monitor o la consola de Deadline Cloud

Agregar un entorno de colas mediante CLI

Registro de Windows (solo CMF)

El registro de Windows proporciona almacenamiento local de credenciales en las máquinas de trabajo. Este método utiliza el sistema de prioridades estándar de Perforce, en el que las credenciales se almacenan en:

Este enfoque solo es adecuado para las implementaciones de CMF en las que se tiene acceso directo para configurar las máquinas de trabajo.

Pre-configured usuario administrador (solo CMF)

Cree un usuario de P4 dedicado a los nodos de renderización con una conexión que no caduque para eliminar la necesidad de pasar datos secretos, como nombres de usuario y contraseñas. En este caso, se puede utilizar un único usuario P4 dedicado para conectarse a todos los servidores P4, incluidos los servidores Commit (Master) y Edge, donde se puede acceder al depósito del proyecto.

Por lo tanto, solo tendrá que pasar por el puerto al que conectarse si el puerto predeterminado no está configurado para los trabajadores. Esto se puede lograr añadiendo lo siguiente en el entorno de trabajo o en el entorno de colas, de forma similar a los pasos descritos anteriormente:

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

Crear un trabajo de renderizado Perforce

En esta sección se explica cómo configurar los activos de datos de los trabajos de Perforce-integrated renderizado para que pueda enviar los trabajos de Perforce-integrated renderizado a Deadline Cloud desde Unreal Engine.

Requisitos previos

Antes de enviar un trabajo de Movie Render Queue (MRQ) desde Unreal Engine a un repositorio de Perforce:

Configuración del proyecto Unreal:

Configuración de Deadline Cloud:

Requisitos de Perforce:

Arquitectura de trabajos de renderizado de Perforce

Los trabajos de renderizado P4 amplían el trabajo de renderizado estándar con las capacidades de sincronización de 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

Diferencias clave con respecto a los trabajos estándar:

Configuración de los componentes del trabajo de renderizado de Perforce

Siga estos pasos para crear los activos de datos necesarios para los trabajos de Perforce-integrated renderizado.

1. Cree un activo de datos de Apply Perforce Credentials

Configure un entorno OpenJD para recuperar las credenciales de Perforce de Secrets Manager y aplicarlas a la conexión de Perforce.

Pasos de configuración:

2. Cree un activo de datos del entorno de sincronización Perforce

Configure un entorno OpenJD para crear un espacio de trabajo Perforce, sincronizar los archivos del servidor Perforce y limpiar el espacio de trabajo después del renderizado.

Pasos de configuración:

3. Cree un activo de datos del entorno Perforce Launch UE

Configure un entorno OpenJD para lanzar Unreal Engine con la integración de Perforce. Esto hace referencia automáticamente al espacio de trabajo de Perforce creado por el entorno de sincronización.

Pasos de configuración:

4. Cree un activo de datos escalonado de Perforce

Configure un paso de renderizado de OpenJD para ejecutar el proceso de renderizado.

Pasos de configuración:

5. Cree un activo de datos de trabajos de renderizado de Perforce

Configure un trabajo de renderizado de OpenJD que organice todo el flujo de trabajo de renderizado.

Pasos de configuración:

Prácticas recomendadas

Pre-submission lista de verificación

Optimización del rendimiento

Configuración del tamaño del fragmento:

Tenga en cuenta las siguientes optimizaciones adicionales:

Monitoreo y depuración

Resolución de problemas

Problemas y soluciones comunes de

Pasos de depuración

Requisitos de host personalizados

En esta sección se describe cómo crear y usar requisitos de host personalizados para el renderizado de Deadline Cloud en Unreal Engine.

Descripción general de

Los requisitos de alojamiento definen qué flota es apta para ejecutar un paso de renderizado en particular. Se almacenan dentro de un UDeadlineCloudHostRequirements activo, al que luego hace referencia un DeadlineCloudRenderStep activo.

Paso 1: Crear el activo de requisitos del anfitrión

Paso 2: carga la plantilla YAML predeterminada

Esto carga los requisitos básicos como la CPU, la memoria, la GPU, el sistema operativo y la arquitectura.

Paso 3: Configurar los requisitos básicos (del sistema)

Si Max = 0, entonces no hay límite superior para ese requisito.

Paso 4: Añadir requisitos de importe personalizados

Se utiliza cuando el requisito es numérico (por ejemplo, número de licencias, límites de simultaneidad).

Paso 5: Añadir requisitos de atributos personalizados

Se utiliza para filtrar a los trabajadores en función de etiquetas y rótulos.

Paso 6: Visibilidad en MRQ (opcional)

Cada entrada obligatoria tiene un icono en forma de ojo.

Esta configuración es útil para simplificar la interfaz de usuario para los artistas y, al mismo tiempo, preservar las limitaciones técnicas.

Paso 7: Adjunte los requisitos a un paso de renderizado

Todos los envíos de MRQ que utilizan este paso ahora aplican tu lógica de selección de anfitriones.

Resumen

Con el recurso de requisitos del anfitrión, puede:

Esta configuración mejora la coherencia del enrutamiento de los trabajos y garantiza que el renderizado se realice en el hardware correcto.

Configuraciones avanzadas

Service-managed flotas frente a flotas gestionadas por el cliente

Service-managed flotas (SMF)

En las flotas gestionadas por servicios, el Unreal Engine y el adaptador están disponibles automáticamente mediante el canal deadline-cloud conda con el entorno de colas predeterminado. Esta configuración proporciona la experiencia más sencilla.

Customer-managed flotas (CMF)

En el caso de las flotas gestionadas por el cliente, Unreal Engine y el adaptador deben instalarse manualmente en los hosts de los trabajadores. Esta configuración proporciona más control y admite funciones adicionales, como la integración con Perforce. Para obtener instrucciones detalladas, consulte Configurar un empleado de una flota gestionada por el cliente (CMF).

Funciones de renderizado de Unreal Engine

El sistema de renderizado de Unreal Engine ofrece un soporte integral para:

El remitente integrado de Unreal Engine detecta y configura automáticamente todas las funciones de renderizado. El adaptador mantiene un manejo adecuado de las dependencias y permite un renderizado eficiente de múltiples tomas sin necesidad de reiniciar Unreal Engine.

Recursos de código abierto

El remitente y el adaptador son de código abierto y están disponibles en: GitHub