Aracılığıyla paylaş


Azure Artifacts'te Evrensel Paketleri yayımlama ve indirme

Azure DevOps Services

Evrensel Paketler, geliştiricilerin NuGet, npm, Python paketleri vb. gibi geleneksel paketlerin ötesinde çok çeşitli paket türlerini depolamasına olanak tanır. Azure CLI kullanarak Evrensel Paketleri doğrudan komut satırından yayımlayabilir ve indirebilirsiniz. Yayımlanan paketlerin boyutu farklılık gösterse de, 4 TB'a kadar çıksa da, her zaman bir ad ve sürüm numarası ekleme gereksinimini sürdürmeleri gerekir. Bu makale, Azure Artifacts akışınızdan Evrensel Paketleri yayımlama ve indirme adımlarında size yol gösterir.

Önkoşullar

Akış oluşturma

Zaten bir akışınız varsa sonraki bölüme geçebilirsiniz. Aksi takdirde, yeni bir Azure Artifacts akışı oluşturmak için aşağıdaki adımları izleyin:

  1. Azure DevOps kuruluşunuzda oturum açın ve projenize gidin.

  2. Yapıtlar'ı seçin ve ardından Akış Oluşturöğesini seçin.

  3. Akışınız için açıklayıcı bir Ad sağlayın ve Kimlerin Görebileceğini ayarlayın (akışınızdaki paketleri kimler görüntüleyebilir). Akışınızın Kapsamı tanımlayın ve genel kayıt defterlerinden paketleri eklemek istiyorsanız Yukarı akış kaynakları onay kutusunu seçin.

  4. İşiniz bittiğinde oluştur'u seçin.

    Yeni akışın nasıl oluşturulacağını gösteren ekran görüntüsü.

Not

Yeni oluşturulan beslemeler, projenin Derleme Hizmeti rolünü varsayılan olarak Besleme ve Yukarı Besleme Okuyucusu (Ortak Çalışan) olarak belirler.

Azure DevOps uzantısını yükleme

CLI'yi kullanmak, görevlerinizi kolaylaştırmaya yardımcı olur. Devam etmeden önce Azure CLI(sürüm 2.10.1 veya üzeri) yüklediğinizden emin olun. Ayrıca, komut satırından Azure DevOps hizmetlerini yönetmek için Azure DevOps uzantısını yüklememiz gerekir.

  1. Azure DevOps uzantısını yüklemek için aşağıdaki komutu çalıştırın:

    az extension add --name azure-devops
    
  2. Azure DevOps uzantısı zaten yüklüyse ve en son sürüme güncelleştirmek istiyorsanız aşağıdaki komutu çalıştırın:

    az extension update --name azure-devops
    

Akışa bağlan

  1. Azure DevOps kuruluşunuzda oturum açın ve projenize gidin.

  2. Yapıtlar'ı seçin ve ardından açılan menüden akışınızı seçin.

  3. Akışa Bağlan'ıseçin ve ardından sol gezinme bölmesinden Evrensel Paketler 'yi seçin.

  4. Akışınıza bağlanmak için Project kurulumu bölümündeki yönergeleri izleyin.

  1. Azure CLI'da oturum açmak için aşağıdaki komutu çalıştırın:

    az login
    
  2. Projenizi ve kuruluşunuzu CLI'nın varsayılan yapılandırması olarak ayarlamak için aşağıdaki komutu çalıştırın:

    az devops configure --defaults project=<YOUR_PROJECT_NAME> organization=https://dev.azure.com/<YOUR_ORGANIZATION_NAME> 
    

Not

Kuruluşunuz bir güvenlik duvarı veya ara sunucu kullanıyorsa,Azure Artifacts Etki Alanı URL'lerine ve IP adreslerine izin verdiğinizden emin olun.

Evrensel Paketleri Yayımlama

Akışınızda Evrensel Paket yayımlamak için bir paket adı ve sürüm numarası sağlamanız gerekir.

Paket adı tamamen küçük harflerle yazılmalı, harf veya sayıyla başlayıp bitmeli ve yalnızca harfler, sayılar, ardışık olmayan kısa çizgiler, alt çizgiler ve noktalar içermelidir. Paket sürümü de küçük harfle yazılmalıdır ve derleme meta verilerini (+ son eki) içermemelidir. Daha fazla bilgi için anlamsal sürümleme bölümüne bakın.

  1. Evrensel Paketinizi akışınızda yayımlamak için aşağıdaki komutu çalıştırın:

    • Kuruluş genelinde besleme

      az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>
      
    • Projeye özel besleme

      az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>
      

Not

Çok fazla sayıda dosya (100K+) içeren Evrensel Paketler yayımlanamayabilir. Bu durumda, dosya sayısını azaltmak için dosyaları bir ZIP veya TAR arşivine paketlemenizi öneririz.

Yayımlanan paketleri görüntüleme

  1. Azure DevOps kuruluşunuzda oturum açın ve projenize gidin.

  2. Yapıtlar'ı seçin ve ardından açılan menüden akışınızı seçin. Yayımlama işlemi başarıyla tamamlandıktan sonra paketinizin akışınızda kullanılabilir olması gerekir.

    Yeni yayımlanan Evrensel Paketi gösteren ekran görüntüsü.

Evrensel Paketleri İndir

Azure CLI kullanarak akışınızdan belirli bir Evrensel Paketi indirmek için aşağıdaki komutu çalıştırın:

  • Kuruluş kapsamındaki akış:

    az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>
    
  • Proje kapsamlı akış:

    az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>
    

Belirli dosyaları indirme

Yalnızca belirli dosyaları indirmek istiyorsanız, dosyaların bir alt kümesini getirmek için --file-filter parametresini kullanın. Daha fazla bilgi için bkz. Dosya eşleştirme deseni referansı.

  • Kuruluş kapsamlı akış:

    az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH> --file-filter <MATCH_PATTERN>
    
  • Proje kapsamlı akış:

    az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH> --file-filter <MATCH_PATTERN>
    

Örnek: Örneğin, --file-filter logs/.log kullanılarak "logs" içeren ve ".log" uzantısıyla biten (örneğin, build_logs.log) dosya adıyla tüm dosyalar eşleşir.

En son sürümü indirin

Universal Paketlerinizin en son sürümünü indirmek için * joker karakterlerini kullanabilirsiniz.

Örnekleri:

  • --version '*': En son sürümü indirin.

  • --version '1.*': Ana sürüm 1'in en son versiyonunu indirin.

  • --version '1.2.*': Ana sürüm 1 ve alt sürüm 2 ile en son yama sürümünü indirin.

Not

Joker karakter desenleri yayın öncesi sürümlerde (sürüm numarasında tire bulunan paketler) desteklenmez.