開始する前に
まずオペレーティング境界を設定する。
- 繰り返し可能なローカルテストを備えた動作するアプリケーションとロックされたパッケージマネージャ。
- Cloudflareアカウント、Wrangler認証、および名前が付けられたプロダクション所有者。
- 必要なバインディング、シークレット、データ領域、および予期されるリクエストパスのリストです。
- 低リスクのスモーキーテスト経路とロールバック決定ルール。
ステップバイステップ
範囲からチェック済みアーティファクトに移動します。
デプロイメントパスを意図的に選択
新しいNext.jsアプリケーションの場合、Cloudflareが推奨するパスとしてvinextをリストしているため、まずvinext互換性を確認してください。既存のOpenNextデプロイメントの場合、移行中に未解決の互換性ギャップがある場合はアダプタを保持してください。真の静的エクスポートの場合のみPagesを使用してください。
- チェックポイント
- このリポジトリは、なぜvinext、OpenNext、またはstatic Pagesが今日のアプリケーションに適しているのかを記録しています。
- アーティファクト
- デプロイパスの決定記録
実行時とデータの境界を定義
どのルートがサーバーレンダリングまたはAPIを必要とするのか、どのルートが静的のままでも良いのかをリストアップしてください。検証された機能が必要な場合にのみD1、R2、KV、Workers AI、Queues、または他のバインディングを追加してください。各境界を通過するデータと、そのデータの削除および復元を担当するシステムをドキュメント化してください。
- チェックポイント
- すべてのバインディングには、名前付きの機能、データ所有者、および失敗の挙動があります。
- アーティファクト
- 実行時とバインディングマップ
ビルドを再現可能にする
アダプタとデプロイメントツールをピン留めし、バインディングタイプを生成し、型チェック、テスト、コンテンツ検証、および正確なプロダクションビルドコマンドを実行します。シークレットをソースコード管理から除外し、プレビュー設定とプロダクション設定を区別します。
- チェックポイント
- クリーンなチェックアウトは、文書化されていないローカル状態なしで同じデプロイメントアーティファクトを生成できます。
- アーティファクト
- 検証済みビルドおよび構成インベントリ
プロダクションアーティファクトをプレビューする
ビルドされたWorkerをローカルまたはプレビュー環境で実行し、ステータスコード、リダイレクト、メタデータ、静的アセット、認証された境界、およびデータベースのマイグレーションを確認してください。ローカル開発中でもリモートAIバインディングは請求対象となる可能性があるため、注意してください。
- チェックポイント
- 正確な製品アーティファクトは、書面によるルートとバインディングマトリクスを通過します。
- アーティファクト
- プレビューのスモーキーテスト記録
追跡可能なバージョンをリリース
コミットから公開バージョンマーカーを生成し、デプロイメントのドライランを実行し、不変ビルドをデプロイします。コミット、Workerバージョン、デプロイメント時間、オペレーターを記録してください。データスキーマやアプリケーションの動作を一度に変更しないでください。
- チェックポイント
- パブリックバージョンマーカーは意図されたコミットに解決され、デプロイプロバイダーは成功したバージョンを報告しています。
- アーティファクト
- プロダクションリリース記録
確認し、ロールバックを可能にしてください
公開ドメインに対してルートマトリクスを繰り返し実行してください。これは、重要な200、リダイレクト、404、メタデータ、およびAPIチェックを含みます。エラーとユーザーに見えるリグレッションを監視してください。リリースが重要なパスを破損したり、事前に書かれた受け入れ境界に違反したりした場合はロールバックしてください。
- チェックポイント
- プロダクションはリリース記録と一致し、または以前の信頼できるバージョンが復元されます。
- アーティファクト
- パブリック検証およびロールバック意思決定
出力物
作業を再利用可能で検査可能に保ちます。
- デプロイパスの決定記録
- 実行時、データ、バインディングマップ
- 繰り返し可能な製品ビルドコマンド
- プレビューのルートとバインディングマトリクス
- Workerリリース記録にコミット
- パブリックスモーキーテストおよびロールバック記録
決定境界
このチュートリアルが証明しないこと
- Cloudflareはvinextベータをラベル付けしています。既存の本番アプリケーションを移行する前に、互換性レポートを確認してください。
- OpenNextは文書化されたメンテナンス経路のままですが、これはCloudflareの新しいアプリケーションのデフォルトとして提示されてはなりません。
- D1、R2、Workers AI、およびその他のサービスには、選択したプランに対して確認が必要な別個の制限、料金、データ動作があります。
- 成功した展開は、アプリケーションの正しさ、セキュリティ、データ復元、またはモデル出力の品質を証明しない。
出典台帳
現在の主要なガイドラインを確認する
- Cloudflare Workers: Next.jsガイド
現在の推奨されるvinextパス、互換性チェック、Workersバインディングのプライマリソース。
- Cloudflare Workers: OpenNextアダプター
既存のOpenNextアプリケーションとそのサポートされているNext.jsの機能を維持するためのプライマリソース。
- Cloudflare D1ドキュメント
D1バインディング、データ、運用詳細のプライマリソース。
- Cloudflare R2ドキュメント
オブジェクトストレージの動作、制限、価格リンクのプライマリソース。