リポジトリ
ドキュメント
v1へのアップグレード

Turborepo v1.xへのアップグレード

TurborepoがVercelに買収されました！この発表に伴い、Vercelはturbo CLIをオープンソース化し、移行期間中はすべてのアカウントでリモートキャッシュを無料で提供します。

既存のTurborepoのお客様は、できるだけ早くturbo CLIをv1.xにアップグレードし、Vercelに移行する必要があります（以下の手順を参照）。1.xより前のturbo CLIの古いバージョンは、今後メンテナンスされなくなります。beta.turborepo.comでの新規アカウントの作成は無効になっています。beta.turborepo.comダッシュボードとリモートキャッシュサービスは2022年1月15日にシャットダウンされ、古いバージョンはインストールできなくなります。

この時点で、既存のリモートキャッシュの成果物もすべて削除されます。.

以下は、既存のTurborepoユーザー向けのステップバイステップの移行ガイドです。もし行き詰まった場合は、コミュニティDiscord (新しいタブで開きます)にご連絡いただくか、GitHub (新しいタブで開きます)でIssueを提出してください。Turborepoのこの素晴らしい新たな章を共に始めるにあたり、引き続きご支援を賜りますよう、重ねてお願い申し上げます。

1. クリーンアップ

念のため、古い認証情報を削除するためにturboからログアウトしてください。

yarn turbo logout

存在する場合は、モノレポのルートから.turboディレクトリも削除してください。

rm -rf .turbo

2. 最新リリースのturboをインストールする

turboの最新バージョンをインストールします。

yarn add turbo --save-dev --ignore-workspace-root-check

3. リモートキャッシュの設定

前述のとおり、Turborepoは現在、Vercel (新しいタブで開きます)を介してゼロ構成のリモートキャッシュを提供しています。この移行期間中、リモートキャッシュはすべてのVercelプランで無料です。各Vercelアカウントには、共有のリモートキャッシュがあります。このキャッシュは、すべての環境（開発、プレビュー、本番）で共有されます。

重要: turborepo.comでは、チームごとに複数のキャッシュ（つまりプロジェクト）を許可していました（--projectフラグで指定）。v1.xでのVercelでのキャッシュでは、各Vercelアカウント（ユーザーまたはチーム）は単一の共有リモートキャッシュを持ちます。もしあなたがチームで複数のturborepo.comプロジェクトを積極的に使用していた場合は、Discord (新しいタブで開きます)でお知らせください。

Vercelにキャッシュアーティファクトを移行しないことにご注意ください。Vercelまたはカスタムキャッシュインフラストラクチャでリモートキャッシュを再構築する際、移行中のビルドが遅くなることをお詫び申し上げます。

4. ローカル開発

ローカル開発でリモートキャッシュを使用していた場合、アップグレードには1～2分かかります。開始するには、Vercel CLIにログインしてください。

npx turbo login

Vercel経由でリモートキャッシュを設定するには、以下を実行します。

npx turbo link

プロンプトに従い、接続したいVercelアカウント（ユーザーまたはチーム）を選択してください。

Vercelで

  • すでにTurborepoとVercelを一緒に使用していた場合は、すべてのプロジェクトからTURBO_TOKEN、TURBO_TEAM、およびTURBO_PROJECT環境変数を削除してください。これらはVercelによって自動的に設定されるようになりました。

  • Vercelプロジェクトの設定やpackage.jsonスクリプトでの--team、--token、および--project CLIフラグの使用を削除してください。

その他のCI/CDで

  • turborepo.comの個人アクセストークンを新しいVercel個人アクセストークン (新しいタブで開きます)に置き換え、TURBO_TOKEN環境変数または--tokenCLIフラグの同等の使用を更新してください。
  • TURBO_PROJECT環境変数を削除し、--projectCLIフラグの使用をすべて削除してください。これは非推奨になりました。
  • TURBO_TEAM環境変数と--teamCLIフラグの値を、Vercelアカウントのスラッグ（例：https://vercel.com/<スラッグ>）になるように更新してください。

ヘルプ

アップグレードで問題が発生した場合は、GitHub (新しいタブで開きます)で問題を提出してください。Vercelでのリモートキャッシュに問題がある場合は、Discord (新しいタブで開きます)でお問い合わせください。