As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Motor Epic Unreal

O Unreal Engine é uma ferramenta de criação 3D em tempo real para visuais fotorreais e experiências imersivas. O Unreal Engine é compatível com o Deadline Cloud com remetentes, pacotes conda e um adaptador para maior desempenho de renderização. Este guia fornece instruções passo a passo para usar o Deadline Cloud com o Unreal Engine para renderizar seus projetos do Movie Render Queue mais rapidamente, distribuindo tarefas de renderização em várias máquinas.

Visão geral do Support

O Unreal Engine é compatível com os seguintes componentes:

Compatibilidade da versão do Unreal Engine

A tabela a seguir mostra os níveis de suporte atuais para as versões do Unreal Engine:

Canal Deadline Cloud Conda

A tabela a seguir lista todos os pacotes conda aplicáveis ao Unreal Engine disponíveis para Service-managed frotas no canal condadeadline-cloud:

Introdução

Pré-requisitos

Antes de instalar o remetente do Unreal Engine, verifique se você tem o seguinte:

Instalando o remetente

O remetente do Unreal Engine adiciona a funcionalidade do Deadline Cloud como um plug-in ao Unreal Engine, permitindo que você envie seus trabalhos do Movie Render Queue diretamente para o Deadline Cloud para renderização.

Escolhendo sua filial

Selecione a ramificação apropriada para sua implantação:

Criação de uma nova instância do Windows Amazon EC2 para instalar o Unreal (opcional)

Se você estiver configurando uma nova instância do Windows Amazon Elastic Compute Cloud (Amazon EC2) como remetente, uma instância g5.2xlarge com 200 GB de armazenamento é o mínimo razoável:

Caminhos longos do Windows

Muitas das etapas abaixo podem criar arquivos que excedam o tamanho máximo padrão do caminho do Windows. Antes de criar e instalar o remetente ou adaptador do Deadline Cloud for Unreal Engine em uma máquina Windows, recomendamos que você habilite o suporte a caminhos longos do Windows. Para fazer isso, siga as instruções na página Limitação máxima do caminho do arquivo, por exemplo, executando o PowerShell comando.

Também há um problema aberto no agente de trabalho causado por uma dependência que não é fornecida configurada para oferecer suporte a caminhos longos do Windows. Ao configurar seus trabalhadores, siga as etapas de solução alternativa no problema vinculado para oferecer suporte total aos caminhos longos do Windows até que o problema seja resolvido.

Instalando ferramentas de compilação

Atualmente, o plug-in Unreal submitter deve ser compilado localmente.

Instalando o monitor Deadline Cloud

O monitor Deadline Cloud é usado para gerenciar suas credenciais para enviar trabalhos para o Deadline Cloud e monitorar o status de seus trabalhos.

Configuração do ambiente

Instalação do software Deadline Cloud

Clone ou baixe deadline-cloud-for-unreal-engine da ramificação de lançamento ou da linha principal, dependendo se você deseja a versão testada mais recente ou todos os commits mais recentes.

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

Opcional - Crie e instale o plug-in com script

scripts/build_plugin.pyOpcionalmente, um script auxiliar automatiza as próximas duas etapas. Ele tenta encontrar a versão mais recente do Unreal, cria seu plug-in e dependências do Python e os instala nos locais corretos. Você pode substituir configurações como a versão Unreal. Para ver a lista de ajuda completa, execute:

python scripts/build_plugin.py -h

Para criar e instalar sua cópia atual de deadline-cloud-for-unreal-engine como remetente com a instalação mais recente do Unreal Engine, execute:

python scripts/build_plugin.py --install

Se você instalou esse script com sucesso, pode pular paraCriação de uma frota.

Crie o plug-in

Ajuste os dois primeiros caminhos abaixo com base em onde está sua instalação do Unreal e onde você instaloudeadline-cloud-for-unreal-engine.

Na pasta Unreal Install Batchfiles (o package parâmetro pode ser qualquer novo diretório, mas você desejará que ele seja chamado UnrealDeadlineCloudService posteriormente):

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"

Copie a pasta “package” acima para a pasta Plugins da instalação do Unreal (por exemplo,C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService).

Dependências do Python

Há 4 maneiras de instalar as dependências necessárias do Python.

1. Se você construiu e instalou o plug-in a partir da ramificação de lançamento acima, você pode instalar a partir do pip. Use o seguinte comando de instalação, ajustando os caminhos para sua instalação do 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, em seu .uplugin arquivo (nas etapas acima, isso existiriaC:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService\UnrealDeadlineCloudService.uplugin), você pode adicionar uma PythonRequirements seção que corresponda à versão mais recente do deadline-cloud-for-unreal-engine in GitHub/PyPI, por exemplo:

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

