Cloudinary、Filestack、Mux、Uploadcare からの移行
アップロード、画像リサイズ、動画エンコーディング、ドキュメントプレビューを、管理下のストレージにあるファイルを使う 1 つのバージョン管理可能なパイプラインにまとめられます。当社の移行ガイドでは、Cloudinary、Filestack、Mux、Uploadcare のワークフローを Transloadit にどう対応づけるか、既存ファイルをどう引き継ぐか、トラフィックをどう段階的に切り替えるかを説明しています。
各ガイドでは、アップロードと処理のワークフローの対応づけ、Template のサンプル、既存ソースのインポート方法、切り替えチェックリストを提供しています。
- Cloudinary から移行:アップロードプリセット、固定変換と eager 変換、アセット棚卸し、配信参照の置き換え
- Filestack から移行:picker コールバック、画像と PDF の MIME ルーティング、静的プレビュー、再試行前の部分エクスポートの整合確認
- Mux から移行:直接アップロード、事前またはオンデマンドの HLS、ポスター、保持するオリジナルまたは一時マスター、playback ID の変更
- Uploadcare から移行:アップローダーのコールバック、CDN 操作レシピ、最適化済み画像バリアント、メタデータとファイルグループレコードの分離
まず概念を対応づける
Transloadit では、各処理 Step を Robot が実行し、それらの Step 全体が Assembly Instructionsになります。その設定は Templateとして保存でき、アップロードやインポートごとに Assemblyとして実行できます。アップロードと処理の関係は、次のとおりです。
| 現在使っているもの | Transloadit で置き換わるもの |
|---|---|
| Cloudinary の upload preset、Filestack の workflow | template_idで参照する再利用可能な Template |
| Mux の asset 作成 | 動画パイプラインを実行する Assembly |
| 変換 URL または CDN 操作 | 処理 Step または署名付き Smart CDN URL |
| アップロードウィジェットまたはファイル picker | Transloadit プラグインと再開可能アップロードを備えた Uppy |
| 処理完了 webhook | 処理完了時に送られる Assembly Notifications |
| ベンダー管理のアセットストレージ | /s3/storeでバケットへ直接エクスポートされる結果 |
| Mux の再生 URL | /video/adaptiveから生成し、自身の CDN 経由で配信する HLS パッケージ |
Template は JSON なので、ガイドで推奨しているとおり、処理ルールをアプリケーションコードと並べてバージョン管理に保存できます。変更はアプリケーションコードとあわせて確認し、新規アップロードやバックフィルでも同じ処理ルールを再利用できます。
1 つの変換を 4 ベンダーで比較
画像系 3 ベンダーについては、各ベンダーの構文による 400×400 の正方形 WebP サムネイルと、それを Transloadit で置き換える方法を並べています。Mux については、640×360 の枠内で 5 秒位置のポスター取得リクエストを比較します。
| ベンダー | 変更前 | 変更後 |
|---|---|---|
| Cloudinary | c_fill,w_400,h_400,f_webp | /image/resize と fillcrop および webp |
| Uploadcare | -/scale_crop/400x400/center/-/format/webp/ | /image/resize と fillcrop および webp |
| Filestack | resize=width:400,height:400,fit:crop/output=format:webp | /image/resize と fillcrop および webp |
| Mux、公開 playback ID | thumbnail.jpg?time=5&width=640&height=360 | /video/thumbs と offsets: [5] および fit |
これら 3 つの画像操作は、画像を枠いっぱいに拡大縮小し、はみ出した部分を中央基準で切り抜きます。これは🤖 /image/resize Robotの
resize_strategy: "fillcrop"で実現します。まったく同じ Step を、後述のバックフィル例でも使っています。見た目と品質は実際の画像で比較してください。クロップ形状を一致させても、自動フォーマット選択、自動品質設定、焦点位置の自動選択までは再現されません。
ポスターフレームでは、🤖 /video/thumbs
Robotの offsets に秒数を設定します。Mux の既定の fit モードは、要求した枠内にアスペクト比を保って収めるため、width: 640と height: 360 を
resize_strategy: "fit" と組み合わせます。既定の pad
戦略では代わりに帯が入ります。4:3 のテスト動画では、この Step で 480×360 のポスターが得られました。
既存ファイルも一緒に移行する
既存ライブラリの移行が終わるまでは、移行は完了ではありません。ガイドでは、ソースを棚卸しし、🤖 /http/import Robotを使って認可済み URL をインポートする方法を説明しています。url
パラメーターは配列も受け取れるため、ファイルを上限を決めたバッチ単位で移行できます。Mux ガイドでは動画 Template の入力 Step を置き換える方法を示し、その他のガイドには画像バックフィル用の Template を含めています。以下は、公開画像 2 枚をインポートし、上の表のサムネイルを作成する実行可能な例です。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
}
}
実行には、当社の Node.js SDKに含まれる CLI を使います。ここでは @transloadit/node 5.1.0 で確認しています。Assembly が完了すると、各サムネイルの URL が出力されます。以下の短縮した URL は、実行結果では異なります。
$ 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

