Bitbucket Notları ve İpuçları

İçindekiler

1. Bitbucket'a Giriş
2. Bitbucket Kurulumu
3. Temel Git Komutları
4. Dallanma ve Birleştirme
5. Çekme İstekleri
6. Sorun Takibi
7. Bitbucket Pipelines
8. Bitbucket API
9. Gelişmiş Özellikler
10. En İyi Uygulamalar

Bitbucket'a Giriş

Bitbucket, Atlassian'a ait, ağırlıklı olarak kaynak kodu ve Git revizyon kontrol sistemlerini kullanan geliştirme projeleri için kullanılan web tabanlı bir sürüm kontrol deposu barındırma hizmetidir.

Temel Özellikler:

• Ücretsiz sınırsız özel depolar
• Jira ve diğer Atlassian ürünleriyle entegrasyon
• Bitbucket Pipelines ile dahili CI/CD
• Çekme istekleri ve kod inceleme
• Sorun takibi
• Dokümantasyon için Wiki

Bitbucket Kurulumu

1. Hesap Oluşturma: bitbucket.org'u ziyaret edin ve yeni bir hesap için kaydolun.

2. Yeni Bir Depo Oluşturma:

   • Kenar çubuğundaki '+' simgesine tıklayın
   • 'Repository' seçeneğini seçin
   • Bir isim belirleyin, özel veya herkese açık olarak ayarlayın
   • Sürüm kontrol sistemi olarak Git'i seçin
   • 'Create repository' düğmesine tıklayın

3. Depoyu Klonlama:

   git clone https://kullanıcıadınız@bitbucket.org/kullanıcıadınız/deponuz.git
   

4. SSH Anahtarı Ayarlama (İsteğe Bağlı ama Önerilir):

   • SSH anahtarı oluşturun:

     ssh-keygen -t rsa -b 4096 -C "eposta@ornek.com"
     

   • Genel anahtarı Bitbucket hesap ayarlarınıza ekleyin

Temel Git Komutları

1. Dosya Ekleme:

   git add dosyaadı
   git add .  # Tüm dosyaları ekler
   

2. Değişiklikleri Commit Etme:

   git commit -m "Commit mesajınız"
   

3. Değişiklikleri Gönderme:

   git push origin main
   

4. Değişiklikleri Çekme:

   git pull origin main
   

5. Durumu Kontrol Etme:

   git status
   

6. Commit Geçmişini Görüntüleme:

   git log
   

Dallanma ve Birleştirme

1. Yeni Dal Oluşturma:

   git branch yeni-özellik
   git checkout -b yeni-özellik  # Yeni dal oluşturur ve ona geçer
   

2. Dallar Arası Geçiş:

   git checkout dal-adı
   

3. Dalları Birleştirme:

   git checkout main
   git merge yeni-özellik
   

4. Dal Silme:

   git branch -d dal-adı  # Yerel silme
   git push origin --delete dal-adı  # Uzak silme
   

Çekme İstekleri

1. Çekme İsteği Oluşturma:

   • Dalınızı Bitbucket'a gönderin
   • Bitbucket'taki deponuza gidin
   • 'Create pull request' düğmesine tıklayın
   • Kaynak ve hedef dalları seçin
   • Başlık ve açıklama ekleyin
   • 'Create pull request' düğmesine tıklayın

2. Çekme İsteği İnceleme:

   • Deponuzdaki 'Pull requests' bölümüne gidin
   • İncelemek istediğiniz çekme isteğine tıklayın
   • Yorum ekleyin, onaylayın veya değişiklik isteyin

3. Çekme İsteği Birleştirme:

   • Onaydan sonra 'Merge' düğmesine tıklayın
   • Birleştirme stratejisini seçin (merge commit, squash, fast-forward)
   • Birleştirmeyi onaylayın

Sorun Takibi

1. Sorun Oluşturma:

   • Deponuzdaki 'Issues' bölümüne gidin
   • 'Create issue' düğmesine tıklayın
   • Başlık, açıklama, atanan kişi ve etiketler ekleyin
   • 'Create issue' düğmesine tıklayın

2. Sorunları Yönetme:

   • Sorunları durum, atanan kişi veya etikete göre filtreleyin
   • Güncellemeler için sorunlara yorum yapın
   • Çözüldüğünde sorunları kapatın

3. Sorunları Commit'lere Bağlama: Commit mesajınızda soruna atıfta bulunun:

   git commit -m "Giriş hatasını düzelt (fixes #123)"
   

Bitbucket Pipelines

1. Pipelines'ı Etkinleştirme:

   • Depo ayarlarına gidin
   • 'Pipelines' üzerine tıklayın ve etkinleştirin

2. bitbucket-pipelines.yml Oluşturma:

   pipelines:
     default:
       - step:
           name: Derleme ve Test
           script:
             - npm install
             - npm test
   

3. Pipeline Sonuçlarını Görüntüleme:

   • Deponuzdaki 'Pipelines' bölümüne gidin
   • Ayrıntıları ve günlükleri görmek için bir pipeline'a tıklayın

Bitbucket API

1. Kimlik Doğrulama: API kimlik doğrulaması için Uygulama şifreleri veya OAuth kullanın

2. Örnek API İsteği (curl kullanarak):

   curl -u kullanıcıadı:uygulama_şifresi -X GET https://api.bitbucket.org/2.0/repositories/kullanıcıadı/depo_slug
   

3. Webhook Kurulumu:

   • Depo ayarlarına gidin
   • 'Webhooks' üzerine tıklayın ve yeni bir webhook ekleyin
   • URL ve tetikleyicileri belirtin

Gelişmiş Özellikler

1. Snippets: Ekibinizle kod parçacıkları paylaşın

2. Çatallamalar: Değişiklik önermek için bir deponun kopyasını oluşturun

3. Bitbucket Cloud vs Server: Bulut tabanlı ve kendi sunucunuzda barındırılan seçenekler arasında seçim yapın

4. Entegrasyonlar: Jira, Trello ve Slack gibi araçlarla bağlantı kurun

En İyi Uygulamalar

1. Anlamlı Commit Mesajları Kullanın:

   git commit -m "Kullanıcı kimlik doğrulama özelliği ekle"
   

2. Düzenli Çekme ve Gönderme: Yerel deponuzu güncel tutun ve değişiklikleri sık sık gönderin

3. Dal Adlandırma Kuralları: feature/, bugfix/, hotfix/ gibi önekler kullanın

4. Kod İncelemesi: Çekme istekleri için her zaman en az bir inceleyici bulundurun

5. Depoları Temiz Tutun: Gereksiz dosyaları hariç tutmak için .gitignore kullanın

6. Sürümler için Etiketler Kullanın:

   git tag -a v1.0 -m "Sürüm 1.0 yayını"
   git push origin v1.0
   

7. Depolarınızı Yedekleyin: Yedekleme için depolarınızı düzenli olarak klonlayın veya yansıtın