返回博客

Turborepo 1.3

2022 年 6 月 23 日，星期四
Greg Soltis
姓名
Greg Soltis
X
@gsoltis
Nathan Hammond
姓名
Nathan Hammond
Tom Knickman
姓名
Tom Knickman
X
@tknickman
Jared Palmer
姓名
Jared Palmer
X
@jaredpalmer
Gaspar Garcia
姓名
Gaspar Garcia
X
@gaspargarcia_
Becca Z.
姓名
Becca Z.
X
@becca__z

Turborepo 1.3 版本带来了改进的缓存和灵活性，其中包括

立即运行 npm install turbo@latest 进行更新。

Pipeline inputs

除了环境变量、依赖项和 pipeline 配置， turbo 在计算每个 package.json 脚本的哈希指纹（turbo 用于索引其缓存并确定脚本是否需要重新执行的键）时，还会考虑包文件夹中的所有非 git 忽略文件。使用 Turborepo 1.3+，您现在可以在 turbo.json 的 pipeline 中指定 inputs 的 glob 模式，以控制哪些文件与特定脚本的缓存相关。 这意味着您现在可以在 turbo.json 中表达以下内容

让我们通过一个具体的示例来说明：假设我们有一个 monorepo，其中包含一个用于文档网站的 Next.js 应用程序，位于 ./apps/docs-site，一些包，以及位于 monorepo 根目录的 ./docs 文件夹中的一些 markdown 文件。

示例 monorepo
.
├── docs/
│   ├── api-reference.md
│   ├── getting-started.md
│   └── intro.md
├── apps/
│   ├── docs-site/
│   │   ├── components/
│   │   ├── pages/
│   │   │   └── [slug].js
│   │   ├── README.md
│   │   └── package.json
│   └── web-site/
│       ├── pages/
│       ├── README.md
│       └── package.json
├── packages/
│   ├── configs/
│   └── ui/
├── package.json
└── turbo.json

假设 Next.js docs-site 渲染来自 ./docs 文件夹的 markdown 文件。我们现在可以在应用程序的 package.json 中设置 build 脚本，以在 turbo.json 中使用 inputs，从而更好地指定哪些文件是相关的（以及哪些文件应该影响缓存），如下所示

./turbo.json
{
  "$schema": "https://turbo.rust-lang.net.cn/schema.json",
  "pipeline": {
    // ... omitted for brevity
    "build": {
      "dependsOn": ["^build"],
      "outputs": [".next/**", "!.next/cache/**", "dist/**"]
    },
    "docs#build": {
      "dependsOn": ["^build"],
      "outputs": [".next/**", "!.next/cache/**"],
      // Define set of relevant globs which impact caching of docs site
      // builds
      "inputs": [
        "../../docs/**/*.md",
        "pages/**",
        "components/**",
        "package.json"
      ]
    }
  }
}

注意：与 outputs 一样，inputs 是相对于相关的 package.json 定义的，但它们可以在给定文件夹之外（例如 ../../docs/**）。

从 monorepo 根目录运行和缓存脚本

从 1.3 版本开始，turbo 现在可以从 monorepo 根目录的 package.json 文件运行和缓存脚本，这将极大地帮助迁移到 Turborepo。

要进行设置，请在 turbo.json 的 pipeline 配置中使用 "//#<script>": {...} 的形式指定根脚本。// 告诉 turbo 该脚本相对于 monorepo 的根目录，而不是每个工作区包。

关于根脚本和执行范围，有 2 个重要的注意事项

一个定义根脚本 check-examples 并选择将根目录纳入 test 的示例 pipeline 可能如下所示

./package.json
{
  "name": "my-turborepo",
  "private": true,
  "scripts": {
    "test": "echo 'test!'",
    "check-examples": "./check-examples.sh"
  },
  "devDependencies": {
    "turbo": "latest"
  }
}
./turbo.json
{
  "$schema": "https://turbo.rust-lang.net.cn/schema.json",
  "pipeline": {
    "build": {
      "dependsOn": ["^build"]
    },
    "test": {
      "dependsOn": ["^build"],
      "outputs": []
    },
    // This will cause the "test" script from all workspace package.json's
    // AND the root package.json to be included when "turbo run test" is run
    "//#test": {
      "dependsOn": [],
      "outputs": []
    },
    // This will cause the "check-examples" script in the root package.json
    // to be run when "turbo run check-examples" is run. Since a general
    // "check-examples" script is not defined in the pipeline, only the root
    // package.json's "check-examples" script will be included
    // when "turbo run check-examples" is run
    "//#check-examples": {
      "dependsOn": [],
      "outputs": [],
      "inputs": [
        "examples/**/*.ts",
        "examples/**/*.tsx",
        "examples/**/*.json",
        "examples/**/*.js",
        "examples/**/*.yaml",
        "cli/**/*.ts",
        "./scripts/run-example.sh"
      ]
    }
  }
}

注意：我们建议在 pipeline 中声明根任务时始终指定 inputs，以提高缓存效率。

新的 CI/CD 配方

我们添加了将 Turborepo 和远程缓存与以下工具一起使用的配方

如果您希望在此处看到其他配方，请通过打开 GitHub Discussion 告知我们。

其他错误修复和改进

社区

自从4 月初发布 Turborepo v1.2 以来，我们看到了惊人的采用率和社区增长

Turborepo 是包括我们的核心团队在内的 136 多位贡献者共同努力的成果。

此版本由以下人员的贡献提供：@gsoltis、@nathanhammond、@tknickman、@jaredpalmer、@zvictor、@ObliviousHarmony、@O4epegb、@rafaeltab、@mcmontseny、@bertspaan、@Jastor11 和 @enBonnet

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