Migrer depuis Cloudinary, Filestack, Mux ou Uploadcare

Kevin van Zonneveld

Cofondateur · Amsterdam, Pays-Bas · Afficher la bio

Regroupez les téléversements, le redimensionnement d’images, l’encodage vidéo et les aperçus de documents dans un seul pipeline versionné, avec vos fichiers dans un stockage que vous contrôlez. Nos guides de migration expliquent comment transposer les flux de travail Cloudinary, Filestack, Mux et Uploadcare dans Transloadit, transférer vos fichiers existants et basculer progressivement le trafic.

Chaque guide établit les correspondances entre les flux de téléversement et de traitement, fournit des exemples de Templates, explique comment importer les sources existantes et propose une liste de contrôle pour la bascule.

• Migrer depuis Cloudinary : préréglages de téléversement, transformations fixes et anticipées, inventaire des ressources et remplacement des références de diffusion
• Migrer depuis Filestack : fonctions de rappel du sélecteur, routage MIME des images et des PDF, aperçus statiques et rapprochement des exports partiels avant une nouvelle tentative
• Migrer depuis Mux : téléversements directs, HLS anticipé ou à la demande, images d’affiche, originaux conservés ou fichiers maîtres temporaires et changements d’identifiants de lecture
• Migrer depuis Uploadcare : fonctions de rappel de l’outil de téléversement, recettes d’opérations CDN, variantes d’images optimisées et enregistrements distincts pour les métadonnées et les groupes de fichiers

Établir d’abord les correspondances entre les concepts

Dans Transloadit, un Robot exécute chaque Step de traitement, et l’ensemble des Steps constitue vos Assembly Instructions. Vous pouvez enregistrer ces instructions dans un Template et les exécuter sous la forme d’une Assembly pour chaque téléversement ou import. Voici comment s’articulent les éléments de téléversement et de traitement :

Les Templates sont au format JSON. Vous pouvez donc conserver les règles de traitement dans votre gestionnaire de versions, à côté du code de votre application, comme le recommandent les guides. Examinez les modifications en même temps que celles du code de votre application et réutilisez les règles de traitement pour les nouveaux téléversements et les reprises de fichiers existants.

Une transformation, quatre fournisseurs

Pour les trois fournisseurs de traitement d’images, voici une vignette WebP carrée de 400×400 dans la syntaxe de chacun, accompagnée de son équivalent Transloadit. Pour Mux, comparez une demande d’image d’affiche à cinq secondes, dans un cadre de 640×360.

Ces trois opérations sur les images les redimensionnent pour remplir le cadre et rognent ce qui dépasse en centrant le recadrage. C’est ce que fait resize_strategy: "fillcrop" dans le Robot 🤖 /image/resize, et vous retrouverez exactement ce Step dans l’exemple de reprise ci-dessous. Comparez le rendu et la qualité sur vos propres images : reproduire la géométrie du recadrage ne reproduit pas la sélection automatique du format, de la qualité ou du point focal.

Pour les images d’affiche, réglez le paramètre offsets en secondes dans le Robot 🤖 /video/thumbs EN (English). Le mode d’ajustement par défaut de Mux conserve le rapport largeur/hauteur dans le cadre demandé. Associez donc width: 640 et height: 360 à resize_strategy: "fit". La stratégie par défaut pad ajouterait des bandes à la place. Avec une vidéo de test au format 4:3, ce Step nous a donné une image d’affiche de 480×360.

Transférer aussi vos fichiers existants

Une migration n’est pas terminée tant que votre bibliothèque existante n’a pas elle aussi été transférée. Les guides expliquent comment inventorier les sources et importer des URL autorisées avec le Robot 🤖 /http/import. Son paramètre url accepte aussi un tableau, ce qui vous permet de transférer des fichiers par lots de taille limitée. Le guide Mux explique comment remplacer le Step d’entrée de son Template vidéo ; les autres guides incluent des Templates de reprise d’images existantes. Voici un exemple exécutable qui importe deux images publiques et produit la vignette du tableau ci-dessus. Enregistrez-le sous backfill.json :

{
  "imported": {
    "robot": "/http/import",
    "url": [
      "https://demos.transloadit.com/inputs/chameleon.jpg",
      "https://demos.transloadit.com/inputs/prinsengracht.jpg"
    ]
  },
  "thumb": {
    "use": "imported",
    "robot": "/image/resize",
    "width": 400,
    "height": 400,
    "resize_strategy": "fillcrop",
    "format": "webp",
    "result": true
  }
}

Exécutez-le dans votre terminal avec l’interface en ligne de commande fournie avec notre SDK Node.js, testée ici avec @transloadit/node 5.1.0. À la fin de l’Assembly, l’interface en ligne de commande affiche une URL pour chaque vignette. Les URL abrégées ci-dessous seront différentes lors de votre exécution :

