Szybki start: rozpoczynanie pracy z pakietami NuGet w usłudze Azure Artifacts

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Usługa Azure Artifacts umożliwia deweloperom publikowanie i pobieranie pakietów NuGet ze źródeł, takich jak źródła danych i rejestry publiczne. Za pomocą usługi Azure Artifacts można tworzyć kanały informacyjne, które są:

• Prywatne, dzięki czemu możesz udostępniać pakiety zespołowi i określonym użytkownikom.
• Publiczne, dzięki czemu można udostępniać pakiety otwarcie wszystkim osobom w Internecie.

W tym przewodniku Szybki start zawarto informacje na temat wykonywania następujących czynności:

• Utwórz nowy kanał informacyjny.
• Skonfiguruj projekt i połącz się ze źródłem danych.
• Publikowanie pakietów NuGet.
• Pobierz pakiety ze źródła danych.

Wymagania wstępne

• Utwórz organizację usługi Azure DevOps i projekt, jeśli jeszcze tego nie zrobiono.

• Zainstaluj najnowszą wersję pakietu NuGet.

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

Tworzenie 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 pozycję Utwórz kanał informacyjny.

3. W polu Nazwa wprowadź opisową nazwę kanału informacyjnego.

   W obszarze Widoczność wybierz opcję, aby wskazać, kto może wyświetlać pakiety w kanale informacyjnym.

   Jeśli chcesz dołączyć pakiety ze źródeł publicznych, zaznacz pole wyboru w obszarze Nadrzędne źródła.

   W polu Zakres określ, czy zakres źródła danych jest projektem, czy organizacją.

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

   

Uwaga

Domyślnie nowo utworzone kanały informacyjne mają wartość usługi kompilacji projektu ustawioną na Wartość Kanał informacyjny i Nadrzędny czytelnik (współpracownik).

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 źródło danych z menu rozwijanego.

3. Wybierz pozycję Połącz z kanałem informacyjnym, a następnie wybierz pozycję NuGet.exe w okienku po lewej stronie. Jeśli po raz pierwszy używasz usługi Azure Artifacts z Nuget.exe, upewnij się, że zainstalowano wszystkie wymagania wstępne.

   

4. Postępuj zgodnie z instrukcjami w sekcji Konfiguracja projektu, aby skonfigurować plik nuget.config i uwierzytelnić się za pomocą usługi Azure Artifacts.

   

Pobieranie pakietów

1. Pobieranie adresu URL źródła pakietu

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

2. Wybierz pozycję Artefakty, wybierz źródło danych z menu rozwijanego, a następnie wybierz pozycję Połącz z kanałem informacyjnym.

3. Wybierz pozycję Visual Studio w okienku po lewej stronie, a następnie skopiuj adres URL źródła .

   

2. Konfigurowanie programu Visual Studio

Windows

1. W programie Visual Studio wybierz pozycję Narzędzia>Opcje.

2. Rozwiń sekcję Menedżer pakietów NuGet, a następnie wybierz pozycję Źródła pakietów.

3. Wprowadź wartość nazwa źródła i adres URL źródła, a następnie wybierz zielony znak plus (+), aby dodać źródło.

4. Jeśli włączono źródła nadrzędne w kanale informacyjnym, wyczyść pole wyboru nuget.org .

5. Po zakończeniu wybierz przycisk OK .

   

macOS

1. Utwórz osobisty token dostępu.

2. W programie Visual Studio na pasku menu wybierz pozycję Preferencje.

3. Wybierz pozycję NuGet, a następnie wybierz pozycję Źródła.

4. Wybierz pozycję Dodaj i wprowadź nazwę źródła danych, adres URL źródła, nazwę użytkownika (dowolny ciąg) i osobisty token dostępu.

5. Wybierz przycisk OK , aby zapisać źródło.

6. Jeśli włączono źródła nadrzędne w kanale informacyjnym, wyczyść pole wyboru nuget.org .

7. Po zakończeniu wybierz przycisk OK .

   

3. Pobieranie pakietów

1. W programie Visual Studio kliknij prawym przyciskiem myszy projekt, a następnie wybierz polecenie Zarządzaj pakietami NuGet.

2. Wybierz pozycję Przeglądaj, a następnie wybierz źródło danych z menu rozwijanego Źródło pakietu.

   

3. Użyj paska wyszukiwania, aby wyszukać pakiety z kanału informacyjnego.

Uwaga

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

Publikowanie pakietów

Aby opublikować pakiet w kanale informacyjnym, uruchom następujące polecenie. Możesz wprowadzić dowolny ciąg dla argumentu ApiKey .

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

Przykłady:

• Źródło danych o 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 o zakresie 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

Jest ApiKey to wymagane, ale podczas publikowania w kanałach informacyjnych usługi Azure Artifacts można użyć dowolnej wartości.

Powiązana zawartość

• Publikowanie pakietów NuGet za pomocą usługi Azure Pipelines (YAML/classic)
• Publikowanie pakietów w NuGet.org
• Używanie pakietów z galerii NuGet