TeamCity On-Premises 2024.12 Help

Node.js

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

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

前提条件

目前,Node.js 步骤只能在 Docker / LXC 容器内运行。 请参考 容器包装器 获取关于可用的 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. 导航到 Administration | <Your Configuration> 以访问构建配置设置。

  3. 打开 Build Features 设置选项卡。

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

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

除了此过程,您还可以让 TeamCity 从您的 JS 项目内的 .npmrc 文件解析一个令牌。 为此,请按照 here中指定的方式在此文件中声明一个令牌变量,然后在 TeamCity 中创建一个 environment variable NPM_TOKEN ,其值为访问令牌,并选择“Password”类型。

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