Repo
Docs
升级到 v1

升级到 Turborepo v1.x

Turborepo 已被 Vercel 收购！随着这一宣布，**Vercel 开源了 turbo CLI，并在过渡期间为所有帐户提供免费的远程缓存。**

现有的 Turborepo 客户应尽快将其 turbo CLI 升级到 v1.x 并迁移到 Vercel（以下说明）。turbo CLI 1.x 之前的早期版本将不再维护。beta.turborepo.com 上的新帐户创建已被禁用。beta.turborepo.com 仪表板和远程缓存服务将于 2022 年 1 月 15 日关闭，旧版本将无法安装。

所有现有的远程缓存工件也将在此期间删除。.

以下是对现有 Turborepo 用户的逐步迁移指南。如果您遇到困难，请在社区 Discord (opens in a new tab) 中联系我们或在 GitHub (opens in a new tab) 上提交问题。感谢您在 Turborepo 进入这个激动人心的新篇章时持续的支持。

1. 清理

为了良好的卫生习惯，请确保您已从 turbo 注销以删除旧凭据。

yarn turbo logout

如果存在，请从您的 monorepo 的根目录中删除 .turbo 目录。

rm -rf .turbo

2. 安装最新版本的 turbo

安装最新版本的 turbo。

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

3. 设置远程缓存

如前所述，Turborepo 现在通过 Vercel (opens in a new tab) 提供零配置远程缓存。在此过渡期间，所有 Vercel 计划都可免费使用远程缓存。每个 Vercel 帐户都拥有一个共享的远程缓存。此缓存在所有环境（开发、预览和生产）之间共享。

重要：turborepo.com 允许每个团队（通过 --project 标志表示）拥有多个缓存（即项目）。使用 Vercel 上的 v1.x 缓存，每个 Vercel 帐户（用户或团队）都拥有一个共享的远程缓存。如果您正在积极地为您的团队使用多个 turborepo.com 项目，请在 Discord (opens in a new tab) 中告知我们。

请注意，我们不会将缓存工件迁移到 Vercel。对于您在 Vercel 或自定义缓存基础设施上重新填充远程缓存时遇到的较慢的构建，我们深表歉意。

4. 本地开发

如果您之前使用过远程缓存进行本地开发，升级将需要一两分钟。要开始，请登录 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 环境变量或 --token CLI 标志的等效用法。
  • 移除 TURBO_PROJECT 环境变量，并移除所有 --project CLI 标志的用法。该标志已弃用。
  • 更新 TURBO_TEAM 环境变量和 --team CLI 标志的值，使其为您的 Vercel 帐户标识符（例如 https://vercel.com/<slug>）。

获取帮助

如果您在升级过程中遇到困难，请在 GitHub (在新标签页中打开) 上提交问题。如果您在 Vercel 上的远程缓存方面遇到困难，请在 Discord (在新标签页中打开) 中联系我们。