Udostępnij przez


Publikowanie i pobieranie pakietów NuGet za pomocą usługi Azure Artifacts

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Usługa Azure Artifacts umożliwia deweloperom publikowanie i pobieranie pakietów NuGet z źródeł danych lub publicznych rejestrów. Kanały informacyjne mogą być prywatne, dzięki czemu można udostępniać pakiety określonym użytkownikom lub publicznie, dzięki czemu pakiety będą dostępne dla wszystkich użytkowników w Internecie.

Ten artykuł przeprowadzi Cię przez proces tworzenia kanału informacyjnego, konfigurowania projektu oraz publikowania i pobierania pakietów NuGet.

Wymagania wstępne

produkt Wymagania
Azure DevOps — Organizacja usługi Azure DevOps .
— Projekt usługi Azure DevOps .
— Pobierz i zainstaluj dostawcę poświadczeń usługi Azure Artifacts.
— Zainstaluj najnowszą wersję pakietu NuGet.

Tworzenie kanału informacyjnego

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

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

  3. Podaj Nazwę dla kanału informacyjnego, wybierz opcję Widoczność definiującą, kto może wyświetlać pakiety, zaznacz Uwzględnij pakiety z typowych źródeł publicznych, jeśli chcesz uwzględnić pakiety ze źródeł, takich jak nuget.org lub npmjs.com, a dla Zakresuzdecyduj, czy kanał informacyjny powinien być ograniczony do projektu, czy całej organizacji.

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

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

  1. Zaloguj się do serwera 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 Nazwę dla kanału informacyjnego, wybierz opcję Widoczność definiującą, kto może wyświetlać pakiety, zaznacz Uwzględnij pakiety z typowych źródeł publicznych, jeśli chcesz uwzględnić pakiety ze źródeł, takich jak nuget.org lub npmjs.com, a dla Zakresuzdecyduj, czy kanał informacyjny powinien być ograniczony do projektu, czy całej organizacji.

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

    Zrzut ekranu przedstawiający opcje tworzenia nowego kanału informacyjnego w usłudze Azure DevOps 2022.

Uwaga

Domyślnie usługa kompilacji dla projektu (na przykład: projectName Build Service (orgName)) ma przypisaną rolę Kanał informacyjny i Nadrzędny czytelnik (współpracownik) podczas tworzenia nowego źródła danych.

Nawiązywanie połączenia z kanałem informacyjnym

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

  2. Wybierz pozycję Artefakty, a następnie wybierz kanał z menu rozwijanego.

  3. Wybierz pozycję Połącz z kanałem informacyjnym, a następnie wybierz pozycję NuGet.exe w okienku nawigacji po lewej stronie. Jeśli po raz pierwszy używasz usługi Azure Artifacts z Nuget.exe, upewnij się, że zainstalowano wymagania wstępne.

  4. Postępuj zgodnie z podanymi instrukcjami w sekcji Konfiguracja projektu , aby skonfigurować plik nuget.config i nawiązać połączenie ze źródłem danych usługi Azure Artifacts.

    Zrzut ekranu przedstawiający sposób konfigurowania projektu i nawiązywania połączenia ze źródłem danych w usługach Azure DevOps Services.

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

  2. Wybierz pozycję Artefakty, a następnie wybierz kanał z menu rozwijanego.

  3. Wybierz pozycję Połącz z kanałem informacyjnym, a następnie wybierz pozycję NuGet.exe w okienku nawigacji po lewej stronie.

  4. Postępuj zgodnie z podanymi instrukcjami w sekcji Konfiguracja projektu , aby skonfigurować plik nuget.config i nawiązać połączenie ze źródłem danych usługi Azure Artifacts.

    Zrzut ekranu przedstawiający sposób konfigurowania projektu i nawiązywania połączenia ze źródłem danych w usługach Azure DevOps Server 2020 i 2022.

Publikowanie pakietów w kanale informacyjnym

Aby opublikować pakiet w kanale informacyjnym, uruchom następujące polecenie. Parametr ApiKey jest wymagany, ale można użyć dowolnego ciągu jako jego wartości.

nuget.exe push -Source <SOURCE_NAME> -ApiKey key <PACKAGE_PATH>

Przykłady

  • Kanał informacyjny w zakresie projektu:

    nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/MyProject/_packaging/MyFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
    
  • Kanał informacyjny dedykowany organizacji:

    nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/_packaging/myFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
    

Uwaga

ApiKey jest wymagany, ale przy publikowaniu do kanałów Azure Artifacts można użyć dowolnej wartości.

Pobieranie pakietów ze źródła danych

Aby przywrócić pakiety ze źródła danych, uruchom następujące polecenie w katalogu projektu:

nuget.exe restore

Uwaga

Wyszukiwanie pakietów w źródłach nadrzędnych przy użyciu Eksploratora pakietów NuGet nie jest obsługiwane.