Actions ile Kanarya Sürümleri

Yeni bir özellik veya güncelleme yayımladığınızı düşününüz. Tüm kullanıcılarınızı etkileyen bir hata içeriyorsa ne olur? Korkutucu, değil mi?

Canary sürümleri, değişiklikleri önce küçük bir kullanıcı grubuna kademeli olarak sunarak bu riski azaltmaya yardımcı olur. Bu, herkes girmeden önce havayı test etmek için "kömür madenine bir canary göndermeye" benzer.

Canary sürümleri birkaç önemli fayda sağlar:

• Azaltılmış Risk: Sorunların etkisini küçük bir kullanıcı grubuyla sınırlandırır.
• Gerçek Dünya Geri Bildirimi: Performans ve kararlılık hakkında üretim verileri elde edersiniz.
• Hızlı Geri Dönüş: Sorunlar ortaya çıkarsa yalnızca küçük canary grubunu veya hizmetin tamamını hızlıca eski durumuna döndürebilirsiniz.
• Denetimli Kullanıma Sunma: Güven arttıkça kullanıcıların erişimini kademeli olarak artırırsınız.

İki birbirinin aynısı ortam arasında trafiği anında geçirdiğiniz Mavi/Yeşil dağıtımlarını hatırlıyor olabilirsiniz.

Canary sürümleri farklıdır. Anında geçiş yerine kademeli trafik geçişi uygulanır. Yeni sürüm eski sürümle birlikte çalışır ve başlangıçta kullanıcıların yalnızca küçük bir yüzdesi yeni sürümü görür. Bu, dağıtımın tamamına geçmeden önce ayrıntılı izleme yapılmasını sağlar.

Canary sürümü için temel akış şöyledir:

1. Yeni Sürümü Dağıtma: Uygulamanızın yeni sürümü, mevcut kararlı sürümün yanında küçük bir sunucu veya örnek kümesine dağıtılır.
2. Az Miktarda Trafik Yönlendirme: Bir yük dengeleyici veya hizmet ağı, kullanıcı trafiğinin küçük bir yüzdesini (ör. %5-10) yeni sürüme gönderecek şekilde yapılandırılır.
3. İzleme: Canary grubunun performansı, hata oranları ve kullanıcı geri bildirimleri yakından izlenir.
4. Yükseltme veya Geri Dönüş: Her şey iyi görünüyorsa trafik kademeli olarak artırılır veya yeni sürüm %100'e çıkarılır. Sorunlar oluşursa canary sürümü geri alınır ve trafik kararlı sürüme yönlendirilir.

GitHub Actions, canary sürüm yayınlama sürecinin tamamını orkestre edebilir. Trafiği doğrudan yönetmez (bu, altyapınızın görevidir); ancak şu adımları tetikler:

• Uygulamanızı derleme ve test etme.
• Yeni sürümü bir canary ortamına dağıtma.
• Yük dengeleyicinize veya hizmet ağınıza API çağrıları göndererek trafik geçişlerini başlatma.
• İzleme sonuçlarını veya manuel onayları bekleme.
• Canary sürümünü yaygınlaştırma ya da geri alma işlemini tetikleme.

Canary sürüm yayınlama için tipik bir GitHub Actions iş akışı şöyle görünebilir:

name: Canary Deployment

on: push

jobs:
  build:
    # ... build and test steps ...

  deploy-canary:
    needs: build
    steps:
      - name: Deploy to Canary Group
        # ... call script/tool to deploy and shift 10% traffic ...

  monitor-canary:
    needs: deploy-canary
    # ... wait for monitoring/approval ...

  promote-or-rollback:
    needs: monitor-canary
    # ... conditionally promote to 100% or rollback ...

Her adım, dağıtım araçlarınızla etkileşime girer.

GitHub Actions orkestrasyonu gerçekleştirirken asıl karar verme ve dağıtım komutları genellikle betikler içinde çalışır. Aşağıda, bir canary yayılımının mantığını simüle eden bir Python örneği yer alıyor. Bir Action'ın bu betiği çalıştırdığını düşünün:

Etkili izleme çok önemlidir. GitHub Actions iş akışınız, izleme sistemleriyle çeşitli şekillerde bütünleşebilir:

• API Çağrıları: Önemli ölçümleri almak için izleme araçlarını (ör. Datadog, Prometheus) sorgulama.
• Sağlık Denetimleri: Uygulamanın sağlık uç noktalarını düzenli olarak sorgulama.
• Manuel Kontrol Noktaları: İş akışını insan incelemesi ve onayı için duraklatma.
• Zamana Dayalı Beklemeler: Ölçümlerin kararlı hâle gelmesi için belirli bir süre bekleme.

İş akışı daha sonra yaygınlaştırma veya geri alma kararını vermek için bu sinyalleri kullanır.

İzleme aşamasından sonra GitHub Actions, sonraki adıma karar vermek için koşullu mantık kullanır. İş veya adım tanımlarınızda if ifadelerini kullanabilirsiniz.

  promote-or-rollback:
    needs: monitor-canary
    if: success() && needs.monitor-canary.outputs.canary_ok == 'true'
    steps:
      - name: Promote Full Rollout
        # ... command to shift 100% traffic to new version ...

  rollback:
    needs: monitor-canary
    if: failure() || needs.monitor-canary.outputs.canary_ok == 'false'
    steps:
      - name: Rollback to Stable
        # ... command to shift 100% traffic to old version ...

Bu, canary performansına otomatik olarak tepki verilmesini sağlar.

Canary sürümlerinin avantajlarını ve işleyişini öğrendiniz. Şimdi anlayışınızı sınayalım.

Bu derste, yeni yazılım sürümlerini kullanıcıların bir alt kümesine kademeli olarak sunmaya yarayan güçlü bir dağıtım stratejisi olan Canary Sürümleri hakkında bilgi edindiniz.

• Canary sürümleri riski en aza indirir ve gerçek dünya geri bildirimi sağlar.
• GitHub Actions; derleme, canary ortamına dağıtım, izleme ve koşullu yaygınlaştırma/geri alma adımlarını orkestre eder.
• Etkili izleme ve koşullu mantık, başarılı canary işlem hatlarının temel unsurlarıdır.

Canary sürümlerini kullanarak daha büyük bir güven ve denetimle dağıtım yapabilirsiniz!