Publikowanie i pobieranie pakietów uniwersalnych w usłudze Azure Artifacts

Azure DevOps Services

Pakiety uniwersalne umożliwiają deweloperom przechowywanie szerokiej gamy typów pakietów poza tradycyjnymi, takimi jak Pakiety NuGet, npm, Python itp. Przy użyciu interfejsu wiersza polecenia platformy Azure można publikować i pobierać pakiety uniwersalne bezpośrednio z wiersza polecenia. Chociaż rozmiar opublikowanych pakietów może się różnić, osiągając do 4 TB, muszą one zawsze zachować niezbędne wymaganie, aby uwzględniać nazwę i numer wersji. W tym artykule opisano kroki publikowania i pobierania pakietów uniwersalnych ze źródła danych usługi Azure Artifacts.

Wymagania wstępne

Tworzenie kanału informacyjnego

Jeśli masz już kanał informacyjny, możesz przejść do następnej sekcji. W przeciwnym razie wykonaj poniższe kroki, aby utworzyć nowe źródło danych usługi Azure Artifacts:

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

  2. Wybierz pozycję Artefakty, a następnie wybierz pozycję Utwórz kanał informacyjny.

  3. Podaj opisową nazwę źródła danych i ustaw jej widoczność (kto może wyświetlać pakiety w kanale informacyjnym). Zdefiniuj zakres źródła danych, a następnie zaznacz pole wyboru Nadrzędne źródła, jeśli chcesz uwzględnić pakiety z publicznych rejestrów.

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

    Zrzut ekranu przedstawiający sposób tworzenia nowego kanału informacyjnego.

Uwaga

Nowo utworzone kanały informacyjne domyślnie wyznaczają rolę usługi kompilacji projektu jako Źródło danych i Nadrzędny czytelnik (współpracownik).

Instalowanie rozszerzenia usługi Azure DevOps

Korzystanie z interfejsu wiersza polecenia pomaga usprawnić zadania. Przed kontynuowaniem upewnij się, że zainstalowano interfejs wiersza polecenia platformy Azure (wersja 2.10.1 lub nowsza). Ponadto należy zainstalować rozszerzenie Usługi Azure DevOps, aby zarządzać usługami Azure DevOps z poziomu wiersza polecenia.

  1. Uruchom następujące polecenie, aby zainstalować rozszerzenie usługi Azure DevOps:

    az extension add --name azure-devops
    
  2. Jeśli masz już zainstalowane rozszerzenie Usługi Azure DevOps i chcesz zaktualizować je do najnowszej wersji, uruchom następujące polecenie:

    az extension update --name azure-devops
    

Połączenie do kanału informacyjnego

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

  2. Wybierz pozycję Artefakty, a następnie wybierz źródło danych z menu rozwijanego.

  3. Wybierz pozycję Połączenie do kanału informacyjnego, a następnie wybierz pozycję Pakiety uniwersalne w okienku nawigacji po lewej stronie.

  4. Postępuj zgodnie z instrukcjami w sekcji Konfiguracja projektu, aby nawiązać połączenie ze źródłem danych.

  1. Uruchom następujące polecenie, aby zalogować się do interfejsu wiersza polecenia platformy Azure:

    az login
    
  2. Uruchom następujące polecenie, aby ustawić projekt i organizację jako domyślną konfigurację interfejsu wiersza polecenia:

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

Publikowanie pakietów uniwersalnych

Aby opublikować pakiet uniwersalny w kanale informacyjnym, musisz podać nazwę pakietu i numer wersji.

Nazwa pakietu powinna mieć małe litery, uruchomić i kończyć się literami lub cyframi i zawierać tylko litery, cyfry i nieskontencyjne kreski, podkreślenia i kropki. Wersja pakietu powinna również zawierać małe litery i nie powinna zawierać metadanych kompilacji (+ sufiks). Aby uzyskać więcej informacji, zobacz semantyczne przechowywanie wersji.

  1. Uruchom następujące polecenie, aby opublikować pakiet uniwersalny w kanale informacyjnym:

    • Kanał informacyjny o 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>
      
    • Źródło danych o 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>
      

Uwaga

Jeśli twoja organizacja korzysta z zapory lub serwera proxy, upewnij się, że zezwalasz na adresy URL i adresy IP domeny usługi Azure Artifacts.

Wyświetlanie opublikowanych pakietów

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

  2. Wybierz pozycję Artefakty, a następnie wybierz źródło danych z menu rozwijanego. Po pomyślnym zakończeniu procesu publikowania pakiet powinien być dostępny w kanale informacyjnym.

    Zrzut ekranu przedstawiający nowo opublikowany pakiet uniwersalny.

Pobieranie pakietów uniwersalnych

Uruchom następujące polecenie, aby pobrać określony pakiet uniwersalny ze źródła danych przy użyciu interfejsu wiersza polecenia platformy Azure:

  • Kanał informacyjny o zakresie organizacji:

    az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>
    
  • Źródło danych o zakresie projektu:

    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>
    

Pobieranie określonych plików

Jeśli chcesz pobrać tylko określone pliki, użyj parametru --file-filter , aby pobrać podzestaw plików. Aby uzyskać więcej informacji, zobacz Dokumentację wzorców dopasowywania plików.

  • Kanał informacyjny o zakresie organizacji:

    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>
    
  • Źródło danych o zakresie projektu:

    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>
    

Przykład: na przykład użycie parametru --file-filter logs/.log będzie pasować do dowolnego pliku z nazwą pliku zawierającą ciąg "logs" i kończącym się rozszerzeniem ".log" (np. build_logs.log).

Pobieranie najnowszej wersji

Możesz użyć symboli wieloznacznych * , aby pobrać najnowszą wersję pakietów uniwersalnych.

Przykłady:

  • --version '*': pobierz najnowszą wersję.

  • --version '1.*': pobierz najnowszą wersję z główną wersją 1.

  • --version '1.2.*': pobierz najnowszą wersję poprawki z głównymi wersjami 1 i 2.

Uwaga

Wzorce wieloznaczne nie są obsługiwane w wersjach wstępnych (pakiety z kreską w numerze wersji).