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 é suportado pelo Deadline Cloud com remetentes, pacotes conda e um adaptador para aumentar o 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 as tarefas de renderização em várias máquinas.

Visão geral do suporte

O Unreal Engine é suportado pelos seguintes componentes:

Compatibilidade com a versão do Unreal Engine

A tabela a seguir mostra os níveis atuais de suporte 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, certifique-se de ter 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 é um mínimo razoável:

Caminhos longos do Windows

Muitas das etapas abaixo podem criar arquivos que excedam o tamanho máximo do caminho padrão 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ê ative o suporte de caminho longo 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

O plugin Unreal Submitter atualmente 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 todas as confirmações 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 plugin 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 plugin 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 do deadline-cloud-for-unreal-engine as a remetente com a instalação mais recente do Unreal Engine, execute:

python scripts/build_plugin.py --install

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

Crie o plug-in

Ajuste os dois primeiros caminhos abaixo com base em onde sua instalação do Unreal está 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

Existem 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 ocorreriaC:\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 de deadline-cloud-for-unreal-engine in GitHub/PyPI, por exemplo:

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

Você pode querer desativar o recurso “hash estrito” nas configurações do Python do 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 retirando da 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 que é 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 do remetente. Eles podem estar desatualizados com o código acima da versão ou da 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. https://docs.aws.amazon.com/deadline-cloud/latest/userguide/create-queue-environment.html#conda-queue-environment Você está pronto para começar a renderizar. Continue com o texto Enviando uma renderização de teste 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 a demonstração do Meerkat do Unreal Marketplace:

Configurando um funcionário da frota gerenciada pelo cliente (CMF)

Esta seção explica 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 Amazon EC2

A seguir está 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

O plugin Unreal atualmente 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 sucesso, você 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, você pode simplesmente instalar com pip:

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

Se você estiver usando a versão 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 sua instalação do Unreal está 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. Pip install 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

Em sua instância de trabalhador CMF:

Gerenciamento de credenciais do Perforce

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

Visão geral do

Existem 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

Gerenciador de segredos (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: Crie 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 ocorre a criação do espaço de trabalho, por exemplo, em p4_sync_smf_environment, ugs_sync_smf_environment ou ambientes 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 Como alternativa, crie um novo modelo de ambiente e anexe-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 filas 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 padrão do Perforce, 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 passar 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, nos quais 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 nos trabalhadores. Você pode passar a porta adicionando o seguinte em um ambiente de trabalho ou 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 orienta você na configuração dos ativos de dados do trabalho de Perforce-integrated renderização para que você possa enviar trabalhos de Perforce-integrated renderização para o Deadline Cloud a partir do Unreal Engine.

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:

Como o Perforce sync se expande para projetos de produção

Os projetos de produção do Unreal Engine podem atingir centenas de gigabytes em dezenas de milhares de arquivos. A Perforce integração mantém o tempo de sincronização proporcional ao que mudou e não ao tamanho do projeto:

Para se beneficiar da reutilização do espaço de trabalho do cliente em uma frota gerenciada por serviços, habilite o armazenamento persistente para que o volume que contém o espaço de trabalho sincronizado seja reconectado aos futuros trabalhadores.

Se o caminho de rede entre a região da sua frota e seu Perforce servidor tiver baixa taxa de transferência ou alta latência, um servidor de Perforce borda na região da frota poderá atuar como um cache regional para dados de depósito. Para obter mais informações, consulte Perforce source control no Deadline Cloud Developer Guide.

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. Criar ativo de dados Apply Perforce Credentials

Configure um ambiente OpenJD para recuperar as credenciais do Perforce do Secrets Manager e aplicá-las à conexão 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 o 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 do Perforce

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

Etapas de configuração:

Enviando as saídas de renderização de volta para o Perforce

Por padrão, um trabalho de Perforce renderização carrega as saídas somente por meio de anexos de trabalho. Em Perforce vez disso, o parâmetro SubmitMode job opta por inserir as saídas renderizadas, para que os quadros finalizados cheguem ao seu depósito junto com o projeto.

Somente os arquivos que foram alterados desde a última sincronização acabam na lista de alterações. Cada tarefa reconcilia os arquivos exatos que ela produziu, e a integração reverte os arquivos cujo conteúdo é idêntico à revisão do depósito, portanto, renderizar novamente um quadro inalterado não produz nenhuma entrada na lista de alterações.

Configure seus trabalhadores para se autenticarem Perforce como o mesmo Perforce usuário em todas as tarefas em um trabalho, porque a etapa de agregação encontra prateleiras de tarefas por proprietário. A configuração de credencial recomendada emGerenciamento de credenciais do Perforce, um único segredo compartilhado no Secrets Manager, já satisfaz esse requisito.

Práticas recomendadas

Pre-submission lista de verificação

Otimização de desempenho

A tabela a seguir mostra como a ShotsPerTask configuração afeta o desempenho:

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 hospedagem 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 determinada etapa de renderização. 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 os 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 quantidade 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 impõem 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 tarefas 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 funcionário da 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 fotos 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