haveagitgat/tdarr_node_acc

Tdarr Node验收容器

概述

Tdarr Node验收容器是专为Tdarr Node设计的测试工具，用于验证Tdarr节点的功能完整性、兼容性及环境适配性。通过该容器，可在部署前或开发阶段对Tdarr Node进行自动化测试，确保节点能够正常接入Tdarr系统并处理媒体转码任务。

核心功能与特性

• 节点兼容性测试：验证节点与Tdarr系统（包括服务器、其他节点）的兼容性。
• 功能完整性验证：检查节点核心功能（如媒体文件解析、转码任务处理、状态上报）是否正常。
• 环境一致性检查：确保节点在不同部署环境中（如不同Docker版本、系统架构）表现一致。
• 轻量级测试框架：内置基础测试用例，无需额外配置即可快速启动验证。

使用场景

• Tdarr Node开发：开发自定义Tdarr节点时，通过验收容器验证功能实现是否符合预期。
• 部署前验证：在生产环境部署Tdarr节点前，确认节点满足运行要求，避免部署后出现功能异常。
• 版本升级测试：Tdarr系统或节点依赖库版本升级后，验证节点兼容性是否受影响。

使用方法

前提条件

• 已安装Docker Engine（20.10.0+）
• 可访问Tdarr服务器（本地或远程部署，需提供服务器URL）

基本使用（docker run）

bash
docker run -d \
  --name tdarr-node-acceptance \
  -e TDARR_SERVER_URL=http://tdarr-server:8266 \
  -e NODE_ID=test-node-01 \
  -e TEST_TIMEOUT=300 \
  tdarr/tdarr-node-acceptance:latest

环境变量配置

验证验收结果

1. 查看测试日志：

   bash
   docker logs tdarr-node-acceptance
   

   日志中若包含 [PASS] All acceptance tests completed successfully，表示节点验收通过；若出现 [FAIL] 开头的条目，需根据具体错误信息排查节点问题。

2. 测试报告： 容器会在 /app/test-results 目录生成JSON格式测试报告，可通过挂载目录持久化保存：

   bash
   docker run -d \
     --name tdarr-node-acceptance \
     -e TDARR_SERVER_URL=http://tdarr-server:8266 \
     -v ./test-results:/app/test-results \
     tdarr/tdarr-node-acceptance:latest
   

   报告文件路径：./test-results/acceptance-report-<timestamp>.json

注意事项

• 网络连通性：确保容器与Tdarr服务器之间网络通畅，防火墙规则需允许容器访问服务器端口（默认8266）。
• 资源限制：测试过程中节点需处理基础媒体文件，建议为容器分配至少2GB内存。
• 清理策略：测试完成后可停止并删除容器：

  bash
  docker stop tdarr-node-acceptance && docker rm tdarr-node-acceptance