Turborepo

系统环境变量

通过设置某些环境变量,您可以更改 Turborepo 的行为。 这对于为不同的环境和机器创建特定的配置非常有用。

系统环境变量始终会被直接提供给您的 turbo 命令的标志值覆盖。

变量描述
TURBO_API

设置以下基础 URL 远程缓存.

TURBO_BINARY_PATH

手动设置 turbo 二进制文件的路径。默认情况下, turbo 将自动发现二进制文件,因此您只应在极少数情况下使用它。

TURBO_CACHE

控制缓存源的读取和写入。使用与

--cache

.

相同的语法

TURBO_CACHE_DIR

设置缓存目录,类似于使用

--cache-dir

标志

TURBO_CI_VENDOR_ENV_KEY 设置您想要从

排除的环境变量的前缀

框架推断。注意:这不需要用户设置,应由受支持的平台自动配置。

TURBO_DANGEROUSLY_DISABLE_PACKAGE_MANAGER_CHECK

禁用对 package.json 中的 packageManager 字段的检查。您可能会遇到 错误和意外的缓存行为

禁用此检查时。使用 true1 禁用。

TURBO_DOWNLOAD_LOCAL_ENABLED

如果未找到本地版本,则允许全局 turbo 安装正确的本地版本。

TURBO_FORCE

设置为 true 以强制所有任务完整运行,选择退出所有缓存。

TURBO_GLOBAL_WARNING_DISABLED

当全局 turbo 找不到要使用的本地版本时禁用警告。

TURBO_PRINT_VERSION_DISABLED

禁用打印正在执行的 turbo 版本。

TURBO_LOG_ORDER

设置

日志顺序。允许的值为 groupeddefault TURBO_LOGIN

设置用于登录到

TURBO_NO_UPDATE_NOTIFIER 远程缓存.

删除当有新版本的

turbo 可用时出现的更新通知程序。您还可以按照生态系统惯例使用 NO_UPDATE_NOTIFIER TURBO_PLATFORM_ENV

在受支持的 CI 环境 (Vercel) 中配置的环境变量键的 CSV。注意:此变量旨在供希望实现零配置环境变量的平台使用。您不应该作为最终用户使用此变量。

TURBO_PLATFORM_ENV_DISABLED

禁用检查在您的

turbo.json 中配置的环境变量与您支持的平台上设置的变量是否一致 TURBO_PREFLIGHT

在每次缓存工件和分析请求之前启用发送预检请求。后续的上传和下载将遵循重定向。仅在配置了

远程缓存时适用。 TURBO_REMOTE_CACHE_READ_ONLY

阻止写入

远程缓存,但仍允许读取。 TURBO_REMOTE_CACHE_SIGNATURE_KEY

使用密钥签名工件。有关更多信息,请访问

工件完整性部分

TURBO_REMOTE_CACHE_TIMEOUT

.

设置 turbo

获取工件的超时时间(以秒为单位) 远程缓存.

TURBO_REMOTE_CACHE_UPLOAD_TIMEOUT

设置 turbo 将工件上传到 远程缓存.

的超时时间(以秒为单位)TURBO_REMOTE_ONLY
始终忽略所有任务的本地文件系统缓存。

TURBO_RUN_SUMMARY 当您运行任务时,生成一个

运行摘要

TURBO_SCM_BASE

当计算从 base...head 更改的内容时,--affected 使用的基础

TURBO_SCM_HEAD

当计算从 base...head 更改的内容时,--affected 使用的头部

TURBO_TEAM

与您的存储库关联的帐户名称。当使用

Vercel 远程缓存时,这是您团队的 slug。

TURBO_TEAMID

与您的存储库关联的帐户标识符。当使用

与您的存储库关联的帐户名称。当使用

时,这是您团队的 ID。

TURBO_TELEMETRY_MESSAGE_DISABLED

禁用通知您 遥测已启用的消息。

TURBO_TOKEN

用于身份验证以访问 远程缓存.

的 Bearer 令牌

TURBO_UI

当传递 true 或 1 时启用 TUI,当传递 false 或 0 时禁用。

任务中的环境变量

变量描述
Turborepo 将在您的任务执行时使以下环境变量在您的任务中可用TURBO_HASH
当前正在运行的任务的哈希值。TURBO_IS_TUI
发送

包配置

下一页

文件 glob 规范

小时
节省的总计算量
开始使用

本页内容