测试容器

人工智能 社区

技能解读

当前原文的自动摘译,尚未人工审校。

何时使用

针对真实的 Postgres、Redis、Kafka、NATS 或其他容器化依赖项进行测试 验证 SQL、迁移、索引、事务、锁定或驱动程序行为 针对真实的 Redis 实例测试缓存集成 用基于容器的密封集成测试取代脆弱的假环境 设计仍允许并行测试的包范围测试基础架构

默认立场

除非有明确的理由不这样做,否则更喜欢这些默认值: 使用真正的容器进行集成测试,而不是模拟 当模块存在时,优先选择特定于模块的帮助程序,例如postgres.Run和redis.Run,而不是较低级别的通用设置 对于通用服务,优先选择testcontainers.Run而不是旧的GenericContainer模式 在正常测试中立即使用testcontainers.CleanupContainer(t, ctr)注册清理

术语:容器不是模拟

对于 Postgres 和 Redis 集成测试,更喜欢真正的 Postgres 和 Redis 容器。这些不是嘲笑。模拟/假货最适合单元测试和窄缝测试容器是最好的,当你想对真实的依赖行为有信心时如果测试是为了验证 SQL、迁移、事务、Redis 命令、TTL 行为或网络依赖行为,那么真正的容器通常是正确的工具。

版本和 API 注释

github.com/testcontainers/testcontainers-go 是主要库 更喜欢现代的 Run(...) API GenericContainer 是较旧的风格;对于新的通用容器示例,更喜欢 testcontainers.Run(...) 模块级 RunContainer(ctx, opts...) 帮助程序已弃用;更喜欢postgres.Run(...)、redis.Run(...)等。WithReuseByName(...)是实验性的;不要将其设为默认的 CI/测试策略

生命周期范围权衡

有意选择容器生命周期: 范围 · 启动成本 · 隔离 · 并行友好性 · 建议使用 每次测试 · 最高 · 最强 · 优秀 · 小套件、破坏性测试、改变进程范围服务器状态的测试 每个包 · 中等 · 如果隔离测试数据则很强 · 正确隔离状态时优秀 · Postgres、Redis 和类似服务的默认值 交叉包/共享可重用容器 · 最低的热启动成本 · 最弱 · 有风险 · 仅本地实验;避免作为默认值

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
人工智能
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tomevault-io · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需手动接入
是否需要外部接口密钥
不需要
兼容的系统
Linux · Docker
运行环境要求
Docker
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 读取环境变量
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

输出预览 golang-testcontainers.preview
package repo_test

import (
    "context"
    "path/filepath"
    "testing"

    "github.com/stretchr/testify/require"

    "github.com/testcontainers/testcontainers-go"
    "github.com/testcontainers/testcontainers-go/modules/postgres"
)

func TestRepositoryWithPostgres(t *testing.T) {
    t.Parallel()

    ctx := context.Background()

    ctr, err := postgres.Run(ctx,
        "postgres:16-alpine",
        postgres.WithDatabase("app_test"),
        postgres.WithUsername("postgres"),
        postgres.WithPassword("postgres"),
        postgres.WithInitScripts(filepath.Join("testdata", "init.sql")),
        postgres.BasicWaitStrategies(),
    )
    testcontainers.CleanupContainer(t, ctr)
    require.NoError(t, err)

    dsn, err := ctr.ConnectionString(ctx, "sslmode=disable")
    require.NoError(t, err)

    _ = dsn // open your DB client here
}

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。