儲存庫
文件
升級到 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（在新分頁中開啟） 上提交問題。再次感謝您持續的支持，讓我們一起開啟 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 旗標表示）。在 Vercel 上使用 v1.x 快取時，每個 Vercel 帳戶（使用者或團隊）都有單一的共用遠端快取。如果您積極地為您的團隊使用多個 turborepo.com 專案，請在 Discord（在新分頁中開啟） 中告知我們。

請注意，我們不會將快取成品移轉到 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（在新分頁中開啟） 中聯繫我們。