動画・SNS · Angla Admin

Remotion の縦動画を個人 VPS でレンダーしている構成

公開: 更新:

CIでbundle、VPSで全国動画1本を生成。並列数1、ファイルの確定順序、デプロイ中断後のrenderingからの復旧を実装に沿って説明します。

Angla Admin の日次動画は、GitHub Actions で Remotion の bundle を作り、既存の VPS で MP4 をレンダーしています。全国ランキング動画は1本に絞り、日次データの取り込み後にバックグラウンドで生成します。

この構成で実際に困ったのは、レンダー中のデプロイでプロセスが止まり、画面には処理中だけが残ったことでした。bundle と実行環境を分けるだけでなく、完成ファイルを確定する順序と、中断後に戻れる状態が必要でした。

実装確認: 2026-10-26。ranking-hook-render.ts、ranking-hook-prerender.ts、score-video.ts、playwright-queue.ts を参照しています。所要時間は2026-09-28の運用記録で、今回の再計測ではありません。

CI と VPS の動画生成の分担

bundle と日次データを別のタイミングで用意する

CI は動画コンポーネントから remotion-bundle/ を作り、アプリのデプロイ時に VPS へ送ります。VPS はこの bundle と対象日のランキングデータを使って、selectComposition() と renderMedia() を呼びます。日付が変わるたびに CI で bundle を作り直す構成ではありません。

レンダー前には bundle の index.html が存在するかを確認し、なければ remotion_bundle_missing として止めます。入力データの問題なのか、成果物の配置漏れなのかを区別するためです。

VPS の実行環境には Chromium や Remotion の依存関係も必要です。bundle があることだけで、動画を作れるとは判断できません。

10地方の取り込み後に、全国1本を生成する

スコアの取り込みは、データを保存した後に動画の事前生成を呼び出します。MP4 が完成するまで応答を待ちません。全国動画側で10地方がそろっているかを確認し、不足していれば待機します。投稿済みの動画も事前生成の対象から外します。

手動の生成ボタンと事前生成は、共通の renderNationalRankingHookForDate() を通します。台本・キャプションなどの前提確認、生成中の確認、完了・失敗の記録を別実装にしないためです。

ただし、生成処理はアプリのプロセス内で動きます。永続ジョブキューではないので、PM2 の再起動で中断した仕事が自動的に再開されるわけではありません。

並列数は1。画像と動画は別の待ち行列

現在のレンダー設定から、主要部分を抜き出すと次のようになります。

await renderMedia({
  composition,
  serveUrl,
  inputProps: renderProps,
  codec: "h264",
  outputLocation: tmpPath,
  concurrency: 1,
  timeoutInMilliseconds: 10 * 60 * 1000,
  overwrite: true,
});

concurrency: 1 は、一つの動画を並列に描画する処理数の設定です。それとは別に、withRemotionQueue() が動画ジョブを一つずつ流します。画像用の withPlaywrightQueue() は独立しており、各待ち行列の中を直列にします。

画像と動画が絶対に同時実行されない仕組みではありません。 動画待ちで画像の取り込みまで長時間止めないために分離しています。この待ち行列はプロセス内の Promise なので、複数のサーバーをまたぐ排他にもなりません。

なお timeoutInMilliseconds は、Remotion の公式仕様では delayRender() の解放待ちに関する設定です。動画処理全体が必ず10分以内に打ち切られる期限としては扱えません。

完成したファイルだけを確定する

出力は、最初から完成用のファイル名へ書きません。{date}-zenkoku.partial.mp4 に書き、レンダーに成功してから {date}-zenkoku.mp4 へ rename します。

処理の順序は次の通りです。

  1. 生成中の状態を記録する
  2. 一時ファイルへ MP4 を出力する
  3. TTS があれば音量の正規化を試す
  4. 一時ファイルを完成用の名前へ rename する
  5. 動画のパスと ready を保存する

レンダーが例外を返した場合は、一時ファイルを削除し、失敗を記録します。音量正規化だけに失敗した場合は、正規化前の音声を残して先へ進みます。「完成した MP4」と「音量調整まで成功した MP4」も同じ意味ではありません。

プロセスが強制終了すると、例外を処理する箇所まで進めません。一時ファイルや rendering の状態が残る可能性があるのは、そのためです。

デプロイ後に rendering が残ったとき

過去には PM2 の停止がレンダーに重なり、DB 上の rendering が残りました。再読み込みしても表示は変わらず、生成ボタンを押せない状態になりました。

現在は updated_at から12分未満の rendering を進行中と判断し、再生成を拒否します。管理画面には状態の再取得と生成ロックの解除もあります。

復旧時は、まずログと動いている処理を確認します。まだ生成中なら待ちます。停止済みなら、既存の完成ファイルと投稿済み記録を確認してからロックを解除し、必要な分だけ再生成します。12分経ったという理由だけで、以前の処理が終了したことまでは保証されません。

この仕組みには、自動で死活監視してジョブを引き継ぐ機能はありません。日次の少数生成に対象を絞り、状態を確認して復旧できる範囲で使っています。

Remotion で生成した動画フレーム

出力の一例。生成状態だけでなく、字幕・日付・読み上げを完成動画で確認します。

所要時間は過去の1回の条件付き記録

2026年9月28日、翌日分の実データ・TTSあり・VPS の空き時という条件で、全国版のレンダーは6分4秒でした。以前の版の約2分40秒に対して約2.3倍です。動画の表現も変わっているため、環境の性能だけを比較したベンチマークではありません。

この待ち時間を毎日10本分へ広げず、全国1本に絞っています。依頼のたびに利用者を待たせるサービスや大量生成なら、専用ワーカーと永続キューを検討する条件です。

読み上げの修正と音声欠落の確認はTTS を全国編だけ戻した話、SNS の投稿完了管理は半自動コンソールで扱っています。

関連記事

← 記事一覧