Turborepo logo
API 参考

选项概览

有三种方法可以管理 turbo 调用的行为

上述三种策略按优先级排序。如果为相同的系统环境变量或 turbo.json 配置提供了标志值，则将使用该标志的值。因此，我们建议使用

  • turbo.json 配置作为默认值
  • 系统环境变量用于每个环境的覆盖
  • 标志用于每次调用的覆盖

选项表

缓存

行为标志环境变量turbo.json
强制任务运行--forceTURBO_FORCEcache
远程缓存超时--remote-cache-timeoutTURBO_REMOTE_CACHE_TIMEOUTremoteCache.timeout
远程缓存上传超时-TURBO_REMOTE_CACHE_UPLOAD_TIMEOUTremoteCache.uploadTimeout
缓存签名密钥-TURBO_REMOTE_CACHE_SIGNATURE_KEYsignature
预检请求--preflightTURBO_PREFLIGHTremoteCache.preflight
远程缓存基础 URL-TURBO_APIremoteCache.apiUrl
缓存源--cacheTURBO_CACHE-
本地缓存目录--cache-dirTURBO_CACHE_DIRcacheDir

消息

行为标志环境变量turbo.json
禁用版本打印-TURBO_PRINT_VERSION_DISABLED-
禁用遥测消息-TURBO_TELEMETRY_MESSAGE_DISABLED-
禁用全局 turbo 警告-TURBO_GLOBAL_WARNING_DISABLED-
无更新通知器-TURBO_NO_UPDATE_NOTIFIER-

任务运行和日志

行为标志环境变量turbo.json
终端 UI--uiTURBO_UIui
运行受影响的任务--affected--
禁用包管理器检查--dangerously-disable-package-manager-checkTURBO_DANGEROUSLY_DISABLE_PACKAGE_MANAGER_CHECKdangerouslyDisablePackageManagerCheck
受影响的基础 ref-TURBO_SCM_BASE-
受影响的头部 ref-TURBO_SCM_HEAD-
仅运行直接指定的任务--only--
任务并发--concurrency--
任务日志顺序--log-orderTURBO_LOG_ORDER-
当前工作目录--cwd--
流式日志前缀--log-prefix--
任务日志输出级别--output-logs-option-outputLogs
全局输入--global-deps-globalDependencies
终端颜色--colorFORCE_COLOR-

环境变量

行为标志环境变量turbo.json
环境变量模式--env-mode-envMode
供应商环境变量-TURBO_CI_VENDOR_ENV_KEY-
框架变量例外--framework-inference--

调试输出

行为标志环境变量turbo.json
运行摘要--summarizeTURBO_RUN_SUMMARY-
图形可视化--graph--
模拟运行--dry--

身份验证

行为标志环境变量turbo.json
登录 URL-TURBO_LOGINremoteCache.loginUrl
团队名称 (用于多团队远程缓存)--teamTURBO_TEAM-
团队 ID (用于多团队远程缓存)-TURBO_TEAMID-
身份验证令牌--tokenTURBO_TOKEN-

其他

行为标志环境变量turbo.json
二进制路径-TURBO_BINARY_PATH-
下载本地 turbo-TURBO_DOWNLOAD_LOCAL_ENABLED-
守护进程--daemon / --no-daemon-daemon

上一个

文件 glob 规范

下一个

run

hours

总共节省的计算量
开始使用
远程缓存 →

本页内容