Publikowanie i pobieranie pakietów uniwersalnych w usłudze Azure Artifacts
usługi Azure DevOps
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.
Warunki wstępne
Organizacja i projekt usługi Azure DevOps. Utwórz organizację lub projekt, jeśli jeszcze tego nie zrobiłeś.
Zainstaluj rozszerzenie Usługi Azure DevOps w wersji 0.14.0 lub nowszej.
Tworzenie kanału informacyjnego
Jeśli masz już kanał, przejdź do następnej sekcji. W przeciwnym razie wykonaj poniższe kroki, aby utworzyć nowe źródło danych usługi Azure Artifacts:
Zaloguj się do organizacji usługi Azure DevOps, a następnie przejdź do projektu.
Wybierz pozycję Artifacts, a następnie wybierz pozycję Create Feed.
Podaj opisową Nazwa dla kanału informacyjnego i ustaw jej widoczności (kto może wyświetlać pakiety w kanale informacyjnym). Zdefiniuj zakres źródła danych, a następnie zaznacz pole wyboru Źródła nadrzędne, jeśli chcesz uwzględnić pakiety z rejestrów publicznych.
Po zakończeniu wybierz pozycję Utwórz.
Notatka
Nowo utworzone kanały informacyjne domyślnie wyznaczają rolę usługi kompilacji projektu jako kanał informacyjny i czytelnik nadrzędny (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.
Uruchom następujące polecenie, aby zainstalować rozszerzenie usługi Azure DevOps:
az extension add --name azure-devopsJeś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łącz z kanałem informacyjnym
Zaloguj się do organizacji usługi Azure DevOps, a następnie przejdź do projektu.
Wybierz pozycję Artifacts, a następnie wybierz swój kanał z menu rozwijanego.
Wybierz pozycję Połącz z kanałem informacyjnym, a następnie wybierz pozycję Universal Packages w okienku nawigacji po lewej stronie.
Postępuj zgodnie z instrukcjami w sekcji konfiguracja Project, aby nawiązać połączenie ze źródłem danych.
Uruchom następujące polecenie, aby zalogować się do interfejsu wiersza polecenia platformy Azure:
az loginUruchom 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>
Notatka
Jeśli twoja organizacja korzysta z zapory lub serwera proxy, upewnij się, że zezwalasz adresy URL domeny i adresy IP usługi Azure Artifacts.
Publikowanie pakietów uniwersalnych
Aby opublikować pakiet uniwersalny w kanale informacyjnym, musisz podać nazwę pakietu i numer wersji.
Nazwa pakietu powinna być zapisana małymi literami, zaczynać się i kończyć literą lub cyfrą, i zawierać tylko litery, cyfry oraz nieprzylegające 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 wersjonowanie semantyczne.
Uruchom następujące polecenie, aby opublikować pakiet Uniwersalny w repozytorium:
Kanał informacyjny 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>
Notatka
Publikowanie pakietów uniwersalnych zawierających wyjątkowo dużą liczbę plików (100K+) może zakończyć się niepowodzeniem. W takim przypadku zalecamy spakowanie plików do archiwum ZIP lub TAR, aby zmniejszyć liczbę plików.
Wyświetlanie opublikowanych pakietów
Zaloguj się do organizacji usługi Azure DevOps, a następnie przejdź do projektu.
Wybierz element Artifacts, a następnie wybierz swój kanał z menu rozwijanego. Po pomyślnym zakończeniu procesu publikowania pakiet powinien być dostępny w kanale.
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 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ć podzbiór plików. Aby uzyskać więcej informacji, zobacz Odwołanie do wzorców dopasowywania plików.
Kanał informacyjny dla 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 --file-filter logs/.log będzie pasować do dowolnego pliku z nazwą pliku zawierającą "logs" i kończącym się rozszerzeniem ".log" (np. build_logs.log).
Pobieranie najnowszej wersji
Możesz użyć znaków wieloznacznych *, aby pobrać najnowszą wersję uniwersalnych pakietów.
Przykłady:
--version '*': pobierz najnowszą wersję.--version '1.*': pobierz najnowszą wersję z wersją główną 1.--version '1.2.*': pobierz najnowszą wersję poprawki z główną wersją 1 i pomocniczą 2.
Notatka
Wzorce wieloznaczne nie są obsługiwane w wersjach wstępnych (pakiety z kreską w numerze wersji).