Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Moteur Epic Unreal

Unreal Engine est un outil de création 3D en temps réel pour des visuels photoréalistes et des expériences immersives. Unreal Engine est pris en charge par Deadline Cloud avec des émetteurs, des packages Conda et un adaptateur pour des performances de rendu améliorées. Ce guide fournit des instructions détaillées sur l'utilisation de Deadline Cloud avec Unreal Engine pour accélérer le rendu de vos projets Movie Render Queue en répartissant les tâches de rendu sur plusieurs machines.

Vue d'ensemble du support

Unreal Engine est supporté par les composants suivants :

Compatibilité des versions d'Unreal Engine

Le tableau suivant indique les niveaux de support actuels pour les versions d'Unreal Engine :

Chaîne Deadline Cloud Conda

Le tableau suivant répertorie tous les packages conda applicables à Unreal Engine disponibles pour les Service-managed flottes via le deadline-cloud canal Conda :

Prise en main

Conditions préalables

Avant d'installer l'émetteur Unreal Engine, assurez-vous de disposer des éléments suivants :

Installation de l'émetteur

L'outil de soumission d'Unreal Engine ajoute la fonctionnalité Deadline Cloud en tant que plug-in à Unreal Engine, vous permettant de soumettre vos tâches Movie Render Queue directement à Deadline Cloud pour le rendu.

Choisir votre agence

Sélectionnez la branche appropriée pour votre déploiement :

Création d'une nouvelle instance Windows Amazon EC2 sur laquelle installer Unreal (facultatif)

Si vous configurez une toute nouvelle instance Windows Amazon Elastic Compute Cloud (Amazon EC2) en tant qu'expéditeur, une instance g5.2xlarge avec 200 Go de stockage constitue un minimum raisonnable :

Fenêtres : longs chemins

La plupart des étapes ci-dessous peuvent créer des fichiers dépassant la longueur de chemin maximale par défaut de Windows. Avant de créer et d'installer l'émetteur ou l'adaptateur Deadline Cloud pour Unreal Engine sur un ordinateur Windows, nous vous recommandons d'activer la prise en charge des longs chemins de Windows. Pour ce faire, suivez les instructions de la page Limitation maximale du chemin de fichier, par exemple en exécutant la PowerShell commande.

Il existe également un problème ouvert concernant l'agent de travail dû à une dépendance qui n'est pas livrée configurée pour prendre en charge les longs chemins Windows. Lorsque vous configurez vos collaborateurs, suivez les étapes de contournement décrites dans le problème associé pour prendre pleinement en charge les longs chemins de Windows jusqu'à ce que le problème soit résolu.

Installation des outils de compilation

Le plugin Unreal Submitter doit actuellement être compilé localement.

Installation du moniteur Deadline Cloud

Le moniteur Deadline Cloud est utilisé à la fois pour gérer vos informations d'identification pour soumettre des tâches à Deadline Cloud et pour surveiller l'état de vos tâches.

Configuration de l’environnement

Installation du logiciel Deadline Cloud

Clonez ou téléchargez deadline-cloud-for-unreal-engine depuis la branche de publication ou la ligne principale, selon que vous voulez la version testée la plus récente ou tous les commits les plus récents.

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

Facultatif : créez et installez le plugin avec un script

Un script d'assistance sur automatise scripts/build_plugin.py éventuellement les deux étapes suivantes. Il tente de trouver la dernière version d'Unreal, crée votre plugin et vos dépendances Python, et les installe aux bons endroits. Vous pouvez modifier des paramètres tels que la version Unreal. Pour consulter la liste d'aide complète, exécutez :

python scripts/build_plugin.py -h

Pour créer et installer votre copie actuelle de deadline-cloud-for-unreal-engine As a Smitter avec la dernière installation d'Unreal Engine, exécutez :

python scripts/build_plugin.py --install

Si vous avez effectué l'installation avec ce script avec succès, vous pouvez passer àCréation d'une flotte.

Créez le plugin

Ajustez les deux premiers chemins ci-dessous en fonction de l'endroit où se trouve votre installation d'Unreal et de l'endroit où vous l'avez installéedeadline-cloud-for-unreal-engine.

Depuis le dossier Unreal Install Batchfiles (le package paramètre peut être n'importe quel nouveau répertoire, mais vous souhaiterez qu'il soit appelé UnrealDeadlineCloudService ultérieurement) :

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"

