Geliştirici Senaryoları-2: Projeyi Başka Bilgisayara Taşıma



Senaryo

Bilgisayarınız arızalandı ve tamir edilmesi gerekiyor. Bu nedenle tamir gerçekleşene kadar şirketinizin eticaretvadisi isimli projesini Githubdan başka bir bilgisayara kurup orada geliştirmeye devam etmeniz gerekiyor. Halihazırda SVS-5144 isimli branch üzerinde çalışıyorsunuz. 

Projeyi nasıl başka bilgisayarınızda başarılı şekilde yeniden kurup branchınızı geliştirmeye devam edersiniz?


Uygulama Adımları:


Başka bir bilgisayarda mevcut projene devam edebilmek için şu adımları takip edebilirsin:

1. Kurulum ve Proje Dizini Oluşturma

Eğer diğer bilgisayarda kurulu değilse şu uygulamaları indirip kurmalısın:

* Git

* VS Code ve kullandığın uzantılar

* Projenin back-end bağımlılığı varsa ilgili veritabanı uygulaması (MongoDB, MongoDBCompass, MYSQL ...)

* Node.js

Sonrasında, projeyi çalıştırmak istediğin bir klasör oluştur. VS Code'da bu klasörü aç ve terminali aç. 

Klasörü komut istemiyle oluşturmak istersen şu kodları kullanabilirsin:

mkdir proje-kontrol cd proje-kontrol

2. Projeyi GitHub’dan Klonlama

Github'a VS Code'da giriş yap. Bu konuda zorluk yaşarsan yazının sonundaki ek kısım yardımcı olacaktır.

VS Code'da proje klasörünü ve terminal açtıktan sonra terminalde aşağıdaki komutu kullanarak projeyi GitHub’dan indir:

git clone https://github.com/kullanici-adi/proje-adi.git

Bu işlem projeyi varsayılan olarak main ya da master branch'inde indirecektir.

3. Projenin İlgili Branch'ine Geçiş Yapma

Eski bilgisayarında üzerinde çalıştığın branchı Github'a yayınlamış ve son değşiklikleri göndermiş olman gerekiyor. 

Eğer henüz yapmadıysan branchını Publish et ve son değişiklikleri Commit ve Sycnc ederek hazır hale getir.

Yeni bilgisayarında ise klonlama işlemi tamamlandıktan sonra, açmış olduğun VS Code terminalinde proje dizinine gir ve üzerinde çalıştığın branch olan SVS-5144 branch'ine geçiş yap:

cd proje-adi git checkout SVS-5144

Branchın remoteda yüklü olup olmadığını kontrol et:

git branch -r (Remoteda yüklü branchları listeler)

Eğer branch'in remote'da değilse, aşağıdaki komutla onu çekebilirsin:

git fetch origin (Github'dan projenin son halini alarak güncelle) git checkout -b SVS-5144 origin/SVS-5144 (Github'daki SVS-5144 branchının aynısını yerelde oluştur.)

####

Bu komutları kullanırken origini baştan tanımlamanıza gerek yoktur. Çünkü klonlama esnasında Git otomatik olarak bu tanımlamayı yapıyor. Fakat yine de sorun yaşarsanız şu komutları hatırlamakta fayda var:

Uzak depo (repository) bağlantısı ayarlamak

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

Mevcut origin Uzak Bağlantısını (Remote) Güncellemek

git remote set-url origin https://github.com/kullanici-adi/proje-adi.git

origin Uzak Bağlantısını (Remote) Kontrol Etmek

git remote -v

Yerel branch'ın uzak branch'ı doğru şekilde izlediğinden emin olma

git branch -vv

Yerel branchı bir uzak branch ile bağlama

git branch --set-upstream-to=origin/<branch_adı>

####

4. Proje Bağımlılıklarını Yükleme

package.json içinden kullanılan package manager ve versiyonunu (npm veya yarn gibi) tespit et. 

Eğer proje npm'nin eski bir versiyonunu kullanıyorsa aşağıdaki komutlarla bu versiyona geç:

nvm install version_number (for example: nvm install 20.11.70)
nvm use version_number

Yarn kullanıyorsanız önce yarn'ı yüklemeniz gerekecektir. Bunun için şu kodu çalıştır:

npm install --global yarn

Eğer yarn'ın özel bir versiyonunu kullanıyorsanız şu kodla ilgili versiyonu yükleyebilirsiniz:

npm install -g yarn@version_number

Projede kullanılan bağımlılıkları yüklemek için proje yapısına bağlı olarak aşağıdaki komutları çalıştır:

Node.js (npm/yarn kullanıyorsan):

npm install # veya yarn install

PHP (Composer kullanıyorsan):

composer install

