Udostępnij za pośrednictwem

Użyj źródeł nadrzędnych w publicznym kanale informacyjnym

  • Artykuł

Azure DevOps Services

Usługa Azure Artifacts umożliwia deweloperom zarządzanie zależnościami z jednego źródła danych. Korzystając z zewnętrznych źródeł, można pobierać pakiety z kanałów i powszechnie dostępnych rejestrów, takich jak NuGet.org i npmjs.com. Ten artykuł obejmuje następujące zagadnienia:

  • Tworzenie publicznego kanału informacyjnego
  • Włączanie źródeł nadrzędnych
  • Dodawanie nowego nadrzędnego źródła

Wymagania wstępne

Tworzenie publicznego kanału informacyjnego

Publiczne źródło danych to źródło danych o zakresie projektu w projekcie publicznym. Publiczne kanały dziedziczą ustawienia widoczności projektu, który je hostuje.

  1. Zaloguj się do organizacji usługi Azure DevOps, a następnie wybierz swój projekt publiczny.

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

    Zrzut ekranu przedstawiający przycisk tworzenia źródła danych w usłudze Azure Artifacts.

  3. Nadaj kanałowi nazwę , a następnie wybierz „Project: PublicProject (Zalecane)” dla jego zakresu.

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

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

Ważne

Publiczne kanały informacyjne nie obsługują transmisji strumieniowej do prywatnego kanału informacyjnego Artifacts. Jeśli używasz publicznego źródła usługi Azure Artifacts, możesz przesyłać dalej tylko do publicznych rejestrów (NuGet.org, npmjs) lub innych publicznych źródeł usługi Azure Artifacts.

Dodawanie nadrzędnego źródła

  1. Zaloguj się do organizacji usługi Azure DevOps, a następnie wybierz swój projekt publiczny.

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

  3. Wybierz ikonę koła zębatego, aby uzyskać dostęp do ustawień kanału.

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

    Zrzut ekranu przedstawiający sposób dodawania nadrzędnego źródła w publicznym kanale informacyjnym.

  5. Wybierz swój Typ źródła nadrzędnego. W tym przykładzie dodamy NuGet.org jako nadrzędne źródło.

    Zrzut ekranu przedstawiający różne typy nadrzędnych źródeł.

  6. Skonfiguruj źródło, a następnie wybierz pozycję Dodaj po zakończeniu.

    Zrzut ekranu przedstawiający sposób konfigurowania nadrzędnego źródła.

  7. Wybierz pozycję Zapisz , aby zapisać nowe nadrzędne źródło.

    Zrzut ekranu przedstawiający sposób zapisywania nowo dodanego nadrzędnego źródła.

Ważne

Pliki blokady pakietów są wymagane do zapisywania pakietów NuGet i Dotnet ze źródeł nadrzędnych w publicznym repozytorium.

Przywracanie pakietów

Uruchom następujące polecenie w katalogu projektu, aby przywrócić pakiety:

nuget.exe restore

Uwaga

Musisz być co najmniej Czytelnikiem kanału i strumienia (współpracownikiem) lub mieć wyższy poziom, aby instalować nowe wersje pakietów z ponadpoziomowego źródła. Użytkownicy anonimowi mogą instalować tylko pakiety, które istnieją w ich kanale informacyjnym.

Q&A

Próbuję przywrócić pakiety, ale otrzymuję błąd 401 Nieautoryzowany?

Zawartość kanału informacyjnego można zmienić tylko przez uwierzytelnioną i autoryzowaną tożsamość, która ma odpowiednie uprawnienia do kanału informacyjnego. Obejmuje to zapisywanie pakietów do repozytorium z źródła nadrzędnego. Użytkownicy nieuwierzytelnieni (anonimowi) mogą pobierać już zapisane w kanale pakiety, ale nie mogą zapisywać nowych pakietów z nadrzędnego źródła danych.

Osoby odpowiedzialne za projekt powinny zapisywać wszystkie potrzebne wersje pakietów w publicznym kanale informacyjnym. Można to zrobić, przywracając projekt przy użyciu tożsamości, która może podać poświadczenia do kanału informacyjnego po wyświetleniu monitu, i upewniając się, że użyta tożsamość ma uprawnienia Kanał informacyjny i Nadrzędny czytelnik (współpracownik) lub wyższe uprawnienia do publicznego kanału informacyjnego.

Jeśli użytkownicy anonimowi, którzy przywracają pakiety dla projektu, są wielokrotnie blokowani przez żądania dotyczące poświadczeń (odpowiedź 401), następujące podejścia spowodują zmniejszenie lub wyeliminowanie problemu:

  1. Unikaj używania zakresów wersji pakietu w konfiguracji projektu. Jawne wersje pakietów zapewnią, że klienci pakietów zażądają tylko dokładnej wymaganej wersji.

  2. Jeśli jest to obsługiwane, użyj plików blokady dla ekosystemu pakietów, aby klienci pakietów żądali tylko określonych wersji wymaganych dla projektu podczas operacji przywracania/instalowania.

.: Próbuję przywrócić pakiety przy użyciu programu Visual Studio, ale zauważam, że są one pobierane z innego źródła?

Upewnij się, że program Visual Studio używa źródła, do którego odwołuje się plik nuget.config, a nie lokalnego menedżera pakietów NuGet. Aby uzyskać więcej informacji, zobacz Źródła pakietów.

Możesz również użyć CLI NuGet, aby wymusić na NuGet korzystanie ze źródła w pliku konfiguracyjnym, uruchamiając następujące polecenie:

nuget restore -config <PATH_TO_NUGET_CONFIG_FILE>

Powiązana zawartość