OpenCode ve GitOps üzerine kurulu bir homelab AI geliştirme platformu

Rsgm takma adıyla yazan bir homelab operatörü, TrueNAS sunucusunu AI destekli bir geliştirme platformuna nasıl dönüştürdüğünü anlattı. OpenCode kendi web arayüzüyle bir sunucu olarak çalışıyor, değişiklikleri Git'e gönderiyor ve GitOps hattı bunları ancak yazar pull request'i onayladıktan sonra dağıtıyor. 14 Haziran'da yayımlanan yazı, yaklaşık bir düzine Docker Compose yığınını ve modelin kendi düzenlediği servislerden uzak tutulmasının gerekçesini ele alıyor.

Claude Code'dan sağlayıcıdan bağımsız bir kodlama aracına

Daha önce Claude Code kullanıyordu, ancak AI sağlayıcılarının token sınırlarıyla müşteriler için değeri giderek kıstığını söylüyor; bu yüzden sağlayıcıdan bağımsız ve başlıca eklentilerle uyumlu bir çözüm aradı ve OpenCode'da karar kıldı. Belirleyici keşif, aracın yerleşik bir web sunucusu ve web arayüzüyle gelmesiydi. TrueNAS sunucusunda temel geliştirme araçlarıyla küçük bir VM kurdu ve OpenCode web sunucusunu bir systemd birimi olarak çalıştırıyor. Bu kurulum ona terminal, dosya tarayıcısı, Git diff'leri ve aynı anda birkaç kodlama oturumu yürütmek için git worktree desteği ile mobilde kullanışlı soru-cevap pencereleri sağlıyor.

Emniyet önlemleri: ayrı bir Git kullanıcısı ve zorunlu PR incelemesi

OpenCode'un Git sunucusunda kendi kullanıcısı ve ayrı SSH anahtarları var. Projeleri klonlayabiliyor ve feature dalları gönderebiliyor, ancak doğrudan deploy dalına gönderemiyor; böylece her değişiklik yazarın kendi birleştirdiği bir pull request'ten geçiyor. Yazar bunu sevimli bulduğunu söylüyor, ama daha önemlisi incelenmemiş kodun dağıtıma çıkmaması. VM'in internete ve Git sunucusuna erişimi var, servislerin kendisine ise yok. Etki alanı küçük kaldığı için yazar, derleme araçları veya test bağımlılıkları kurulması gerektiğinde VM üzerinde root vermekten çekinmiyor. İlk kazanç konteyner bakımı oldu: sürüm notlarını okuyup kırıcı değişiklikleri aramak için saatler harcamak yerine artık AI özetini dakikalar içinde okuyor ve konteynerlerin çoğuna sağlık kontrolleri eklendi.

GitOps zinciri ve eksik CI geri bildirimi

Dağıtım, Docker servis değişiklikleri için Arcane, Home Assistant yapılandırması için bir GitOps eklentisi ve blog için bir Cloudflare Pages worker'ı üzerinden yürüyor. Servisleri Compose yığınları Git'te saklanacak şekilde TrueNAS'ten Arcane projelerine taşıdı ve OpenCode ile birleşiminin beklediğinden iyi çalıştığını gördü: eskiden yığınlar arasında bağlantı izini sürmek saatler alan konteynerler arası ağ güncellemesi artık telefondan başlatılabiliyor. Eksik olan tek şey CI geri bildirimi. GitHub'da başarısız testleri, linter hatalarını, stack trace'leri ve altyapı planı değişikliklerini teşhis etmek için bir kodlama aracını Actions loglarına yönlendiriyor, ancak Forgejo iş loglarını genel API üzerinden açmıyor ve belgelenmemiş uç noktalar üzerine kurulum yapmak istemiyor.