Połączenie do źródeł danych usługi Azure Artifacts (NuGet.exe)

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ł, w tym kanałów informacyjnych i publicznych rejestrów. Prywatne kanały informacyjne usługi Azure Artifacts umożliwiają udostępnianie pakietów prywatnie zespołowi lub określonym użytkownikom. Ponadto można tworzyć publiczne kanały informacyjne, aby udostępniać pakiety publicznie, umożliwiając ich otwarcie udostępnianie wszystkim osobom w Internecie. Ten artykuł przeprowadzi Cię przez proces nawiązywania połączenia z kanałem informacyjnym usługi Azure Artifacts.

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. Utwórz nowe źródło danych , jeśli jeszcze go nie masz.

• Zainstaluj najnowszą wersję pakietu NuGet.

• Zainstaluj dostawcę poświadczeń usługi Azure Artifacts.

Ustawienia projektu

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 z panelu po lewej stronie.

4. Jeśli po raz pierwszy używasz usługi Azure Artifacts z NuGet.exe, upewnij się, że zostały zainstalowane wymagania wstępne, w przeciwnym razie wybierz pozycję Pobierz narzędzia w prawym górnym rogu, aby je zainstalować.

5. Dodaj plik nuget.config do projektu, umieść go w tym samym folderze co plik csproj lub sln, a następnie wklej do niego podany fragment kodu. Fragment kodu powinien być ustrukturyzowany w następujący sposób:

   • Ź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>
     

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

Ważne

Dostawca poświadczeń usługi Azure Artifacts wymaga pakietu NuGet 4.8.0.5385 lub nowszego.

Aby uzyskać optymalną wydajność, usługa Azure Artifacts zaleca korzystanie z wersji 5.5.x NuGet lub nowszej, ponieważ zawiera kluczowe poprawki błędów związane z anulowaniem i przekroczeniami limitu czasu.

Konfiguracja starszego projektu

Jeśli używasz starszej wersji pakietu NuGet, postępuj zgodnie z poniższymi instrukcjami, aby nawiązać połączenie ze źródłem danych:

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 z panelu po lewej stronie.

4. Skopiuj źródłowy adres URL, a następnie zastąp ciąg /v3/index.json ./v2 Zaktualizowany adres URL źródła powinien wyglądać podobnie do następującego:

   • Źródło danych o zakresie projektu:

     https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v2
     

   • Kanał informacyjny o zakresie organizacji:

     https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v2
     

5. Utwórz osobisty token dostępu i upewnij się, że zakres jest powiązany z odpowiednią organizacją, do której chcesz uzyskać dostęp, i wybierz jeden z następujących zakresów: Pakowanie (odczyt), pakowanie (odczyt i zapis) lub pakowanie (odczyt, zapis i zarządzanie).

6. Uruchom następujące polecenie w oknie wiersza polecenia, aby dodać źródło źródła danych do pliku nuget.config :

   nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <ANY_STRING_BUT_NOT_NULL> -password <YOUR_PERSONAL_ACCESS_TOKEN>
   

7. Jeśli Twoja organizacja jest połączona z identyfikatorem Entra firmy Microsoft, musisz najpierw uwierzytelnić się przy użyciu poświadczeń usługi AD, a następnie dodać osobisty token dostępu przy użyciu polecenia setapikey :

   nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <AZURE_ACTIVE_DIRECTORY_USERNAME> -password <AZURE_ACTIVE_DIRECTORY_PASSWORD>
   
   nuget setapikey <YOUR_PERSONAL_ACCESS_TOKEN> -source <SOURCE_URL> 
   

Powiązane artykuły

• Publikowanie i przywracanie pakietów NuGet (NuGet.exe)
• Publikowanie pakietów NuGet za pomocą usługi Azure Pipelines
• Używanie pakietów z NuGet.org