Publikowanie pakietów uniwersalnych z kanałów informacyjnych usługi Azure Artifacts

usługi Azure DevOps

Pakiety uniwersalne umożliwiają przechowywanie wielu typów plików i zawartości pakietu poza formatami, takimi jak Pakiety NuGet, npm i Python. Można je opublikować bezpośrednio z poziomu wiersza polecenia przy użyciu Azure CLI. Pakiet uniwersalny może zawierać maksymalnie 4 TiB i musi zawierać nazwę i wersję. W tym artykule pokazano, jak opublikować pakiet uniwersalny w kanale informacyjnym Azure Artifacts.

Warunki wstępne

Produkt Wymagania
Usługi Azure DevOps — Organizacja usługi Azure DevOps .
— Projekt usługi Azure DevOps .
- Zainstaluj Azure CLI.
— Zainstaluj rozszerzenie Azure DevOps w wersji 0.14.0 lub nowszej.

Instalowanie rozszerzenia usługi Azure DevOps

Rozszerzenie Azure DevOps dla Azure CLI umożliwia zarządzanie usługami Azure DevOps z poziomu wiersza polecenia. Przed zainstalowaniem upewnij się, że zainstalowano Azure CLI w wersji 2.10.1 lub nowszej.

  1. Aby zainstalować rozszerzenie Azure DevOps, uruchom polecenie:

    az extension add --name azure-devops
    
  2. Aby zaktualizować istniejącą instalację do najnowszej wersji, uruchom polecenie:

    az extension update --name azure-devops
    

Tworzenie kanału informacyjnego

Zanim będzie można opublikować pakiet uniwersalny, potrzebny jest strumień, do którego można go opublikować. Feed to kontener, który przechowuje i organizuje Twoje pakiety, a Ty możesz kontrolować, kto ma do nich dostęp. Wykonaj poniższe kroki, aby utworzyć kanał informacyjny dla projektu lub organizacji.

  1. Zaloguj się do organizacji usługi Azure DevOps i przejdź do projektu.

  2. Wybierz pozycję Artifacts, a następnie wybierz pozycję Create Feed.

  3. Wprowadź nazwę kanału informacyjnego.

  4. Wybierz opcję Widoczność, aby kontrolować, kto może wyświetlać pakiety.

  5. Wybierz pozycję Uwzględnij pakiety z typowych źródeł publicznych, jeśli chcesz, aby źródło danych pobierało również pakiety ze źródeł publicznych, takich jak nuget.org lub npmjs.com.

  6. W obszarze Zakres wybierz, czy kanał informacyjny ma zastosowanie tylko do projektu, czy do całej organizacji.

  7. Po zakończeniu wybierz pozycję Utwórz.

    Zrzut ekranu przedstawiający sposób tworzenia nowego kanału informacyjnego w usługach Azure DevOps Services.

Publikowanie pakietów uniwersalnych

Po utworzeniu kanału informacyjnego możesz opublikować w nim pakiet uniwersalny. Każdy publikowany pakiet wymaga nazwy i numeru wersji, a oba muszą być zgodne z określonymi regułami nazewnictwa:

  • Nazwa pakietu musi składać się z małych liter, musi zaczynać i kończyć się literą lub cyfrą oraz może zawierać wyłącznie litery, cyfry i myślniki nie występujące bezpośrednio po sobie (-), znaki podkreślenia (_) lub kropki (.).
  • Wersja pakietu musi być również zapisana małymi literami i nie może zawierać metadanych kompilacji oznaczanych sufiksem +. Aby uzyskać więcej informacji, zobacz wersjonowanie semantyczne.
  1. Uruchom jedno z następujących poleceń, aby opublikować pakiet Universal, w zależności od tego, czy strumień jest ograniczony do projektu, czy do organizacji:

    • Kanał informacyjny w zakresie projektu:

      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>
      
    • Kanał informacyjny w zakresie organizacji:

      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>
      

Notatka

Jeśli pakiet zawiera wyjątkowo dużą liczbę plików (100 000 lub więcej), publikowanie może zakończyć się niepowodzeniem. W takim przypadku należy powiązać pliki z archiwum ZIP lub TAR , aby zmniejszyć liczbę plików.

Wyświetlanie opublikowanych pakietów

Po opublikowaniu pakietu możesz potwierdzić, że jest on dostępny w kanale informacyjnym.

  1. Zaloguj się do organizacji usługi Azure DevOps, a następnie przejdź do projektu.

  2. Wybierz pozycję Artifacts, a następnie wybierz swój kanał z menu rozwijanego. Jeśli publikowanie zostało ukończone pomyślnie, pakiet powinien być dostępny w kanale informacyjnym.

    Zrzut ekranu przedstawiający nowo opublikowany pakiet uniwersalny.