Copiez le dossier « package » ci-dessus dans le dossier Plugins de votre installation Unreal (par exemple,C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService).

Dépendances Python

Il existe 4 manières d'installer les dépendances Python requises.

1. Si vous avez créé et installé le plugin à partir de la branche de publication ci-dessus, vous pouvez l'installer à partir de pip. Utilisez la commande d'installation suivante pour ajuster les chemins d'accès à votre installation 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. Sinon, dans votre .uplugin fichier (dans les étapes ci-dessus, cela se trouveraitC:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService\UnrealDeadlineCloudService.uplugin), vous pouvez ajouter une PythonRequirements section correspondant à la dernière version de deadline-cloud-for-unreal-engine in GitHub/PyPI, par exemple :

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

Vous souhaiterez peut-être désactiver la fonction de « hachage strict » dans les paramètres Python d'Unreal, ou ajouter des paramètres de hachage pour les versions de bibliothèques et de dépendances spécifiques que vous souhaitez utiliser.

3. Si vous utilisez la ligne principale, vous pouvez avoir des dépendances Python qui ne sont pas encore disponibles sur PyPI. Vous devrez créer et installer votre copie locale, ce qui peut être fait avec hatch. Le .whl fichier devra être modifié pour refléter la version sortie par 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. Enfin, les dépendances Python peuvent être installées par le programme d'installation de l'émetteur. Ceux-ci peuvent être obsolètes par rapport à votre code ci-dessus provenant de la version ou de la branche principale, et cette méthode ne devrait pas être préférée actuellement.

Mettre à jour les notifications

Le plugin d'envoi vérifie automatiquement les nouvelles versions au démarrage d'Unreal GitHub Editor. Si une mise à jour est disponible, une boîte de dialogue vous invite à consulter la page de publication.

Pour désactiver les notifications de mise à jour, décochez la case Afficher les notifications de mise à jour à l'expéditeur dans Paramètres généraux du panneau des paramètres de Deadline Cloud (Edition > Paramètres du projet > Plugins > Deadline Cloud).

Vous pouvez également utiliser l'interface de ligne de commande :

deadline config set settings.submitter_update_notification false

Pour réactiver :

deadline config set settings.submitter_update_notification true

Création d'une flotte

Si vous possédez déjà un parc Windows et que vous n'avez pas besoin d'en configurer un nouveau, vous pouvez passer àSoumettre un rendu de test.

Création d'une flotte gérée par les services (SMF)

Suivez le guide de l'utilisateur des flottes gérées par les services pour créer un SMF si vous n'en possédez pas déjà un. Sur les flottes gérées par services (SMF), l'Unreal Engine et l'adaptateur sont automatiquement disponibles via le canal deadline-cloud Conda avec l'environnement de file d'attente par défaut. https://docs.aws.amazon.com/deadline-cloud/latest/userguide/create-queue-environment.html#conda-queue-environment Vous êtes prêt à commencer le rendu. Continuez avec ce qui Soumettre un rendu de test suit pour soumettre une tâche de rendu de test.

Création d'une flotte gérée par le client (CMF)

Soumettre un rendu de test

Cet exemple utilise la démo Meerkat d'Unreal Marketplace :

Configuration d'un agent de parc géré par le client (CMF)

Cette section explique comment configurer une instance Amazon EC2 en tant que travailleur CMF pour Deadline Cloud avec Unreal Engine.

Présentation de

Voici les principales différences entre le CMF et le SMF :

Choisir votre agence

Sélectionnez la branche appropriée pour votre déploiement :

Configuration de l'instance Amazon EC2

La configuration d'instance recommandée est la suivante :

Installation du logiciel

1. Installez Unreal Engine  :

2. Installez les pilotes NVIDIA GRID  :

Installation des outils de compilation

Le plugin Unreal doit actuellement être compilé localement.

Installation du logiciel Deadline Cloud

Clonez ou téléchargez deadline-cloud-for-unreal-engine depuis la branche de publication ou depuis la ligne principale. Assurez-vous que votre version professionnelle des bibliothèques est compatible avec la version utilisée par vos soumissionnaires.

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

Facultatif : créez et installez le plugin et les dépendances à l'aide d'un script :

