TeamCity On-Premises 2025.07 Help

Node.js

Node.js 构建运行程序允许运行 Node.js 工具,如 npmyarn节点

参考 配置构建步骤 以获取常见构建步骤设置的描述。

前提条件

目前,Node.js 步骤只能在 Docker/Podman 容器内运行。 请参考 容器包装器 获取关于可用的 Docker / Podman 设置的一般信息。

您可以定义当前构建步骤要使用的 Node.js 版本。 TeamCity 默认使用 node:lts 镜像,或者,如果您的项目中有一个 .nvmrc 文件,那么在创建构建步骤时,TeamCity 会自动从其中检测到镜像规格。

自动检测 JavaScript 步骤

如果您的存储库中包含一个 package.json 文件,TeamCity 将 自动检测所使用的框架,并建议添加相应的构建步骤。

当前支持的框架包括 ESlintJestMocha

如果 TeamCity 检测到一个 .nvmrc 文件,它将自动使用其中指定的 node 版本。

运行 Node.js 命令

Shell 脚本 字段中,输入此步骤中要执行的所有 Node.js 命令。

访问私有 NPM 注册表

在构建过程中访问私有 npm 注册表(例如,下载包),您需要:

  1. 按照 此处 描述的方法配置一个 NPM Registry 连接。

  2. 打开 配置设置并导航到 构建功能设置选项卡。

  3. 添加一个 NPM Registry Connection构建功能,并选择在第 1 步中创建的连接。

因此,TeamCity 代理将在构建过程中在此注册表中进行身份验证。

除了此过程,您还可以让 TeamCity 从您的 JS 项目内的 .npmrc 文件解析一个令牌。 为了实现这个,按照指定在此文件中声明一个令牌变量 这里 ,然后在 TeamCity 中用访问令牌的值和 "密码" 类型创建一个 环境变量NPM_TOKEN

最后修改日期: 2025年 8月 12日