GitHub'a Proje Nasıl Yüklenir? Adım Adım GitHub Proje Yükleme

Bilgisayarınızda bulunan bir projeyi GitHub'a yüklemek için temel olarak Git kurulumu yapılır, GitHub üzerinde bir repository oluşturulur ve yerel proje bu repository'ye bağlanarak git push komutuyla gönderilir.

İlk kez GitHub kullanıyorsanız aşağıdaki adımları sırasıyla uygulayabilirsiniz.

1. Git'in bilgisayarınızda kurulu olduğunu kontrol edin

Terminal, PowerShell veya Komut İstemi'ni açarak şu komutu çalıştırın:

git --version

Git sürümü görüntüleniyorsa Git kuruludur.

Komut bulunamıyorsa önce Git'i resmi kaynağından kurmanız gerekir.

2. GitHub'da yeni repository oluşturun

GitHub hesabınıza giriş yaptıktan sonra yeni bir repository oluşturun.

Repository oluştururken:

- Proje adını belirleyin.

- Public veya Private seçimini yapın.

- Gerekliyse açıklama ekleyin.

Bilgisayarınızda zaten hazır bir proje bulunuyorsa başlangıçta README, .gitignore veya lisans dosyalarını GitHub tarafında otomatik oluşturmak yerine boş repository oluşturmak işlemi daha basit hale getirebilir.

3. Proje klasöründe terminal açın

Bilgisayarınızda GitHub'a göndermek istediğiniz proje klasörüne gidin.

Terminali bu klasörde açın veya terminal üzerinden klasöre geçin.

Örneğin:

cd proje-klasoru

Komutları doğru proje dizininde çalıştırdığınızdan emin olun.

4. Git repository oluşturun

Proje daha önce Git ile başlatılmadıysa:

git init

komutunu çalıştırın.

Bu işlem proje klasörünü yerel bir Git repository haline getirir.

5. .gitignore dosyasını kontrol edin

Projeyi GitHub'a göndermeden önce hangi dosyaların repository'ye eklenmemesi gerektiğini belirlemek önemlidir.

Özellikle Node.js projelerinde genellikle:

node_modules/

repository'ye gönderilmez.

Ayrıca .env gibi şifre, API anahtarı veya veritabanı bağlantı bilgileri içerebilecek dosyalar da public repository'ye kesinlikle yüklenmemelidir.

Projeye uygun bir .gitignore dosyası hazırlayın.

6. Dosyaları Git'e ekleyin

Projede takip edilmesini istediğiniz dosyaları eklemek için:

git add .

komutunu kullanabilirsiniz.

Ardından durumu kontrol etmek için:

git status

komutunu çalıştırabilirsiniz.

Bu aşamada yanlışlıkla gizli veya gereksiz bir dosyanın eklenip eklenmediğini kontrol etmek faydalıdır.

7. İlk commit'i oluşturun

Dosyaları ekledikten sonra:

git commit -m "Initial commit"

komutunu çalıştırın.

Commit, projenin mevcut durumunu Git geçmişine kaydeder.

Git ilk kullanımda kullanıcı adı ve e-posta bilgilerinizi ayarlamanızı isteyebilir.

Gerekirse:

git config --global user.name "Kullanici Adiniz"

git config --global user.email "mail@example.com"

şeklinde Git kimliğinizi yapılandırabilirsiniz.

8. Ana branch adını ayarlayın

Yeni repository'lerde ana branch için genellikle main adı kullanılır.

Yerel branch'i main yapmak için:

git branch -M main

komutunu kullanabilirsiniz.

9. GitHub repository adresini projeye bağlayın

GitHub'da oluşturduğunuz repository'nin HTTPS veya SSH adresini kopyalayın.

HTTPS örneği:

git remote add origin https://github.com/kullanici/proje.git

SSH örneği:

git remote add origin git@github.com:kullanici/proje.git

Buradaki adresi kendi repository adresinizle değiştirmeniz gerekir.

Bağlantının eklenip eklenmediğini kontrol etmek için:

git remote -v

komutunu kullanabilirsiniz.

10. Projeyi GitHub'a gönderin

İlk yükleme için:

git push -u origin main

komutunu çalıştırın.

Kimlik doğrulama başarılı olursa proje dosyalarınız GitHub repository'nize gönderilir.

Sonraki değişikliklerde temel işlem genellikle:

git add .

git commit -m "Değişiklik açıklaması"

git push

şeklinde devam eder.

GitHub şifre kabul etmiyorsa ne yapılmalı?

GitHub, Git işlemlerinde hesap şifresinin doğrudan kullanılmasına dayanan eski kimlik doğrulama yöntemini desteklemez.

HTTPS kullanıyorsanız uygun GitHub kimlik doğrulama yöntemlerinden yararlanmanız gerekir. SSH kullanacaksanız bilgisayarınızda SSH anahtarı oluşturup GitHub hesabınıza tanımlamanız gerekir.

Kimlik doğrulama yönteminiz kullandığınız Git ve GitHub yapılandırmasına göre değişebilir.

Repository'ye yanlışlıkla şifre yüklemeyin

GitHub'a proje yüklerken en önemli güvenlik konularından biri gizli bilgilerin korunmasıdır.

Şunları repository'ye göndermemeye dikkat edin:

- Veritabanı şifreleri

- API anahtarları

- Erişim tokenları

- Özel SSH anahtarları

- .env dosyaları

- Gerçek kullanıcı bilgileri

- Sunucu erişim bilgileri

Bir gizli bilgi commit geçmişine girdiyse yalnızca dosyayı sonradan silmek yeterli olmayabilir. İlgili anahtar veya şifrenin değiştirilmesi ve gerekirse Git geçmişinden de temizlenmesi gerekir.

Temel GitHub yükleme komutları

Yeni bir proje için temel akış özetle şöyledir:

git init

git add .

git commit -m "Initial commit"

git branch -M main

git remote add origin REPOSITORY_ADRESI

git push -u origin main

Bu komutları kullanırken REPOSITORY_ADRESI bölümüne kendi GitHub repository adresinizi yazmalısınız.

GitHub'a proje gönderirken hata alıyorsanız çalıştırdığınız komutu, aldığınız hata mesajını ve HTTPS mi SSH mı kullandığınızı paylaşmanız sorunun daha hızlı çözülmesini sağlar.