Talvez você queira desativar o recurso de “hash estrito” nas configurações de Python da Unreal ou adicionar configurações de hash para versões específicas de bibliotecas e dependências que você deseja consumir.

3. Se você estiver usando a linha principal, pode ter dependências do Python que ainda não foram lançadas para o PyPI - você precisará criar e instalar sua cópia local, o que pode ser feito com o hatch. O .whl arquivo precisará ser alterado para refletir a versão gerada pelo 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 fim, as dependências do Python podem ser instaladas pelo instalador remetente. Eles podem estar desatualizados com o código acima na versão ou na ramificação principal, e esse método não deve ser preferido no momento.

Notificações de atualização

O plug-in do remetente verifica automaticamente as versões mais recentes GitHub quando o Unreal Editor é iniciado. Se uma atualização estiver disponível, uma caixa de diálogo solicitará que você visite a página de lançamento.

Para desativar as notificações de atualização, desmarque Mostrar notificações de atualização do remetente em Configurações gerais no painel de configurações do Deadline Cloud (Editar > Configurações do projeto > Plugins > Deadline Cloud).

Como alternativa, você pode usar a CLI:

deadline config set settings.submitter_update_notification false

Para reativar:

deadline config set settings.submitter_update_notification true

Criação de uma frota

Se você já tem uma frota do Windows e não precisa configurar uma nova frota, pode pular paraEnviando uma renderização de teste.

Criação de uma frota gerenciada por serviços (SMF)

Siga o guia do usuário de frotas gerenciadas por serviços para criar um SMF, caso ainda não tenha um. Em frotas gerenciadas por serviços (SMFs), o Unreal Engine e o adaptador estão automaticamente disponíveis usando o canal deadline-cloud conda com o ambiente de fila padrão. Você está pronto para começar a renderizar. Continue com o Enviando uma renderização de teste texto abaixo para enviar um trabalho de renderização de teste.

Criação de uma frota gerenciada pelo cliente (CMF)

Enviando uma renderização de teste

Este exemplo usa o Meerkat Demo do Unreal Marketplace:

Configurando um trabalhador de frota gerenciada pelo cliente (CMF)

Esta seção mostra como configurar uma instância do Amazon EC2 como um trabalhador CMF para o Deadline Cloud com o Unreal Engine.

Visão geral do

A seguir estão as principais diferenças entre CMF e SMF:

Escolhendo sua filial

Selecione a ramificação apropriada para sua implantação:

Configuração da instância do Amazon EC2

Veja a seguir a configuração de instância recomendada:

Instalação de software

1. Instale o Unreal Engine:

2. Instale os drivers NVIDIA GRID:

Instalando ferramentas de compilação

Atualmente, o plug-in Unreal deve ser compilado localmente.

Instalação do software Deadline Cloud

Clone ou baixe deadline-cloud-for-unreal-engine da ramificação de lançamento ou da linha principal. Certifique-se de que sua versão de trabalho das bibliotecas seja compatível com a versão que está sendo usada por seus remetentes.

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

Opcional - Crie e instale plug-ins e dependências com script:

Existe um script auxiliar scripts/build_plugin.py que pode automatizar as etapas restantes da instalação. Ele tenta encontrar a versão mais recente do Unreal, criar suas dependências de plug-in e python e instalá-las nos locais corretos. Configurações como a versão Unreal a ser usada podem ser substituídas. Para ver a lista de ajuda completa, execute:

python scripts/build_plugin.py -h

Para criar e instalar sua cópia atual do deadline-cloud-for-unreal-engine as a worker com a instalação mais recente do Unreal Engine, execute:

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

Configure o agente de trabalho do Deadline Cloud executando:

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

Se você instalou com esse script e configurou o agente de trabalho com êxito, pode pular paraIniciando o serviço Deadline Cloud Worker Agent.

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

A versão correta do adaptador deve ser instalada dependendo da versão do remetente que está sendo usada. Se você estiver usando a versão do remetente da ramificação de lançamento em GitHub, basta instalar com pip:

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

Se você estiver usando a linha principal ou uma versão personalizada em desenvolvimento do remetente, para evitar problemas de compatibilidade, recomendamos que você crie e instale a partir da mesma versão do código ou transfira o .whl arquivo da compilação do remetente:

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

