Apache Pegasus手动压缩工具权限问题分析与解决方案

背景介绍

Apache Pegasus是一个分布式键值存储系统，提供了高效的数据存储和访问能力。在实际生产环境中，管理员经常需要使用pegasus_manual_compact.sh脚本来手动触发数据压缩操作，以优化存储空间和查询性能。

问题现象

在Kerberos认证环境中，当用户尝试使用pegasus_manual_compact.sh脚本执行手动压缩时，会遇到脚本执行后立即退出的问题。具体表现为：

1. 执行命令后仅输出基本信息，如UID、PID、集群地址、表名等
2. 脚本退出后，通过replica.query-compact命令确认压缩操作并未实际执行
3. 检查日志发现存在"Permission denied"错误，指向config-shell.ini文件的创建失败

问题根源分析

深入分析问题原因，我们发现：

1. pegasus_manual_compact.sh脚本内部会调用run.sh shell命令
2. run.sh在执行时会尝试在当前目录下创建临时配置文件config-shell.ini
3. 在Kerberos环境中，执行用户可能没有run.sh所在目录的写权限
4. 这种设计导致在权限受限环境中脚本无法正常工作

技术解决方案

针对这一问题，我们提出了以下改进方案：

1. 扩展pegasus_manual_compact.sh脚本功能，使其支持--config参数
2. 当使用--config参数时，脚本将直接使用指定的配置文件，而不再尝试创建临时文件
3. 同时保持对原有--cluster参数的支持，确保向后兼容
4. 增加参数校验逻辑，确保--cluster和--config参数不会同时使用

实现细节

改进后的脚本将包含以下关键变更：

1. 参数解析部分增加对--config的支持
2. 根据参数选择不同的shell调用方式：
   • 使用--cluster时：./run.sh shell --cluster ${cluster}
   • 使用--config时：./run.sh shell --config ${config_file}
3. 增加错误处理逻辑，确保在参数不合法时给出明确提示

实际应用价值

这一改进带来了以下实际好处：

1. 解决了Kerberos环境下的权限问题，使脚本能够在更多环境中稳定运行
2. 提供了更灵活的配置方式，用户可以根据实际情况选择使用集群地址或配置文件
3. 保持了与现有使用方式的兼容性，不影响已有自动化流程
4. 提升了工具在复杂环境中的适应能力

最佳实践建议

基于这一改进，我们建议用户：

1. 在权限受限环境中优先使用--config参数指定配置文件
2. 将配置文件放置在用户有写权限的目录中
3. 对于自动化部署，预先准备好配置文件并测试权限设置
4. 定期检查脚本执行日志，确保压缩操作按预期执行

总结

通过对pegasus_manual_compact.sh脚本的改进，我们有效解决了Kerberos环境下的权限问题，同时增强了工具的灵活性和可靠性。这一改进体现了Apache Pegasus项目对实际生产环境需求的快速响应能力，也展示了开源社区通过协作解决问题的典型模式。