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.

Motor épico de Unreal

Unreal Engine es una herramienta de creación 3D en tiempo real que ofrece imágenes fotorrealistas y experiencias inmersivas. Unreal Engine es compatible con Deadline Cloud e incluye herramientas de envío, paquetes conda y un adaptador para aumentar el rendimiento de 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 varias máquinas.

Descripción general del soporte

Unreal Engine es compatible con los siguientes componentes:

Compatibilidad entre versiones de Unreal Engine

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

Canal Deadline Cloud Conda

En la siguiente tabla se enumeran todos los paquetes de 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 en la que 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 Windows, te recomendamos que habilites la compatibilidad con rutas largas de Windows. Para ello, sigue las instrucciones de la página de 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 viene configurada para admitir rutas largas de Windows. Cuando configures a tus trabajadores, sigue los pasos que se indican en el problema vinculado para que las rutas largas de Windows sean totalmente compatibles con las rutas largas hasta que se resuelva el problema.

Instalación de herramientas de compilación

El complemento Unreal Submitter actualmente debe compilarse localmente.

Instalación del monitor Deadline Cloud

El monitor Deadline Cloud se usa tanto para administrar tus credenciales para enviar trabajos a Deadline Cloud como para monitorear el estado de tus 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, en función 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

Un script auxiliar automatiza scripts/build_plugin.py opcionalmente los dos pasos siguientes. Intenta encontrar la versión más reciente de Unreal, crea las dependencias de Python y complementos 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 crear 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 instalado este script correctamente, puedes ir directamente a. Crear una flota

Crea el plugin

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

