TerminusDB CI/CD 中自托管运行器的容器清理问题分析

在TerminusDB项目的持续集成/持续部署(CI/CD)流程中，发现了一个关于自托管运行器(docker容器)未正确清理的技术问题。这个问题会导致后续构建失败，影响开发团队的持续集成效率。

问题背景

在TerminusDB的集成测试流程中，CI/CD系统会启动一个docker容器来运行测试。测试完成后，这个容器应该被自动清理，但实际流程中缺少了清理步骤。这会导致：

1. 容器资源未被释放，占用系统资源
2. 端口冲突可能导致后续测试失败
3. 可能影响其他并行运行的测试任务

技术细节

问题的核心在于check.yml工作流文件中，integration_tests_basic部分的实现存在缺陷。具体表现为：

• 测试启动时正确创建了docker容器
• 测试执行完毕后，没有调用docker stop和docker rm命令
• 容器以detached模式运行，没有自动清理机制

解决方案

修复此问题需要修改CI/CD工作流文件，确保在测试完成后执行以下操作：

1. 停止运行的测试容器
2. 删除已停止的容器
3. 可选：清理相关的网络和卷资源

正确的实现应该类似于：

steps:
  - name: Run integration tests
    run: docker-compose up -d
  - name: Cleanup
    run: |
      docker-compose down
      docker system prune -f

最佳实践建议

对于CI/CD环境中的容器管理，建议：

1. 始终为容器设置明确的超时时间
2. 使用--rm标志运行一次性容器
3. 在流水线中添加清理阶段作为最后一步
4. 考虑使用容器编排工具管理测试环境
5. 实施资源监控，防止资源泄漏

影响评估

这个问题的修复将带来以下改进：

• 提高CI/CD环境的稳定性
• 减少资源浪费
• 避免因端口冲突导致的测试失败
• 提升整体构建速度

对于TerminusDB这样的数据库项目，稳定的测试环境尤为重要，因为数据库测试通常涉及复杂的资源管理和状态验证。这个修复确保了测试环境的清洁和一致性，为开发团队提供了更可靠的持续集成体验。