Git ve GitHub temelleri

Klasörü kopyalamanın çözmediği neyi git çözer?

Git öncesi yöntemi herkes gördü: site, site-final, site-final-2 ve kimsenin silmeye cesaret edemediği o klasör. Sorun çirkin olması değil; o klasörlerin hiçbirinin neden yapıldığını ya da hangi dosyaların birlikte değiştiğini söylememesi.

Git bir sürüm kontrol sistemidir: birkaç tam kopya tutmak yerine, projenin durumunu sizin seçtiğiniz noktalarda kaydeder. Her nokta bir committir ve kopyalanmış bir klasörün asla taşımadığı üç şeyi taşır: kesin tarih ve saat, kaydeden kişinin adı ve değişikliğin neden yapıldığını söyleyen bir mesaj.

Git'in asıl değeri de o üçüncü şeydedir. Altı ay sonra anlamını çıkaramadığınız bir satıra geldiğinizde sorunuz bu satır nereden geldi olmaz; biri bunu neden yaptı olur. Git tam da bu soruyu yanıtlar, yeter ki mesajları ciddiye alarak yazmış olun. "değişiklikler" ve "düzeltme" dolu bir tarihçe, final-2 klasörü kadar işe yaramazdır.

Ve diğerlerinden önce işinize yarayacak pratik bir fark: git, iki nokta arasında tam olarak hangi satırların değiştiğini görmenizi sağlar. Dün çalışan bir site bugün bozuksa, bu bir konfor özelliği değil, nedeni saatler yerine dakikalar içinde bulmanın tek yoludur.

Git ile GitHub aynı şey değildir

Git, kendi bilgisayarınıza kurulan ve işi tarihçe tutmak olan bir programdır. GitHub ise bu tarihçeleri sunucularında barındıran ve etraflarına başka şeyler kurmuş bir şirkettir: profil sayfaları, hata takibi, kod incelemesi ve gerisi. Biri araç, öteki hizmet; kabaca kelime işlemcinin e-postaya oranı gibi.

Bu ayrımın, eğitimlerde genelde kaybolan önemli bir sonucu var: git dağıtıktır, yani bilgisayarınızda sunucuya bir işaretçi değil, tarihçenin tam bir kopyası durur. Gün boyu commit atabilir, tarihçeyi okuyabilir ve geriye dönebilirsiniz; bir kez bile internete bağlanmadan. push yalnızca aynı tarihçenin bir kopyasını başka bir yere de koyar.

Yani o barındırıcı yarın erişilemez olursa, makinenizdeki depo eksilmez ve onu başka herhangi bir yere gönderebilirsiniz: GitLab, kişisel bir sunucu, hatta bir harici disk. Barındırıcıyla birlikte kaybolan şey, hata kayıtları, birleştirme istekleri ve altlarındaki tartışmalardır; çünkü onlar git'in içinde değil, o şirketin kendi ürünüdür.

İran'daki okur için pratik bir cümle: yabancı barındırma hizmetlerine erişilip erişilemediği, o gün kendinizin denemesi gereken bir şeydir ve bugüne dair bir iddiayı buraya yazmıyoruz. Doğru karar bundan bağımsız zaten: tarihçeyi, bir hizmet ortadan kalkarsa işinizi durdurmayacak bir yerde tutun. Bu, git'in doğasına uyar ve hiçbir hizmete bağlı değildir.

İlk dört komut ve add aslında ne işe yarar

Bir projeyi git init ile git'in gözetimine alırsınız. Bu komut .git adlı gizli bir klasör oluşturur ve o andan sonra o klasörde olan her şey kaydedilebilir hale gelir. Henüz hiçbir şey kaydedilmedi; yalnızca defter açıldı.

git init
git add index.html
git commit -m "first page with contact form"
git push origin main

Yeni başlayanları şaşırtan komut addtir, çünkü gereksiz bir fazladan adım gibi görünür. Değildir. Dosyalarınızla tarihçe arasında hazırlık alanı denen bir ara masa vardır ve add "bunu masaya koy, bir sonraki anlık görüntüde olsun" demektir. Bugün değiştirdiğiniz on dosyadan yalnızca tek bir işe ait üçünü tek bir commit'te kaydetmenizi sağlayan şey o masadır.

