« 生成插件 私有 Gem 存储库 »
Elastic 文档 ›Logstash 参考 [8.14] ›使用插件

离线插件管理

编辑

离线插件管理编辑

Logstash 插件管理器 支持准备离线插件包，您可以使用这些插件包在无法访问互联网的系统上安装 Logstash 插件。

此过程需要一台运行 Logstash 的过渡机器，该机器可以访问公共或私有 Rubygems 服务器。过渡机器会下载并打包离线安装所需的所有文件和依赖项。

构建离线插件包编辑

“离线插件包”是一个压缩文件，其中包含离线 Logstash 安装所需的所有插件以及这些插件的依赖项。

要构建离线插件包，请执行以下操作：

  1. 确保要打包的所有插件都已安装在过渡服务器上，并且过渡服务器可以访问互联网。

  2. 运行 bin/logstash-plugin prepare-offline-pack 子命令以打包插件和依赖项

    bin/logstash-plugin prepare-offline-pack --output OUTPUT --overwrite [PLUGINS]

    其中

    • OUTPUT 指定将写入压缩插件包的 zip 文件。默认文件为 /LOGSTASH_HOME/logstash-offline-plugins-8.14.2.zip。如果您使用的是 5.2.x 和 5.3.0，则此位置应为将覆盖其内容的 zip 文件。
    • [PLUGINS] 指定要包含在包中的一个或多个插件。
    • --overwrite 指定是否要覆盖该位置的现有文件

示例

bin/logstash-plugin prepare-offline-pack logstash-input-beats 
bin/logstash-plugin prepare-offline-pack logstash-filter-* 
bin/logstash-plugin prepare-offline-pack logstash-filter-* logstash-input-beats

打包 Beats 输入插件和任何依赖项。

使用通配符打包所有过滤器插件和任何依赖项。

打包所有过滤器插件、Beats 输入插件和任何依赖项。

下载指定插件的所有依赖项可能需要一些时间，具体取决于列出的插件。

安装离线插件包编辑

要安装离线插件包，请执行以下操作：

  1. 将压缩包移动到要安装插件的机器。

  2. 运行 bin/logstash-plugin install 子命令并传入离线插件包的文件 URI。

    Windows 示例

    bin/logstash-plugin install file:///c:/path/to/logstash-offline-plugins-8.14.2.zip

    Linux 示例

    bin/logstash-plugin install file:///path/to/logstash-offline-plugins-8.14.2.zip

    此命令需要文件 URI，因此请确保使用正斜杠并指定包的完整路径。

更新离线插件编辑

要更新离线插件，请在过渡服务器上更新插件，然后使用与构建和安装插件包相同的过程

  1. 在过渡服务器上，运行 bin/logstash-plugin update 子命令以更新插件。请参阅更新插件。
  2. 创建新版本的插件包。请参阅构建离线插件包。
  3. 安装新版本的插件包。请参阅安装离线插件包。
« 生成插件 私有 Gem 存储库 »