Udostępnij za pośrednictwem


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

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:

  • Utwórz nowy kanał informacyjny.
  • Skonfiguruj projekt i połącz się ze źródłem danych.
  • Publikowanie pakietów NuGet.
  • Pobierz pakiety 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

  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 nowego źródła danych w usłudze 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 ź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).

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

    Zrzut ekranu przedstawiający sposób tworzenia nowego źródła danych w usłudze Azure DevOps 2022.

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

    Zrzut ekranu przedstawiający sposób tworzenia nowego źródła danych w usłudze Azure DevOps 2020.

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

  2. Wybierz pozycję Artefakty, a następnie wybierz pozycję 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). Jeśli chcesz dołączyć pakiety ze źródeł publicznych, wybierz opcję Użyj pakietów ze źródeł publicznych za pośrednictwem tego kanału informacyjnego .

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

    Zrzut ekranu przedstawiający sposób tworzenia nowego źródła danych w usłudze Azure DevOps 2019.

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, 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 wszystkie wymagania wstępne.

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

  4. Postępuj zgodnie z instrukcjami podanymi w sekcji Konfiguracja projektu, aby skonfigurować plik nuget.config i uwierzytelnić się za pomocą usługi Azure Artifacts.

    Zrzut ekranu przedstawiający sposób konfigurowania projektu.

  1. Zaloguj się do serwera 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ę NuGet.exe po lewej stronie.

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

    Zrzut ekranu przedstawiający sposób konfigurowania projektu NuGet w systemach Server 2020 i Server 2022.

  1. Zaloguj się do serwera 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ę NuGet po lewej stronie.

  4. Postępuj zgodnie z instrukcjami, aby dodać adres URL źródła pakietu do pliku nuget.config.

    Zrzut ekranu przedstawiający sposób konfigurowania projektu NuGet w programie Server 2019.

Pobieranie pakietów

1. Pobieranie adresu URL źródła pakietu

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

  2. Wybierz pozycję Artefakty, wybierz źródło danych z menu rozwijanego, a następnie wybierz pozycję Połączenie do kanału informacyjnego.

  3. Wybierz pozycję NuGet po lewej stronie, a następnie skopiuj adres URL źródła pakietu.

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

  2. Wybierz pozycję Artefakty, wybierz źródło danych z menu rozwijanego, a następnie wybierz pozycję Połączenie do kanału informacyjnego.

  3. Wybierz pozycję Visual Studio z panelu nawigacji po lewej stronie, a następnie 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 pakietu w programie Visual Studio.

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

Uwaga

Wyszukiwanie pakietów w nadrzędnych źródłach 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 wprowadzić dowolny ciąg dla argumentu ApiKey .

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