Gerrit/Eğitim

This page is a translated version of the page Gerrit/Tutorial and the translation is 100% complete.
Other languages:

Bu, Git ve Gerrit'in Wikimedia gelişimi için nasıl kullanılacağını açıklayan bir öğreticidir.

  • Zaman kazanmak ve teknoloji meraklısıysanız, bunun yerine çok kısa nasıl yapılır kılavuzunu kullanın: Gerrit/Eğitim/tl;dr
  • Uzman kullanıcılar için Gerrit/Advanced usage ek belgelere sahiptir.
  • Yalnızca Gerrit ile oynamak ve "gerçek" bir Wikimedia yazılım projesi için bir yama yazmak istemiyorsanız, bunun yerine Gerrit test örneğimizi kullanın.

Bu öğreticide, kutudaki dolar işareti ile başlamak için aşağıdaki gibi komutlar: command. $ önekini girmeyin.
Komut ayrıca kendinizi değiştirmeniz gereken bir değişken de içeriyorsa, değişken kırmızı renkte gösterilir: command variable.

Git nedir?

Git ücretsiz ve açık bir kaynaktır dağıtılmış sürüm kontrol sistemi. “Dağıtılmış”, deponun merkezi bir kopyası olmadığı anlamına gelir. Git ile, depoyu klonladıktan sonra, tüm dallar ve etiketli sürümler elinizin altında olacak şekilde kaynak kodunun tam olarak çalışan bir kopyasına sahip olursunuz.

Gerrit nedir?

Gerrit Git ile entegre olan ücretsiz, web tabanlı bir ortak kod inceleme aracıdır.