Il existe un script d'assistance scripts/build_plugin.py qui peut automatiser les étapes d'installation restantes. Il tente de trouver la dernière version d'Unreal, de créer votre plugin et vos dépendances Python, et de les installer aux bons endroits. Les paramètres tels que la version d'Unreal à utiliser peuvent être modifiés. Pour consulter la liste d'aide complète, exécutez :

python scripts/build_plugin.py -h

Pour créer et installer votre copie actuelle de deadline-cloud-for-unreal-engine As a Worker avec la dernière installation d'Unreal Engine, exécutez :

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

Configurez l'agent Deadline Cloud Worker en exécutant :

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

Si vous avez effectué l'installation à l'aide de ce script et configuré correctement l'agent de travail, vous pouvez passer àDémarrage du service d'agent Deadline Cloud Worker.

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

La version correcte de l'adaptateur doit être installée en fonction de la version de l'émetteur utilisée. Si vous utilisez la version de l'émetteur depuis la branche release de GitHub, vous pouvez simplement l'installer avec pip :

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

Si vous utilisez une version principale ou une version personnalisée en cours de développement de l'émetteur, pour éviter tout problème de compatibilité, nous vous recommandons de compiler et d'installer à partir de la même version de code ou de transférer le .whl fichier depuis la version de votre émetteur :

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

Création du plugin

Ajustez les deux premiers chemins ci-dessous en fonction de l'endroit où se trouve votre installation d'Unreal et de l'endroit où vous l'avez installéedeadline-cloud-for-unreal-engine.

Depuis le dossier Unreal Install Batchfiles (le package paramètre peut être n'importe quel nouveau répertoire, mais vous souhaiterez qu'il soit appelé UnrealDeadlineCloudService ultérieurement) :

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"

Copiez le dossier « package » ci-dessus dans le dossier Plugins de votre installation Unreal (par exemple,C:\Program Files\Epic Games\UE_5.5\Engine\Plugins\UnrealDeadlineCloudService).

pywin 32

La version de Python d'Unreal aura besoin de pywin32. Installation de Pip à l'aide d'une copie de l'installation Python tierce d'Unreal :

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

Démarrage du service d'agent Deadline Cloud Worker

Sur votre instance CMF Worker :

Gestion des informations d'identification Perforce

Cette section couvre la gestion sécurisée des informations d'identification pour intégrer Perforce aux collaborateurs de Deadline Cloud.

Présentation de

Il existe plusieurs approches pour configurer les informations d'identification Perforce pour les employés de Deadline Cloud. Chaque méthode a des implications de sécurité et des cas d'utilisation différents :

Principes de base des informations d'identification P4

Pour récupérer les paramètres de connexion, y compris l'URL et le port du serveur Perforce, le nom d'utilisateur et le mot de passe, Perforce suit la priorité suivante :

Avec ces priorités, si vous disposez de la configuration suivante :

La connexion Perforce qui en résultera sera la suivante :

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

Gestionnaire de secrets (recommandé)

Secrets Manager fournit la solution la plus sécurisée et la plus évolutive pour les déploiements CMF et SMF.

Cette approche présente les avantages suivants :

Étape 1 : créer un secret dans Secrets Manager

Créez un secret contenant vos paramètres de connexion Perforce.

Paires clé-valeur requises :

Exemple de secret  :

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

Pour créer le secret  :

Étape 2 : Autoriser le travailleur à accéder au secret

Les travailleurs ont besoin d'une secretsmanager:GetSecretValue autorisation pour accéder au secret. Cela suit le même schéma que la gestion des secrets utilisateur des tâches Windows.

Pour autoriser l'accès  :

Variables de l'environnement de travail

Vous pouvez transmettre des informations de connexion dans l'environnement de travail dans lequel l'espace de travail est créé, par exemple dans p4_sync_smf_environment, ugs_sync_smf_environment ou des environnements similaires pour 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 Vous pouvez également créer un nouveau modèle d'environnement et l'ajouter à votre tâche.

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

Cette approche comporte les risques de sécurité suivants :

variables d'environnement de file d'attente

Selon le guide de l'utilisateur de Deadline Cloud, vous pouvez utiliser les environnements de file d'attente pour fournir des applications logicielles, des variables d'environnement et d'autres ressources aux tâches de la file d'attente. Des exemples d'environnement de file d'attente se trouvent dans le dossier queue_environments de deadline-cloud-samples.

