Azure Artifacts en iyi uygulamalar

Azure DevOps Hizmetleri | Azure DevOps Server | Azure DevOps Server 2022

Azure Artifacts, ekiplere paketleri yayımlamak, depolamak, paylaşmak ve kullanmak için tek bir yer sağlar. Akışlarınızın, paketlerinizin ve tüketicilerinizin sayısı arttıkça, erken alınan birkaç karar paket yönetimini ya basit hâle getirebilir ya da bakımını zorlaştırabilir. Bu makale, paket geri yüklemelerini tahmin edilebilir tutmanıza, paketleri daha fazla denetimle yayınlamanıza ve akışları zaman içinde daha kolay yönetmenize yardımcı olan uygulamaları bir araya getirir.

Temel kılavuz

  • Her istemci yapılandırma dosyasında bir akış kullanın ve genel kayıt defterlerine veya ek iç kaynaklara ihtiyacınız olduğunda bu akışta yukarı akış kaynaklarını etkinleştirin. Bu yaklaşım, yapılandırma dosyalarını daha basit tutar ve akışınızın daha öngörülebilir geri yükleme davranışı sağlamasına yardımcı olur. Daha fazla bilgi için bkz. Yukarı akış kaynakları nedir?

  • Akış görünümlerini yayın kanalları olarak değerlendirin. @local'de yeni sürümler yayımlayın, bunları burada doğrulayın ve ardından daha geniş kullanıma hazır olan sürümleri @release veya @prerelease'ye ilerletin. Bu yaklaşım, hala değerlendirilmekte olan paket sürümlerini daha fazla tüketiciyle paylaşmaya hazır sürümlerden ayırmanıza yardımcı olur. Daha fazla bilgi için bkz. Akış görünümleri nedir?

  • Akış izinlerini kasıtlı olarak yapılandırın. Paketleri kimin yayımlayabileceğine, yukarı akış kaynaklarından paketleri kimin kaydedebileceğine ve paylaşılan görünümlerdeki paketleri kimin kullanabileceğine karar verin. Net rol sınırları, akışın korunmasına ve kazara yapılan değişikliklerin azaltılmasına yardımcı olur. Daha fazla bilgi için Akış rolleri ve izinleri bölümüne bakın.

  • Eski paket sürümleri birikmeye başlamadan önce bekletme ilkelerini etkinleştirin. Eski sürümler, özellikle aktif akışlarda, hızla birikebilir. Bekletme ilkeleri, depolama büyümesini denetlemeye ve akışları yönetilebilir tutmak için gereken çabayı azaltmaya yardımcı olur. Daha fazla bilgi için bkz. Bekletme ilkeleriyle paketleri otomatik olarak silme.

Paket yayımcıları için en iyi yöntemler

Aşağıdaki en iyi yöntemler tutarlılık, güvenlik ve sorunsuz bir kullanıcı deneyimi sağlamaya yardımcı olur. Aşağıda Azure Artifacts ile paket yayımlarken önemli öneriler yer almaktadır:

Not

Bir akışa paket yayımlamak için Besleme Yayımcısı (Katkıda Bulunan) veya üzeri olmanız gerekir. Daha fazla ayrıntı için Akış rolleri ve izinlerine bakın.

  • Depo başına tek bir akış kullanın:

    Akış, birden çok paket türünü barındırabilen bir kuruluş yapısıdır. Bir proje birden çok akış kullanabilir ancak çakışmaları azaltmak ve paket yönetimini basitleştirmek için bir deponun bir birincil akışa bağlı kalmasını sağlamak genellikle daha iyidir. Ek akışlardan veya genel kayıt defterlerinden gelen paketlere ihtiyacınız varsa, her istemci yapılandırmasına doğrudan birden çok akış eklemek yerine yukarı akış kaynaklarını kullanın.

  • yeni oluşturulan paketleriotomatik olarak yayımla:

    Yeni paketlerin yayınını otomatikleştirmek, en son sürümlerin el ile müdahale edilmeden ekibinizin veya hedef tüketicilerin kullanımına sunulmasına yardımcı olur. Bir paketi yayımladığınızda Azure Artifacts, paketi akışınızdaki @local görünümüne ekler. Bkz. Akış görünümleri nedir? Daha fazla bilgi için.

  • Eski paket sürümlerini otomatik olarak temizlemek için bekletme ilkelerini etkinleştirin:

    Zaman içinde eski paket sürümleri birikebilir, depolamayı tüketebilir ve akışların yönetilmesini zorlaştırabilir. Bekletme ilkeleri, belirtilen sayıda son sürümü tutarken eski paket sürümlerini otomatik olarak kaldırmanıza olanak sağlar. Bu işlem, depolama büyümesini denetlemeye ve akışların bakımının daha kolay tutulmasına yardımcı olur. Daha fazla ayrıntı için bkz. Bekletme ilkeleriyle paketleri otomatik olarak silme .

  • paketleri serbest bırakmak için akış görünümlerini kullanın:

    Akış görünümleri, paket sürümlerinin bir alt kümesini tüketicilerle paylaşmanıza olanak verir. Örneğin, bir paketi ilk kullanıcılar için @prerelease durumuna geçirebilir, ardından daha geniş kullanıma hazır olduğunda @release durumuna geçirebilirsiniz. Görünüme yükseltilen paketler bekletme ilkelerinden muaftır. Bkz. Akış görünümleri nedir? Daha fazla bilgi için.

  • Görünümleriniz için uygun erişim izinlerini sağlayın

    Paketleriniz dış ekipler tarafından veya kuruluşlar arasında kullanılıyorsa, @prerelease ve @release görünümlerinin uygun görünürlük ayarlarına sahip olduğundan emin olun. Daha fazla ayrıntı için bkz. Akış görünümleri ayarları.