これらの結果 URL は一時的なものです。ファイルは通常
24 時間保持され、短期取得用として想定されています。本番環境では、ガイドにあるように、自身の認証情報を使う
🤖 /s3/store Robotのようなエクスポート Step を追加します。署名付き Assembly リクエストでは
notify_urlを設定し、通知シグネチャーを検証し、ASSEMBLY_COMPLETEDを必須にしてください。アプリケーションを更新する前に、結果を生成した Step から結果を読み取り、is_temp_url: falseを確認して、永続的なエクスポート URL を保存してください。/http/importは、インポートされたバイト数の 10% を処理使用量として計上します。リサイズ、メタデータ抽出、各種エクスポートには、それぞれ別途使用量が加算されます。詳しくは
Robot 料金を参照してください。
Smart CDN で動的 URL を維持する
フロントエンドで変換 URL を動的に組み立てている場合でも、すべてをアップロード時処理へ移す必要はありません。Smart CDNは、ある URL への最初のリクエスト時に Template を実行し、その結果をエッジでキャッシュします。その Template は、互換性のある Robot を使い、レスポンス分岐を /file/serve で終え、バックエンドで署名した URL経由で呼び出す必要があります。ここでは /image/resize は使えますが、/video/encode と
/video/adaptive は使えません。動画については、Mux ガイドで
/video/ondemand を案内しており、視聴者のリクエストに応じて HLS を生成します。
Cloudinary ガイドでは、高トラフィックページ向けには正規バリアントを事前生成し、裾野の広いライブラリには Smart CDN を使う構成を推奨しています。1 度アップロードすれば、以後は何度でも変換できるの記事では、このオンデマンド構成を最初から最後まで解説しています。
切り替え後に得られるもの
- 画像、動画、ドキュメントを 1 つのパイプラインで処理。 1 つの Assembly で、ファイルのインポート、画像リサイズ、動画エンコーディング、ドキュメントのサムネイル化、結果のエクスポートまで行えます。たとえば Filestack ガイドでは、画像と PDF を 1 つの Template でルーティングしています。
- メディア種別をまたいだ 1 つの使用量指標。 画像、動画、ドキュメント処理を、動画の分単位課金ではなく、GB ベースの 1 つの指標で計画できます。多くの処理 Robot は入力バイト数と出力バイト数の合計を計上し、個別の割引や最低料金があります。月次の支出上限も設定できます。詳しくは 料金を参照してください。
- オープンソースのアップロード。 ファイルアップローダーの Uppy と、その tus プラグインが再開可能アップロードに使う tus-js-client は、MIT ライセンスのオープンソースプロジェクトです。そのため、アップロード用フロントエンドを確認、フォーク、拡張できます。
- ストレージもリージョンも自分で選択。 結果は自分のバケットへエクスポートでき、処理は データレジデンシーの要件に合わせて米国、欧州、アジア太平洋から選べます。グローバルエンドポイントも利用できます。ストレージリージョンと配信リージョンは別々に設定できます。
これらのプラットフォームの違いをより広く把握したい場合は、スタートアップ向けメディア処理プラットフォーム比較を参照してください。
アプリケーション変更を計画する
ガイドが扱うのは、処理、アップロード、ストレージ、通知です。メディアのバイト列をコピーしても、メタデータ、グループ、バージョン、権限、ホスト型 DAM カタログ、CMS 連携は移行されません。そうしたレコードは保持したまま、必要なアプリケーション動作を再構築してください。Mux では、プレーヤー連携、分析、ライブストリーミング、DRM、多言語トラックのパッケージングについて、別途計画が必要です。Assembly は Mux asset や playback ID を再作成しません。プロバイダー固有の効果や AI ワークフローの置き換えは個別に検証し、実ファイルとアクセスルールを比較してからトラフィックを切り替えてください。
ガイドの例では、自身のバケットへエクスポートします。オリジナルと結果のためのマネージドストレージである Transloadit Storage は、現在プライベートプレビューです。試したい場合は、Workspace で有効化するようお問い合わせください。この記事のバックフィルでは一時結果を使うため、ストレージ設定は不要です。
まずは 1 つのワークフローから
移行一覧から対象ベンダーを選び、1 つのワークフローを棚卸しし、そのエクスポート先を設定して、自身のファイルを数件テストしてください。トラフィックを段階的に移し替える間は、ロールバックに備えて従来の asset ID と配信マッピングを使える状態にしておいてください。認証情報の取得には 登録 を、マッピングをもう一度確認してほしい場合は お問い合わせ を利用してください.
