Udostępnij za pośrednictwem


Używanie pakietów z galerii NuGet

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

Dzięki źródłom nadrzędnym usługi Azure Artifacts deweloperzy mogą korzystać z pakietów z publicznych rejestrów, takich jak nuget.org i npmjs.com. Ten artykuł przeprowadzi Cię przez proces konfigurowania projektu i korzystania z wiersza polecenia w celu efektywnego korzystania z pakietów NuGet z galerii NuGet. Ten artykuł obejmuje następujące zagadnienia:

  • Włączanie źródeł nadrzędnych dla kanału informacyjnego
  • Dodawanie galerii NuGet jako nadrzędnego źródła
  • Połączenie do kanału informacyjnego
  • Instalowanie pakietów z nuget.org

Wymagania wstępne

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

  • Źródło danych usługi Azure Artifacts.

  • Pobierz pakiet NuGet.

  • Pobierz i zainstaluj dostawcę poświadczeń usługi Azure Artifacts.

Włączanie źródeł nadrzędnych w kanale informacyjnym

Jeśli kanał informacyjny nie został jeszcze utworzony, wykonaj poniższe kroki, aby utworzyć nowy kanał i upewnij się, że zaznaczono pole wyboru nadrzędne źródła, aby je włączyć. Jeśli masz już źródło danych, przejdź do następnego kroku , aby dodać galerię NuGet jako nadrzędne źródło.

  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).

Jeśli podczas tworzenia kanału informacyjnego zaznaczono pole wyboru nadrzędne źródła, galeria NuGet powinna zostać dodana automatycznie. Jeśli nie, dodaj ją ręcznie, wykonując następujące kroki:

  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.

  3. Wybierz przycisk ikona koła zębatego ikony koła zębatego, aby przejść do ustawień kanału informacyjnego.

  4. Wybierz pozycję Nadrzędne źródła, a następnie wybierz pozycję Dodaj nadrzędny, aby dodać nowe nadrzędne źródło.

  5. Wybierz pozycję Źródło publiczne, a następnie z menu rozwijanego wybierz pozycję Galeria NuGet.

  6. Wybierz pozycję Zapisz po zakończeniu, a następnie wybierz pozycję Zapisz jeszcze raz w prawym górnym rogu, aby zapisać zmiany.

  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.

  3. Wybierz przycisk ikona koła zębatego ikony koła zębatego, aby przejść do ustawień kanału informacyjnego.

  4. Wybierz pozycję Nadrzędne źródła, a następnie wybierz pozycję Dodaj nadrzędną.

  5. Wybierz pozycję Źródło publiczne, a następnie z menu rozwijanego wybierz pozycję Galeria NuGet.

  6. Wybierz pozycję Zapisz po zakończeniu, a następnie wybierz pozycję Zapisz jeszcze raz w prawym górnym rogu, aby zapisać zmiany.

  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.

  3. Wybierz przycisk ikona koła zębatego ikony koła zębatego, aby przejść do ustawień kanału informacyjnego.

  4. Wybierz pozycję Nadrzędne źródła, a następnie wybierz pozycję Dodaj nadrzędne źródło.

  5. Wybierz pozycję Źródło publiczne, a następnie z menu rozwijanego wybierz pozycję Galeria NuGet.

  6. Po zakończeniu wybierz pozycję Dodaj .

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.

  3. Wybierz pozycję Połączenie do kanału informacyjnego, a następnie wybierz pozycję NuGet.exe.

  4. Dodaj plik nuget.config w tym samym folderze co plik csproj lub .sln. Wklej podany fragment kodu XML do pliku. Jeśli używasz poniższych przykładów, pamiętaj, aby zastąpić symbole zastępcze odpowiednimi wartościami dla danego scenariusza.

    • Kanał informacyjny o zakresie organizacji:

      <?xml version="1.0" encoding="utf-8"?>
      <configuration>
        <packageSources>
          <clear />
          <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
        </packageSources>
      </configuration>
      
    • Źródło danych o zakresie projektu:

      <?xml version="1.0" encoding="utf-8"?>
      <configuration>
        <packageSources>
          <clear />
          <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
        </packageSources>
      </configuration>
      
  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.

  3. Wybierz pozycję Połączenie do kanału informacyjnego, a następnie wybierz pozycję NuGet.exe 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. 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.

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

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

Po skonfigurowaniu projektu do uwierzytelniania za pomocą naszego kanału informacyjnego możemy teraz kontynuować instalowanie pakietów z nadrzędnej galerii NuGet. W tym przykładzie zainstalujemy bibliotekę rejestrowania diagnostycznego Serilog :

  1. Przejdź do galerii NuGet pod adresem https://www.nuget.org/.

  2. Wyszukaj pakiet Serilog, a następnie wybierz go, aby przejść do strony szczegółów.

  3. Wybierz kartę Menedżer pakietów i skopiuj polecenie . W naszym przykładzie polecenie jest następujące:

    NuGet\Install-Package Serilog -Version 3.1.2-dev-02097
    
  4. Otwórz projekt w programie Visual Studio, a następnie wybierz pozycję Narzędzia NuGet>Menedżer pakietów> Menedżer pakietów Konsola, aby otworzyć okno konsoli.

  5. Wklej polecenie w oknie konsoli Menedżer pakietów i naciśnij klawisz Enter, aby zainstalować pakiet.

Uwaga

Aby zapisać pakiety z nadrzędnych strumieni, musisz mieć rolę Kanał informacyjny i Nadrzędny czytelnik (współpracownik) lub wyższy. Aby uzyskać więcej informacji, zobacz Zarządzanie uprawnieniami .

Wyświetlanie zapisanych pakietów

  1. Zaloguj się do organizacji usługi Azure DevOps, a następnie przejdź do projektu.
  1. Zaloguj się do serwera usługi Azure DevOps, a następnie przejdź do projektu.
  1. Wybierz pozycję Artefakty, a następnie wybierz źródło danych z menu rozwijanego.

  2. Wybierz źródło galerii NuGet z menu rozwijanego, aby filtrować pakiety z tego nadrzędnego źródła.

  3. Pakiet Serilog zainstalowany w poprzednim kroku jest teraz dostępny w naszym kanale informacyjnym. Usługa Azure Artifacts automatycznie zapisała kopię do naszego kanału informacyjnego po wykonaniu polecenia instalacji.

    Zrzut ekranu przedstawiający pakiet zapisany z nadrzędnego strumienia.