Geliştirici Senaryoları-3: Jira, Github ve İlk React Task'iniz

Posted by on

 

Senaryo

Yeni dahil olduğunuz "eticaretvadisi" isimli MERN projesi için bilgisayarınızda VS Code'u kurdunuz ve proje dosyalarınızı lokalinize indirerek projeyi çalıştırmayı başardınız. Şimdi, Takım Lideri size ilk görev olarak dil dosyalarındaki kelime hatalarının düzeltilmesi görevini verdi. Bununla birlikte, daha önce açılmış olan ve yine basit kelime düzeltmeleri içeren SVW-1076 numaralı taskı bu görevle birlikte halletmeniz istendi.

Proje yönetimi için Jira kullanıyorsunuz. Proje Github'da idame ediliyor.

Yapılacaklar:

1 Jira'da bir task açacaksınız.

2. Kodda yaptığınız değişiklikleri burada açtığınız task numarasına ve standartlara uygun olarak Github'a commit edeceksiniz.

3. SVW-1076 numaralı taska ait kod değişikliklerini yaparak Github'a uygun şekilde commit edeceksiniz.

4. Değişiklikler bittiğinde Pull Request (PR) açarak Takım Liderinden kontrol ve merge etmesini isteyeceksiniz.

Uygulama Adımları

Adım 1: Jira'da Task Açın

Task açmanın farklı yolları mevcut olmakla birlikte, temel olarak bir task şu şekilde açılır:

* Jira'ya giriş yaparak projenin Kanban sayfasına gidin.
* Üst menüdeki Create butonuna basın.
* Açılan pencerede şunları seçin:
    *    Proje Adı
    *    Issue Type: Task (Ya da verilen talimata göre, örneğin Bug)
    *    Status: Open
    *    Description: Görevi kısaca açıklayın
    *    Reporter: Kendinizi girin
    *    Priority: Medium
    *    Assignee: Kendiniz seçin
    *    Sprint: Projenin aktif olan sprintini seçin

Burada özellikle assignee ve sprint kısımlarını doğru girmeniz önemli. Sprinti seçmezseniz, taskinizi diğer geliştiriciler ve takım lideriniz takip edemezler.

Taskı açtıktan sonra Jira taska otomatik olarak isim verecektir. Bu örnek için yeni taskınızın ismi SVW-1088 olsun.

Adım 2: Projede Yeni Branch Aç

    *    VS Code'da projeyi açın ve yeni bir terminal açın
    *    Ana branchı güncelleyin 

git pull

    *    Jira'da açtığınız task adıyla yeni bir branch açın

git checkout -b SVW-1088

Adım 3: Kodda Gerekli Geliştirmeleri Yap ve Commit Et

    *    Kodda gerekli değişiklikleri yapın
    *    Değişiklikleri commit edin

Bunu komutla ya da Source Control sekmesinden Commit ve sonrasında çıkacak Sync butonlarıyla yapabilirsiniz. Burada önemli olan commiti Takım Liderinizin ya da şirketinizin standartlarına uygun olarak yapmanız. Örneğin commit mesajı standardınız şuna benzer olabilir: 

(Task Adı) (işlem kategorisi): (yapılan işlemin kısa açıklaması) 

SVW-1088 fix: corrected wrong words in en lang files

Komut ile yaparsanız:

Değişiklikleri Git'e ekle

git add . 

Commit et

git commit -m "SVW-1088 fix: corrected wrong words in en lang files"

Github'a gönder

git push origin SVW-1078

Adım 4: Diğer Task İçin Kodda Gerekli Geliştirmeleri Yap ve Commit Et

Task ların basit ve kısa olduğu durumlarda her task için yeni branch açmak gerekmez. Bazen bir task için açılan branch içinde bir çok basit task da tamamlanarak commit edilebilir.

Burada bilinmesi gereken her commitin ilgili task adıyla yapılmasıdır. Yani bu örnek üzerinden devam edersek, SVW-1088 için açtığımız branch içinde SVW-1076 isimli taski hallettikten sonra göndereceğimiz commit SVW-1088 değil, SVW-1076 olarak gönderilmelidir. Şunun gibi:

SVW-1076 fix: corrected wrong words in tr lang files

Böylece SVW-1088 isimli branch içinde hem SVW-1088 görevine ait commitleri, hem de SVW-1076'ya ait commitleri göndermiş olduk.

Eğer Jira ile Github'ın entegrasyonu ve Jira'daki süreç otomasyonu doğru yapıldıysa, bu commitlerinizden sonra Jira'daki her iki taskın da statüsü otomatik olarak REVIEW şeklinde değişecektir.

Adım 5: PR (Pull Request) Açmak ve İncelemeye Sunmak

  • Github'da pull request (PR) açın:

    Normalde projenin Github sayfasına gittiğinizde sizin taskınıza ait bir Pull Request butonu görürsünüz. Bu butona basarak PR'ı halledebilirsiniz. Fakat temelde aşağıdaki yolu izleyerek PR oluşturabilirsiniz.

    a. Github'a gidin ve projenizi açın.
    b. Sol tarafta "Pull requests" sekmesine tıklayın.
    c. "New pull request" butonuna tıklayın.
    d. Açılan sayfada base branch’i main olarak ve compare branch’i SVW-1088 olarak ayarlayın.
    e. PR açıklamasını yazın. Commit ile aynı mesajı tercih edebilirsiniz.
    f. "Create pull request" butonuna tıklayarak PR’ı oluşturun.
    g. Sayfanın sağındaki şu kısımları doldurun:

    * Reviewer: Takım Liderinizi ya da taskı kontrolden sorumlu kişiyi seçin

    * Assignee: Kendinizi seçin. 

    * Type: Bu örnek için Bugfix girin. Eğer projeye yeni özellik eklendiyse Feature seçebilirsiniz.

  • Takım Liderine bildirin:
    a. PR oluşturduktan sonra, eğer commitlerden sonra otomatik REVİEW statüsüne geçmiyorsa, Jira’da görevi güncelleyin. Slack veya email gibi bir iletişim aracını kullanarak Takım Liderine PR’ı incelemesi ve merge etmesi için haber verin.

Adım 6: Task’ı Kapatmak

  1. PR merge edildikten sonra taskı kapatın:

    a. PR merge edildikten sonra Jira’ya gidin ve task’ınızı "Done" olarak işaretleyin.

    b. Daha profesyönel takımlarda bu süreç şöyle yürür: Takım Lideri PR'ı merge ettikten sonra Jira taskı otomatik olarak veya lider tarafından QA statüsüne geçirilir. Tester ekibi değişikliği test ettikten sonra sorun yoksa statüsünü Done olarak değiştirir ve süreç tamamlanmış olur.
Tebrikler! Yazılım geliştirici olarak ilk görevinizi başarıyla tamamladınız.

Comments

Post a Comment