GitHub Actions

以下示例展示了如何将 Turborepo 与 GitHub Actions 结合使用。

对于给定的根目录 package.json

./package.json

{
  "name": "my-turborepo",
  "scripts": {
    "build": "turbo run build",
    "test": "turbo run test"
  },
  "devDependencies": {
    "turbo": "latest"
  }
}

以及 turbo.json

./turbo.json

{
  "$schema": "https://turbo.rust-lang.net.cn/schema.json",
  "tasks": {
    "build": {
      "outputs": [".next/**", "!.next/cache/**", "other-output-dirs/**"],
      "dependsOn": ["^build"]
    },
    "test": {
      "dependsOn": ["^build"]
    }
  }
}

在你的仓库中创建一个名为 .github/workflows/ci.yml 的文件，内容如下

.github/workflows/ci.yml

name: CI
 
on:
  push:
    branches: ["main"]
  pull_request:
    types: [opened, synchronize]
 
jobs:
  build:
    name: Build and Test
    timeout-minutes: 15
    runs-on: ubuntu-latest
    # To use Remote Caching, uncomment the next lines and follow the steps below.
    # env:
    #  TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
    #  TURBO_TEAM: ${{ vars.TURBO_TEAM }}
    #  TURBO_REMOTE_ONLY: true
 
    steps:
      - name: Check out code
        uses: actions/checkout@v4
        with:
          fetch-depth: 2
 
      - name: Setup Node.js environment
        uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: 'npm'
 
      - name: Install dependencies
        run: npm install
 
      - name: Build
        run: npm run build
 
      - name: Test
        run: npm run test

远程缓存

要将远程缓存与 GitHub Actions 结合使用，请将以下环境变量添加到你的 GitHub Actions 工作流程中，以便你的 turbo 命令可以使用它们。

TURBO_TOKEN - 用于访问远程缓存的 Bearer 令牌
TURBO_TEAM - Monorepo 所属的帐户

要使用远程缓存，请检索你的提供商的远程缓存的团队和令牌。在此示例中，我们将使用 Vercel 远程缓存。

在 Vercel 仪表板中为你的帐户创建一个作用域访问令牌

Vercel Access Tokens

将该值复制到一个安全的地方。稍后你需要它。

转到你的 GitHub 仓库设置，然后单击 Secrets 选项卡，再单击 Actions 选项卡。创建一个名为 TURBO_TOKEN 的新 secret，然后输入你的作用域访问令牌的值。

GitHub Secrets GitHub Secrets Create

创建一个新的仓库变量（单击 Variables 选项卡），名为 TURBO_TEAM，然后输入你的团队 Vercel URL 的值，不包括 vercel.com/。使用仓库变量而不是 secret 可以防止 GitHub Actions 在日志输出中审查你的团队名称。

GitHub Repository Variables

你的团队 URL 可以在仪表板中团队的常规项目设置中找到。如果你使用的是 Hobby 计划，则可以使用你的用户名。你的用户名可以在你的 Vercel 个人帐户设置中找到

Vercel Account Slug

在你的 GitHub Actions 工作流程的顶部，为使用 turbo 的作业提供以下环境变量

.github/workflows/ci.yml

# ...
 
jobs:
  build:
    name: Build and Test
    timeout-minutes: 15
    runs-on: ubuntu-latest
    # To use Turborepo Remote Caching, set the following environment variables for the job.
    env:
      TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }} // [!code highlight]
      TURBO_TEAM: ${{ vars.TURBO_TEAM }} // [!code highlight]
 
    steps:
      - name: Check out code
        uses: actions/checkout@v4
        with:
          fetch-depth: 2
    # ...

使用 GitHub actions/cache 进行缓存

以下步骤举例说明了如何使用 actions/cache 在 GitHub 上缓存你的 monorepo 工件。

提供一个 package.json 脚本，该脚本将使用 Turborepo 运行任务。

带有 build 脚本的 package.json 示例

./package.json

{
  "name": "my-turborepo",
  "scripts": {
    "build": "turbo run build"
  },
  "devDependencies": {
    "turbo": "1.2.5"
  }
}

在 CI 文件的构建步骤之前，配置你的 GitHub 管道，使其包含一个使用 actions/cache@v4 action 的步骤。

确保在 actions/cache action 中设置的 path 属性与上面的输出位置匹配。在下面的示例中，path 设置为 .turbo。
在 key 属性下声明当前运行的缓存键。在下面的示例中，我们使用了 runner os 和 GitHub sha 的组合作为缓存键。
在 restore-keys 属性下声明所需的缓存前缀模式。确保此模式在未来的 ci 运行中仍然有效。在下面的示例中，我们使用了 ${{ runner.os }}-turbo- 作为缓存键前缀模式进行搜索。这允许我们在任何后续 ci 运行中命中缓存，尽管 github.sha 发生了更改。

示例 ci yaml，其中 .turbo 作为选定的缓存文件夹

.github/workflows/ci.yml

  jobs:
    build:
      runs-on: ubuntu-latest
      steps:
        - name: Check out code
          uses: actions/checkout@v4
 
        - name: Cache turbo build setup // [!code highlight]
          uses: actions/cache@v4 // [!code highlight]
          with:
            path: .turbo // [!code highlight]
            key: ${{ runner.os }}-turbo-${{ github.sha }} // [!code highlight]
            restore-keys: |
              ${{ runner.os }}-turbo- // [!code highlight]
 
        - name: Setup Node.js environment
          uses: actions/setup-node@v4
          with:
            node-version: 20
            cache: 'npm'
 
        - name: Install dependencies
          run: npm install
 
        - name: Build
          run: npm run build

GitHub Actions

远程缓存

使用 GitHub actions/cache 进行缓存

本页内容

资源

Turborepo

公司

法律声明

支持