Longhorn Manager（测试专用）镜像文档

镜像概述

本镜像为Longhorn存储系统的管理器组件，专为测试场景设计。它实现了Longhorn核心管理功能，可在开发、测试环境中对存储卷、节点、高可用配置等进行管理操作，支持功能验证、流程测试及兼容性验证。

主要用途

• 开发环境中Longhorn存储管理功能的快速验证
• 测试场景下存储卷生命周期（创建、删除、扩容等）的流程测试
• Longhorn新特性预发布阶段的功能测试与兼容性验证
• 集成测试中存储管理组件的模拟与控制

核心功能与特性

核心管理功能

• 存储卷全生命周期管理（创建、删除、挂载、扩容、快照）
• 节点状态监控与管理
• 备份与恢复功能测试支持
• 高可用性配置（如副本数调整、故障转移触发）测试

测试增强特性

• 内置调试日志模式，支持详细操作日志输出
• 临时配置覆盖机制，便于快速切换测试参数
• 测试专用API端点，支持模拟异常场景（如节点故障、网络分区）

使用场景与适用范围

适用场景

• 开发人员本地调试Longhorn管理逻辑
• QA团队执行存储功能自动化测试
• CI/CD流水线中集成存储组件的功能验证步骤

适用范围

• 开发环境、测试环境、CI/CD环境
• 非生产环境的Longhorn功能验证
• 不建议用于生产环境（缺乏生产级稳定性与安全加固）

使用方法与配置说明

基础使用（Docker Run）

bash
docker run -d \
  --name longhorn-manager-test \
  --network host \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/lib/longhorn-test:/var/lib/longhorn \
  -e LOG_LEVEL=debug \
  -e TEST_MODE=true \
  longhorn/manager:test

核心配置参数

环境变量

卷挂载要求

• 需挂载Docker守护进程套接字（/var/run/docker.sock）以管理容器化存储组件
• 建议挂载临时目录作为数据存储路径（测试场景避免持久化数据）

测试功能使用示例

启用调试日志

bash
docker run -d \
  --name longhorn-manager-debug \
  -e LOG_LEVEL=debug \
  longhorn/manager:test

模拟节点故障测试

通过测试API触发节点故障模拟（需启用TEST_MODE=true）：

bash
# 进入容器
docker exec -it longhorn-manager-test sh

# 调用测试API模拟节点故障
curl -X POST http://localhost:9500/v1/test/simulate-node-failure?node=test-node-1

注意事项

• 本镜像不含生产环境所需的安全加固与数据保护机制，禁止用于生产系统
• 测试数据默认存储于容器内，需通过卷挂载确保测试数据可持久化（如需保留测试结果）
• 测试模式下部分功能可能绕过正常校验逻辑，结果仅供测试参考，不代表生产环境表现