main.go — merakit seluruh aplikasi

main.go adalah satu-satunya tempat di aplikasimu yang boleh tahu segalanya. Menyusunnya dengan benar membuat sisa kode tetap bisa diuji, dan membuat container gagal cepat saat ada yang salah.

Kerangka lengkap

package main

func main() {
	if err := jalankan(); err != nil {
		// Ditulis ke stderr karena logger mungkin belum sempat dibuat.
		fmt.Fprintf(os.Stderr, "fatal: %v\n", err)
		os.Exit(1)
	}
}

func jalankan() error {
	// 1. Sinyal → context. Semua yang di bawah mewarisinya.
	ctx, hentikanSinyal := signal.NotifyContext(context.Background(),
		os.Interrupt, syscall.SIGTERM)
	defer hentikanSinyal()

	// 2. Konfigurasi. Gagal di sini = container tidak pernah melayani.
	cfg, err := config.Muat()
	if err != nil {
		return err
	}

	// 3. Logger — sebelum apa pun yang mungkin perlu dicatat.
	log := buatLogger(cfg)
	log.Info("mulai", "versi", versi, "env", cfg.Env, "commit", commit)

	// 4. Observability, dengan penutupan yang mengirim sisa data.
	matikanOtel, err := platform.SiapkanOtel(ctx, cfg)
	if err != nil {
		return fmt.Errorf("otel: %w", err)
	}
	defer matikanOtel(context.WithoutCancel(ctx))

	// 5. Infrastruktur. Ping di dalam konstruktornya: kredensial salah
	//    harus jadi kegagalan startup, bukan 500 pertama.
	pool, err := platform.BukaPool(ctx, cfg.DSN.Buka())
	if err != nil {
		return fmt.Errorf("database: %w", err)
	}
	defer pool.Close()

	rdb, err := platform.BukaRedis(ctx, cfg.RedisURL)
	if err != nil {
		return fmt.Errorf("redis: %w", err)
	}
	defer rdb.Close()

	// 6. Domain.
	produkSvc := produk.NewLayanan(
		postgres.NewProdukRepo(pool),
		cache.NewRedis(rdb, "produk", time.Minute),
		log)

	pesananSvc := pesanan.NewLayanan(
		postgres.NewPesananRepo(pool),
		produkSvc,
		antrean.NewOutbox(pool),
		log)

	// 7. Transport.
	h := httpapi.New(produkSvc, pesananSvc, log, cfg)

	srv := &http.Server{
		Addr:              cfg.Addr,
		Handler:           h.Rute(),
		ReadHeaderTimeout: 5 * time.Second,
		ReadTimeout:       15 * time.Second,
		WriteTimeout:      15 * time.Second,
		IdleTimeout:       65 * time.Second,
		BaseContext:       func(net.Listener) context.Context { return ctx },
	}

	// 8. Jalankan sampai sinyal, lalu tutup rapi (Fase 3).
	return sajikan(ctx, srv, log, cfg)
}

Urutan yang penting

Versi build yang ikut ke dalam binari

var (
	versi  = "dev"
	commit = "none"
	waktu  = "unknown"
)

go build -ldflags "\
  -X main.versi=$(git describe --tags --always) \
  -X main.commit=$(git rev-parse --short HEAD) \
  -X main.waktu=$(date -u +%Y-%m-%dT%H:%M:%SZ) \
  -s -w" \
  -o bin/server ./cmd/server

Beberapa binari, satu modul

cmd/
├── server/main.go     # HTTP
├── worker/main.go     # pemroses antrean
├── migrate/main.go    # migrasi skema
└── seed/main.go       # data awal untuk staging

go build -o bin/server  ./cmd/server
go build -o bin/worker  ./cmd/worker
go build -o bin/migrate ./cmd/migrate

Daftar periksa startup

1. Konfigurasi tidak lengkap → keluar dengan kode bukan-nol, sebutkan semua yang kurang.
2. Database tidak bisa dihubungi → keluar, jangan melayani.
3. Migrasi tertinggal → putuskan sadar: gagal, atau jalan dengan peringatan.
4. Baris log pertama menyebut versi, commit, dan environment.
5. /sehat siap sebelum port didengarkan, dan tidak menyentuh database.
6. Setiap sumber daya yang dibuka punya defer penutupnya.