Azure Linux koduna katkıda bulunma

Azure Linux kaynak depoları geneldir ve standart açık kaynak çekme isteği (PR) iş akışlarını izler. Bu makalede, PR gönderme, hataları düzeltme ve Azure üzerindeki Azure Linux senaryoları için yeni özellikler ekleme dahil olmak üzere Azure Linux koduna nasıl katkıda bulunabileceğiniz açıklanmaktadır.

Important

Kod katkıları Azure tarafından desteklenen senaryoları hedeflemelidir. Microsoft destek ve yaşam döngüsü taahhütleri yalnızca şu işlemler için geçerlidir:

  • Azure Linux Sanal Makineleri (VM) / Sanal Makine Ölçek Kümeleri (VMSS), AKS kapsayıcı ana bilgisayarı ve kapsayıcı görüntüleri.
  • Önceden oluşturulmuş bir Azure Linux görüntüsünün üzerine oluşturulan özelleştirmeler (örneğin, Image Customizer ile).

GitHub’daki Azure Linux kaynaklarından sıfırdan oluşturulan bare metal, yerinde ortamlar, diğer bulutlar veya görüntülere özgü değişiklikler upstream’e gönderilmelidir. Bunun yerine üst projeye veya Fedora Linux Project'e katkıda bulunmayı değerlendirin. Daha fazla bilgi için Azure Linux’e nasıl katkıda bulunulur bölümüne bakın.

Note

Azure Linux 4.0 artık preview içindedir ve kesinlikle değerlendirme ve test amaçlarıyla sınırlıdır. Üretim kullanımı için uygun değildir.

Başlamadan önce

Tüm kod katkıları önce bir sorun gerektirir. Bağlantılı ve sorumlu tarafından onaylanmış bir kayıt olmadan çekme isteği açmayın. Önceden sorun onayı olmadan gönderilen PR'ler gözden geçirilmeden kapatılabilir.

Katkı en iyi yöntemleri

Azure Linux'a koda katkıda bulunurken, PR’nizin verimli bir şekilde incelenip başarıyla birleştirilebilmesini sağlamak için şu en iyi uygulamaları izleyin:

  • Yukarı akış öncelikli modeli izleyin. Azure Linux'ta bir PR açmadan önce değişikliğin upstream'e ait olup olmadığını denetleyin.
  • Ekibin yönü ve kapsamı onay edebilmesi için önemsiz olmayan çalışmaya başlamadan önce bir sorun açın.
  • PR'leri küçük ve odaklanmış tutun. Her PR’da yalnızca bir mantıksal değişiklik olmalı.
    • Göndermeniz gereken daha büyük değişiklikler varsa, tam değişikliği uygulamaya çalışmadan önce kapsamı ve yaklaşımı tartışmak için bir sorun bildirerek başlayın.
  • Yeni davranış eklerken veya hataları düzeltirken testleri veya doğrulama kanıtlarını ekleyin.
  • PR açıklamanızda ilgili sorunları ve varsa upstream gönderilerini belirtin.
  • Yalnızca işlevsel değişiklikler yapacak PR'ler gönderin. Davranışı değiştirmeden yalnızca kodun stilini değiştiren veya kodu yeniden biçimlendiren PR'ler göndermekten kaçının.

Azure Linux'a kod katkıda bulunmak için:

  1. Yapmak istediğiniz çalışmayla ilgili bir sorun oluşturun veya bulun. İşe başlamadan önce bakımcının sorunu onaylamasını bekleyin. Mevcut bir sorun senaryonuzu kapsıyorsa, üzerinde çalışmak istediğinizi belirten bir açıklama ekleyin.
  2. GitHub'da depoyu oluşturun.
  3. temel alınarak açıklayıcı bir ada sahip bir main oluşturun (örneğin, feature/tool-logging).
  4. Değişikliklerinizi yapın ve kaydedin. Net ve kısa işleme iletileri yazın.
  5. Değişikliklerinizi test edin ve derlemelerin temiz olduğundan emin olun.
  6. Bir PR açın; hedef dal main olsun. PR şablonunu eksiksiz doldurun, ilgili sorunlara bağlantı verin ve nelerin değiştiğini ve nedenini açıklayın.
  7. Geri bildirimlere yanıt verin. Sürdürücüler değişiklik talep edebilir ve birden fazla revizyon turu olağandır.
  8. Onay için bekleyin. Onaylandıktan sonra PR'niz birleştirilir. Bu adım için garantili bir zaman çizelgesi yoktur.

Katılımcı Lisans Sözleşmesi (CLA)

Katkıların çoğu, Katkıda Bulunan Lisans Sözleşmesi'ni (CLA) kabul etmenizi bize katkınızı kullanma haklarını verme hakkına sahip olduğunuzu bildirmenizi ve gerçekten bunu yapmanızı gerektirir.

Çekme isteği gönderdiğinizde CLA botu, CLA sağlamanız gerekip gerekmediğini otomatik olarak belirler ve çekme isteğini buna göre güncelleştirir (örneğin, durum denetimi veya açıklama ekleyerek). Bot bir CLA gerektiğini belirtiyorsa, PR’niz birleştirilmeden önce CLA sürecini tamamlamak için sağladığı talimatları izleyin. Bunu Microsoft CLA kullanarak tüm depolarda yalnızca bir kez yapmanız gerekir.

Gözden geçirme sırasında bekleyebileceğinizler

  • İncelemeler en iyi çabadır. Bakımcılar, kapasitenin izin verdiği katkıları gözden geçirir. Zaman çizelgeleri farklılık gösterebilir.
  • Kabul garanti değildir. Her PR birleştirilmez. Farklı bir yaklaşım önerebilir, sizden önce upstream’e göndermenizi isteyebilir veya bir değişikliğin kapsam dışında olduğuna karar verebiliriz.
  • Yeniden yönlendirebiliriz. Değişikliğiniz bir yukarı akış projesi veya Fedora için daha uygunsa size bildirir ve doğru yeri bulmanıza yardımcı oluruz.
  • Küçük PR'ler daha hızlı hareket eder. Net sorun deyimleri ve yeniden üretilebilir doğrulama ile odaklanmış değişiklikler gözden geçirilmesi en kolay olanlardır.
  • Eski PR'ler kapatılacak. 30 gün boyunca etkinliği olmayan PR'ler otomatik olarak kapatılabilir. Pr üzerinde çalışmaya devam etmek istiyorsanız yeniden açabilirsiniz.

İlgili içerik

Azure Linux’a katkıda bulunma hakkında daha fazla bilgi için Azure Linux’a nasıl katkıda bulunulur bölümüne bakın.

  • Last updated on