Go CLI aracını GoReleaser ve Homebrew ile çoklu platforma nasıl dağıtırım?

Kısa cevap: Bu tam olarak GoReleaser’ın çözdüğü problem — bir .goreleaser.yaml + tag’de tetiklenen tek bir workflow, hem cross-compile’ı hem GitHub Release’i hem de Homebrew tap formülünü otomatik halleder.

Kısa cevap

Sizin yapmanız gereken tek şey paketleme zincirini elinizden bırakmak; gerisini GoReleaser üstlenir. Aracın kendisini yazma tarafını Go’da ilk CLI aracımı anlattığım yazıda ele almıştım; buradaki soru o binary’yi kullanıcının makinesine nasıl ulaştıracağınız.

Neden

1. Çoklu platform elle yönetilecek bir iş değil. darwin/arm64, darwin/amd64, linux/amd64, linux/arm64 — her hedefi elle derleyip arşivlemek, checksum üretmek ve Release’e yüklemek her sürümde tekrar eden bir emektir; GoReleaser bunu tek bir konfigürasyona indirir.

2. Tap ayrı bir repo olduğu için varsayılan token yetmez. Formül homebrew-tap reposunda yaşar; varsayılan GITHUB_TOKEN başka repoya yazamaz, o yüzden ayrı bir token şart.

3. Bozuk config en kötü anda, release anında patlar. Tag atıldıktan sonra fark edilen bir konfigürasyon hatası sürümü yarıda bırakır; bu yüzden doğrulamayı release’e değil PR’a taşımak gerekir.

Ne yapmalı

1. .goreleaser.yaml’da build matrisini tanımlayın. darwin/arm64, darwin/amd64, linux/amd64, linux/arm64 hedeflerini yazın. İsterseniz universal_binaries ile macOS için tek bir evrensel artefakt üretin; M1/M2/Intel ayrımı kullanıcı tarafında kaybolur.

2. Tag push’unda tetiklenen bir GitHub Actions workflow’u kurun. on: push: tags: ['v*'] ile goreleaser release çalışsın: cross-compile eder, arşivleri + checksum’ları üretir, GitHub Release’i yayımlar.

3. homebrew_casks: bloğuyla tap’i otomatik güncelleyin. Bu blok, cask’i ayrı bir homebrew-tap reposuna commit eder. Kullanıcı sonra brew install seninadin/tap/cli ile kurar. İhtiyacınız olan: tap reposuna push yetkisi olan bir PAT. (Eski brews: bloğu GoReleaser v2.10’dan beri deprecated; hâlâ çalışıyor ama yeni kurulumlarda homebrew_casks: kullanın.)

4. Sürüm bilgisini binary’ye gömüp config’i CI’da doğrulayın. ldflags ile version/commit/date stamp’leyin ki cli --version doğru bilgi versin. Pipeline’a goreleaser check ekleyin — config bozuksa release anına kalmadan, daha PR’da yakalarsınız.

Sonuç: Tag atın, gerisini GoReleaser yapsın — Releases + tap formülü tek komutla çıkar, manuel paketleme tamamen ortadan kalkar. Bu, Go ekosisteminde fiili standart; siz sadece tag disiplinini ve ayrı tap token’ını kurarsanız akış kendi kendine döner. CLI’yı paketleyip dağıtmanın daha geniş resmini hub yazısında ele aldım; oradaki dağıtım modelini bu workflow’a oturtursunuz.