Turborepo 1.8

2023年2月22日，星期三

姓名: Greg Soltis
X: @gsoltis

姓名: Nathan Hammond

姓名: Tom Knickman
X: @tknickman

姓名: Anthony Shew
X: @anthonysheww

姓名: Jared Palmer
X: @jaredpalmer

姓名: Mehul Kar
X: @mehulkar

姓名: Chris Olszewski

姓名: Nicholas Yang
X: @nicholaslyang

姓名: Alexander Lyon
X: @_arlyon

Turborepo 1.8 通过改进 turbo 对您的工作区的理解，为您的代码库带来更好的灵活性和更多控制。

工作区配置：现在您可以在工作区中添加 turbo.json 配置文件，以覆盖存储库中的根配置。
自动工作区范围界定：全局 turbo 现在可以自动推断您当前的工作区，以便它仅运行该工作区的任务。
更轻松的迁移：使用 npx @turbo/codemod migrate 自动迁移到新版本的 turbo。

立即运行 npx @turbo/codemod migrate 进行更新。

工作区配置

在工作区目录中，您现在可以添加 turbo.json 来

添加特定于该工作区的任务
覆盖任务的配置

这将使团队能够通过从全局配置转向对工作区中任务的细粒度控制，来扩展其 monorepo 中项目的所有权。

例如，假设您的 monorepo 有一个 Next.js 应用程序和一个 SvelteKit 应用程序，并且您想使用 Turborepo 来缓存 build 任务的输出。Next.js build 脚本创建一个 .next 目录，而 SvelteKit 创建一个 .svelte-kit 目录。与其在根目录 outputs 中添加两个构建目录，不如在工作区中定义 outputs 键

turbo.json

{
  "pipeline": {
    "build": {
      "dependsOn": ["^codegen"]
      // no need to define outputs here!
    }
  }
}

apps/my-nextjs-app/turbo.json

{
  "extends": ["//"],
  "pipeline": {
    "build": {
      // dependsOn is inherited from root
      "outputs": [".next/**", "!.next/cache/**"]
    }
  }
}

apps/my-sveltekit-app/turbo.json

{
  "extends": ["//"],
  "pipeline": {
    "build": {
      // dependsOn is inherited from root
      "outputs": [".svelte-kit/**"]
    }
  }
}

工作区配置中的 extends 键使工作区所有者可以使用根 turbo.json 的最佳部分，并自定义使其应用程序不同的部分（如果您习惯于定义从根目录运行的任务，则 "//" 符号会看起来很熟悉）。

已声明的键如果存在，将替换根目录中的键，从而覆盖根配置中定义的内容。未声明的键从根配置继承。

在上面的示例中，outputs 为两个应用程序自定义，而 dependsOn 由根 turbo.json 配置，并保持为 "^codegen"。

在文档中了解更多信息.

自动工作区范围界定

在 Turborepo v1.7 中，turbo 变为全局可安装，使您能够从代码库中的任何位置运行任务。但是，turbo 仍然会从根目录运行任务，从而运行您可能不希望运行的其他工作区中的任务。

在 1.8 中，turbo 将自动检测您所在的工作区并生成 --filter 语法，以将您的任务限定在该工作区范围内。

例如，如果您的当前目录是 apps/admin 并且您使用 turbo build 命令，则 turbo 将在后台运行 turbo build --filter=admin，专注于您正在处理的工作区。

更轻松的迁移

升级 Turborepo 版本时，不再需要以正确的顺序手动运行各个 codemod。@turbo/codemod 现在提供了一个简单的 migrate 命令，该命令既可以将您的存储库升级到指定的 turbo 版本（默认为 latest），又运行任何必需的 codemod。

立即使用 npx @turbo/codemod migrate 试用。

社区

自从发布 Turborepo v1.7 以来，我们看到了令人难以置信的采用和社区增长

Turborepo 是所有贡献者（包括我们的核心团队）共同努力的成果。

感谢您一直以来的支持、反馈和协作，使 Turborepo 成为您首选的构建工具。