İlk profesyonel alışkanlık burada oluşur: bir commit bir iş olmalı. Commit mesajında "ve" demek zorunda kalıyorsanız, muhtemelen iki commit olmalıdır. Bu bir zevk meselesi değil; bir değişikliği geri almak istediğiniz ve o değişikliğin başka iki işle aynı commit'e karıştığı gün bedelini ödersiniz.

Dördü içinde ağa ihtiyaç duyan tek komut pushtur. İlk üçü tamamen kendi makinenizde çalışır. Bunu akılda tutarsanız git'in hata mesajları da anlam kazanır: erişim ve kimlik doğrulama hatası neredeyse her zaman push ile ilgilidir, "kaydedilecek bir şey yok" ise neredeyse her zaman add yaptığınızı unuttuğunuz anlamına gelir.

İlk bozulan şey: asla işlenmemesi gereken bir dosya

Projenin kökündeki .gitignore adlı dosya, git'e neye dokunmayacağını söyler. İçinde her zaman üç kategori bulunur: yeniden kurulabilen bağımlılık klasörü, derleme sırasında üretilen dosyalar ve gerçek bir parola ya da anahtar taşıyan her şey.

İnsanların yara aldığı yer üçüncü kategoridir. Veritabanı parolasını içeren bir ayar dosyası bir kez işlenir, sonra biri fark eder, parolayı dosyadan çıkarır ve yeni bir commit atar. İş bitmiş değildir: git tarihçeyi saklar ve o parola hâlâ önceki commit'in içindedir, tek bir basit komutla görünür.

GitHub'ın kendi kılavuzu da aynısını söylüyor: böyle bir şeyden sonra o kimlik bilgisini yanmış saymalı ve değiştirmelisiniz; dosyayı tarihçeden çıkarmak tek başına yeterli değildir. Doğru sıra da insanın beklediğinin tersidir: önce parolayı değiştirin, sonra tarihçeyi temizlemeyi düşünün.

Yani ilk günden edinmeye değer alışkanlık şu: .gitignore dosyasını ilk commit'ten sonra değil, ondan önce yazın. Proje bir ayar örneği gerektiriyorsa, boş değerlerle config.example gibi bir dosya bırakın; böylece sonraki kişi neyin gerektiğini bilir ve hiçbir gerçek değer hiçbir yere kaydedilmez.

Bu dersin üzerinde yazıldığı site git'te değil

rgb.ir canlı bir sunucuda düzenleniyor ve bir git deposu yok. Bunu yazıyoruz, çünkü yalnızca öğüt veren ve kendisinin nerede durduğunu söylemeyen bir ders gerçeğin yarısıdır.

Peki git'in yerini ne aldı? Tema için yazdığımız düzenleyici, her kaydetmeden önce dosyanın bir kopyasını tarih ve saatle adlandırıp bir kenara koyuyor ve her dosyanın son yirmi sürümünü saklıyor. Sonra yeni dosyayı token_get_all ve TOKEN_PARSE bayrağıyla ayrıştırıyor; çünkü bu sunucuda hem php -l hem proc_open kapalı ve olağan sözdizimi denetimi kullanılamıyor. Yeni dosya ayrıştırılamazsa, canlı sayfa düşmesin diye o önceki kopya otomatik geri yükleniyor.

Bu, bir sürüm sisteminin asgari tanımına yakındır ve işini iyi yapar. Ama git'ten farkı tam da bu dersin konusu olan şeydir: o yirmi kopyanın hiçbiri neden kaydedildiğini söylemez, birlikte değişen iki dosyayı hiçbir şey birbirine bağlamaz ve yirmi birinci sürümden sonra geriye bir şey kalmaz.

Yani projeniz henüz git'te değilse, bu ders bir azar değil. Yalnızca bedelini bilin: git'in olmaması, her şeyin çalıştığı gün hiçbir şeye mal olmaz; çalışmadığı gün ise faturanın tamamını bir kerede keser.