FiveM Güncellemelerini Basitleştirmek ve Her Değişikliği Tespit Etmek İçin GitHub Desktop Kullanımı

Giriş

Her sunucu sahibi bu hissi bilir. Yeni bir kaynak sürümü yayınlanır, değişiklik günlüğü "/config/framework klasörünü değiştirin" der ve donup kalırsınız — çünkü o dosyaları ayarlamak için saatler harcadınız ve güncellemenin gerçekte neye dokunduğu hakkında hiçbir fikriniz yok. Üzerine yazıp çalışmanızı kaybeder misiniz? Klasörü atlayıp scriptin bozulması riskini mi alırsınız? Satırları elle ileri geri kopyalayıp bir şeyi kaçırmadığınızı mı umarsınız?

Çok daha iyi bir yol var — ve tek bir komuta bile dokunmanıza gerek yok. GitHub Desktop adlı ücretsiz bir uygulama ile, basit bir tıkla yönetilen arayüz üzerinden herhangi bir güncellemede tam olarak neyin değiştiğini görebilir, kendi özelleştirmelerinizi güvende tutabilir ve saniyeler içinde geri yükleme yapabilirsiniz.

Git Nedir ve GitHub Desktop Nedir?

Git bir versiyon kontrol sistemidir — bunu bir klasör için sınırsız, mükemmel bir geri alma geçmişi olarak düşünün. Her bir anlık görüntü ( commit olarak adlandırılır) kaydettiğinizde, her dosyanın tam durumunu kaydeder. Daha sonra herhangi iki anlık görüntüyü satır satır karşılaştırabilir, önceki bir durumu geri yükleyebilir veya değişiklikleri birleştirebilirsiniz.

GitHub Desktop Git'i kullanıcı dostu butonların arkasına yerleştiren ücretsiz, görsel bir uygulamadır. Siyah terminal yok, ezberlenecek komutlar yok — sadece neyin değiştiğini gösteren ve tek bir tıklamayla commit yapmanıza, geri almanıza ve birleştirmenize olanak tanıyan net bir pencere.

Bir FiveM sunucusu için takip ettiğiniz klasör, resources dizininizdir (veya içindeki tek bir scripttir). Git, "Birkaç hafta önce burada bir şeyleri değiştirdiğimi sanıyorum" ifadesini şuna dönüştürür: "geçen aydan bugüne tam olarak neyin değiştiğini bana göster."

Bu Neden Kaynak Güncellemeleri İçin Mükemmeldir

Bir scripti geleneksel yöntemle güncellemek, körleme çalışmak anlamına gelir. Git size üç süper güç verir:

1. Değişiklik algılama — yeni bir sürüm yükledikten sonra GitHub Desktop, değişen her dosyayı ve değişen her satırı vurgular. Değişiklik günlüğü size hangi klasörlerin değiştirileceğini söyler; Git, güvenebilmeniz için aslında neyin değiştiğini gösterir.
2. Güvenli özelleştirme — düzenlemeleriniz commit'lerde yaşar. Bir satıcı güncellemesi aynı dosyaya dokunduğunda, Git iki değişiklik setini birleştirebilir, sizinkini ve onlarınkini korur.
3. Anında geri yükleme — bir güncelleme sunucunuzu bozarsa, beş dakika önceki tam durumunuza tek bir tıklama uzaklıktasınız. "Yedeği nereye koymuştum" paniği yok.

GitHub Desktop ile Tek Seferlik Kurulum

Bunu her sunucu için yalnızca bir kez yaparsınız.

# Never track secrets
**/*.env
**/secrets.lua
server.cfg

# Caches, logs, build output
**/cache/
**/logs/
**/.DS_Store

Güncelleme İş Akışı

Bu, her güncelleme için tekrarladığınız rutindir. Yaklaşık bir dakika sürer.

Bir Şeyler Bozulduğunda Geri Alma

Güncelleme hatalı mı çalışıyor? Sakin olun — GitHub Desktop, hafif yöntemlerden radikal yöntemlere kadar size birkaç seçenek sunar.

Commit edilmemiş değişiklikleri geri al. Changes sekmesinde dosyaları (veya hepsini) seçin, sağ tıklayın ve Discard Changes / Discard All Changes seçeneğini seçin. Bu, dosyaları son commit halinize geri döndürür.

