Turborepo 1.2

2022年4月8日，星期五

姓名: Jared Palmer
X: @jaredpalmer

姓名: Becca Z.
X: @becca__z

姓名: Gaspar Garcia
X: @gaspargarcia_

姓名: Greg Soltis
X: @gsoltis

自从一月下旬发布 Turborepo v1.1 以来，我们看到了惊人的采用率和社区增长

6.5k+ GitHub 星星
140k+ 每周 npm 下载量 (自我们关于 v1.1 的上一篇博文以来翻了一番)
95+ OSS 贡献者
900+ Turborepo 社区 Discord 成员
1.6 年 通过 Vercel 上的远程缓存节省的时间，每周节省超过 2.5 个月

我们在 Turborepo v1.2 中进一步改进了人体工程学、可观察性和安全性，功能包括

新的任务过滤 API: --filter 为 turbo run 添加了更强大的任务过滤功能
人类可读和 JSON dry run: --dry-run 标志可以打印出关于 turbo run 的信息，而无需执行任何任务，格式包括人类可读和 JSON 解析友好的格式
改进的内部调度器和图表: 我们重构了 turbo 的内部调度器和图表，使其更符合人体工程学和更可预测
增强的远程缓存安全性: 使用您自己的密钥对远程缓存工件进行加密签名

立即运行 npm install turbo@latest 进行更新。首次运行 turbo run 后，您将看到关于如何使用 @turbo/codemod 运行 v1.2 的自动迁移的说明。

新的任务过滤 API

我们很高兴发布我们最受欢迎的功能之一：通过 --filter 标志表达性地过滤任务的能力。--filter 标志是当前 --scope、--include-dependencies、--since 和 --no-deps 标志组合的更强大的替代品。

使用 --filter，您可以告诉 turbo 将命令执行限制为 monorepo 中匹配包的子集，基于名称、文件夹，甚至自 git commit ref 以来是否已更改。

看看您可以使用新的 --filter 命令完成的一些示例

--filter=<package_name> - 按确切的包名称或 glob 模式匹配
--filter=...<package_name>- 按包名称/glob 匹配，并包括所有匹配项的依赖包
--filter=...^<package_name>- 按包名称/glob 匹配，并包括所有匹配项的依赖包，但排除匹配项本身
--filter=<package_name>... - 按包名称/glob 匹配，并包括所有匹配包的依赖项
--filter=<package_name>^... - 按包名称/glob 匹配，并包括所有匹配包的依赖项，但排除匹配项本身
--filter={./path/to/package} - 按路径或文件系统 glob 模式匹配
--filter=[origin/main] - 按自 git commit ref 以来更改的包匹配

您可以将多个过滤器一起使用，以获得更精细的过滤，并将上述模式 {}、[]、^ 和 ... 的每个部分组合起来，以表达更复杂的行为。

例如，如果您有一个位于 ./apps/web 目录中的应用程序，其中本地包用作依赖项，并且 Turborepo 管道中 test 在拓扑上依赖于 ^build，则运行

终端

turbo run test --filter={./apps/web}[HEAD^1]^...

将告诉 turbo 确保构建依赖项，并在位于 ./apps/web 的应用程序的所有本地依赖项中运行 test 脚本，如果应用程序自 HEAD^1 以来已更改，则不包括该应用程序本身。

有关更多详细信息和示例，请参阅新的过滤文档。

使用 `--dry-run` 调试和自动化

现在，您可以通过将 --dry-run 或 --dry-run=json 附加到任何 turbo run 命令来查看 turbo run 的影响，而无需实际执行任何命令。这将产生人类可读或 JSON 输出。

Dry run 在两种情况下非常有用

调试和测试运行选项
使用 turbo 过滤和任务图来构建自动化

Turborepo Dry Run

我们希望这将提高对 turbo 正在执行的操作的可见性，加快调试速度，并使其更容易在动态 CI/CD 系统中利用 turbo。

改进的内部调度器和图表

当使用 turbo run 时，每个 package.json 任务都会被添加到内部图表中，以根据 Turborepo pipeline 中定义的推断关系映射依赖项。此任务图允许 Turborepo 有效地安排增量并发任务运行并缓存任务输出以供以后使用。

我们对内部任务调度器和生成的图结构进行了重大改进，从而提高了性能并改善了开发人员体验。例如，在许多情况下，您将不再需要使用 --include-dependencies。相反，在指定任务入口点后，新的和改进的图将代表您自动处理此图解析。

缓存输出完整性和签名验证

现在，您可以配置 Turborepo 在将远程缓存输出上传到远程缓存之前，使用带有密钥的 HMAC-SHA256 对其进行签名。当 Turborepo 下载签名的缓存工件时，它现在将验证工件的完整性和真实性。任何未能通过验证的工件都将被 Turborepo 忽略、丢弃并视为缓存未命中。

要启用此功能，请在您的 turbo.json 配置文件中设置 remoteCache 选项以包含 signature: true。然后通过声明 TURBO_REMOTE_CACHE_SIGNATURE_KEY 环境变量来指定您的密钥。

./turbo.json

{
  "$schema": "[https://turbo.net.cn/schema.json](https://turbo.net.cn/schema.json)",
  "remoteCache": {
    // Indicates if signature verification is enabled.
    "signature": true
  }
}

其他错误修复和改进

--sso-team 标志现在允许具有 SAML 令牌的团队通过 turbo login 登录，并具有正确的团队权限
--log-output 标志允许您控制哪些日志以及何时打印到终端，从而使您只关注新内容
现在支持 FORCE_COLOR 环境变量
TURBO_FORCE=true 环境变量现在将强制执行
--remote-only 和 TURBO_REMOTE_ONLY=true 将告诉 turbo 仅使用远程缓存
当至少尝试一个任务时，我们现在显示 >>> FULL TURBO
turbo run 命令支持带有 Plug'n'Play (PnP linker) 的 Yarn v2+，但 turbo prune 仍未完全支持
如果指定了 --profile，则修复了 chrome 跟踪的回归
现在，您可以使用 --concurrency=50% 按 CPU 百分比设置并发

Turborepo 1.2

新的任务过滤 API

使用 `--dry-run` 调试和自动化

改进的内部调度器和图表

缓存输出完整性和签名验证

其他错误修复和改进

我们正在招聘！

下一步是什么？

谢谢，贡献者