$ export TRANSLOADIT_KEY=MY_AUTH_KEY TRANSLOADIT_SECRET=MY_SECRET_KEY
$ npx -y @transloadit/node assemblies create --steps backfill.json --print-urls
STEP   NAME                URL
thumb  chameleon.webp      https://pub-….r2.dev/…/….webp
thumb  prinsengracht.webp  https://pub-….r2.dev/…/….webp

Ces URL de résultats sont temporaires ; les fichiers sont normalement conservés pendant 24 heures EN (English) et sont destinés à être récupérés à court terme. En production, les guides ajoutent un Step d’export, par exemple le Robot 🤖 /s3/store EN (English), avec vos propres informations d’accès. Définissez notify_url dans la requête d’Assembly signée, vérifiez les signatures des notifications et exigez ASSEMBLY_COMPLETED. Avant de mettre à jour votre application, lisez les résultats des Steps qui les produisent et vérifiez is_temp_url: false pour enregistrer durablement les URL d’export permanentes. /http/import comptabilise 10 % des octets importés dans l’utilisation liée au traitement ; le redimensionnement, l’extraction de métadonnées et tout export ajoutent chacun leur propre utilisation, conformément à notre tarification des Robots EN (English).

Conserver des URL dynamiques avec le Smart CDN

Si votre interface construit des URL de transformation à la volée, vous n’avez pas à effectuer tous les traitements au moment du téléversement. Le Smart CDN exécute un Template à la première requête pour une URL et met le résultat en cache en périphérie du réseau. Ce Template doit utiliser des Robots compatibles, terminer sa branche de réponse par /file/serve et être appelé via des URL que vous signez côté serveur. /image/resize y fonctionne, tandis que /video/encode et /video/adaptive n’y fonctionnent pas. Pour la vidéo, le guide Mux renvoie à /video/ondemand, qui génère le HLS à mesure que les spectateurs le demandent.

Le guide Cloudinary recommande de générer les variantes canoniques à l’avance pour les pages à fort trafic et d’utiliser le Smart CDN pour les bibliothèques dont de nombreux fichiers sont rarement consultés. Notre article Téléverser une fois, transformer indéfiniment EN (English) présente de bout en bout la configuration du traitement à la demande.

Ce que vous obtenez après la migration

• Un pipeline pour les images, les vidéos et les documents. Une seule Assembly peut importer des fichiers, redimensionner des images, encoder des vidéos, créer des vignettes de documents et exporter les résultats. Le guide Filestack, par exemple, fait passer les images et les PDF par un seul Template.
• Une mesure d’utilisation commune à tous les types de médias. Planifiez le traitement des images, des vidéos et des documents avec une seule mesure en GB, plutôt qu’une tarification vidéo à la minute. La plupart des Robots de traitement comptabilisent les octets d’entrée et de sortie, avec leurs propres remises et frais minimaux. Vous pouvez définir des plafonds de dépenses mensuelles. Consultez les tarifs.
• Des téléversements open source. Uppy, notre outil de téléversement de fichiers, et tus-js-client, que son plugin Tus utilise pour les téléversements avec reprise, sont des projets open source sous licence MIT. Vous pouvez donc lire leur code, en créer des forks et étendre votre interface de téléversement.
• Votre stockage, vos régions. Exportez les résultats dans votre propre bucket et choisissez un traitement aux États-Unis, en Europe ou en Asie-Pacifique pour la résidence des données, ou utilisez notre point de terminaison mondial. Configurez séparément vos régions de stockage et de diffusion.

Pour une vue plus large des différences entre ces plateformes, consultez notre comparaison des plateformes de traitement multimédia pour les startups EN (English).

Planifier les modifications de l’application

Les guides couvrent le traitement, les téléversements, le stockage et les notifications. Copier les octets des médias ne migre pas les métadonnées, les groupes, les versions, les autorisations, les catalogues DAM hébergés ni les intégrations CMS. Conservez ces enregistrements et recréez les comportements de l’application dont vous avez besoin. Pour Mux, l’intégration du lecteur, les analyses, la diffusion en direct, les DRM et le conditionnement des pistes multilingues doivent être planifiés séparément ; une Assembly ne recrée ni un objet Asset de Mux ni un identifiant de lecture. Testez séparément les équivalents des effets propres au fournisseur et des flux de travail d’IA, puis comparez des fichiers réels et les règles d’accès avant de basculer le trafic.

Les exemples des guides exportent vers votre propre bucket. Transloadit Storage, notre stockage géré pour les originaux et les résultats, est en préversion privée. Si vous souhaitez l’essayer, demandez-nous de l’activer pour votre Workspace. La reprise présentée dans cet article utilise des résultats temporaires et ne nécessite aucune configuration de stockage.

Commencer par un flux de travail

Choisissez votre fournisseur dans l’index des migrations, inventoriez un flux de travail, configurez sa destination d’export et testez quelques-uns de vos propres fichiers. Gardez les anciens identifiants de ressources et les correspondances de diffusion à disposition pour pouvoir revenir en arrière pendant la bascule progressive du trafic. Inscrivez-vous pour obtenir vos informations d’accès et, si vous souhaitez un second avis sur vos correspondances, contactez-nous.