Construindo o plugin

Ajuste os dois primeiros caminhos abaixo com base em onde está sua instalação do Unreal e onde você instaloudeadline-cloud-for-unreal-engine.

Na pasta Unreal Install Batchfiles (o package parâmetro pode ser qualquer novo diretório, mas você desejará que ele seja chamado UnrealDeadlineCloudService posteriormente):

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"

Copie a pasta “package” acima para a pasta Plugins da instalação do Unreal (por exemplo,C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService).

pywin32

A versão do Python da Unreal precisará do pywin32. Instale o Pip usando uma cópia da instalação Python de terceiros da Unreal:

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

Iniciando o serviço Deadline Cloud Worker Agent

Na sua instância de trabalho do CMF:

Gerenciamento de credenciais Perforce

Esta seção aborda o gerenciamento seguro de credenciais para integrar o Perforce aos trabalhadores do Deadline Cloud.

Visão geral do

Há várias abordagens para configurar as credenciais do Perforce para funcionários do Deadline Cloud. Cada método tem implicações de segurança e casos de uso diferentes:

Noções básicas sobre credenciais P4

Para recuperar as configurações de conexão, incluindo URL e porta do servidor Perforce, nome de usuário e senha, o Perforce segue a seguinte prioridade:

Com essas prioridades, se você tiver a seguinte configuração:

A conexão Perforce resultante será:

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

Secrets Manager (recomendado)

O Secrets Manager fornece a solução mais segura e escalável para implantações de CMF e SMF.

Essa abordagem oferece os seguintes benefícios:

Etapa 1: criar um segredo no Secrets Manager

Crie um segredo contendo seus parâmetros de conexão do Perforce.

Pares de valores-chave necessários:

Exemplo de segredo:

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

Para criar o segredo:

Etapa 2: conceder ao trabalhador acesso ao segredo

Os trabalhadores precisam de secretsmanager:GetSecretValue permissão para acessar o segredo. Isso segue o mesmo padrão do gerenciamento de segredos de usuário de tarefas do Windows.

Para conceder acesso:

Variáveis de ambiente de trabalho

Você pode passar credenciais de conexão no ambiente de trabalho em que a criação do espaço de trabalho acontece, por exemplo, em p4_sync_smf_environment, ugs_sync_smf_environment ou ambientes semelhantes para CMF. Como alternativa, crie um novo modelo de ambiente e adicione-o ao seu trabalho.

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

Essa abordagem tem os seguintes riscos de segurança:

Variáveis de ambiente de fila

De acordo com o guia do usuário do Deadline Cloud, você pode usar ambientes de fila para fornecer aplicativos de software, variáveis de ambiente e outros recursos para trabalhos na fila. Amostras do ambiente de fila podem ser encontradas na pasta queue_environments em deadline-cloud-samples.

Adicione um ambiente de fila usando o monitor ou console do Deadline Cloud

Adicionar ambiente de fila usando CLI

Registro do Windows (somente CMF)

O registro do Windows fornece armazenamento local de credenciais em máquinas de trabalho. Esse método usa o sistema de prioridade Perforce padrão, no qual as credenciais são armazenadas em:

Essa abordagem só é adequada para implantações de CMF nas quais você tem acesso direto para configurar máquinas de trabalho.

Pre-configured usuário administrador (somente CMF)

Crie um usuário P4 dedicado para renderizar nós com uma conexão que não expira para eliminar a necessidade de transmitir dados secretos, como nomes de usuário e senhas. Nesse caso, um único usuário P4 dedicado pode ser usado para se conectar a todos os servidores P4, incluindo os servidores Commit (Master) e Edge, onde o depósito do projeto está acessível.

Portanto, você só precisa passar a porta à qual se conectar, se o padrão não estiver configurado em trabalhadores. Isso pode ser feito adicionando o seguinte em um ambiente de trabalho ou em um ambiente de fila semelhante às etapas documentadas acima:

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

Criação de um trabalho de renderização do Perforce

Esta seção mostra como configurar os ativos de dados do trabalho de Perforce-integrated renderização para que você possa enviar trabalhos de Perforce-integrated renderização do Unreal Engine para o Deadline Cloud.

Pré-requisitos

Antes de enviar um trabalho do Movie Render Queue (MRQ) do Unreal Engine em um repositório Perforce:

Configuração do projeto Unreal:

Configuração do Deadline Cloud:

Requisitos do Perforce:

Arquitetura de trabalho de renderização Perforce

