› › ›

升级 Node.js

编辑

升级 Node.js编辑

Kibana 需要特定版本的 Node.js 才能运行。从源代码运行 Kibana 时，您必须在本地安装此版本。

步骤 1：生成自定义 Node.js 构建编辑

在提交 PR 升级 Node.js 之前，我们必须先生成与所需 Node.js 版本匹配的所需自定义 Node.js 构建。

步骤 2：创建 PR 以升级 Node.js编辑

所需的 Node.js 版本列在整个 Kibana 源代码中的几个不同文件中。升级 Node.js 时必须更新这些文件

.node-version
.nvmrc
package.json - 版本在 engines.node 字段中指定（如果可能，还要将 @types/node 升级到匹配的新版本，包括 devDependencies 和 resolutions）。
WORKSPACE.bazel - 版本在 node_version 属性中指定。除了此属性之外，node_repositories 下的文件列表及其各自的 SHA256 哈希值也必须更新。这些可以在公共 kibana-custom-node-artifacts GCP 存储桶中的 SHASUMS256.txt 文件中找到。Node.js v20.15.1 的示例：kibana-custom-node-artifacts/node-glibc-217/dist/v20.15.1/SHASUMS256.txt

有关如何升级 Node.js 版本的示例，请参阅 PR #128123。

主要 Node.js 升级注意事项编辑

升级到新的 Node.js 主要版本时，必须执行以下额外步骤

将新的 Node.js 版本支持的平台列表与Kibana 支持矩阵进行比较。例如，以下是Node.js 18 支持的平台列表。您可以通过更改所选分支来更改要查看的 Node.js 主要版本。如果 Node.js 已放弃对 Kibana 仍支持的平台的支持，则必须尽快采取适当的步骤来弃用对此平台的支持。这样，就可以在当前使用的 Node.js 主要版本达到生命周期结束之前放弃对它的支持。

Node.js 的自定义构建编辑

由于 Node.js 16 即将提前结束生命周期，并且 Node.js 18 不再支持 Kibana 支持的相同平台（最值得注意的是 CentOS7/RHEL7），因此我们无法将官方 Node.js 二进制文件与 Kibana 的 Linux 可发行版捆绑在一起。为了继续支持这些旧平台，我们正在将 Kibana 的 Linux 可发行版与具有扩展向后兼容性的自定义 Node.js 构建捆绑在一起。官方 Node.js 构建与我们的自定义构建之间的唯一区别是编译它所依据的 glibc 版本。

如何开始新的构建编辑

要生成新的自定义 Node.js 构建，请在我们专用的 Buildkite 管道上启动新的构建（需要 Elastic 员工权限）。给它起一个清晰的名称（例如 Node 20.15.1），并记住将自定义 OVERRIDE_TARGET_VERSION 环境变量设置为所需的 Node.js 版本 - 例如 OVERRIDE_TARGET_VERSION=20.15.1。您可以通过在“新建构建”对话框中展开“选项 >”来找到“环境变量”字段。

向后移植编辑

以下规则并非一成不变。向后移植时请酌情使用。

Node.js 补丁升级编辑

通常，您希望将 Node.js **补丁** 升级向后移植到运行相同**主要** Node.js 版本的所有受支持版本分支（目前是所有版本，但这在将来可能会更改）

如果当前版本是 8.1.x，则主 PR 应以 main 为目标，并向后移植到 7.17 和 8.1（GitHub 标签示例：backport:all-open）。

Node.js 次要升级编辑

通常，您希望将 Node.js **次要** 升级向后移植到之前的 Kibana 主要版本分支（如果它运行相同的**主要** Node.js 版本）

如果当前版本是 8.1.x，则主 PR 应以 main 为目标，并向后移植到 7.17，而将 8.1 分支保持原样（GitHub 标签示例：auto-backport + v7.17.13）。

Node.js 主要升级编辑

通常，您希望将 Node.js **主要** 升级向后移植到之前的 Kibana 主要版本分支

如果当前版本是 8.1.x，则主 PR 应以 main 为目标，并向后移植到 7.17，而将 8.1 分支保持原样（GitHub 标签示例：auto-backport + v7.17.13）。

升级已安装的 Node.js 版本编辑

以下说明假定使用nvm 来管理本地安装的 Node.js 版本。

运行以下命令以安装新的 Node.js 版本。将 <version> 替换为所需的 Node.js 版本

nvm install <version>

要获取与当前安装的 Node.js 版本相同的全局 npm 模块，请使用 --reinstall-packages-from 命令行参数（可以选择将 16 替换为所需的源版本）

nvm install <version> --reinstall-packages-from=16

如果需要，请运行以下命令卸载旧版本的 Node.js。将 <old-version> 替换为应卸载的版本的完整版本号

nvm uninstall <old-version>

（可选）告诉 nvm 始终使用“最高”的已安装 Node.js 16 版本。如果需要不同的主要版本，请替换 16

nvm alias default 16

或者，在末尾包含完整的版本号以指定特定的默认版本。

« 基路径注意事项共享已保存对象 »