Temel olarak: Önerilen yazılım değişikliğinizi (Gerrit'te "changeset" olarak adlandırılır) yeni bir dal olarak gönderirsiniz. İlk sürüm ("patchset 1") henüz mükemmel değilse, o dalda ("patchset 2" vb.) daha fazla değişiklik yapabilirsiniz ("amend"). Bir yama seti bir "+2" incelemesi aldığında, kabul edilir ve kod deposunun ana dalında birleştirilir (genellikle "master" olarak adlandırılır). Birleştirme, birisi bu kod deposunu teslim aldığında veya indirdiğinde, yaptığınız değişikliğin varsayılan olarak dahil edileceği anlamına gelir.

Wikimedia geliştirici hesabı oluşturun

Henüz bir Wikimedia geliştirici hesabınız yoksa, wikitech.wikimedia.org sayfasına gidin ve bir hesap oluşturun. Aynı kullanıcı adı ve parola aşağıdaki Gerrit'te oturum açmak için kullanılacaktır.

Git'i kurun

Bu talimatlar Git'in komut satırı (terminal penceresi) aracı olarak nasıl kurulacağını açıklar. Komut satırı yerine grafik kullanıcı arabirimi (GUI) tercih ederseniz, Git projesi tarafından tutulan istemcilerin listesini denetleyin. Alternatif kurulum talimatları için resmi belgelere bakın.

Kurulum

  Linux

  • git paketini kurmak için Linux dağıtımınızın grafiksel yazılım paketi yönetim aracını kullanın.
  • Git dağıtımınız tarafından paketlenmemişse, lütfen dağıtımınızın destek forumuna sorun.

  Windows

  • Windows için Git ile https://gitforwindows.org/ üzerinden yükleyin. Bu size Git'e ek olarak bu talimatlardaki komut satırlarının çoğunun Windows üzerinde çalışmasına izin veren "Git Bash" adlı bir kabuk verir.
Windows kabuğuyla ek entegrasyon istiyorsanız, Gerrit/TortoiseGit tutorial sayfasına bakın.

  macOS

  • Homebrew paket yöneticisini kurun ve sonra brew install git komutunu çalıştırın – Diğer paketlerin kolay güncellenmesine ve kolayca kurulmasına izin verdiği için bu önerilir.
  • Alternatif olarak, tek başına Git for Mac yükleyebilirsiniz.

Git'i yapılandırın

Git'i yüklediğinize göre artık kişisel bilgilerinizi yapılandırma zamanı. Bunu sadece bir kez yapmanız gerekir. Ayrıca bu komutları tekrar çalıştırarak kişisel bilgilerinizi istediğiniz zaman değiştirebilirsiniz.

Git, kullanıcının adını ve e-postasını kontrol ederek her işlemi yapanları izler. Ayrıca, bu bilgi taahhütlerinizi Gerrit hesabınızla ilişkilendirmek için kullanılır.

Kullanıcı adınızı ve e-posta adresinizi ayarlamak için aşağıdaki iki komutu girin. gerrituser ile kendi Gerrit kullanıcı adınızla değiştirin ve gerrituser@example.com ile kendi e-posta adresinizle değiştirin:

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

git config --global user.name "gerrituser"

Git'in nasıl davrandığını kontrol eden mevcut yapılandırma değişkenlerinizi görmek için git config -l kullanın.

Gerrit'te SSH Anahtarlarını Ayarla

Bilgisayarınız ve Gerrit arasında güvenli bir bağlantı kurmak için bir SSH anahtarı kullanıyoruz. Yepyeni bir anahtar oluşturmanız gerekip gerekmediğinden emin olmak için, sisteminizde zaten bir SSH anahtarı olup olmadığını kontrol edelim. Bu komutu bir terminalde çalıştırın:

ls ~/.ssh

Komut, (gizli) .ssh dizinindeki dosyaları listeler. Dizin sisteminizde zaten varsa ve çıkışta id_rsa.pub adlı bir dosya listeleniyorsa, doğrudan #SHH Genel anahtarınızı kopyalayın bölümüne gidebilirsiniz.

Yeni bir SSH anahtarı oluşturun

Yeni bir SSH anahtarı oluşturmak için aşağıdaki komutu girin ve gerrituser@example.com yerine kendi e-posta adresinizi yazın. Varsayılan ayarları istiyoruz, bu nedenle anahtarı kaydetmek için bir dosya girmeniz istendiğinde, enter tuşuna basın.

 
ssh-keygen komutunun çıkışı

ssh-keygen -t rsa -C "gerrituser@example.com"

Güçlü ve benzersiz bir parola girin ve [Enter] tuşuna basın.

Parolalar neden önemlidir?
Parolalar çok güvenli değildir. Hatırlaması kolay bir tane kullanırsanız, tahmin etmesi veya brute-force daha kolaydır. Rastgele bir tane kullanırsanız, hatırlaması zordur, bu nedenle parolayı not edebilirsiniz. İkisi de çok kötü. Bu nedenle ssh anahtarlarını kullanıyorsunuz. Ancak parola olmadan bir ssh anahtarı kullanmak, temelde bu rastgele parolayı bilgisayarınızdaki bir dosyaya yazmakla aynıdır. Sürücünüze erişim sağlayan herkes, bu anahtarı kullandığınız her sisteme erişim kazanmış olur. Bu yüzden bir parola da eklemelisiniz. Anahtarı her kullanışınızda uzun bir parola girmemek için ssh-agent adında bir araç vardır. Parolanızı güvenli bir şekilde kaydedebilir. MacOS veya Linux kullanıyorsanız, hayatınızı daha da kolaylaştırmak için anahtarlarınız sistemin anahtar zincirine kaydedilebilir.

ssh-keygen komutu ~/.ssh dizininde 2 dosya oluşturacaktır:

  • ~/.ssh/id_rsa : özel SSH anahtarınız (tanımlama için)
  • ~/.ssh/id_rsa.pub : genel SSH anahtarınız

SSH Genel anahtarınızı kopyalayın

Genel anahtar dosyanızın içeriğini (örneğin, id_rsa.pub) panonuza kopyalayın:

Bir seçenek, ortak anahtar dosyanızı en sevdiğiniz metin düzenleyicisiyle (Notepad, TextEdit, gedit vb.) açmaktır. Metin düzenleyicinizin dosya seçici iletişim kutusunda, dosyayı bulmak için “Gizli dosyaları görüntüle”'yi açmanız gerekebilir, çünkü .ssh dizini gizlidir. Bazen "Gizli dosyaları görüntüle" seçeneği, dosya seçici iletişim kutusuna sağ tıklayarak kullanılabilir.

Diğer seçenekler:

  • Linux'ta, cat ~/.ssh/id_rsa.pub çalıştırın ve çıkışı manüel olarak panoya kopyalayın.
  • Windows'ta, Git GUI'yi açabilir, Yardım 🡒 Anahtarı Göster'e gidebilir ve ardından genel anahtarınızı panonuza kopyalamak için "Panoya Kopyala" düğmesine basabilirsiniz.
  • MacOS'ta, genel anahtar dosyanızın içeriğini panonuza kopyalamak için pbcopy < ~/.ssh/id_rsa.pub çalıştırabilirsiniz.

SSH Genel anahtarınızı herhangi bir yeni satır veya boşluk eklemeden, aynen yazıldığı gibi kopyalamanız önemlidir. "ssh-rsa" öneki, anahtarın kendisi ve e-posta adresi son eki dahil olmak üzere tam metni kopyalayın.

Gerrit hesabınıza SSH Genel anahtarı ekleyin

  • Gerrit için web arayüzünde oturum açın. Gerrit'inizin kullanıcı adı ve parolası Wikimedia Geliştirici hesabınız ile aynıdır.
  • Sağ üst köşedeki kullanıcı adınızı tıklayın ve ardından "Ayarlar" seçin.
  • Soldaki menüde "SSH Genel Anahtarları" tıklayın.
  • SSH Genel Anahtarınızı ilgili alana yapıştırın ve "Ekle" düğmesine tıklayın.

Git ile kullanmak için SSH Özel anahtarı ekleyin

Git Bash komut satırını başlatın.

  • ssh-agent ile kullanarak çalıştırın
eval `ssh-agent`
Tek tırnak ' değil, ` vurguyu kullandığınızdan emin olun. (Bu özel karakteri kolayca giremezseniz bu sayfadan kopyalayıp yapıştırabilirsiniz.)
  • Özel anahtarınızı aracıya ekleyin.[1] Yukarıdaki adımları izlediyseniz ve anahtarınızın varsayılan adı id_rsa ise, komut şu şekildedir:
ssh-add .ssh/id_rsa
  • Her şeyin beklendiği gibi çalışıp çalışmadığını kontrol etmek için ssh ile Gerrit sunucusuna bağlanın. gerrituser ile Gerrit ayarlarınızda gösterilen kullanıcı adınızla değiştirin:
ssh -p 29418 gerrituser@gerrit.wikimedia.org
  • Paranoyak olun ve "RSA anahtarı parmak izinin" gerrit.wikimedia.org:29418 için SSH parmak izi ile aynı olduğunu karşılaştırın. Aynıysa, "Bağlanmaya devam etmek istediğinizden emin misiniz?" sorusuna "Evet" yanıtını verin. Ardından anahtarınızın parolasını girin.
  • "Welcome to Gerrit Code Review" mesajı almalısınız. Son satır "Connection to gerrit.wikimedia.org closed." ifadesini göstermelidir.
  • Sorunla karşılaşırsanız, ssh -p 29418 -v gerrituser@gerrit.wikimedia.org kullanın (gerrituser ile kullanıcı adınızla değiştirin). -v, sorunların bulunmasına yardımcı olmak için ayrıntılı çıkış sağlayacaktır. Ardından Gerrit Sorun Giderme'yi okuyun.

Örnek bir Gerrit SSH bağlantısı başarı mesajı şuna benzer:

  Example:

Git'i kullanarak kod indirin

"Sandbox" adlı deposu indirerek ("cloning" denir) pratik yapalım. Git Bash komut satırı üzerinde aşağıdakileri çalıştırın:

git clone ssh://gerrituser@gerrit.wikimedia.org:29418/sandbox (gerrituser'i Gerrit kullanıcı adınızla değiştirin. Ve URL'nin https: ile değil, ssh: ile başladığından emin olun).

Bu işlem, "sandbox" uzantı deposunun tüm geçmişini ve kod tabanını makinenize kopyalar. Uzantının ana dalının (genellikle "git master" olarak da bilinir) bir çalışma dizinine sahip olursunuz. Yeni dizini girin (cd sandbox komutu ile). Artık koda bakıp düzenlemeye başlayabilirsiniz.

Deneme tahtası deposunu klonlamak size bir geliştirme ortamı kurulumu veya çalışan bir MediaWiki kurulumu sağlamaz. (Çalıştırmak için MediaWiki Core ve teslim aldığınız kodu web sunucunuz tarafından beklenen bir konuma yerleştirmeniz gerekir.) Git'ten Git'ten indirin MediaWiki Core, uzantılar, görünümler veya gerrit.wikimedia.org adresinde barındırılan diğer herhangi bir proje deposunu nasıl indirileceğine bakın.

Gerrit ile çalışmaya hazırlanın

Gerrit, kaydetme mesajınızın bir "değişiklik kimliği" içermesini gerektirir I (büyük i) ile başlayan Change-Id: Ibd3be19ed1a23c8638144b4a1d32f544ca1b5f97 ile benziyorlar. Gerrit'te mevcut bir yamayı iyileştirmek için bir işlemi değiştirdiğiniz her seferinde, bu değişiklik kimliği aynı kalır, bu nedenle Gerrit bunu aynı kod değişikliğini ele alan yeni bir "yama kümesi" olarak anlar.

Kayıtlarınıza bir Change-ID satırı ekleyen git-review adında bir git taahhüdünüz var. git-review kullanılması önerilir. Git klonunuzu yapılandırmayı, bir değişiklik göndermeyi veya mevcut olanı getirmeyi kolaylaştırır.

git-review yükleme

Wikimedia Gerrit'in git-review 1.27 veya daha yeni bir sürümünü gerektirdiğini unutmayın.

Daha fazla bilgi için lütfen Gerrit/git-review#Kurulum bölümüne bakın.

  Linux

  Windows

  macOS

  • OS X 10.11 El Capitan ve sonrası için, Yöntem 1'i izleyin.
  • 10.11'den önceki sürümlerde, Yöntem 2'yi izleyerek pip Python paket yükleyicisini kullanın.

git-review yapılandırma

Git'in varsayılan uzak ana bilgisayar adı "origin". Bu ad Wikimedia projeleri tarafından da kullanılır. Bu konağı kullanabilmek için git-review söylememiz gerekiyor. gerrituser yerine Gerrit kullanıcı adınızı yazın:

git config --global gitreview.remote origin

git config --global gitreview.username gerrituser

git-review ayarlama

Bir depoyu indirdikten ("cloning") sonra, git-review için ayarlamanız gerekir. Bu, bir taahhüdü ilk kez göndermeye çalıştığınızda otomatik olarak gerçekleşir, ancak bunu klonlamadan hemen sonra yapmak genellikle daha iyidir. Klonladığınız projenin dizininde olduğunuzdan emin olun (aksi takdirde "hata: Git deposu değil" hatası alırsınız). Ardından şu komutu çalıştırın:

git review -s --verbose

Çıkışının sonuna doğru, şöyle bir şey görmelisiniz:

  Example:

Bu, kullandığınız kabuk kullanıcı adından farklıysa git kullanıcı adınızı isteyebilir.

git-review yükleyemezseniz, bir yama göndermek için Gerrit yama yükleyicisini kullanabilirsiniz.

Bir yama gönderin

İlgilendiğiniz kod deposunu klonladığınızdan emin olun (buraya bakın).

Kod deposunun dizininde olduğunuzdan emin olun (pwd komutu size tam olarak nerede olduğunuzu söyler).

Güncelleme yöneticisi

Ana dalınızın (depoyu ilk kez klonladığınızda oluşturulan dal) güncel olduğundan emin olun:

git pull origin master

Ancak, birkaç deponun farklı terimler kullandığını unutmayın (örneğin, operations/puppet deposunda master yerine production vardır).

Bir dal oluştur

İlk olarak, yeni değişikliğiniz için yerel bir dal oluşturun. Aşağıdaki BRANCHNAME kısa ama makul ölçüde açıklayıcı bir adla değiştirin (ör. değişiklikleriniz için karşılık gelen Phabricator görev varsa T1234, cleanup/some-thing veya badtitle-error) Diğer kişiler de dalınızı tanımlamak için bu adı kullanacaktır.

git checkout -b BRANCHNAME origin/master

  Example:

Bu, yeni bir şube oluşturacaktır (en son 'master' üzerinden BRANCHNAME) olarak adlandırılır ve sizin için kontrol edin. Yukarıdaki örnekte, bu yeni dalına mentionWikimedia adını verdik.

Değişikliklerinizi yapın

Yerel kodunuzda değişiklik yapın. Tercih ettiğiniz metin düzenleyiciyi kullanın ve bir dosyayı değiştirin. Aşağıdaki örnekte, README.md dosyasını düzenliyoruz ve bir kelime ekliyoruz.

Ardından metin düzenleyicinizi kapatın ve son işlemden bu yana, dosya(lar) ve dizin içinde yaptığınız değişiklikleri kontrol edin:

git diff

  Example:

git diff, değişikliklerinizi birleştirilmiş fark biçimi olarak görüntüler: Kaldırılan satırların bir eksi (-) öneki ve eklenen satırların bir artı (+) öneki vardır. Bu değişiklikler, bir sonraki kaydetme için henüz "aşamalı" değildir (git add üzerinden).

Bir taahhüt için değişikliklerinizi yapın

Yaptığınız değişikliklerden hangisinin taahhüdünüzün bir parçası olacağına karar vermek için git status çalıştırın. Dizinde değiştirdiğiniz tüm dosyaların bir listesini gösterecektir. Bu noktada, çıkış son satır olarak "kaydetmeye hiçbir değişiklik eklenmedi" ifadesini gösterecektir.

Değiştirdiğiniz dosya(ları)nızı bir sonraki kaydetmenizin parçası haline getirmek için git add kullanın. Yukarıdaki örnekte README.md dosyasını değiştirdik, dolayısıyla komut şöyle olacaktır:

git add README.md git add ile geçmediğiniz, değiştirdiğiniz tüm dosyalar, bir sonraki adımda git commit çalıştırıldığında yok sayılacaktır.

İstediğiniz zaman, git status çalıştırarak önceden hazırlanmış değişiklikleri her zaman gözden geçirebilirsiniz. git add çalıştırdıktan sonra git status "artık taahhütte değişiklik yapılmadı" satırını göstermeyecek.
Ayrıca hangi değişikliklerin hazırlandığını ve bir sonraki işleme geçeceğini görmek için git diff --cached kullanabilirsiniz. Çıkış, yukarıdaki git diff komutuyla aynı görünecektir.

Aşamalı değişikliklerinizi yapın

git add yoluyla eklenen değişikliklerin listesinden memnun olduğunuzda, bu değişiklikleri kullanarak yerel deponuzdaki bir taahhüde dönüştürebilirsiniz.

git commit

  sandbox/.git/COMMIT_EDITMSG:

Daha sonra metin düzenleyicinizde işleminiz için açıklayıcı bir özet eklemeniz istenecektir. Taahhüt mesajı kurallarına uymalısınız. Kod deposundaki değişikliklerin geçmişine bakarken başkalarının göreceği şey budur.

İşleme mesajını kaydedin ve metin düzenleyicinizi kapatın. Bir özet (tamamlama kimliği, konu satırınız, değiştirilen dosyalar ve satırlar) görüntülenir.

Ana dalı itmek istediğiniz bir dizi değişiklik olana kadar bu adımı tekrar tekrar yapabilirsiniz.

git commit geldiğinizde, yerel kopyanızı taahhüt ediyorsunuz.

Bu, projedeki başka bir geliştirici için işleri potansiyel olarak bozmadan istediğiniz sıklıkta iş yapabileceğiniz anlamına gelir.

Taahhüdünüzü Gerrit'e aktarmaya hazırlanın

Değişiklik kümenizi, çalışırken ana dalda olabilecek tüm değişikliklerle senkronize edin ("yeniden basma"). Dalınızdan şunları çalıştırın:

git pull --rebase origin master

  Example:
git pull --rebase origin master uzaktan yeni taahhütler getirecek ve daha sonra yerel taahhütlerinizi bunlara yeniden temellendirecektir.

Şubenizde yaptığınız değişiklikleri geçici olarak bir kenara bırakır, master'da gerçekleşen tüm değişiklikleri çalışma şubenize uygular, sonra da şubeye yaptığınız tüm değişiklikleri birleştirir (tavsiye eder). Bunu yapmak, gelecekteki birleşme çakışmalardan kaçınmanıza yardımcı olacaktır.

Ayrıca, değişikliklerinizi master'daki en son koda karşı test etme fırsatı verir.

Artık kodunuzu incelenmek üzere Gerrit'e göndermeye hazırsınız. Birkaç ilişkili kaydetme yaptıysanız, bunları incelenmek üzere tek bir işlemde birleştirmeyi düşünün.

Taahhüdünüzü Gerrit'e aktarın

Yukarıdaki #Gerrit ile çalışmaya hazırlanın bölümünü takip edip git-review yüklediyseniz ve git review -s çalıştırdıysanız, değişiklikleri Gerrit'e aktarma komutu:

git review -R

-R seçeneği, git-review ile değişikliği Gerrit'e göndermeden önce yeniden gönderme yapmamasını söyler.

  Example:

Başarılı olduktan sonra, bir onay ve Gerrit'teki değişiklik setine bir bağlantı alacaksınız. Yukarıdaki örnekte, bu bağlantı: https://gerrit.wikimedia.org/r/#/c/sandbox/+/563720

Tebrikler! Yamanız Gerrit'te ve umarım yakında incelenir!

Değişikliği / Sonraki Adımları Görüntüleyin

Gerrit değişiklik setinizin bağlantısını bir web tarayıcısında açın.

"Dosyalar" altında, listedeki herhangi bir dosyanın en sağındaki aşağı oku tıkladıktan sonra, dosya başına yaptığınız değişikliğin farkını görebilirsiniz: Eski satırlar kırmızı renkte ve yeni satırlarınız yeşil renkte gösterilir .

Gerrit'in diff algoritması (jGit) git'in varsayılan diff algoritmasından biraz farklıdır. Gerrit tarafından görüntülenen farklar Git tarafından makinenizde görüntülenen farklılıklara benzemeyebilir.

Taahhütünüz Phabricator cinsinden bir bileti ele alırsa, Taahhüt mesajı yönergelerini izlediyseniz, Phabricator görevine otomatik olarak bir yorum eklenir. Bunu yapmadıysanız, tamamlama mesajınızı düzeltebilir (güncellenmiş bir yama seti oluşturarak) veya bu Phabricator biletine Gerrit'teki değişiklik kümenize bir bağlantı içeren bir yorumu manüel olarak ekleyebilirsiniz.

Diğer yaygın durumlar

Ayrıca durumunuz burada ele alınmıyorsa Gerrit Gelişmiş kullanıma bakın.

Rebase ile birkaç taahhüdü tek bir taahhütte toplayın

İncelemeye gönderilmeyi istemeden önce yerel deponuza ilgili birkaç taahhütte bulunduysanız, bu taahhütleri tek bir taahhütte ezmeniz (birleştirmeniz) gerekir.

--interactive veya -i seçeneği, kaydetme geçmişinizi değiştirmenize (yeniden yazmanıza) olanak tanır. Her taahhüt için, taahhüt mesajını değiştirebilir, dosya ekleyebilir veya kaldırabilir veya başka değişiklikler yapabilirsiniz.

Önce git'i ne kadar geri çekmek istediğinizi söylemelisiniz. Şubenizdeki tüm değişikliklerin bir listesini almak için:

git rebase -i origin/master

Ayrıca son değişikliklerin görüntülenen listesini de sınırlayabilirsiniz. HEAD~3, son üç taahhüt çek anlamına gelir:

git rebase -i HEAD~3

Bu komutu yazdıktan sonra, metin düzenleyiciniz taahhütlerinizi ters sırayla ve kullanılabilir komutların bir listesini görüntüler:

  Example:

İncelemek için yalnızca bir taahhüt göndermek istediğimizden, son iki taahhüt ilkinde ezeceğiz. Bu nedenle, ilk "pick" ile "squash" olarak değiştirin:

pick aa8cf1d Adding method customFilterFunctionGetRiskyCountryCodeScore() to GatewayAdapter.
squash 38828e2 Adding $wgDonationInterfaceCustomFiltersFunctionsRiskyCountries to donationinterface.php
squash be33007 Fix a typo

Seçip sıkıştırmayı bitirip dosyayı kaydettiğinizde, taahhüt mesajlarınızı düzenlemenize ve birleştirmenize izin vermek için metin düzenleyicinizde başka bir dosya açılır. Change-Id satırlarından yalnızca birini tutmaya ve boş bir satırdan sonra mesajın altında kalmasına dikkat edin.

Önceki taahhütlerinizde gelen mesajlarınız otomatik olarak bu mesaja yerleştirilecektir:

  Example:

Özet mesajınızı (güncellenmiş) işleme koymayı unutmayın. Bu durumda yeni özet mesaj şöyle olacaktır:

(mingle-fr-2012-69) Adding a custom filter for risky countries.
Kullanmak istediğiniz Change-Id ile ilgili olarak, mevcut bir taahhüde (zaten Gerrit'te olan) bir taahhütte bulunmak için, yeni bir patchset göndermek istediğinize ait olan Change-Id ile seçmeniz gerekir (hayatta kalma taahhüt). Taahhütleriniz yeniyse ve Gerrit'te değilse, hangi Change-Id'yi seçtiğiniz önemli değildir.

Her şey yolunda giderse, başarılı bir rebase mesajı görmelisiniz:

  Example:

Daha sonra yamanızı incelemeye gönderin:

git review

Git incelemenizin Gerrit'e gittiğini gösteren bir mesaj görmelisiniz (bu örnekte https://gerrit.wikimedia.org/r/7187):

  Example:

Değişikliği düzeltme (kendinizin veya başkasının)

Bazen, gönderilen bir değişikliği değiştirmeniz gerekebilir. Değişiklik henüz birleştirilmediği sürece bir değişikliği değiştirebilirsiniz.

Kendi değişikliklerinizi değiştirebilirsiniz. Başkası tarafından gönderilen değişiklikleri değiştirmek için Gerrit'in Trusted-Contributors grubunun bir üyesi olmanız gerekir. Trusted-Contributors grubun bir üyesi olmak için, üye olan birini bulun ve ondan sizi eklemesini isteyin. Grup, üyelerin yeni üyeler ekleyebilmesi, yetkilerinizi sorumlu bir şekilde kullanabilmesi açısından viraldir.

Yerel dalınızı uzak ile güncel hale getirmek için yeniden temel alın. Yeniden temelleme güncellemelerini ayrı bir yama yapmak en iyisidir, böylece kod inceleyecileri yaptığınız değişiklikleri kolayca görebilir. Gerrit kullandığınızı varsayarsak, bunu Gerrit'in web arayüzünde yamanızı görüntülerken "Rebase Change" düğmesine tıklayarak yapabilirsiniz.

Bu komutla tam sıfırlama ve değişikliği kontrol edin: (DİKKAT: git review -d, tüm yerel değişiklikleri kaldıran bir donanım sıfırlaması gerçekleştirir. Önce korumak istediğiniz değişiklikleri saklayın veya uygulayın!)

git review -d changenumber Örneğin: git review -d 9332

Yerel deponuzda bir dalda zaten değişiklik varsa, bunun yerine sadece kontrol edebilirsiniz:

git checkout BRANCHNAME Örneğin: git checkout review/gerrituser/2012/bug12345

Ardından, favori metin düzenleyicinizle bazı değişiklikler yapın.

git add dosyaları gerektiği gibi uygulayın, ardından değişikliği tamamlayın (kaydetmeyi "değiştirdiğinizden" emin olun):

git add Example/Example.body.php

git commit --amend --all

Bir taahhüt özeti belirtmek için -m işaretini KULLANMAYIN: bu önceki özeti geçersiz kılar ve Change-Id yeniden oluşturur. Bunun yerine, taahhüt özetini değiştirmek için metin düzenleyicinizi kullanın (gerekirse .git/COMMIT_EDITMSG dosyasında ve Change-Id satırını olduğu gibi bırakın.

Değişiklikliği push yapın:

git review -R

-R burada önemlidir. git-review ile değişikliğinizi ana bilgisayara karşı yeniden düzenlememesini söyler, bu da yama seti 1 ile 2 arasında farklılık gösterir.

Master'dan farklı bir dalına aktarın

Yukarıda taahhüt, ana dalına aktarıldı. Dal adı yalnızca Gerrit kullanıcı arayüzünde işlemin konusu olarak görünüyordu. Eğer gerçekten ana daldan farklı bir şubeye geçmek istiyorsanız, git review <branch name> üzerinden aktarmanız gerekir.

Web arayüzü üzerinden düzenleme

Gerrit'te oturum açtıysanız, doğrudan web arayüzünde kod değişiklikleri de oluşturabilirsiniz. Bu, küçük yamalar yapmak için veya geliştirici olmayanlar için küçük düzeltmelere katkıda bulunmak için yararlı olabilir.

  1. https://gerrit.wikimedia.org/r/admin/projects gidin ve düzenlemek istediğiniz kod deposunu seçin.
  2. Kenar çubuğunda "Commands" seçin
  3. "Create Change" tıklayın
  4. Dalı "master" olarak ayarlayın (ana dalı kullanmak istemiyorsanız, o proje için mevcut olan diğer dalları kullanabilirsiniz)
  5. Konuyu seçtiğiniz bir şeye ayarlayın (ör. "copy-edit" - tümü tek dizeli olmalıdır) (isteğe bağlı)
  6. Büyük metin alanına ileti yönergelerini uygulayarak bir açıklama ("taahhüt özeti") yazın. (Örnek)
  7. "Create" tıklayın
  8. Sağ üst köşede "Edit" düğmesini tıklayın
  9. "Files" altında, "ADD/OPEN/UPLOAD" düğmesini tıklayın
  10. Düzenlemek istediğiniz dosyanın klasör/dosya yolunu yazın (ör. i18n/en.json) ve "Open" düğmesine tıklayın
  11. Değiştirmek istediğiniz satırları bulun ve değiştirin.
  12. "Save" tıklayın
  13. "Close" tıklayın
  14. "Publish edit" tıklayın
  15. "Start Review" düğmesine tıklayın

Yapıldı!

Mevcut bir değişiklik kümesinin kaydetme mesajını değiştirmeniz gerekirse şu adımları kullanabilirsiniz:

  1. Değişiklik setinin kendisine gidin. Örnek URL: https://gerrit.wikimedia.org/r/c/1234567890 (sondaki kimliği değiştirin)
  2. "Files" bölümünde "Commit message" düğmesine tıklayın
  3. Sağ üst köşede "Edit" düğmesini tıklayın
  4. Taahhüt özetinde değişiklik yapın.
  5. Sağ üst köşede "Save" düğmesini tıklayın
  6. Sağ üst köşede "Close" düğmesini tıklayın
  7. Sağ üst köşede "Publish edit" düğmesini tıklayın

Kod Gerrit'te nasıl incelenir

Kod incelemesi katkı iş akışımızın önemli bir parçasıdır. Prensip temeldir: herhangi bir yama birleştirilmeden önce başkaları tarafından incelenmelidir.

Bu, kodunuzun gözden geçirenlere ihtiyaç duyacağı anlamına gelir. Yorum alma tavsiyemize göz atın.

Birleştirmeden önce inceleyin

MediaWiki çekirdeği ve ayrıca herhangi bir uzantı için biz dağıtımı birleştirmeden önce inceleme iş akışına sahip olmak bizim için önemlidir. Bu seçeneği, uzantı için isteyen herhangi bir uzantı yazarına da sunacağız. Tek istisna, incelemeden aktarılabilecek yerelleştirme ve uluslararasılaştırma taahhütleridir.

Kim inceleyebilir? Gerrit proje sahipleri

Geliştirici hesabı oluşturduktan sonra, herkes taahhütler hakkında yorum yapabilir ve eleştirilerini ve onaylarını ifade edebilir. Herkes herhangi bir işleme için bağlayıcı olmayan bir "+1" verebilir. Bununla birlikte, herhangi bir veri deposu ("Gerrit project") için, yalnızca küçük bir grup insan Gerrit içinde kodu onaylama ve arşivde birleştirme yeteneğine sahip olacaktır. Bu süper onay, yanıltıcı bir ad olsa da bir "+2"'dir, çünkü iki +1 onayının toplamı +2 DEĞİLDİR. Bu kişiler "Gerrit proje sahipleri"'dir.

Gerrit'te kod hakkında yorum yapma, inceleme ve birleştirme nasıl yapılır

 
Gerrit'in web arayüzüne yeni yüklenmiş bir örnek değişiklik kümesi
 
Gerrit'in web arayüzünde yan yana farklılık

Gerrit'te kod hakkında herkes yorum yapabilir.

Kodu görüntüleme ve yorum yapma

  • Bir geliştirici hesabı sahibi olduğunuzdan emin olun.
  • Gerrit üzerinden oturum açın. Bakmak istediğiniz değişiklik kümesini biliyorsanız (URL https://gerrit.wikimedia.org/r/#/c/23939/ gibi görünecek), buna gidin. Aksi takdirde, arama kutusunu kullanın. Yazara ("Owner"), Gerrit projesine, dalına, yıldız verdiğiniz değişiklik setlerine vb. göre arama yapabilirsiniz. Gerrit arama belgelendirmesi, kullanabileceğiniz tüm farklı arama iletimlerini kapsar.
  • Değişiklik kümesinde birkaç alan, bağlantı ve düğme bulunur:
    • Vekil. Değişiklik kümesinin incelenmesinden tek bir kişinin sorumlu olmasını sağlayan isteğe bağlı bir alan. Bu, yalnızca vekil kabul etmişse ayarlanmalıdır.
    • İnceleyiciler. 'jenkins-bot', Jenkins testlerinden geçen her şeyi otomatik olarak doğrulayan otomatik inceleyicidir. Yapının geçip geçmediğine bağlı olarak kırmızı veya yeşil bir işaret bildirecektir.
    • "Add reviewer" düğmesi altındaki Reviewers: sol üst köşede birinden manüel olarak inceleme isteyin. Onların Gerrit kontrol panelinde görünecektir.
    • Files altında, Expand All aşağıdaki her dosya için farkı açar. Bir satırı çift tıklayabilir ve ardından o satır hakkında yorum yapmak için C tuşuna basabilir, ardından taslak yorumu kaydetmek için "Save" düğmesine tıklayabilirsiniz. Ardından, yorumunuzu yayınlamak için sayfanın üst kısmındaki "Reply" düğmesini tıklayın.
    • Reply, yorumlarınızı genel bir yorum ve/veya eklediğiniz satır içi yorumlar dahil olmak üzere bir değişiklik grubuna ekler (yukarıya bakın).
      • Kod incelemesi üzerine, approve basarsanız, "Reply" altında "Code-Review: -1" kullanın; aksi takdirde, reddetmek için "Code-Review: -1" kullanın. Bu numaralar bağlayıcı değildir, birleşmelere veya reddedilmelere neden olmaz ve kod incelemesi üzerinde resmi bir etkisi yoktur.
    • Abandon (bu farkı yazdıysan bunu göreceksin). Bu eylem, incelemek üzere listeden farkı kaldırır, ancak arşivleme amacıyla Gerrit'te bırakır.
  • "Only Comments" anahtarı, insan olmayan botların incelemelerini gizlemeye olanak tanır. Örnek için https://phabricator.wikimedia.org/T48148#6294913 sayfasına bakın.

Yama kümelerini karşılaştırma

Taahhüdünüzü her değiştirdiğinizde ve incelemeye gönderdiğinizde, yeni bir yama seti oluşturulur. Farklı yama setlerini şu şekilde karşılaştırabilirsiniz:

  • "Files" altında, "Expand All" seçin veya bu dosyayı açmak için listelenen belirli bir dosyayı seçin.
  • Sol tarafta Patch Set altında Base önceden seçilmiştir. Ekranın sağ tarafında Patch Set altında, en son yama seti önceden seçilmiştir. Seçili yama setlerini ihtiyaçlarınıza göre ayarlayın.

Resmi olarak incelemek ve kodu birleştirmek veya reddetmek

Gerrit proje sahiplerinden biriyseniz, şunları da göreceksiniz:

  • Abandon düğmesi
* Reply altında, +2 (onayla) veya -2 (veto) için ek Code-Review seçenekleri ve bir Post düğmesi (yorumunuzu yayımlayın ve farkı 1 adımda dalında birleştirin)
  • Submit düğmesi (merge -- yalnızca siz veya bir başkası farka +2 onayı verdiyse, ancak onu birleştirmediyse kullanışlıdır)

Ve bir şeyi örnek Gerrit projesiyle birleştirdiğinizde, onu https://gerrit.wikimedia.org/r/plugins/gitiles/mediawiki/extensions/examples/ olarak göreceksiniz.

Phabricator'da bir göreve kaynaklanan bir taahhüt birleştirdiyseniz ve bu işlemin bu görevi tamamen düzeltmesi gerekiyorsa, lütfen o göreve gidin ve durumunu "Çözüldü" olarak değiştirin (Eylem Ekle… 🡒 Durumu Değiştir açılır menüsünden). Ayrıca gerritbot bu göreve daha önce göndermediyse birleştirme kimliğine bakın.

Sorun giderme

Sorunlar ve nasıl çözüleceği için Gerrit/Troubleshooting sayfasına bakın.

Ayrıca bakınız

Ayrıca şu sayfalar da yararlıdır:

Üçüncü taraf Git kılavuzları

Tarihsel belgeler

Kaynakça

  1. Bir Ubuntu kullanıcısı olarak "İzin reddedildi (publickey)" mesajınız varsa, lütfen bu yardım sayfasında kontrol edin