离线插件管理

编辑

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.16.0.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.16.0.zip

    Linux 示例

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

    此命令期望一个文件 URI,因此请确保使用正斜杠并指定包的完整路径。

更新离线插件

编辑

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

  1. 在暂存服务器上,运行 bin/logstash-plugin update 子命令来更新插件。请参阅 更新插件
  2. 创建插件包的新版本。请参阅 构建离线插件包
  3. 安装插件包的新版本。请参阅 安装离线插件包