Daha önceki bir anlık görüntüye geri dön. Oluşturduğunuz her anlık görüntüyü görmek için sol kenar çubuğundaki History sekmesini açın:

• Temiz bir kayıt tutarak bir güncellemeyi güvenli bir şekilde geri almak için, hatalı commit'e sağ tıklayın ve Revert Changes in Commit seçeneğini seçin. Bu, yeni bir "geri alma" commit'i oluşturur — hiçbir şey kaybolmaz.
• Tamamen daha önceki bir duruma geri sarmak için, istediğiniz anlık görüntüye sağ tıklayın ve Reset to commit seçeneğini seçin.

Değişikliklerinizi geçici olarak kenara kaldırın — bir güncellemeyi temiz bir sayfa ile test etmek ve ardından çalışmanızı geri getirmek için kullanışlıdır. Changed files başlığına sağ tıklayın ve Stash All Changes seçeneğini seçin. Onları geri almak için kenar çubuğunda Stashed Changes öğesini seçin ve Restore butonuna tıklayın.

İpucu: Otomatik Birleştirme ile Vendor Güncellemeleri

Her güncellemeden sonra konfigürasyon düzenlemelerinizi elle tekrar uygulamaktan yoruldunuz mu? GitHub Desktop, üç yönlü birleştirme kullanarak bunu sizin yerinize yapabilir.

Mantık: Bir dalı saf vendor sürümleri ile, diğerini ise üzerine kendi düzenlemeleriniz ile tutun.

Bu, profesyonel ekiplerin yerel değişiklikleri kaybetmeden upstream kütüphanelerini takip etmek için kullandığı aynı tekniktir ve sunucunuz için de aynı derecede iyi çalışır.

Komut Satırını mı Tercih Ediyorsunuz?

Terminal kullanmaya alışıksanız, yukarıdaki iş akışının tamamı birkaç komuta karşılık gelir:

# One-time setup (run inside your resources folder)
git init
git add .
git commit -m "Baseline: working server before updates"

# Each update
git add . && git commit -m "Pre-update snapshot"   # snapshot first
# ...drop in the new release, overwriting files...
git status            # which files changed
git diff --stat       # a compact per-file summary
git diff              # full line-by-line changes
git add . && git commit -m "Update sky_base to 1.21.0"

# Rolling back
git restore <file>    # undo changes to one file
git restore .         # undo all uncommitted changes
git log --oneline     # find a snapshot
git reset --hard <id> # rewind to it (destructive)
git stash / git stash pop   # shelve and restore temporarily

En İyi Uygulamalar

• Her güncellemeden önce commit edin. Bir anlık görüntü almak iki saniye sürer ve saatler kazandırır.
• Net özetler yazın. Altı ay sonra geçmişi tararken Update sky_base to 1.21.0 gibi bir özet, stuff gibi bir özetten çok daha iyidir.
• Gizli bilgileri görmezden gelinen olarak tutun. Kimlik bilgileri asla sürüm geçmişinde yer almamalıdır.
• Temiz bir başlatma sonrasında commit edin, öncesinde değil. Bir anlık görüntüyü ancak sunucu gerçekten çalıştığında "iyi" olarak etiketleyin.
• Tüm resources klasörünüzü tek bir depoda takip edin. Bu sayede tek bir geri yükleme, herhangi bir scriptin hatalı bir güncellemesinden kurtulmanızı sağlayabilir.
• Yerel tutun. Lisanslı veya escrow korumalı kaynakları asla halka açık bir depoda yayınlamayın.

Sonuç

Bir FiveM sunucusunu güncellemek artık tahmin yürütmek, özelleştirmelerin kaybolması ve panik içinde yedek aramayı gerektirmiyor. Tek seferlik bir GitHub Desktop kurulumu ve bir dakikalık bir rutin ile, güncellemenin yaptığı her değişikliği görebilir, kendi düzenlemelerinizi koruyabilir ve herhangi bir hatayı anında geri alabilirsiniz — üstelik tek bir komut bile yazmadan.

Bir sonraki değişiklik günlüğü (changelog) size bir klasörü değiştirmenizi söylediğinde, bunu güvenle yapacaksınız; çünkü GitHub Desktop her seferinde size tam olarak neyin değiştiğini gösterecek.