5. Projenin Çalışması İçin Gerekli Ayarlamalar

Projede .env dosyası gibi özel ayarlar varsa, eski bilgisayarındaki .env dosyasını kopyalayıp yeni bilgisayara yapıştır. Eğer başka konfigürasyon dosyaları varsa, bunları da gözden geçirmelisin. .env dosyasının kurulması bu tür durumlarda en sık unutulan hususlar arasında yer alıyor. Geliştirici aldığı hatanın sebebini araştırırken gereksiz vakit kaybı yaşıyor.

Şirketinin standartları gereği olan default ayarlar varsa VS Code'da bunları yapmalısın.

Projenin çalışması için veritabanı gerekiyorsa veritabanını gerekli ayarlarla çalışır hale getirip, veritabanıyla projen arasındaki irtibatı sağlamalısın. Bunun için çoğunlukla veritabanının end-point URL'sinin projede ilgili yere yapıştırılması/ güncellenmesi yeterli olacaktır.

6. Son Durumu Kontrol Etme ve Devam Etme

Her şey tamamlandığında, kaldığın yerden projeye devam edebilirsin. Yeni değişiklikler yapmadan önce, en son commit'i kontrol etmek için:

git log --oneline

7. Projeyi Çalıştırma ve Test Etme

Projeyi çalıştırarak her şeyin düzgün çalıştığını kontrol et:

Node.js projesiyse:

npm start # veya yarn start

PHP/Laravel projesiyse:

php artisan serve

Bu adımlar seni kaldığın yerden çalışmaya devam etmene yardımcı olacaktır.


Ek Kısım:

GitHub'a Giriş Yapma

  1. VS Code'da GitHub ile Bağlantı Kurma

    • Proje dizininde terminali açın ve aşağıdaki komutu kullanarak GitHub ile bağlantı kurun:
      git config --global user.name "kullanici-adi" git config --global user.email "kullanici-eposta"
    • Bu komutlar, GitHub'daki kullanıcı adınızı ve e-posta adresinizi ayarlayarak Git işlemlerinde bu bilgilerin kullanılmasını sağlar.
  2. GitHub'a Giriş İçin Yetkilendirme

    • GitHub ile etkileşimde bulunmak için (örneğin, git push veya git pull komutları kullandığınızda) kimlik doğrulama yapmanız gerekir.
    • İlk kez bir depoya erişmeye çalıştığınızda, terminal sizi GitHub kimlik bilgilerinizi girmeye yönlendirebilir. Bu aşamada, kullanıcı adınızı ve şifrenizi girmeniz istenecektir.
  3. 2 Adımlı Doğrulama (Two-Factor Authentication)

    • Eğer GitHub hesabınızda 2 adımlı doğrulama aktifse, giriş yaptıktan sonra size bir doğrulama kodu sorulacaktır.
    • Bu kod genellikle mobil cihazınıza gönderilen bir SMS veya kimlik doğrulama uygulaması (örneğin, Google Authenticator veya Authy) üzerinden alınır.
    • Doğrulama kodunu girdikten sonra GitHub erişiminiz sağlanmış olur.

Giriş Yaparken 2 Adımlı Doğrulamayı Kullanma

  1. Doğrulama Uygulaması ile Giriş

    • Eğer 2 adımlı doğrulama aktifse ve mobil cihazınıza yüklediğiniz bir doğrulama uygulaması varsa, uygulama üzerinden aldığınız kodu terminalde ilgili alana girmeniz yeterlidir.
  2. Kişisel Erişim Token'ı Oluşturma (Personal Access Token)

    • 2 adımlı doğrulama ile GitHub'a giriş yaparken şifreniz yerine bir Kişisel Erişim Token'ı (Personal Access Token) kullanmanız gerekebilir.
    • GitHub'da kullanıcı ayarlarınıza gidin, "Developer settings" altında "Personal access tokens" bölümüne girin.
    • Yeni bir token oluşturun ve gerekli izinleri (örneğin, repo erişimi) verin. Bu token'ı şifre yerine terminalde kullanabilirsiniz.

Browser ile Kolay Giriş

  • GitHub, terminalden kimlik doğrulaması yaparken browser üzerinden de bir doğrulama süreci sunabilir. Bu durumda terminalde yukarıda anlatılan herhangi bir işlemi yapmanıza gerek kalmayacaktır.

  • Bu opsiyon otomatik çalışmazsa Git işlemlerinizi browser üzerinden gerçekleştirmek için terminalde şu komutu kullanabilirsiniz:
    git config --global credential.helper cache
  • Bu komut, GitHub kimlik bilgilerinizi kaydedecek ve bir süre boyunca tekrar tekrar istemeyecektir.

Comments