Desde la carpeta Batchfiles de instalación de Unreal (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 necesarias.

1. Si has creado e instalado el plugin desde la rama de lanzamiento 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 (siguiendo los pasos anterioresC:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService\UnrealDeadlineCloudService.uplugin) 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 lo utilizas desde la línea principal, es posible que tengas dependencias de Python que aún no se hayan publicado en PyPI; tendrás que compilar e instalar tu copia local, lo que puedes hacer con hatch. Será necesario cambiar el .whl archivo para que refleje la versión generada por 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 del remitente puede instalar las dependencias de Python. Es posible que no estén actualizados con el código anterior de la rama principal o de la versión original, y este método no debería preferirse actualmente.

Notificaciones de actualización

El complemento de envío 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 que 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, puedes 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 tienes una flota de Windows y no necesitas configurar una nueva, puedes 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 administradas 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 https://docs.aws.amazon.com/deadline-cloud/latest/userguide/create-queue-environment.html#conda-queue-environment Ya está listo para empezar a renderizar. Continúe con lo que Enviar un renderizado de prueba se indica a continuación para enviar un trabajo de renderizado de prueba.

Crear una flota gestionada por el cliente (CMF)

Enviar un renderizado de prueba

En este ejemplo, se usa la demo de Meerkat de Unreal Marketplace:

Configurar un trabajador de flota gestionado por el cliente (CMF)

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

Descripción general de

Las siguientes son las diferencias clave entre CMF y SMF:

Cómo elegir tu sucursal

Seleccione la sucursal adecuada para su implementación:

Configuración de la instancia Amazon EC2

La siguiente es la configuración de instancia recomendada:

Instalar el software

1. Instale Unreal Engine:

2. Instale los controladores NVIDIA GRID:

Instalación de herramientas de compilación

El complemento Unreal actualmente debe compilarse localmente.

Instalación del software Deadline Cloud

Clone o deadline-cloud-for-unreal-engine descárguelo 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 sus 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 los complementos y las dependencias con un script:

Existe un script auxiliar scripts/build_plugin.py que puede automatizar los pasos de instalación restantes. Intenta encontrar la última versión de Unreal, crear las dependencias de plugins y 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 crear e instalar tu copia actual de deadline-cloud-for-unreal-engine as a worker 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 según la versión del remitente que se utilice. Si está utilizando la versión del remitente de la rama de lanzamiento GitHub, simplemente puede instalarlo con pip:

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

Si utilizas la versión principal del remitente o una versión personalizada en desarrollo, 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 versión de tu remitente:

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

Creando el complemento

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

Desde la carpeta Batchfiles de instalación de Unreal (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 con 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 su instancia de trabajador de CMF:

Impulse la administración de credenciales

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 la siguiente prioridad:

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 las implementaciones de CMF y SMF.

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

Paso 1: Crea un secreto en Secrets Manager

Crea un secreto que contenga tus parámetros de conexión de Perforce.

Pares clave-valor requeridos:

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 cuando se administran los secretos de usuario de los trabajos de Windows.

Para conceder el acceso:

Variables de entorno de los trabajos

Puede transferir las credenciales de conexión desde el 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. https://github.com/aws-deadline/deadline-cloud-for-unreal-engine/blob/mainline/src/unreal_plugin/Content/Python/openjd_templates/ugs/ugs_sync_smf_environment.yml También puedes crear una nueva plantilla de entorno y añadirla a tu 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 utilizar los entornos de cola para proporcionar aplicaciones de software, variables de entorno y otros recursos a los trabajos en cola. Puedes encontrar ejemplos de entornos de cola en la carpeta queue_environments de deadline-cloud-samples.

Agregue un entorno de colas mediante el monitor o la consola de Deadline Cloud

Agregue un entorno de colas mediante la CLI

Registro de Windows (solo CMF)

El registro de Windows proporciona un 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 en CMF)

Cree un usuario P4 dedicado para los nodos de renderizado con una conexión que no caduque para eliminar la necesidad de transmitir datos secretos, como nombres de usuario y contraseñas. En este caso, se puede usar un único usuario P4 dedicado para conectarse a todos los servidores P4, incluidos los servidores Commit (Master) y Edge, donde se puede acceder al almacén de proyectos.

Por lo tanto, solo es necesario pasar el puerto al que conectarse, si el puerto predeterminado no está configurado para los trabajadores. Puede pasar el puerto añadiendo lo siguiente en el entorno de trabajo o en el entorno de cola, de forma similar a los pasos documentados anteriormente:

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

Crear un trabajo de renderizado de Perforce

En esta sección se explica cómo configurar los activos de datos de los trabajos de Perforce-integrated renderizado para que puedas 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 forzosos:

Arquitectura de trabajos de renderizado forzoso

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:

Cómo se adapta Perforce Sync a los proyectos de producción

Los proyectos de producción de Unreal Engine pueden alcanzar cientos de gigabytes en decenas de miles de archivos. La Perforce integración mantiene el tiempo de sincronización proporcional a los cambios y no al tamaño del proyecto:

Para aprovechar la reutilización del espacio de trabajo de los clientes en una flota gestionada por servicios, habilite el almacenamiento persistente para que el volumen que contiene el espacio de trabajo sincronizado se vuelva a conectar a los futuros trabajadores.

Si la ruta de red entre la región de la flota y el Perforce servidor tiene un rendimiento bajo o una latencia alta, un servidor Perforce periférico de la región de la flota puede actuar como caché regional para los datos del almacén. Para obtener más información, consulte el control de código fuente de Perforce en la guía para desarrolladores de Deadline Cloud.

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 el 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 Perforce Sync

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

Pasos de configuración:

3. Cree el activo de datos ambientales de 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 el activo de datos de pasos de renderizado 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:

Enviar los resultados de renderizado a Perforce

De forma predeterminada, un trabajo de Perforce renderizado carga los resultados únicamente a través de los archivos adjuntos del trabajo. En su Perforce lugar, el parámetro de SubmitMode trabajo opta por insertar los resultados renderizados, de modo que los fotogramas terminados se guardan en el almacén junto con el proyecto.

Solo los archivos que han cambiado desde la última sincronización terminan en la lista de cambios. Cada tarea reconcilia los archivos exactos que generó y la integración revierte los archivos cuyo contenido es idéntico al de la revisión del almacén, por lo que volver a renderizar un marco sin cambios no produce ninguna entrada en la lista de cambios.

Configure a sus trabajadores para que se autentiquen con el Perforce mismo Perforce usuario en todas las tareas de un trabajo, ya que en la etapa de agregación se encuentran las listas de tareas por propietario. La configuración de credenciales recomendadaImpulse la administración de credenciales, un único secreto compartido en Secrets Manager, ya cumple ese requisito.

Prácticas recomendadas

Pre-submission lista de verificación

Optimización del rendimiento

En la tabla siguiente se muestra cómo afecta la ShotsPerTask configuración al rendimiento:

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 los requisitos de host personalizados para el renderizado de Deadline Cloud en Unreal Engine.

Descripción general de

Los requisitos del anfitrión 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: Crea 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 un límite superior para ese requisito.

Paso 4: Agregue requisitos de cantidad personalizados

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

Paso 5: Añadir requisitos de atributos personalizados

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

Paso 6: Visibilidad en MRQ (opcional)

Cada entrada de requisito tiene un icono con forma de ojo.

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

Paso 7: Adjunte los requisitos a un paso de renderizado

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

Resumen

Con el recurso relativo a los requisitos del anfitrión, puede:

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

Configuraciones avanzadas

Service-managed Flotas frente a flotas administradas 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 cola predeterminado. Esta configuración proporciona la experiencia más sencilla.

Customer-managed flotas (CMF)

En el caso de las flotas administradas por los clientes, 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 trabajador de flota gestionado por el cliente (CMF).

Funciones de renderizado de Unreal Engine

El sistema de renderizado de Unreal Engine brinda soporte integral para:

El remitente integrado de Unreal Engine detecta y configura automáticamente todas las funciones de renderizado. El adaptador mantiene una gestión adecuada de las dependencias y admite una renderización 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