Téléverser et télécharger des fichiers sur Super Renders Farm

Introduction

Déplacer des fichiers de projet vers et depuis une render farm est la partie du workflow qui pose le plus souvent des problèmes. Un rendu échoue non pas parce que le moteur se comporte mal, mais parce qu'un chemin de texture ne s'est pas résolu sur le nœud distant, qu'un projet a été envoyé sous forme de ZIP que la render farm ne décompresse jamais, ou qu'une connexion domestique lente s'est interrompue à mi-chemin après vingt minutes.

Super Renders Farm prend en charge trois façons de déplacer les fichiers de projet (l'interface web, le Client App SuperRenders, et l'accès S3 avec Cyberduck ou l'AWS CLI) et trois façons de récupérer la sortie rendue. Aucune des trois n'est « la bonne » de manière abstraite ; chacune a un point optimal défini par la taille des fichiers, la vitesse du réseau, et la fréquence à laquelle vous ressoumettrez le même projet.

Ce guide vous fournit un arbre de décision pour choisir la méthode correspondant à votre job, des instructions étape par étape pour chacune, et une référence des erreurs de téléversement que nous voyons le plus souvent en support.

Arbre de décision : quelle méthode de téléversement utiliser ?

Les trois méthodes ne sont pas interchangeables. Utilisez cet arbre de décision lors de votre première soumission de projet, puis adaptez au fur et à mesure que votre workflow se stabilise.

Utilisez l'interface web si :

• La taille totale du projet est inférieure à environ 2 Go
• Vous soumettez des jobs occasionnellement (quelques fois par mois) plutôt que de manière continue
• Vous souhaitez une installation nulle — juste un navigateur

Utilisez le Client App si :

• Vous soumettez des jobs au moins chaque semaine et souhaitez moins d'étapes manuelles
• Votre projet pèse plus d'environ 2 Go
• Vous souhaitez que le téléversement reprenne automatiquement en cas de coupure de connexion
• Vous souhaitez que les images terminées soient téléchargées automatiquement dans un dossier local au fur et à mesure

Utilisez l'accès S3 (Cyberduck ou l'AWS CLI) si :

• Vous travaillez déjà avec un client S3 et le préférez au navigateur ou au Client App
• Vous voulez scripter les envois vers votre SRF Space, ou les téléchargements depuis celui-ci ; l'AWS CLI s'exécute depuis un terminal ou un script planifié
• Vous êtes à l'aise pour gérer une clé d'accès (traitez-la comme un mot de passe)

Une petite mise en garde s'applique à tous les chemins : la render farm n'extrait aucune archive (.zip, .rar, .7z, .tar, .tar.gz). La farm a besoin d'un dossier de projet non compressé (le fichier de scène plus tous les assets référencés dans la bonne structure de répertoires) pour que le gestionnaire de rendu puisse résoudre les chemins d'assets. Nous développons ce point dans la section Erreurs de téléversement fréquentes ci-dessous.

Méthode 1 : téléversement via l'interface web

Le téléversement web est le chemin le plus simple et celui que nous recommandons pour les premières soumissions et les petits projets.

Étape par étape :

