› › ›

升级 Node.js

编辑

升级 Node.js

编辑

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

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

编辑

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

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

编辑

Kibana 源代码中的多个不同文件中列出了所需的 Node.js 版本。升级 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。您可以通过展开“New Build”对话框中的“Options >”找到“Environment Variables”字段。

向后移植

编辑

以下规则并非一成不变。向后移植时请使用最佳判断。

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>

要获取与当前安装的相同的全局 npm 模块以及新版本的 Node.js，请使用 --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

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

« basepath 的注意事项共享已保存的对象 »