Jira'yı GitHub ve Bitbucket ile bağlamak: iş anahtarı ve smart commit

Neden Jira ile kod deposunu bağlarız?

Yazılım ekiplerinde iş Jira'da, kod GitHub ya da Bitbucket'ta yaşar. İkisi bağlanmadığında "bu işin kodu hangisi", "bu pull request neden açıldı", "bu işte kodlama bitti mi" soruları elle sorulur. Bağlantı kurulduğunda iş öğesinin içinde ilgili dallar, commit'ler ve pull request'ler görünür; kodu inceleyen kişi de hangi işe ait olduğunu görür.

Bağlantının asıl kazancı izlenebilirliktir. Bir hata düzeltmesi yayına çıktığında hangi işten geldiği, kimin incelediği ve hangi sürümde olduğu geriye doğru takip edilebilir. Sürüm notu hazırlarken, denetimde ya da üretim hatasının kaynağını ararken bu iz paha biçilmezdir.

Bağlantı iki katmanda çalışır. Birincisi görünürlüktür: iş anahtarını dal adına, commit mesajına ya da pull request başlığına yazınca Jira bunları o işe bağlar. İkincisi eylemdir: smart commit komutlarıyla commit mesajından iş yorumlanabilir, süre girilebilir ya da iş durumu değiştirilebilir.

Önce bağlantıyı kurmak

Bağlantı yönetici tarafından kurulur: Jira, GitHub organizasyonuna ya da Bitbucket çalışma alanına bağlanır ve hangi depoların izleneceği seçilir. Bağlantı kurulduktan sonra mevcut geçmiş taranır; iş anahtarı içeren eski dallar ve commit'ler de ilgili işlere bağlanabilir, yeni işlerde ise anahtarı hemen kullanmaya başlayabilirsiniz.

Görünürlük için iki koşul vardır. İş öğesindeki geliştirme bilgilerini görmek için kullanıcının ilgili izne sahip olması gerekir ve işte Geliştirme alanının yerleşimde gizlenmemiş olması gerekir. Panel boş görünüyorsa önce bu iki noktaya bakın.

Kişi eşleştirmesi için, GitHub hesabındaki e-posta adresinin Jira hesabındaki adresle uyuşması gerekir. Bu ayrıntı hem panelde yazar ve gözden geçiren adlarının görünmesi hem de smart commit'in çalışması için kritiktir. Kurumsal ve kişisel e-postaların karıştığı ekiplerde en sık sorunun kaynağı budur.

Dal, commit ve pull request'i işe bağlamak

Bağlamanın temel kuralı basittir: iş anahtarı büyük harflerle ve olduğu gibi yazılmalıdır. Örneğin PROJ-123 bağlanır, proj-123 bağlanmaz.

• Dal adı: anahtarı dal adının başına koyun, örneğin PROJ-123-odeme-formu. Jira işinden doğrudan dal oluşturursanız anahtar otomatik eklenir.
• Commit mesajı: mesajı anahtarla başlatın, örneğin PROJ-123 Ödeme formuna doğrulama ekle.
• Pull request başlığı: başlığa anahtarı yazın ya da kaynak dal adında bulunsun. Jira'daki geliştirme panelinden pull request açarsanız anahtar başlığa kendiliğinden eklenir.

Push sonrası bağlantının görünmesi birkaç dakika sürebilir. İşi açıp geliştirme alanındaki dal, commit ve pull request sayılarına tıklayarak ayrıntıları görebilirsiniz.

Ekip düzeyinde en önemli karar, dal adlandırma kuralıdır. Anahtarı her zaman dal adının başına koyan bir kural, hem bağlantı hem de dal listelerinde arama için işleri kolaylaştırır. Bu kuralı proje başında yazılı hale getirin.

Smart commit: commit mesajıyla işi yönetmek

Smart commit, commit mesajına eklenen komutlarla Jira'da işlem yapmanızı sağlar. Genel biçim şöyledir: iş anahtarı, ardından komut. Üç temel komut vardır. #comment işe yorum ekler. #time çalışma süresi girer; süre haftalık, günlük, saatlik ve dakikalık birimlerle yazılır. Geçiş adıyla yazılan komut ise işi iş akışındaki bir duruma taşır, örneğin #resolve.

