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 nie masz kanału informacyjnego, wykonaj następujące kroki, aby utworzyć nowy kanał informacyjny i upewnij się, że zaznaczono pole wyboru nadrzędne źródła, aby je włączyć. Jeśli masz już źródło danych, możesz przejść do następnego kroku , aby dodać galerię NuGet jako źródło nadrzędne.

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 .

   

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

Dodawanie źródła nadrzędnego galerii NuGet

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

Uwaga

Lokalizacja indeksu usługi dla nuget.org to https://api.nuget.org/v3/index.json.

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>
     

Instalowanie pakietów z galerii NuGet

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

Wyświetlanie zapisanych pakietów

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 źródło galerii NuGet z menu rozwijanego, aby filtrować pakiety z tego nadrzędnego źródła.

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

   

Powiązane artykuły

• Publikowanie pakietów NuGet za pomocą usługi Azure Pipelines
• Publikowanie pakietów w NuGet.org
• Zarządzanie uprawnieniami