Ajouter un environnement de file d'attente à l'aide du moniteur ou de la console Deadline

Ajouter un environnement de file d'attente via la CLI

Registre Windows (CMF uniquement)

Le registre Windows fournit un stockage local des informations d'identification sur les ordinateurs des opérateurs. Cette méthode utilise le système de priorité Perforce standard dans lequel les informations d'identification sont stockées dans :

Cette approche ne convient qu'aux déploiements CMF auxquels vous avez un accès direct pour configurer les machines de travail.

Pre-configured utilisateur administrateur (CMF uniquement)

Créez un utilisateur P4 dédié pour les nœuds de rendu avec une connexion non expirante afin d'éliminer le besoin de transmettre des données secrètes telles que des noms d'utilisateur et des mots de passe. Dans ce cas, un seul utilisateur P4 dédié peut être utilisé pour se connecter à tous les serveurs P4, y compris les serveurs Commit (Master) et Edge où le dépôt de projets est accessible.

Par conséquent, il vous suffit de transmettre le port auquel vous connecter, si le port par défaut n'est pas configuré sur les travailleurs. Vous pouvez passer le port en ajoutant les éléments suivants dans l'environnement de travail ou dans l'environnement de file d'attente, de la même manière que les étapes décrites ci-dessus :

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

Création d'une tâche de rendu Perforce

Cette section explique comment configurer les actifs de données des tâches de Perforce-integrated rendu afin que vous puissiez soumettre des tâches de Perforce-integrated rendu à Deadline Cloud depuis Unreal Engine.

Conditions préalables

Avant de soumettre une tâche Movie Render Queue (MRQ) depuis Unreal Engine dans un référentiel Perforce :

Configuration du projet Unreal :

Configuration de Deadline Cloud  :

Exigences en matière de performances :

Architecture des tâches de rendu par Perforce

Les tâches de rendu P4 étendent les tâches de rendu standard grâce aux fonctionnalités de synchronisation 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

Principales différences par rapport aux emplois classiques  :

Comment Perforce Sync s'adapte aux projets de production

Les projets Unreal Engine de production peuvent atteindre des centaines de gigaoctets sur des dizaines de milliers de fichiers. L'Perforceintégration permet de maintenir le temps de synchronisation proportionnel à ce qui a changé plutôt qu'à la taille du projet :

Pour tirer parti de la réutilisation de l'espace de travail du client sur une flotte gérée par les services, activez le stockage persistant afin que le volume contenant l'espace de travail synchronisé soit reconnecté aux futurs collaborateurs.

Si le chemin réseau entre la région de votre flotte et votre Perforce serveur présente un faible débit ou une latence élevée, un serveur Perforce périphérique situé dans la région de la flotte peut faire office de cache régional pour les données du dépôt. Pour plus d'informations, consultez Perforce source control dans le Deadline Cloud Developer Guide.

Configuration des composants de la tâche de rendu Perforce

Suivez ces étapes pour créer les actifs de données requis pour les tâches de Perforce-integrated rendu.

1. Créer une ressource de données Apply Perforce Credentials

Configurez un environnement OpenJD pour récupérer les informations d'identification Perforce depuis Secrets Manager et les appliquer à la connexion Perforce.

Étapes de configuration  :

2. Création d'un actif de données de l'environnement Perforce Sync

Configurez un environnement OpenJD pour créer un espace de travail Perforce, synchroniser les fichiers depuis le serveur Perforce et nettoyer l'espace de travail après le rendu.

Étapes de configuration  :

3. Créer une ressource de données sur l'environnement Perforce Launch UE

Configurez un environnement OpenJD pour lancer Unreal Engine avec intégration Perforce. Cela fait automatiquement référence à l'espace de travail Perforce créé par l'environnement de synchronisation.

Étapes de configuration  :

4. Créer une ressource de données d'étape de rendu Perforce

Configurez une étape de rendu OpenJD pour exécuter le processus de rendu.

Étapes de configuration  :

5. Créer une ressource de données sur les tâches de rendu Perforce

Configurez une tâche de rendu OpenJD qui orchestre l'ensemble du flux de rendu.

Étapes de configuration  :

Renvoi des résultats de rendu à Perforce

