OpenSearch项目DEB/RPM包中缺失agent文件夹问题分析与解决方案

问题背景

在OpenSearch 3.0.0-beta1版本的发布过程中，开发团队发现基于DEB/RPM包安装的OpenSearch无法正常启动，而使用Tar/Zip包安装的版本则运行正常。通过日志分析发现，系统报错显示无法找到agent/opensearch-agent.jar文件，这表明DEB/RPM打包过程中遗漏了关键的agent文件夹。

问题分析

通过对比不同打包格式的内容发现：

1. DEB/RPM包内容结构：

   bin
   jdk  
   lib
   modules
   NOTICE.txt
   plugins
   README.md
   

2. Tar/Zip包内容结构：

   agent
   bin
   config
   jdk
   lib
   LICENSE.txt
   logs
   modules
   NOTICE.txt
   plugins
   README.md
   

明显差异在于DEB/RPM包中缺少了agent目录，该目录包含OpenSearch运行所需的关键Java代理组件：

• opensearch-agent.jar
• byte-buddy-1.17.5.jar
• opensearch-agent-bootstrap-3.0.0-SNAPSHOT.jar

根本原因

经过代码审查发现，OpenSearch核心项目的打包脚本(distribution/packages/build.gradle)中，DEB/RPM包的构建配置没有包含agent文件资源的复制指令，导致最终生成的安装包中缺失这些必要文件。

解决方案

开发团队采取了以下修复措施：

1. 核心项目修复：修改OpenSearch项目的gradle构建脚本，在DEB/RPM打包配置中显式添加agent文件夹的复制指令：

into('/usr/share/opensearch') {
  // ...其他配置...
  
  into('agent') {
    with agentFiles()
  }
  
  // ...其他配置...
}

2. 构建系统适配：同步更新OpenSearch构建仓库(opensearch-build)的打包脚本，确保在最终产品组装阶段正确处理agent文件夹。

验证结果

修复后，团队进行了全面验证：

1. DEB包验证：

$ curl https://localhost:9200 -ku admin:examplePassword!
{
  "name" : "30b88f5a700d",
  "cluster_name" : "opensearch",
  "cluster_uuid" : "jLUJjTr9QZyFjrACc6nPbg",
  "version" : {
    "distribution" : "opensearch",
    "number" : "3.0.0-beta1",
    "build_type" : "deb",
    // ...其他版本信息...
  }
}

2. RPM包验证：

$ curl https://localhost:9200 -ku admin:examplePassword!
{
  "name" : "1e3522934a87",
  "cluster_name" : "opensearch",
  "cluster_uuid" : "1wKoiH