GitHub'a Mevcut Proje Nasıl Gönderilir? Git ile Proje Yükleme

Bilgisayarınızda geliştirmeye başladığınız mevcut bir projeyi GitHub'a göndermek için proje klasöründe Git repository oluşturmanız, dosyaları commit etmeniz, GitHub repository'sini remote olarak tanımlamanız ve ardından git push yapmanız gerekir.

Projeniz zaten hazırsa sıfırdan oluşturmanıza gerek yoktur.

1. Önce projenizin yedeğini alın

Git işlemlerine başlamadan önce özellikle önemli projelerin yedeğini almak iyi bir alışkanlıktır.

Git normal kullanımda dosyalarınızı silmez ancak yanlış kullanılan reset, checkout veya temizleme komutları veri kaybına neden olabilir.

İlk kez Git kullanıyorsanız proje klasörünün bir kopyasını almak faydalı olabilir.

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

GitHub'a göndereceğiniz projenin ana klasörüne gidin.

Örneğin:

cd C:\projeler\uygulamam

Linux veya macOS üzerinde örnek:

cd ~/projeler/uygulamam

Ardından:

git status

komutunu çalıştırabilirsiniz.

Proje henüz Git repository değilse buna ilişkin bir mesaj görebilirsiniz.

3. Git repository oluşturun

Proje daha önce Git ile takip edilmiyorsa:

git init

komutunu çalıştırın.

Eğer proje zaten .git klasörüne sahipse tekrar git init çalıştırmanız genellikle gerekli değildir.

Önce mevcut Git yapılandırmasını kontrol etmek daha doğru olur.

4. .gitignore dosyasını hazırlayın

Bütün proje dosyalarının GitHub'a gönderilmesi doğru değildir.

Özellikle Node.js projelerinde:

node_modules/

klasörü genellikle repository'ye eklenmez.

Ayrıca gizli bilgiler içeren dosyalar da dışarıda bırakılmalıdır.

Örnek .gitignore içeriği:

.env

node_modules/

*.log

Projeye göre farklı klasör ve dosyalar eklenebilir.

5. Gizli bilgileri kontrol edin

git add komutunu çalıştırmadan önce projenizde:

- API anahtarları

- Veritabanı şifreleri

- Erişim tokenları

- SSH özel anahtarları

- Sunucu şifreleri

- .env dosyaları

bulunup bulunmadığını kontrol edin.

Özellikle repository public olacaksa bu adımı atlamayın.

6. Proje dosyalarını Git'e ekleyin

Dosyaları hazırladıktan sonra:

git add .

komutunu çalıştırın.

Ardından:

git status

ile hangi dosyaların commit'e dahil edileceğini kontrol edin.

Yanlışlıkla eklenen gizli veya gereksiz bir dosya görürseniz push işleminden önce düzeltin.

7. İlk commit'i oluşturun

Dosyaları Git'e ekledikten sonra:

git commit -m "Initial commit"

komutunu çalıştırabilirsiniz.

Git kullanıcı bilgileri daha önce yapılandırılmadıysa kullanıcı adı ve e-posta isteyebilir.

Gerekirse:

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

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

komutlarıyla yapılandırabilirsiniz.

8. GitHub üzerinde repository oluşturun

GitHub hesabınızdan yeni bir repository oluşturun.

Mevcut yerel projeyi göndereceğiniz için işlemleri kolaylaştırmak amacıyla başlangıçta boş repository oluşturabilirsiniz.

Repository:

- Public

- Private

olabilir.

Private repository yalnızca yetkilendirdiğiniz hesapların erişimine açık olacak şekilde kullanılabilir.

9. Mevcut remote olup olmadığını kontrol edin

Projeyi başka bir Git repository'den aldıysanız halihazırda origin tanımlı olabilir.

Kontrol etmek için:

git remote -v

komutunu çalıştırın.

Hiçbir sonuç yoksa yeni remote ekleyebilirsiniz:

git remote add origin REPOSITORY_ADRESI

Örneğin:

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

10. Origin zaten varsa ne yapılmalı?

Şu hatayı alabilirsiniz:

remote origin already exists

Bu durumda tekrar origin eklemek yerine mevcut adresi kontrol edin:

git remote -v

Repository adresini değiştirmek istiyorsanız:

git remote set-url origin YENI_REPOSITORY_ADRESI

komutunu kullanabilirsiniz.

Bu işlem özellikle mevcut bir projeyi farklı GitHub repository'sine bağlarken kullanışlıdır.

11. Ana branch'i kontrol edin

Aktif branch'i görmek için:

git branch

komutunu kullanabilirsiniz.

Ana branch'in main olmasını istiyorsanız:

git branch -M main

komutunu çalıştırabilirsiniz.

Ancak ekip halinde kullanılan mevcut bir projede branch adını değiştirmeden önce repository yapısını kontrol edin.

12. Mevcut projeyi GitHub'a gönderin

Remote bağlantısı hazır olduğunda:

git push -u origin main

komutuyla projeyi GitHub'a gönderebilirsiniz.

İlk push işleminden sonra normal çalışma akışı genellikle:

git add .

git commit -m "Yapılan değişiklik"

git push

şeklinde devam eder.

GitHub repository tamamen boş değilse dikkat edin

GitHub tarafında repository oluştururken README veya başka dosyalar eklediyseniz uzak repository ile yerel projenin commit geçmişleri farklı olabilir.

Bu durumda doğrudan push yapmaya çalıştığınızda Git işlemi reddedilebilir.

Hata aldığınızda doğrudan zorla gönderme yapmak yerine önce:

git status

git remote -v

git branch

gibi komutlarla mevcut durumu kontrol edin.

Uzak repository'de korunması gereken dosyalar varsa bunları dikkate alarak geçmişleri birleştirmek gerekir.

Force push kullanırken dikkat edin

İnternette bazı çözümlerde:

git push --force

komutunu görebilirsiniz.

Bu komut uzak repository geçmişinin üzerine yazılmasına neden olabileceği için ne yaptığınızı bilmiyorsanız kullanmayın.

Özellikle ekip tarafından kullanılan repository'lerde veri kaybına veya diğer geliştiricilerin commit geçmişinin bozulmasına yol açabilir.

Mevcut proje için temel komut sırası

Git kullanılmayan hazır bir projeyi boş bir GitHub repository'sine göndermek için temel akış:

git init

git add .

git commit -m "Initial commit"

git branch -M main

git remote add origin REPOSITORY_ADRESI

git push -u origin main

Ancak proje daha önce Git kullanıyorsa git init, branch veya remote işlemlerini tekrar uygulamak yerine önce mevcut yapılandırmayı kontrol edin.

Proje daha önce başka GitHub hesabına bağlıysa

İlk olarak:

git remote -v

ile bağlantıyı kontrol edin.

Yeni repository'ye geçmek istiyorsanız uygun durumda:

git remote set-url origin YENI_REPOSITORY_ADRESI

kullanılabilir.

Ardından doğru hesaba erişim yetkinizin bulunduğundan emin olun.

GitHub'a mevcut proje gönderirken hata alırsanız git status, git remote -v, aktif branch adı ve aldığınız hata mesajını paylaşmanız problemin çok daha hızlı anlaşılmasını sağlar.