Par défaut, une tâche de Perforce rendu télécharge les sorties via des pièces jointes uniquement. Le paramètre SubmitMode job permet d'y insérer les sorties rendues, de sorte que les images finies atterrissent dans votre dépôt en même temps que le projet. Perforce

Seuls les fichiers qui ont été modifiés depuis la dernière synchronisation figurent dans la liste des modifications. Chaque tâche réconcilie les fichiers exacts qu'elle a produits, et l'intégration rétablit les fichiers dont le contenu est identique à la révision du dépôt, de sorte que le rendu d'un cadre inchangé ne produit aucune entrée dans la liste des modifications.

Configurez vos collaborateurs de manière à ce qu'ils s'authentifient en Perforce tant qu'Perforceutilisateur unique pour toutes les tâches d'une tâche, car l'étape d'agrégation permet de trouver des étagères de tâches par propriétaire. La configuration des informations d'identification recommandée dans Gestion des informations d'identification Perforce un secret partagé unique dans Secrets Manager répond déjà à cette exigence.

Bonnes pratiques

Pre-submission liste de contrôle

Optimisation des performances

Le tableau suivant montre comment ce ShotsPerTask paramètre affecte les performances :

Envisagez les optimisations supplémentaires suivantes :

Surveillance et débogage

Résolution des problèmes

Problèmes courants et solutions correspondantes

Étapes de débogage

Exigences d'hôte personnalisées

Cette section explique comment créer et utiliser des exigences d'hôte personnalisées pour le rendu de Deadline Cloud dans Unreal Engine.

Présentation de

Les exigences de l'hôte définissent quelle flotte est éligible pour exécuter une étape de rendu particulière. Ils sont stockés dans un UDeadlineCloudHostRequirements actif, qui est ensuite référencé par un DeadlineCloudRenderStep actif.

Étape 1 : Création de la ressource relative aux exigences de l'hôte

Étape 2 : charger le modèle YAML par défaut

Cela charge les exigences de base telles que le processeur, la mémoire, le GPU, le système d'exploitation et l'architecture.

Étape 3 : Configuration de la configuration de base (système) requise

Si Max = 0, il n'y a pas de limite supérieure pour cette exigence.

Étape 4 : Ajouter des exigences de montant personnalisées

Utilisé lorsque l'exigence est numérique (par exemple, nombre de licences, limites de simultanéité).

Étape 5 : Ajouter des exigences d'attributs personnalisées

Utilisé pour filtrer les travailleurs en fonction des tags et des étiquettes.

Étape 6 : Visibilité dans MRQ (facultatif)

Chaque entrée d'exigence comporte une icône représentant un œil.

Ce paramètre est utile pour simplifier l'interface utilisateur des artistes tout en préservant les contraintes techniques.

Étape 7 : Joindre les exigences à une étape de rendu

Toutes les soumissions MRQ utilisant cette étape appliquent désormais votre logique de sélection d'hôte.

Résumé

À l'aide de la ressource relative aux exigences de l'hôte, vous pouvez :

Cette configuration améliore la cohérence du routage des tâches et garantit que le rendu s'effectue sur le matériel approprié.

Configurations avancées.

Service-managed flottes et flottes gérées par le client

Service-managed flottes (SMF)

Sur les flottes gérées par des services, l'Unreal Engine et l'adaptateur sont automatiquement disponibles via le canal deadline-cloud Conda avec l'environnement de file d'attente par défaut. Cette configuration offre l'expérience la plus simple.

Customer-managed flottes (CMF)

Pour les flottes gérées par le client, Unreal Engine et l'adaptateur doivent être installés manuellement sur les hôtes de travail. Cette configuration offre plus de contrôle et prend en charge des fonctionnalités supplémentaires telles que l'intégration de Perforce. Pour obtenir des instructions complètes, consultez Configuration d'un agent de parc géré par le client (CMF).

Fonctionnalités de rendu d'Unreal Engine

Le système de rendu d'Unreal Engine fournit un support complet pour :

Toutes les fonctionnalités de rendu sont automatiquement détectées et configurées par l'émetteur intégré Unreal Engine. L'adaptateur gère correctement les dépendances et permet un rendu multi-plans efficace sans redémarrer Unreal Engine.

Ressources open source

L'émetteur et l'adaptateur sont open source et disponibles sur : GitHub