Publikowanie i pobieranie pakietów NuGet za pomocą usługi Azure Artifacts

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

Usługa Azure Artifacts umożliwia deweloperom publikowanie i pobieranie pakietów NuGet z źródeł danych lub publicznych rejestrów. Kanały informacyjne mogą być prywatne, dzięki czemu można udostępniać pakiety określonym użytkownikom lub publicznie, dzięki czemu pakiety będą dostępne dla wszystkich użytkowników w Internecie.

Ten artykuł przeprowadzi Cię przez proces tworzenia kanału informacyjnego, konfigurowania projektu oraz publikowania i pobierania pakietów NuGet.

Wymagania wstępne

produkt	Wymagania
Azure DevOps	— Organizacja usługi Azure DevOps . — Projekt usługi Azure DevOps . — Pobierz i zainstaluj nuget.exe wersję lub nowszą 4.8.0.5385 . Zalecamy korzystanie z programu NuGet w wersji 5.5.x lub nowszej, która zawiera ważne poprawki błędów dotyczące anulowania i przekroczeń limitu czasu.

Konfigurowanie dostawcy poświadczeń Azure Artifacts

Dostawca poświadczeń Azure Artifacts umożliwia bezpieczne uwierzytelnianie do feedów Azure Artifacts. Aby używać go z nuget.exe, należy najpierw dodać go do ścieżki wyszukiwania wtyczki NuGet. Aby uzyskać szczegółowe informacje, zobacz Instalacja i odnajdywanie wtyczki. Po dodaniu wtyczki wykonaj kroki instalacji systemu operacyjnego:

Windows

Użyj jednej z następujących metod, aby zainstalować dostawcę poświadczeń Azure Artifacts:

Instalacja ręczna

1. Pobierz najnowszą wersję Microsoft.NetFx48.NuGet.CredentialProvider.zip.

2. Wyodrębnij plik zip.

3. Skopiuj folder netfx z wyodrębnionego archiwum do %UserProfile%/.nuget/plugins/. Folder netfx jest wymagany do zapewnienia zgodności z programem nuget.exe.

Instalowanie przy użyciu skryptu pomocnika

Alternatywnie można użyć skryptu zautomatyzowanego pomocnika do uproszczonej instalacji. Upewnij się, że masz program PowerShell 5.1 lub nowszy, a następnie uruchom polecenie:

iex "& { $(irm https://aka.ms/install-artifacts-credprovider.ps1) } -AddNetfx"

Aby uzyskać więcej informacji, zobacz repozytorium Azure Artifacts Credential Provider .

Linux/Mac

Upewnij się, że skonfigurowaliśmy Prerequisites a następnie użyj jednej z następujących metod, aby zainstalować dostawcę poświadczeń Azure Artifacts:

Instalacja ręczna

1. Pobierz najnowszą Microsoft. NetFx48.NuGet.CredentialProvider.tar.gz wydanie.

2. Wyodrębnij plik tar.

3. Skopiuj folder netfx z wyodrębnionego archiwum do $HOME/.nuget/plugins. Folder netfx obsługuje scenariusze MSBuild.

Instalowanie przy użyciu skryptu pomocnika

Skrypt pomocnika zapewnia zautomatyzowaną instalację wersji netcore. Jeśli potrzebujesz plików binarnych netcore i netfx w scenariuszach, takich jak mono MSBuild, użyj metody instalacji ręcznej powyżej.

1. Uruchom jedno z następujących poleceń:

   • Korzystanie z wget:

     wget -qO- https://aka.ms/install-artifacts-credprovider.sh | bash
     

   • Za pomocą narzędzia curl:

     sh -c "$(curl -fsSL https://aka.ms/install-artifacts-credprovider.sh)"
     

Aby uzyskać więcej informacji, zobacz repozytorium Azure Artifacts Credential Provider .

Tworzenie kanału informacyjnego

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ę dla kanału informacyjnego, wybierz opcję Widoczność definiującą, kto może wyświetlać pakiety, zaznacz Uwzględnij pakiety z typowych źródeł publicznych, jeśli chcesz uwzględnić pakiety ze źródeł, takich jak nuget.org lub npmjs.com, a dla Zakresuzdecyduj, czy kanał informacyjny powinien być ograniczony do projektu, czy całej organizacji.

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

   

Uwaga

Domyślnie usługa kompilacji dla projektu (na przykład: projectName Build Service (orgName)) ma przypisaną rolę Kanał informacyjny i Nadrzędny czytelnik (współpracownik) podczas tworzenia nowego źródła danych.

Nawiązywanie połączenia z kanałem informacyjnym

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

2. Wybierz pozycję Artefakty, a następnie wybierz 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. Jeśli po raz pierwszy używasz usługi Azure Artifacts z Nuget.exe, upewnij się, że zainstalowano wymagania wstępne.

4. Postępuj zgodnie z podanymi instrukcjami w sekcji Konfiguracja projektu , aby skonfigurować plik nuget.config i nawiązać połączenie ze źródłem danych usługi Azure Artifacts.

   

Publikowanie pakietów w kanale informacyjnym

Uwaga

Aby publikować pakiety do kanału, musisz być Publikatorem Kanału (Kontrybutorem) lub wyższym. Aby uzyskać więcej informacji, zobacz Zarządzanie uprawnieniami .

Aby opublikować pakiet w kanale informacyjnym, uruchom następujące polecenie. Parametr ApiKey jest wymagany, ale można użyć dowolnego ciągu jako jego wartości.

nuget.exe push -Source <SOURCE_NAME> -ApiKey key <PACKAGE_PATH>

Przykłady

• Kanał informacyjny w zakresie projektu:

  nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/MyProject/_packaging/MyFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
  

• Kanał informacyjny dedykowany organizacji:

  nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/_packaging/myFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
  

Uwaga

ApiKey jest wymagany, ale przy publikowaniu do kanałów Azure Artifacts można użyć dowolnej wartości.

Pobieranie pakietów ze źródła danych

Aby przywrócić pakiety ze źródła danych, uruchom następujące polecenie w katalogu projektu:

nuget.exe restore

Uwaga

Wyszukiwanie pakietów w źródłach nadrzędnych przy użyciu Eksploratora pakietów NuGet nie jest obsługiwane.

Powiązana zawartość

• Publikowanie pakietów NuGet za pomocą usługi Azure Pipelines (YAML/classic)

• Publikowanie pakietów w NuGet.org

• Korzystanie z pakietów z galerii NuGet