1. Connectez-vous à votre compte sur superrendersfarm.com et ouvrez le tableau de bord de rendu.
2. Cliquez sur Nouveau job (ou Soumettre un projet, selon la page d'accueil de l'engine sur laquelle vous êtes arrivé).
3. Faites glisser le dossier de projet sur la zone de téléversement, ou cliquez sur Choisir un dossier et sélectionnez-le.
4. Attendez que la barre de progression du téléversement soit complète. Le navigateur affiche la progression par fichier pour les projets avec de nombreux assets.
5. Une fois le téléversement terminé, configurez les paramètres de rendu (plage d'images, format de sortie, priorité) et soumettez le job.

Limites pratiques. Les navigateurs brident les sessions de téléversement individuelles, donc le chemin web devient lent au-delà d'environ 2 Go et peu fiable au-delà d'environ 5 Go sur des connexions résidentielles. Si votre onglet de navigateur est fermé en cours de téléversement, le transfert s'interrompt — il n'y a pas de reprise côté navigateur. Pour les projets dans cette plage, passez au Client App.

Ce qui est téléversé. Le glisser-déposer préserve exactement votre structure de dossiers. Si votre scène référence des textures dans \textures\ et \proxies\, ces sous-dossiers doivent être à l'intérieur du dossier de projet de niveau supérieur glissé, avec les mêmes noms. Les références manquantes sur la farm retracent presque toujours l'un de ces sous-dossiers se trouvant hors de la racine du téléversement.

Méthode 2 : Client App SuperRenders

Le Client App est le chemin sur lequel la plupart des studios de production finissent par s'établir. Il gère la reprise sur déconnexion, les vérifications d'intégrité et le téléchargement automatique des images terminées — aucune de ces fonctionnalités n'est disponible via le navigateur.

Étape par étape :

1. Téléchargez le Client App depuis la page de téléchargement et installez-le sur votre station de travail.
2. Connectez-vous avec vos identifiants de compte Super Renders Farm.
3. Cliquez sur Nouveau projet et sélectionnez votre dossier de projet. L'application analyse le fichier de scène et les assets référencés.
4. Passez en revue la liste de fichiers — l'application affiche les références manquantes avant le début du téléversement, vous permettant de les corriger localement plutôt qu'après un rendu raté.
5. Cliquez sur Téléverser. La progression est affichée par fichier, et le téléversement reprend automatiquement si votre connexion est interrompue.
6. Une fois le téléversement terminé, configurez les paramètres de rendu dans l'application et soumettez.

Téléchargement automatique. Le Client App gère également le trajet retour. Une fois que vous avez activé un dossier de sortie local, les images terminées sont transférées vers votre station de travail au fur et à mesure que chaque image se termine — vous n'avez pas à attendre que tout le job soit terminé avant de récupérer quoi que ce soit.

Note sur les versions v1 vs v2 du plugin. Les studios utilisant des versions plus anciennes du Client App devraient consulter la référence des outils et du Client App pour les chemins d'installation actuels, la compatibilité des versions de plugins et le plan de migration lorsque Spaces (notre couche de transfert de nouvelle génération) remplacera le Client App. Ce doc couvre l'intégration des plugins par DCC, la soumission de bout en bout et les étapes de dépannage en profondeur — cette page ne couvre que la surface de téléversement et de téléchargement.

Méthode 3 : accès S3 (Cyberduck ou l'AWS CLI)

L'accès S3 vous permet de déplacer des fichiers entre votre station de travail et votre SRF Space avec un client S3 standard, sans passer par le navigateur ou le Client App. Les fichiers que vous téléversez ainsi apparaissent dans votre SRF Space et peuvent être utilisés pour une tâche comme n'importe quel autre envoi. L'accès S3 ne fait que déplacer des fichiers : vous soumettez toujours la tâche depuis le tableau de bord web, le Client App, ou un plugin DCC.

Étapes :

1. Dans votre compte, ouvrez Cloud Direct Connect et générez votre clé d'accès (le portail appelle cela votre compte FTP). Copiez l'Access Key ID, la Secret Access Key et le Remote Directory.
2. Cyberduck : choisissez Open Connection, sélectionnez le protocole Amazon S3, et saisissez l'Access Key ID et la Secret Access Key. Développez More Options et saisissez votre Remote Directory dans Path, puis connectez-vous.
3. AWS CLI : exécutez aws configure, saisissez l'Access Key ID et la Secret Access Key, définissez la région sur ap-southeast-1, et laissez le format de sortie vide. Copiez ensuite le dossier de projet non compressé dans votre Remote Directory, par exemple aws s3 cp ./my-project s3://<Remote Directory>/my-project --recursive.
4. Soumettez la tâche depuis le tableau de bord web, le Client App, ou un plugin DCC, en choisissant les fichiers que vous avez téléversés.

Récupérer la sortie via S3. Les images terminées sont écrites dans le dossier SuperRendersOutput/<job ID>/ de votre SRF Space, vous pouvez donc les récupérer avec le même client, par exemple aws s3 sync s3://<Remote Directory>/SuperRendersOutput/<job ID>/ ./frames/.

Bon à savoir. Votre compte dispose d'une seule clé d'accès, sans date d'expiration. Traitez-la comme un mot de passe : ne la laissez pas dans des scripts ou dépôts partagés. Si vous avez besoin qu'elle soit modifiée, contactez le support. Les fichiers temporaires et système (*.tmp, *.temp, *.partial, *.swap, *.lnk, *.ini, *.db) ainsi que tout dossier rendertemp/ ne sont pas transmis aux nœuds de rendu, alors laissez les données de scène hors des fichiers portant ces noms.

Utilisez Cyberduck avec le protocole Amazon S3 ou l'AWS CLI ; FileZilla et les clients FTP/SFTP ne pourront pas se connecter.

Comparaison : méthodes en un coup d'œil

Faites correspondre la méthode à la forme du projet. Un fichier de 200 Mo est très bien dans le navigateur ; une animation de 60 Go avec des fluides en cache devrait passer par le Client App, ou par l'accès S3 si votre pipeline scripte déjà ses transferts.

Erreurs de téléversement fréquentes

Ce sont les erreurs que nous voyons le plus souvent en support, et quoi vérifier en premier.

« Un .zip, .rar ou .7z a été téléversé et le job ne trouve pas la scène. »

Vous pouvez téléverser un .zip, .rar ou .7z, mais la render farm ne les extrait pas, donc rien de ce qui s'y trouve n'est rendu (le téléverseur web avertit que le fichier ne sera pas décompressé automatiquement). C'est la même chose pour .tar et .tar.gz. Extrayez votre dossier de scène et téléversez les fichiers non archivés. Si vous travaillez à partir d'une livraison ZIP d'un collègue, décompressez-la localement d'abord, puis téléversez le dossier résultant.

« Texture manquante : D:\projets\... »

Votre scène référence un chemin absolu sur votre machine locale qui n'existe pas sur les nœuds workers de la farm. C'est la cause la plus fréquente des jobs échoués, et elle se manifeste que vous ayez téléversé via l'interface web ou le Client App. Corrigez-le localement en utilisant des chemins relatifs (la plupart des DCC ont une commande « rendre les chemins relatifs » ou « consolider les assets » — Fichier → Éditeur de références → Rendre relatif dans Maya, Fichier → Archiver dans 3ds Max, Fichier → Données externes → Regrouper les ressources dans Blender). Le Client App scanne au préalable les chemins absolus et les signale avant le début du téléversement, ce qui évite un aller-retour.

« Délai de téléversement dépassé. »

Fréquent sur les connexions résidentielles, surtout en Wi-Fi avec des fichiers de plus de 1 Go. Le chemin navigateur ne reprend pas — passez au Client App, qui récupère des coupures de connexion transitoires. Vérifiez également votre vitesse de téléversement locale (la plupart des FAI plafonnent le téléversement résidentiel à 10–50 Mbps) ; un projet de 20 Go sur une ligne à 10 Mbps prend environ cinq heures de transfert continu.

« Structure de projet invalide. »

Le dossier que vous avez téléversé ne contient pas de fichier de scène que la farm reconnaît (.max, .ma/.mb, .c4d, .blend, .hip/.hiplc, .aep). Cause fréquente : glisser uniquement le dossier de textures au lieu de la racine complète du projet. Retéléversez depuis un niveau au-dessus pour que le fichier de scène soit inclus.

« Les chemins d'assets pointent en dehors du dossier de projet. »

Votre scène référence des assets qui se trouvent au-dessus de la racine du projet (par exemple un dossier partagé \Bibliothèque Studio\ un niveau au-dessus de \Projet_X\). Les nœuds workers ne peuvent voir que ce qui se trouve à l'intérieur du dossier téléversé. Consolidez ces assets dans le dossier de projet localement avant le téléversement (la plupart des DCC ont une commande « collecter tous les assets »), ou téléversez le dossier parent pour que tous les chemins référencés se résolvent.

Télécharger la sortie rendue

Trois chemins existent pour récupérer les images terminées : le téléchargement manuel depuis le tableau de bord, le streaming automatique via le Client App, ou une récupération S3 depuis le dossier SuperRendersOutput/<job ID>/ de votre SRF Space.

Téléchargement manuel via le tableau de bord. Lorsqu'un job se termine, le tableau de bord liste chaque image de sortie et propose un téléchargement par image et par job complet. Pour les jobs d'animation, le tableau de bord compresse la sortie (c'est une commodité de téléchargement — non un format de soumission) afin que vous puissiez récupérer toute la séquence en un seul transfert. Pour les images fixes ou les courtes séquences, le téléchargement par image garde le nombre de fichiers gérable.

Téléchargement automatique via le Client App. Avec le Client App installé et un dossier de sortie local configuré, les images terminées sont transférées au fur et à mesure que chaque image se termine. Vous n'avez pas à attendre que le job complet soit terminé — vous pouvez examiner l'image 1 pendant que les images 240 à 480 sont encore en rendu. C'est particulièrement utile pour les longs jobs d'animation où les cycles de révision chevauchent le rendu lui-même.

Récupération S3 via Cyberduck ou l'AWS CLI. Si vous utilisez l'accès S3 (Cloud Direct Connect), les images terminées sont écrites dans le dossier SuperRendersOutput/<job ID>/ de votre SRF Space. Récupérez-les avec le même client que pour l'envoi, par exemple aws s3 sync s3://<Remote Directory>/SuperRendersOutput/<job ID>/ ./frames/. La configuration est décrite dans la Méthode 3 ci-dessus.

Rétention. Les fichiers de sortie restent disponibles au téléchargement une fois la tâche terminée ; il n'y a pas de période de suppression automatique fixe, et nous supprimons un projet lorsque vous nous le demandez. Pour l'archivage à long terme, téléchargez vers le stockage de votre studio plutôt que de compter sur la farm comme niveau de sauvegarde.

FAQ

Q : Pourquoi Super Renders Farm n'extrait-il pas les fichiers ZIP ? A : Le gestionnaire de rendu a besoin de parcourir votre dossier de projet pour résoudre les chemins d'assets : les fichiers de scène référencent les textures, proxies, caches et plugins par des chemins relatifs ou absolus. La render farm n'extrait aucun format d'archive, donc téléversez le projet en tant que dossier non compressé ; c'est ce que produit par défaut la commande « collecter tous les assets » de chaque DCC.

Q : Quelle est la taille maximale d'un projet que je peux téléverser ? A : Il n'y a pas de limite supérieure imposée. Nous avons géré des projets d'animation de plusieurs centaines de gigaoctets avec des simulations en cache. Pour les gros projets, utilisez le Client App : les téléversements via navigateur se bloquent sur les longs transferts, et le Client App reprend là où il s'est arrêté.

Q : Comment téléverser si ma connexion est peu fiable ? A : Utilisez le Client App SuperRenders. Il reprend sur déconnexion, donc une coupure Wi-Fi ne redémarre pas votre transfert depuis zéro. Le chemin de téléversement via navigateur ne reprend pas : si vous fermez votre onglet en cours de téléversement, le transfert s'interrompt.

Q : Combien de temps mes images rendues sont-elles conservées sur la farm ? A : Les fichiers de sortie restent disponibles au téléchargement une fois la tâche terminée ; il n'y a pas de période de suppression automatique fixe, et nous supprimons un projet lorsque vous nous le demandez. Pour l'archivage, téléchargez les jobs terminés vers le stockage de votre studio plutôt que de traiter la farm comme une sauvegarde à long terme.

Q : Comment récupérer automatiquement les images terminées sur ma station de travail ? A : Utilisez le Client App SuperRenders avec un dossier de sortie configuré. Les images se transfèrent au fur et à mesure que chacune se termine, vous permettant d'examiner les premières images pendant que les suivantes sont encore en rendu. Le chemin de téléchargement manuel du tableau de bord convient pour les jobs ponctuels, mais pour les travaux d'animation, le téléchargement automatique du Client App réduit considérablement les temps d'attente.

Q : Ma scène référence des textures sur un lecteur réseau. Seront-elles téléversées ? A : Seulement si les chemins du lecteur réseau se trouvent à l'intérieur de votre dossier de projet téléversé. Les nœuds workers ne peuvent pas accéder directement aux partages réseau de votre studio. Exécutez d'abord localement la commande « collecter tous les assets » ou « consolider les références » de votre DCC — cela copie tous les fichiers référencés dans le dossier de projet et réécrit les chemins en relatifs — puis téléversez le dossier consolidé. La plupart des tickets de jobs échoués que nous voyons retracent cette étape manquée.

Formats et limites de taille, en détail : pourquoi la render farm a besoin que votre projet soit non archivé, et la méthode d'envoi à choisir dès qu'un projet dépasse ~2 Go, sont couverts dans le guide dédié : Formats d'envoi et limites de taille.