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.
Téléchargements automatiques
L'interface de ligne de commande Deadline fournit une commande permettant de télécharger le résultat de toutes les tâches d'une file d'attente qui se sont terminées depuis la dernière exécution de la même commande. Vous pouvez le configurer comme une tâche cron ou une tâche planifiée à exécuter de manière répétée. Cette configuration met en place le téléchargement automatique de la sortie sur une base continue.
Avant de configurer les téléchargements automatiques, suivez les étapes décrites dans Profils de stockage pour les pièces jointes aux tâches afin de configurer tous les chemins d'accès aux données des actifs pour le chargement et le téléchargement. Si une tâche utilise un chemin de sortie qui ne figure pas dans son profil de stockage, le téléchargement automatique ignore le téléchargement de cette sortie et affiche des messages d'avertissement résumant les fichiers qu'elle n'a pas téléchargés. De même, si une tâche est soumise sans profil de stockage, le téléchargement automatique ignore cette tâche et affiche un message d'avertissement. Par défaut, les émetteurs de Deadline Cloud affichent des messages d'avertissement pour les chemins qui ne font pas partie des profils de stockage afin de garantir une configuration correcte.
Configuration AWS informations d’identification
Les téléchargements automatiques utilisent l'interface de ligne de commande Deadline pour télécharger en continu les résultats des tâches. Pour authentifier ces téléchargements, vous avez besoin d'informations d'identification IAM à long terme. Les identifiants du moniteur Deadline Cloud expirent, vous ne pouvez donc pas les utiliser à cette fin.
Suivez les étapes ci-dessous pour configurer des informations d'identification à long terme.
Important
Tenez compte des avertissements suivants :
-
N'utilisez PAS les informations d'identification root de votre compte pour accéder aux AWS ressources. Ces informations d’identification offrent un accès illimité au compte et sont difficiles à révoquer.
-
N’incluez PAS de clés d’accès littérales ou d’informations d’identification dans vos fichiers d’application. Vous risqueriez en effet d’exposer accidentellement vos informations d’identification si, par exemple, vous chargiez le projet sur un référentiel public.
-
N’incluez PAS de fichiers contenant des informations d’identification dans votre zone de projet.
-
Sécurisez vos clés d'accès. Ne communiquez pas vos clés d’accès à des tiers non autorisés, même pour vous aider à trouver les identifiants de votre compte. Ce faisant, vous pourriez donner à quelqu'un un accès permanent à votre compte.
-
Sachez que toutes les informations d'identification stockées dans le fichier AWS d'informations d'identification partagé sont stockées en texte brut.
Pour plus de détails, consultez la section Meilleures pratiques pour la gestion des clés AWS d'accès dans la Référence AWS générale.
Créer un utilisateur IAM
Ouvrez la console IAM à l’adresse https://console.aws.amazon.com/iam/
. -
Dans le volet de navigation, sélectionnez Utilisateurs, puis Créer un utilisateur.
-
Donnez un nom à l'utilisateur
deadline-output-downloader. Décochez la case Fournir un accès utilisateur au Console de gestion AWS, puis choisissez Suivant. -
Choisissez Joindre directement des politiques.
-
Choisissez Créer une politique pour créer une politique personnalisée avec les autorisations minimales requises.
-
Dans l'éditeur JSON, spécifiez les autorisations suivantes :
-
Donnez un nom à la politique
DeadlineCloudOutputDownloadPolicyet choisissez Créer une politique. -
Retournez à la page de création d'un utilisateur, actualisez la liste des politiques, sélectionnez celle DeadlineCloudOutputDownloadPolicy que vous venez de créer, puis choisissez Suivant.
-
Vérifiez les informations relatives à l'utilisateur, puis choisissez Créer un utilisateur.
Créer une clé d’accès
-
Sur la page des détails de l'utilisateur, sélectionnez l'onglet Informations d'identification de sécurité. Dans la section Clés d’accès, choisissez Créer une clé d’accès.
-
Indiquez que vous souhaitez utiliser la touche pour Autre, puis choisissez Suivant, puis choisissez Créer une clé d'accès.
-
Sur la page Récupérer les clés d'accès, choisissez Afficher pour révéler la valeur de la clé d'accès secrète de votre utilisateur. Vous pouvez copier les informations d’identification ou télécharger un fichier .csv.
Stockez les clés d'accès utilisateur
-
Enregistrez les clés d'accès utilisateur dans le fichier AWS d'informations d'identification de votre système :
-
LinuxActivé, le fichier se trouve dans
~/.aws/credentials -
WindowsActivé, le fichier se trouve dans
%USERPROFILE%\.aws\credentials
Remplacez les clés suivantes :
[deadline-downloader] aws_access_key_id=ACCESS_KEY_IDaws_secret_access_key=SECRET_ACCESS_KEYregion=YOUR_AWS_REGION -
Important
Lorsque vous n'avez plus besoin de cet utilisateur IAM, nous vous recommandons de le supprimer pour respecter les meilleures pratiques AWS de sécurité. Nous vous recommandons de demander à vos utilisateurs humains d'utiliser des informations d'identification temporaires AWS IAM Identity Center lors de l'accès AWS.
Conditions préalables
Effectuez les étapes suivantes avant de créer une tâche cron ou une tâche planifiée pour un téléchargement automatique.
-
Si ce n'est pas déjà fait, installez Python
depuis le site Web de Python. -
Installez l'interface de ligne de commande Deadline en exécutant :
python -m pip install deadline -
Vérifiez que la version de l'interface de ligne de commande Deadline est 0.52.1 ou plus récente à l'aide de la commande suivante.
$ deadline --version deadline, version 0.52.1Pour voir l'état du téléchargement sur le moniteur Deadline Cloud, utilisez la version 0.60.4 ou une version ultérieure. Cette version a commencé à enregistrer l'état du téléchargement lu par le moniteur. Pour de plus amples informations, veuillez consulter Afficher l'état du téléchargement de la sortie dans Deadline Cloud.
Testez la commande de téléchargement de sortie
Pour vérifier que la commande fonctionne dans votre environnement
-
Trouvez le chemin vers Deadline
-
Exécutez la commande sync-output pour démarrer.
/path/to/deadline queue sync-output \ --profile deadline-downloader \ --farm-id YOUR_FARM_ID \ --queue-id YOUR_QUEUE_ID \ --storage-profile-id YOUR_PROFILE_ID \ --checkpoint-dir /path/to/checkpoint/directory \ -
Vous ne devez effectuer cette étape que si votre machine de téléchargement est la même que celle de soumission. Remplacer
--storage-profile-id YOUR_PROFILE_ID \ci-dessus par--ignore-storage-profiles. -
Soumettez une tâche de test.
-
Téléchargez le fichier .zip depuis GitHub.
-
Ouvrez le référentiel deadline-cloud-samples sur le site Web.
GitHub -
Choisissez Code, puis, dans le menu déroulant, sélectionnez Télécharger le fichier ZIP.
-
Décompressez l'archive téléchargée dans un répertoire local.
-
-
Exécuter
cd /path/to/unzipped/deadline-cloud-samples-mainline/job_bundles/job_attachments_devguide_output -
Exécuter
deadline bundle submit .-
Si vous n'avez pas configuré la configuration de date limite par défaut, vous devrez peut-être fournir les informations suivantes dans la ligne de commande.
--farm-idYOUR-FARM-ID--queue-idYOUR-QUEUE-ID
-
-
Attendez que la tâche soit terminée avant de passer à l'étape suivante.
-
-
Exécutez à nouveau la commande sync-output.
/path/to/deadline queue sync-output \ --profile deadline-downloader \ --farm-id YOUR_FARM_ID \ --queue-id YOUR_QUEUE_ID \ --storage-profile-id YOUR_PROFILE_ID \ --checkpoint-dir /path/to/checkpoint/directory -
Vérifiez les paramètres suivants :
-
Les résultats de votre tâche de test apparaissent dans le répertoire de destination.
-
Un fichier de points de contrôle est créé dans le répertoire de points de contrôle que vous avez indiqué.
-
Configurer des téléchargements planifiés
Sélectionnez l'onglet correspondant à votre système d'exploitation pour savoir comment configurer les téléchargements automatiques toutes les 5 minutes.
Vérifiez la configuration
Pour vérifier que la configuration des téléchargements automatiques s'est bien déroulée, procédez comme suit.
-
Soumettez une nouvelle tâche de test.
-
Attendez la fin d'un intervalle de planification, qui dans ce cas est de 5 minutes.
-
Vérifiez que les nouvelles sorties sont téléchargées automatiquement.
Si les sorties ne sont pas téléchargées, consultez la section Dépannage pour les journaux de processus.
Résolution des problèmes liés aux téléchargements automatiques
Si vous rencontrez des problèmes avec les téléchargements automatiques, vérifiez les points suivants :
Télécharger les codes d'erreur
Lorsqu'un téléchargement échoue, la colonne État du téléchargement du moniteur Deadline Cloud indique la raison et la deadline queue sync-output commande enregistre l'un des codes d'erreur suivants. La plupart de ces erreurs sont résolues sur la machine qui exécute la commande de téléchargement, qui est souvent une machine différente de celle sur laquelle vous visualisez le moniteur.
PERMISSION_DENIED(Autorisation refusée)-
Le téléchargeur n'est pas autorisé à écrire dans l'emplacement de sortie, ou ses AWS informations d'identification ont été refusées. Accordez à l'utilisateur qui exécute la commande de téléchargement l'accès en écriture à l'emplacement de sortie, confirmez que le AWS profil de la commande a accès à la file d'attente et exécutez à nouveau la commande.
DISK_FULL(Disque plein)-
L'ordinateur exécutant le téléchargement a manqué d'espace disque. Libérez de l'espace sur le lecteur qui contient l'emplacement de sortie, puis exécutez à nouveau la commande.
PATH_NOT_FOUND(Chemin introuvable)-
La destination de sortie n'existe pas ou n'est pas montée sur la machine qui exécute le téléchargement. Créez le répertoire ou montez le lecteur partagé, puis exécutez à nouveau la commande.
NETWORK_ERROR(Erreur réseau)-
Une interruption du réseau a interrompu le transfert. Les erreurs réseau sont généralement transitoires. Exécutez à nouveau la commande et vérifiez la connectivité de la machine si l'erreur se répète.
UNKNOWN(Échec)-
Le téléchargeur n'a pas pu identifier de cause précise. Le moniteur affiche « Échec » pour ce code et pour tout code qu'il ne reconnaît pas. Vérifiez la sortie du journal de la
deadline queue sync-outputcommande pour l'erreur sous-jacente.
Une tâche dont le téléchargement échoue est réessayée automatiquement à chaque exécution ultérieure. Après cinq tentatives infructueuses, le téléchargeur arrête de recommencer et affiche un avertissement. Une fois la cause corrigée, restaurez la tâche en exécutant la commande de téléchargement avec une fenêtre rétrospective indiquant la date à laquelle la tâche s'est terminée :
deadline queue sync-output --farm-idFARM_ID--queue-idQUEUE_ID\ --storage-profile-idSTORAGE_PROFILE_ID\ --force-bootstrap --bootstrap-lookback-minutes1440
Passez les deux drapeaux ensemble. L'--bootstrap-lookback-minutesoption est définie par défaut --force-bootstrap sur 0, donc à elle seule, ne récupère rien.
Pourquoi mon travail a-t-il été annulé ?
Lorsque le téléchargeur ignore une tâche, la colonne État du téléchargement indique la raison directement dans la cellule :
- Aucune pièce jointe (
no_attachments) -
La tâche n'a pas été soumise avec des pièces jointes, elle ne contient donc aucun fichier de sortie enregistré à télécharger. Certaines tâches ne produisent jamais de sortie téléchargeable, de sorte qu'une tâche ignorée sans pièces jointes ne nécessite généralement aucune action.
- Profil de stockage manquant (
missing_storage_profile) -
La tâche a été envoyée sans profil de stockage alors que la commande de téléchargement en utilise un. Le téléchargeur ne sait donc pas où se trouvent les fichiers de la tâche sur chaque machine. Rien n'est téléchargé pour la tâche tant qu'un profil de stockage n'est pas configuré pour celle-ci. Le profil de stockage d'une tâche est défini lorsque celle-ci est soumise. Soumettez la tâche avec un profil de stockage et transmettez le même profil à la commande de téléchargement. Dans le tableau des tâches, l'état du profil de stockage manquant est un lien qui ouvre une explication, un lien vers la documentation et un bouton Résoudre les problèmes avec l'IA. Pour plus d'informations, consultez la section Profils de stockage pour les pièces jointes aux tâches.
Une tâche ignorée sans indication de raison a été annulée ou arrêtée avant la production de la sortie. Il n'a pas besoin d'action.
S'agit-il d'un problème de téléchargement ou de rendu ?
Un problème dans la colonne État de téléchargement d'une tâche peut avoir deux significations différentes et être résolu différemment. Le texte de statut vous indique lequel vous possédez :
-
Aucune sortie sur une tâche dont l'état d'exécution
FAILEDsignifie que la tâche n'a pas pu être rendue sur la batterie de serveurs. Aucun fichier n'a jamais été produit, il n'y avait donc rien à télécharger. Votre disque dur et votre réseau fonctionnent bien. Consultez les journaux de la tâche pour trouver l'erreur de rendu, la corriger et mettre la tâche en file d'attente. Une tâche peut également afficher Aucune sortie après avoir terminé avec succès sans écrire de fichiers, ce qui est normal et ne nécessite aucune action. -
Un nom d'erreur, tel que Permission refusée, signifie que la tâche a été rendue et que sa sortie existe, et que la copie des fichiers sur votre système de fichiers a échoué. Résolvez l'erreur à l'aide deTélécharger les codes d'erreur.
Dans le tableau des tâches, les deux problèmes apparaissent sous la forme d'un segment rouge dans la barre de progression du téléchargement de la tâche. Ouvrez le tableau des tâches de la tâche pour les différencier. Une tâche dont chaque tâche a échoué affiche un tiret au lieu d'une erreur de téléchargement, car la tâche n'a jamais produit de résultat. La colonne d'état de la tâche indique cet échec. Diagnostiquer le téléchargement dans ces cas d'échec de rendu fait perdre du temps. Vérifiez donc toujours d'abord l'état d'exécution de la tâche.
Résoudre les problèmes avec l'IA
Les messages d'échec de téléchargement sur le moniteur Deadline Cloud, y compris l'indicateur rouge d'échec de la synchronisation des sorties, incluent un bouton Résoudre les problèmes à l'aide de l'IA. Le bouton ouvre l'assistant Deadline Cloud, qui lit l'enregistrement de l'état du téléchargement de votre file d'attente et vous explique votre échec spécifique, y compris les commandes à exécuter pour y remédier.
Utilisez-le lorsqu'un téléchargement échoue après avoir essayé de corriger son code d'erreur, lorsque vous voyez une erreur que vous ne reconnaissez pas ou lorsque vous ne savez pas sur quelle machine le problème se trouve. Le bouton apparaît lorsque l'assistant Deadline Cloud est activé pour votre moniteur. Pour de plus amples informations, veuillez consulter Assistant Deadline Cloud.
Problèmes liés au profil de stockage
-
Une erreur similaire
[Errno 2] No such file or directoryou présente[Errno 13] Permission denieddans le fichier journal peut être liée à des profils de stockage manquants ou mal configurés. -
Consultez la section Profils de stockage pour savoir comment configurer vos profils de stockage lorsque la machine de téléchargement est différente de la machine d'envoi.
-
Pour les téléchargements effectués sur le même ordinateur, essayez le
--ignore-storage-profilesdrapeau.
Autorisations sur le répertoire
-
Assurez-vous que l'utilisateur du service de planification dispose des éléments suivants :
-
Read/write accès au répertoire des points de contrôle
-
Accès en écriture au répertoire de destination de sortie
-
-
Pour Linux etmacOS, utilisez
ls -lapour vérifier les autorisations. -
PourWindows, passez en revue les paramètres de sécurité dans le dossier Propriétés.