VercelからBuildへの移行
BuildはNext.jsを標準のアプリケーションとしてデプロイ・実行するため、フロントエンドは同じリポジトリからビルドしてデプロイできます。
2つのプラットフォームで違うのは、サーバーサイドのコードの扱いです。Vercelはサーバーサイドのコードを、リクエストごとに起動するFunctionsとして実行します。Buildは常駐するプロセスを動かすため、Functionsとして書かれたコードは、webプロセス内のルートかワーカーになります。この書き換えが、Vercelからの移行作業の大部分を占めます。
移行の作業は、アプリケーションとデータの2つに分かれます。
2つのプラットフォームの比較はBuildとVercelの比較をご覧ください。
1. 書き換えが必要な箇所を特定する
Section titled “1. 書き換えが必要な箇所を特定する”Vercelで動いているものを洗い出し、次のように分類します。
- そのまま移行できるもの: ページ、静的アセット、リポジトリからビルドされるもの全般
- 常駐プロセスのルートになるもの: リクエストを処理するFunctionsとFluid Compute
- ワーカーまたはスケジュールジョブになるもの: cronジョブ、Workflows、長時間実行するものや状態を持つもの
Vercelのモデルに合わせるためだけにリクエスト単位に分割していた処理は、多くの場合、この段階でまとめられます。常駐プロセスなら、接続や状態を持ち続けられるためです。
エッジミドルウェアやフレームワーク固有の機能など、Vercelの構成のうちどう移せばよいか分からない部分があれば、Buildのサポートチームにご相談ください。Buildでどう実現するかを一緒に考えます。
2. Buildでアプリを作成する
Section titled “2. Buildでアプリを作成する”デプロイ先のチームを開き、New app をクリックします。チーム、パイプライン、ステージを設定します。
GitHubリポジトリを接続し、スタックとBuildpackを設定するか、Dockerfileを指定します。BuildはVercelと違ってコンテナイメージをビルドするので、ランタイムを完全に制御したい場合はDockerfileを選ぶとよいでしょう。アプリケーションのデプロイをご覧ください。
3. プロセスを定義する
Section titled “3. プロセスを定義する”アプリケーションのプロセスはProcfileに記述します。典型的なNext.jsアプリケーションはwebプロセスだけで動作します。バックグラウンド処理を行っていたFunctionsはworkerプロセスに、cronはスケジュールジョブにします。
Vercelのcronは関数を起動するトリガーですが、Buildのスケジュールジョブはアプリケーションのプロセスとして動きます。
4. 環境変数を持ち込む
Section titled “4. 環境変数を持ち込む”Vercelの環境変数をBuildアプリのconfig varsにコピーします。プレビュー用、開発用、本番用の値は、パイプラインの各ステージに分けて設定してください。
データベース接続文字列は、データベースをプロビジョニングしてから設定します。
5. デプロイして確認する
Section titled “5. デプロイして確認する”webプロセスを1 Dynoにスケールし、アプリを開いてVercelと同じように動作することを確認します。
これまでVercelが行っていた処理のうち、今後はアプリケーションかBuildで担うものを確認します。キャッシュの挙動、画像の処理、Vercelの設定に書いていたリダイレクトやリライトなどです。
データベース
Section titled “データベース”Vercelのデータストアはサードパーティのマーケットプレイス統合で提供されており、そのまま持ち出すことはできません。Buildのアドオンをプロビジョニングし、データを移行します。PostgresはSchema To Goに置き換えます。
- Buildでデータベースをプロビジョニングします。作成時に
import_urlで既存のデータベースを指定すれば、Buildがデータを取り込みます。 - アプリにアタッチします。アドオンのAttachmentsセクションでAttach to Appを選び、アタッチ名を
DATABASEにすると、アプリからDATABASE_URLとして参照できます。 - 再デプロイします。
データがVercel上ではなくサードパーティの事業者にある場合は、まずはそのままにしてBuildアプリから参照し、アプリケーションが安定してから別に移行する方法もあります。
エンジニアによる移行サポートはエンタープライズプランに含まれています。本番データを移行する前には、必ずエンジニアに相談してください。
6. 切り替える
Section titled “6. 切り替える”動作に問題がなければ、DNSをBuildに向けてトラフィックを移行します。Vercelのデプロイはそのまま動いているので、必要ならDNSをVercelに向け直して切り戻せます。
