Testcontainers — tes integrasi dengan database sungguhan

Fake di memori bagus untuk logika bisnis, tapi tidak menguji SQL-mu. Testcontainers menjalankan Postgres sungguhan di Docker selama tes, sehingga kueri, migrasi, dan constraint benar-benar teruji.

Satu container untuk satu paket

// internal/produk/main_test.go
var dbUji *pgxpool.Pool

func TestMain(m *testing.M) {
	if testing.Short() {
		os.Exit(m.Run())      // lewati; tes unit tetap jalan
	}

	ctx := context.Background()

	kontainer, err := postgres.Run(ctx, "postgres:17-alpine",
		postgres.WithDatabase("uji"),
		postgres.WithUsername("uji"),
		postgres.WithPassword("uji"),
		testcontainers.WithWaitStrategy(
			wait.ForLog("database system is ready to accept connections").
				WithOccurrence(2).
				WithStartupTimeout(30*time.Second)),
	)
	if err != nil {
		log.Fatalf("jalankan postgres: %v", err)
	}

	dsn, err := kontainer.ConnectionString(ctx, "sslmode=disable")
	if err != nil {
		log.Fatal(err)
	}

	// Migrasi yang SAMA dengan produksi — jadi migrasinya ikut teruji.
	if err := migrasi.Jalankan(dsn); err != nil {
		log.Fatalf("migrasi: %v", err)
	}

	dbUji, err = pgxpool.New(ctx, dsn)
	if err != nil {
		log.Fatal(err)
	}

	kode := m.Run()

	dbUji.Close()
	_ = kontainer.Terminate(ctx)
	os.Exit(kode)
}

Isolasi antar tes

// Cara tercepat: satu transaksi per tes, selalu di-rollback.
func repoUji(t *testing.T) *Repo {
	t.Helper()

	tx, err := dbUji.Begin(t.Context())
	if err != nil {
		t.Fatalf("mulai transaksi: %v", err)
	}
	t.Cleanup(func() { _ = tx.Rollback(context.Background()) })

	return NewRepoDenganTx(tx)
}

// Paling bersih (dan bisa paralel): satu skema per tes.
func dbTerisolasi(t *testing.T) *pgxpool.Pool {
	t.Helper()

	skema := "uji_" + strings.ReplaceAll(t.Name(), "/", "_")
	ctx := t.Context()

	if _, err := dbUji.Exec(ctx, "CREATE SCHEMA "+pgx.Identifier{skema}.Sanitize()); err != nil {
		t.Fatal(err)
	}
	t.Cleanup(func() {
		_, _ = dbUji.Exec(context.Background(),
			"DROP SCHEMA "+pgx.Identifier{skema}.Sanitize()+" CASCADE")
	})
	...
}

Yang hanya bisa diuji dengan database sungguhan

1. SQL-mu sendiri — sintaks, nama kolom, join. Fake tidak menguji satu karakter pun dari kuerimu.
2. Migrasi — apakah up berjalan dari nol, dan apakah down benar.
3. Constraint — unique, foreign key, check. Termasuk kode error 23505 (Fase 4).
4. Transaksi dan penguncian — FOR UPDATE, SKIP LOCKED, deadlock.
5. Tipe khusus Postgres — jsonb, array, tstzrange.
6. Rencana kueri — EXPLAIN pada data yang cukup banyak.

Wadah lain yang berguna

// Redis
rd, _ := redis.Run(ctx, "redis:7-alpine")

// LocalStack: S3, SQS, Secrets Manager — untuk tes integrasi AWS (Fase 10)
ls, _ := localstack.Run(ctx, "localstack/localstack:3")

Memisahkan tes unit dan integrasi

go test -short ./...    # tanpa Docker: cepat, jalan di mana saja
go test ./...           # lengkap: butuh Docker

# Langkah CI
- run: go test -short -race ./...        # cepat, di setiap push
- run: go test -race ./...               # lengkap, sebelum merge