Os trabalhos de renderização P4 estendem o trabalho de renderização padrão com os recursos de sincronização do 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

Principais diferenças em relação aos trabalhos padrão:

Configurando os componentes do trabalho de renderização do Perforce

Siga estas etapas para criar os ativos de dados necessários para trabalhos de Perforce-integrated renderização.

1. Crie um ativo de dados Apply Perforce Credentials

Configure um ambiente OpenJD para recuperar as credenciais do Perforce do Secrets Manager e aplicá-las à conexão do Perforce.

Etapas de configuração:

2. Crie um ativo de dados do ambiente de sincronização Perforce

Configure um ambiente OpenJD para criar um espaço de trabalho Perforce, sincronizar arquivos do servidor Perforce e limpar o espaço de trabalho após a renderização.

Etapas de configuração:

3. Crie um ativo de dados do ambiente Perforce Launch UE

Configure um ambiente OpenJD para lançar o Unreal Engine com integração com Perforce. Isso faz referência automaticamente ao espaço de trabalho do Perforce criado pelo ambiente de sincronização.

Etapas de configuração:

4. Crie um ativo de dados da etapa de renderização Perforce

Configure uma etapa de renderização do OpenJD para executar o processo de renderização.

Etapas de configuração:

5. Crie um ativo de dados de trabalho de renderização Perforce

Configure um trabalho de renderização do OpenJD que orquestre todo o fluxo de trabalho de renderização.

Etapas de configuração:

Práticas recomendadas

Pre-submission lista de verificação

Otimização de desempenho

Configuração do tamanho do fragmento:

Considere as seguintes otimizações adicionais:

Monitoramento e depuração

Solução de problemas

Problemas e soluções comuns de

Etapas de depuração

Requisitos de host personalizados

Esta seção descreve como criar e usar requisitos de host personalizados para renderização do Deadline Cloud no Unreal Engine.

Visão geral do

Os requisitos do host definem qual frota está qualificada para executar uma etapa de renderização específica. Eles são armazenados dentro de um UDeadlineCloudHostRequirements ativo, que é então referenciado por um DeadlineCloudRenderStep ativo.

Etapa 1: criar o ativo de requisitos do host

Etapa 2: carregar o modelo YAML padrão

Isso carrega requisitos básicos, como CPU, memória, GPU, sistema operacional e arquitetura.

Etapa 3: Configurar os requisitos básicos (do sistema)

Se Max = 0, então não há limite superior para esse requisito.

Etapa 4: adicionar requisitos de valor personalizados

Usado quando o requisito é numérico (por exemplo, número de licenças, limites de simultaneidade).

Etapa 5: adicionar requisitos de atributos personalizados

Usado para filtrar trabalhadores com base em etiquetas e rótulos.

Etapa 6: Visibilidade no MRQ (opcional)

Cada entrada de requisito tem um ícone de olho.

Essa configuração é útil para simplificar a interface do usuário para artistas e, ao mesmo tempo, preservar as restrições técnicas.

Etapa 7: anexar os requisitos a uma etapa de renderização

Todos os envios de MRQ usando essa etapa agora aplicam sua lógica de seleção de anfitriões.

Resumo

Usando o ativo de requisitos do host, você pode:

Essa configuração melhora a consistência do roteamento de trabalhos e garante que a renderização ocorra no hardware correto.

Configurações avançadas

Service-managed frotas versus frotas gerenciadas pelo cliente

Service-managed frotas (SMF)

Em frotas gerenciadas por serviços, o Unreal Engine e o adaptador estão automaticamente disponíveis usando o canal deadline-cloud conda com o ambiente de fila padrão. Essa configuração fornece a experiência mais fácil.

Customer-managed frotas (CMF)

Para frotas gerenciadas pelo cliente, o Unreal Engine e o adaptador devem ser instalados manualmente nos hosts dos trabalhadores. Essa configuração fornece mais controle e oferece suporte a recursos adicionais, como a integração com o Perforce. Para obter instruções detalhadas, consulte Configurando um trabalhador de frota gerenciada pelo cliente (CMF).

Recursos de renderização do Unreal Engine

O sistema de renderização do Unreal Engine fornece suporte abrangente para:

Todos os recursos de renderização são detectados e configurados automaticamente pelo remetente integrado do Unreal Engine. O adaptador mantém o tratamento adequado de dependências e oferece suporte à renderização eficiente de várias tomadas sem reiniciar o Unreal Engine.

Recursos de código aberto

O remetente e o adaptador são de código aberto e estão disponíveis em: GitHub