Builtin Template:安定したバージョン管理付きの変換
ゼロから作成するのではなく、十分にテストされた堅実な
Templateを出発点にしたいこともあります。今回発表する Builtin Template は、Transloadit が保守するバージョン管理付きの
Templateです。ほかの
Templateと同様に、template_id で参照できます。
Builtin Template は、一般的な変換や、すぐに使える構成要素として設計されています。安定性を備え、バージョン管理に対応しているため、変更管理が必要なデプロイでは特定のバージョンに固定できます。
Builtin Template とは?
Builtin Template は API2 内にあり、builtin/ で始まるスラッグで識別されます。以下はその例です。
builtin/encode-hls-video@0.0.1builtin/generate-image@0.0.1builtin/generate-video@0.0.1
template_id を通じて利用できます。
builtin/<name>は、認識されている最新バージョンを参照します。builtin/<name>@latestは、認識されている最新バージョンの明示的なエイリアスです。builtin/<name>@<version>は、特定のバージョンに固定します。
Builtin Template を使う理由
- 一般的な変換に、実績があり、正常に動作することが確認された基盤を利用
- 試すだけならTemplateの作成は不要で、連携をシンプルに維持
- バージョンを固定して予測可能な動作を確保し、準備ができた時点でアップグレード
- ほかのTemplateと同様に、実行時の上書きによって独自のStepと組み合わせ
簡単な例:Builtin Template を使った Assembly の作成
Builtin Template を使うAssemblyリクエストは、次のような形式です。
{
"template_id": "builtin/encode-hls-video"
}
ほかのTemplateと同様に、実行時に Stepを上書きしたり拡張したりできます(たとえば、ストレージへのエクスポート用のStepを追加できます)。上書きの詳細は、Templateをご覧ください。
利用できるものを探す
正式な一覧と利用上の注意事項は、ドキュメントに掲載しています。
API の一覧に表示したい場合は、GET /templates に
include_builtin を指定して含められます(詳細はエンドポイントのリファレンスをご覧ください)。
今後の予定
Builtin Template の提供範囲は現時点では限定的ですが、実際の利用状況に応じて拡充していきます。繰り返し実行している変換で、Builtin Template として提供するとよいと思うものがあれば、ぜひお知らせください。
まだTemplateを利用していない場合は、まずこちらから始めてください。
