Udostępnij przez


Używanie pakietów z galerii NuGet

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

Źródła nadrzędne usługi Azure Artifacts ułatwiają deweloperom ściąganie pakietów z publicznych rejestrów, takich jak nuget.org i npmjs.com. Z tego artykułu dowiesz się, jak skonfigurować projekt i używać wiersza polecenia do korzystania z pakietów NuGet z galerii NuGet.

Wymagania wstępne

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

Tworzenie źródła danych i włączanie źródeł nadrzędnych

Jeśli jeszcze nie utworzono kanału informacyjnego, wykonaj poniższe kroki, aby utworzyć nowe źródło danych i włączyć źródła nadrzędne. 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 i przejdź do projektu.

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

  3. Podaj nazwę kanału informacyjnego, wybierz opcję Widoczność , aby zdefiniować, kto może wyświetlać pakiety, i wybrać zakres. Usługa Azure Artifacts zaleca określanie zakresu źródeł danych do projektu, a nie całej organizacji.

  4. Upewnij się, że opcja Uwzględnij pakiety z typowych źródeł publicznych jest potrzebna do korzystania z pakietów z rejestrów publicznych, takich jak nuget.org, npmjs.com itp.

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

    Zrzut ekranu przedstawiający sposób tworzenia nowego źródła danych i włączania nadrzędnych źródeł w usłudze Azure Artifacts.

Jeśli pole wyboru Źródła nadrzędne zostało zaznaczone podczas tworzenia źródła danych (jak pokazano w poprzedniej sekcji), galeria NuGet powinna zostać automatycznie dodana do nadrzędnych źródeł kanału informacyjnego. Jeśli pracujesz z innym kanałem informacyjnym lub nie pamiętasz, aby sprawdzić tę opcję, możesz ręcznie dodać galerię NuGet, wykonując następujące kroki:

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

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

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

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

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

  3. Wybierz pozycję Zapisz w prawym górnym rogu, a następnie ponownie wybierz pozycję Zapisz , aby potwierdzić i zastosować zmiany.

Połącz się ze swoim kanałem

W tej sekcji dowiesz się, jak skonfigurować projekt w celu uwierzytelniania przy użyciu źródła danych usługi Azure Artifacts i zapisywania pakietów ze źródeł nadrzędnych, takich jak galeria NuGet.

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

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

  3. Wybierz pozycję Połącz z kanałem informacyjnym, a następnie wybierz pozycję NuGet.exe.

  4. Upewnij się, że zainstalowano wymagania wstępne, a następnie dodaj plik nuget.config w tym samym folderze co plik csproj lub .sln .

  5. Wklej fragment kodu XML podany w sekcji Konfiguracja projektu do pliku. Plik powinien wyglądać podobnie do następującego:

    • Ź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>
      
    • Ogólnofirmowy kanał informacyjny

      <?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>
      
  1. Zaloguj się do kolekcji usługi Azure DevOps, a następnie przejdź do projektu.

  2. Wybierz pozycję Artefakty, a następnie wybierz swój 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 instrukcjami w sekcji Konfiguracja projektu, aby nawiązać połączenie ze źródłem danych.

Teraz, gdy projekt jest skonfigurowany do uwierzytelniania przy użyciu źródła danych usługi Azure Artifacts, możesz kontynuować instalowanie pakietów z galerii NuGet nadrzędnej. W tym przykładzie zainstalujesz zestaw MCP C# SDK dla protokołu kontekstowego modelu dla aplikacji platformy .NET w celu interakcji z klientami i serwerami MCP:

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

  2. Wyszukaj kolumnę ModelContextProtocol, a następnie wybierz ją, aby otworzyć stronę szczegółów.

  3. Wybierz kartę interfejsu wiersza polecenia platformy .NET i skopiuj polecenie . W tym przykładzie polecenie to:

    dotnet add package ModelContextProtocol --version 0.3.0-preview.4
    
  4. Otwórz okno wiersza polecenia, przejdź do katalogu projektu, a następnie wklej polecenie i naciśnij Enter , aby zainstalować pakiet.

Po zainstalowaniu kopia pakietu zostanie automatycznie zapisana w kanale informacyjnym, zapewniając dostępność, jeśli galeria NuGet nie działa i chroni przepływ pracy przed innymi uszkodzonymi lub złośliwymi pakietami z rejestru publicznego.

Uwaga

Aby zapisać pakiety z repozytoriów nadrzędnych, musisz mieć rolę Czytelnik kanału i źródeł zewnętrznych (współpracownik) lub wyższą. Aby uzyskać więcej informacji, zobacz Role i uprawnienia kanału informacyjnego .

Wyświetlanie zapisanych pakietów

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

  2. Wybierz Artefakty, a następnie wybierz swój kanał informacyjny z menu rozwijanego.

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

  4. Pakiety ModelContextProtocol zainstalowane w poprzednim kroku są teraz dostępne w naszym kanale informacyjnym. Usługa Azure Artifacts automatycznie zapisała kopię do kanału informacyjnego.

    Zrzut ekranu przedstawiający pakiet MCP zapisany w kanale informacyjnym.