Wprowadzenie do pakietów NuGet w usłudze Azure Artifacts

  • Artykuł

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Usługa Azure Artifacts umożliwia deweloperom publikowanie i pobieranie pakietów NuGet z różnych źródeł, takich jak kanały informacyjne i rejestry publiczne. Za pomocą usługi Azure Artifacts możesz tworzyć kanały informacyjne, które mogą być prywatne, co pozwala udostępniać pakiety zespołowi i określonym użytkownikom lub użytkownikom publicznym, umożliwiając ich otwarcie wszystkim użytkownikom w Internecie.

Ten artykuł obejmuje następujące zagadnienia:

  • Tworzenie nowego kanału informacyjnego
  • Konfigurowanie projektu i nawiązywanie połączenia z kanałem informacyjnym
  • Publikowanie pakietów NuGet
  • Pobieranie pakietów ze źródła danych

Wymagania wstępne

  • Organizacja i projekt usługi Azure DevOps. Utwórz organizację lub projekt, jeśli jeszcze tego nie zrobiono.

  • Zainstaluj najnowszą wersję pakietu NuGet.

  • Zainstaluj dostawcę poświadczeń usługi Azure Artifacts.

Tworzenie kanału informacyjnego

Usługa Azure Artifacts oferuje dwa typy źródeł danych: źródła danych o zakresie projektu i źródła danych o zakresie organizacji. Jeśli chcesz utworzyć publiczne źródło danych, zacznij od utworzenia kanału informacyjnego o zakresie projektu, a następnie dostosuj ustawienia widoczności projektu obsługującego kanał informacyjny do publicznej wiadomości. Dzięki temu kanał informacyjny o zakresie projektu będzie dostępny dla publicznej wiadomości.

  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 źródło danych , aby utworzyć nowe źródło danych.

  3. Wprowadź opisową nazwę źródła danych i zdefiniuj jego widoczność (wskazującą, kto może wyświetlać pakiety w kanale informacyjnym). Określ zakres źródła danych, a jeśli chcesz uwzględnić pakiety ze źródeł publicznych, zaznacz pole wyboru Upstream sources (Źródła nadrzędne).

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

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

Uwaga

Domyślnie nowo utworzone kanały informacyjne mają ustawioną usługę kompilacji projektu na Źródło danych i Czytelnik nadrzędny (współpracownicy).

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.

    Zrzut ekranu przedstawiający przycisk Połącz z kanałem informacyjnym.

  4. Wybierz pozycję NuGet.exe. Jeśli po raz pierwszy używasz usługi Azure Artifacts z Nuget.exe, upewnij się, że zainstalowano wszystkie wymagania wstępne.

  5. Postępuj zgodnie z instrukcjami podanymi w sekcji Konfiguracja projektu, aby skonfigurować plik nuget.config.

    Zrzut ekranu przedstawiający sposób konfigurowania projektu.

Pobieranie pakietów

1. Pobieranie źródłowego adresu URL kanału informacyjnego

  1. Przejdź do projektu, a następnie wybierz pozycję Artefakty , a następnie wybierz źródło danych.

  2. Wybierz pozycję Połączenie do kanału informacyjnego, a następnie wybierz pozycję Visual Studio z panelu nawigacji po lewej stronie.

  3. Skopiuj adres URL źródła .

    Zrzut ekranu przedstawiający źródłowy adres URL.

2. Konfigurowanie programu Visual Studio

  1. W programie Visual Studio wybierz pozycję Narzędzia, a następnie pozycję Opcje.

  2. Rozwiń sekcję Menedżer pakietów NuGet, a następnie wybierz pozycję Źródła pakietów.

  3. Wprowadź nazwę źródła i adres URL źródła, a następnie wybierz zielony znak (+), aby dodać źródło.

  4. Jeśli włączono źródła nadrzędne w kanale informacyjnym, wyczyść pole wyboru nuget.org .

  5. Po zakończeniu wybierz przycisk OK .

    Zrzut ekranu przedstawiający sposób konfigurowania programu Visual Studio w systemie Windows.

3. Pobieranie pakietów

  1. W programie Visual Studio kliknij prawym przyciskiem myszy projekt, a następnie wybierz polecenie Zarządzaj pakietami NuGet.

  2. Wybierz pozycję Przeglądaj, a następnie wybierz źródło danych z menu rozwijanego Źródło pakietu.

    Zrzut ekranu przedstawiający sposób wybierania źródła kanału informacyjnego.

  3. Użyj paska wyszukiwania, aby wyszukać pakiety z kanału informacyjnego.

Uwaga

Wyszukiwanie pakietów w nadrzędnych strumieniach przy użyciu Eksploratora pakietów NuGet nie jest obsługiwane.

Publikowanie pakietów

Uruchom następujące polecenie, aby opublikować pakiet w kanale informacyjnym. Możesz użyć dowolnego ciągu dla argumentu ApiKey .

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