Testcontainers-go v0.36.0 版本发布：Azure模块重构与多项功能增强

Testcontainers-go 是一个用于Go语言的轻量级库，它允许开发者在测试中轻松启动和管理Docker容器。通过简单的API，开发者可以快速创建数据库、消息队列等各种依赖服务，实现真正的集成测试。最新发布的v0.36.0版本带来了多项重要更新，包括Azure模块重构、日志系统改进以及多个新模块的加入。

重大变更与架构调整

Azure模块重构

本次版本对Azure相关功能进行了彻底重构，将原有的Azurite模块整合到新的Azure模块中。新模块不仅包含了原有的Azurite功能，还新增了对EventHubs和ServiceBus的支持。开发者需要注意，原有的Azurite容器类型中的Settings字段已被移除，迁移时需要调整代码结构。

重构后的Azure模块采用更合理的包结构，将不同服务划分到子包中，如azurite、eventhubs等，使得代码组织更加清晰。这种模块化设计也为未来添加更多Azure服务提供了良好的扩展性。

Docker SDK版本升级

项目将Docker SDK从v27升级到v28，这是一个重要的底层变更。新版本带来了性能优化和API改进，但也引入了一些不兼容的修改：

• Container.Inspect方法的返回类型从types.ContainerJSON变为container.InspectResponse
• Container.State方法的返回类型从types.ContainerState变为container.State
• DockerProvider.ContainerFromType方法现在接受container.Summary而非types.Container

开发者需要检查代码中是否直接使用了这些类型，并进行相应调整。值得注意的是，Docker团队在新的主要版本中重新组织了类型定义，建议开发者将github.com/docker/docker/api/types的引用更新为更具体的子包如github.com/docker/docker/api/types/container。

日志系统重构

v0.36.0对日志系统进行了全面改造，引入了新的log包来提供一致的日志输出。原有的testcontainers.Logging变量和testcontainers.TestLogger函数已被弃用，取而代之的是log.Default()和log.TestLogger()。

新日志系统的主要优势包括：

1. 更清晰的接口定义，通过log.Logger接口规范日志行为
2. 支持通过log.SetDefault(l log.Logger)灵活设置自定义日志实现
3. 统一的日志格式和输出控制
4. 更好的测试支持，通过TestLogger可以方便地捕获测试日志

新功能与模块增强

新增ScyllaDB和Pinecone模块

本次版本引入了两个重要的新模块：

1. ScyllaDB模块：提供了对高性能NoSQL数据库ScyllaDB的支持。ScyllaDB作为Cassandra的替代品，具有更低的延迟和更高的吞吐量，特别适合需要高性能分布式数据库的场景。

2. Pinecone模块：添加了对Pinecone向量数据库的支持。Pinecone是专为AI应用设计的向量数据库，能够高效存储和检索高维向量，非常适合机器学习和大语言模型应用。

其他功能改进

• Docker-in-Docker(DinD)支持：新增了dind模块，允许在容器中运行Docker守护进程，为需要构建或运行其他容器的测试场景提供了便利。

• MSSQL初始化SQL支持：通过WithInitSQL函数，开发者现在可以在MSSQL容器启动时执行自定义SQL脚本，简化了数据库初始化流程。

• Redpanda用户账户配置：Redpanda模块新增了引导用户账户的选项，增强了安全性配置能力。

质量提升与工程实践

代码质量改进

项目团队持续投入代码质量建设，通过多项措施提升代码健壮性：

1. 启用了更多revive静态检查规则，包括unused-parameter、use-any、var-declaration等，确保代码风格一致
2. 修复了多处拼写错误和命名不规范问题
3. 改进了错误处理流程，添加了panic恢复机制

持续集成优化

CI/CD流水线进行了多项改进：

1. 将lint检查分离到独立的构建步骤，加快反馈循环
2. 添加了流水线完整性检查，确保所有步骤成功完成
3. 优化了模块变更检测逻辑，避免重复构建
4. 引入了SonarQube代码质量分析，并集成到GitHub Actions中

依赖管理

项目持续更新依赖版本，包括：

1. 将Go版本升级到1.23.0
2. 更新多个关键依赖如golang.org/x/net到0.36.0
3. 定期更新Docker Compose及相关工具链

迁移指南与最佳实践

对于计划升级到v0.36.0的用户，建议采取以下步骤：

1. 逐步迁移：先更新依赖版本，再逐个处理破坏性变更
2. 日志系统迁移：
   • 替换testcontainers.Logging为log.Default()
   • 更新日志接口类型为log.Logger
3. Azure模块迁移：
   • 将Azurite相关代码移动到新的Azure模块
   • 移除对Settings字段的引用
4. Docker类型更新：
   • 检查所有直接使用Docker SDK类型的代码
   • 更新导入路径到新的子包结构
5. 测试验证：
   • 充分利用新的日志测试工具验证容器行为
   • 检查自定义容器逻辑是否受API变更影响

Testcontainers-go v0.36.0通过架构重构和功能增强，为Go开发者提供了更强大、更稳定的测试容器管理能力。特别是对Azure服务和日志系统的改进，使得在云原生环境下的测试更加便捷可靠。建议用户评估新版本功能，规划适当的升级路径，以充分利用这些改进带来的好处。