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

离线插件管理

编辑

离线插件管理

编辑

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.17.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 输入插件及其任何依赖项。

使用通配符打包所有 filter 插件及其任何依赖项。

打包所有 filter 插件、Beats 输入插件及其任何依赖项。

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

安装离线插件包

编辑

要安装离线插件包：

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

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

    Windows 示例

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

    Linux 示例

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

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

更新离线插件

编辑

要更新离线插件，请更新暂存服务器上的插件，然后使用您遵循的相同流程来构建和安装插件包

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