Paket tüketicileri için en iyi yöntemler

Paketleri kullandığınızda, geri yüklemeleri tahmin edilebilir hale getirmeyi ve paketlerin nereden geldiğini net hale getirmeyi hedefleyin.

  • İstemci yapılandırmanızda bir akış kullanın:

    Akışınızın belirlenimci bir geri yükleme sağlamasına yardımcı olmak için istemci yapılandırmanızın yukarı akış kaynaklarının etkinleştirildiği tek bir akışa başvurdığından emin olun. Bu yaklaşım, yapılandırma dosyalarınızı daha basit tutar ve beklenmeyen paket çözümleme sonuçları olasılığını azaltır. Daha fazla bilgi için bkz. Yukarı akış kaynakları nedir?

  • dış paketler için yukarı akış kaynaklarını kullanın:

    Dış akışlardan veya NuGet.org veya npmjs.com gibi genel kayıt defterlerinden paketler kullanıyorsanız, bu kaynakları her istemci yapılandırmasına ayrı olarak eklemek yerine yukarı akış kaynaklarını kullanın. Bu yaklaşım, ekibinize aynı akış aracılığıyla hem iç hem de dış bağımlılıkları geri yüklemek için tutarlı bir yol sağlar. Daha fazla bilgi için bkz. Yukarı akış kaynakları nedir? ve Akış kaynaklarını ayarlama.

    Not

    Yukarı akış kaynaklarından paketleri kaydetmek için Feed ve Yukarı Akış Okuyucu (Katılımcı) veya üzeri olmanız gerekir. Daha fazla ayrıntı için Akış rolleri ve izinlerine bakın.

  • Yukarı akış kaynaklarını kasıtlı olarak sırala:

    Akış, yukarı akış kaynaklarını sıralı olarak denetler ve onu içeren ilk kaynaktan paketi döndürür. Birden çok yukarı akış kaynağı kullanıyorsanız, akışın istediğiniz kaynaktan gelen paketleri çözümlemesi için bunları sıralarsınız. Bu sıralama en çok genel kayıt defterlerinin ve iç akışların bir karışımını kullandığınızda veya kuruluşunuz özelleştirilmiş açık kaynak paketlerini dahili olarak yeniden yayımladığında önemlidir. Daha fazla bilgi için bkz: Yukarı akış kaynaklarınızı bilinçli olarak sıralayın ve Arama sırası.

  • Tüketicilerin ne göreceğini denetlemek için akış görünümlerini kullanın:

    Ekibiniz akış görünümleri aracılığıyla doğrulanmış paket sürümlerini yükseltiyorsa, yalnızca belirli bir hedef kitleye yönelik paket sürümlerini paylaşmak için bu görünümleri kullanın. Örneğin, yeni yayımlanan paketleri @local içinde tutabilir, önizleme derlemelerini @prerelease aracılığıyla paylaşabilir ve onaylanmış paketleri @release aracılığıyla paylaşabilirsiniz.

  • Aynı kiracıdaki kuruluşlar arası kaynaklar için akış bulucuyu kullanın:

    Kaynaklar aynı Microsoft Entra kiracısındaysa ancak kuruluşunuzun bir parçası değilse, akış bulucuyu kullanın. Söz dizimi azure-feed://<organization>/<projectName>/<feed>@<view>'dir.

İlgili içerik

  • Last updated on