Örnek bir mesaj: PROJ-123 #time 2h #comment Doğrulama eklendi #resolve. Bu satır işe süre girer, yorum ekler ve işi çözüldü durumuna taşır. Aynı satırda birden çok komut yazılabilir, birden çok iş anahtarı da boşlukla ya da virgülle ayrılarak verilebilir. Bir komut tek satıra sığmalıdır.

Belirsiz geçiş adlarında tire kullanılır: iki geçişin adı aynı kelimeyle başlıyorsa #start-review gibi tam adı yazmak gerekir. Smart commit yalnız varsayılan anahtar biçimini destekler: iki ya da daha fazla büyük harf, tire ve sayı.

Smart commit neden çalışmaz?

Commit her durumda başarılı olur; yalnızca komut başarısız olabilir ve bu durumda e-posta bildirimi gelir. Başarısızlığın en sık nedeni e-posta uyuşmazlığıdır: commit'i yapan kişinin e-postası Jira kullanıcılarından tam olarak biriyle eşleşmelidir. Birden çok kullanıcıyla eşleşiyorsa ya da hiç eşleşmiyorsa komut çalışmaz.

İkinci neden izinlerdir. Komutu çalıştıran kullanıcının yorum ekleme, süre girme ya da geçiş yapma izni olmalıdır. Süre komutu için yönetici tarafından zaman takibinin açılmış olması gerekir. Üçüncü neden iş akışıdır: geçişte zorunlu bir alan varsa geçiş sessizce başarısız olabilir ve çözüm alanı smart commit ile ayarlanamaz.

Son olarak pull request başlığına smart commit komutu yazmaktan kaçının; başlık birleştirme commit'inin mesajına dönüşebilir ve istenmeyen komutları tetikler. Gerekirse birleştirme mesajını elle düzenleyin.

Örnek: bir hata düzeltmesinin yolculuğu

Kurgusal bir örnek: bir ekip, ödeme formundaki doğrulama hatası için bir iş açar. Geliştirici Jira'dan dal oluşturur; anahtar dal adına otomatik girer. Çalışırken commit mesajlarını anahtarla başlatır. İlk commit'te yalnız anahtar yer alır, son commit'e süre ve yorum ekler.

Pull request açıldığında başlıkta anahtar bulunur. İş sahibi Jira'da işi açtığında geliştirme alanında dal ve pull request'i görür, gözden geçiren kişinin adı da panelde belirir. Kod birleştirildiğinde iş, takımın iş akışı izin verdiği ölçüde ilerler.

Sürüm planında aynı işin hangi sürüme girdiği Jira'dan görülür. Üretim hatası çıkarsa kod değişikliğinden işe, işten gereksinim sayfasına geri gidilebilir. Ekip bu izi elle tutmak zorunda kalmaz.

Sık yapılan hatalar

En sık hata, anahtarı küçük harfle ya da hatalı yazmaktır. İkinci hata, commit mesajına anahtar koymayı ekip kuralı haline getirmemektir; bağlantı kişiye bağlı kalır. Üçüncü hata, e-posta adreslerinin uyuşmadığını fark etmemektir.

Dördüncü hata, smart commit ile geçişi iş akışının gerektirdiği alanları düşünmeden denemektir. Beşinci hata ise pull request başlığına komut yazmaktır. Altıncı hata, bağlantıyı kurup izinleri kontrol etmemektir; yetkisiz kullanıcılar paneli boş görür ve entegrasyonun çalışmadığını düşünür.

Bu beceriyi Mindset programlarında nerede çalışırsınız

Jira Eğitimi: Temel ve İleri Uygulama programının Jira'yı diğer araçlarla entegrasyon ve ileri özellikler başlığı, geliştirme araçlarıyla bağlantı mantığını ele alır. Terminoloji ve durum geçişleri başlığı ise smart commit ile tetiklenen geçişlerin dayandığı iş akışı kavramlarını netleştirir. Yazılım ekipleri, ürün sahipleri ve Jira yöneticileri için uygundur.

Git tarafındaki dallanma, commit ve pull request mantığı için ayrı beceri sayfaları vardır; bu sayfa yalnız Jira bağlantısını kapsar.