TeamCity On-Premises 2026.2 Help

Ruby 环境配置器

Ruby 环境配置器 构建功能将 Ruby 解释器传递给所有构建步骤。 它(1)将所选的 Ruby 解释器和 gems bin 目录添加到系统 PATH 环境变量,并且(2)在 RVM 解释器的情况下配置其他必要的环境变量。

示例使用案例

例如,此功能允许在 命令行 构建运行程序中使用诸如 ruby, rake, gem, 束 等命令。 因此,如果您想在启动 Rake 构建运行程序之前安装 gems,您需要添加一个启动自定义脚本的 Command Line 构建步骤。 示例:

gem install rake --no-ri --no-rdoc gem install bundler --no-ri --no-rdoc

Ruby 环境配置器设置

选项

描述

Ruby 解释器路径

到 Ruby 解释器的路径。 如果未指定,解释器将在 PATH 中进行搜索。 在此字段中,您可以使用环境和系统变量的值。

示例:

%\env.I_AM_DEFINED_IN_BUILDAGENT_CONFIGURATION%

RVM 解释器

RVM 解释器的名称以及,可选地,构建代理上配置的 gemset。

解释器名称不能为空。 如果未指定 gemset ,将使用默认的。

如果您不想使用 .rvmrc 设置,可以使用此选项:例如,用不同的 Ruby 解释器运行测试,而不是在 .rvmrc 文件中定义的那些。

使用 .rvmrc 文件的 RVM

相对于签出目录的 .rvmrc 文件的路径。 如果指定,TeamCity 将使用 rvm-shell 获取环境变量,并将它们传递给所有构建步骤。

如果未找到 Ruby 解释器,则构建失败

启用它将会导致构建失败,原因是如果 Ruby 环境配置器无法将 Ruby 解释器传递给步骤执行环境,那么就是由于代理上找不到解释器。

2026年 9月 11日