Udostępnij za pośrednictwem

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

  • Artykuł

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 swoim kanałem.
  • Publikowanie pakietów NuGet.
  • Pobierz pakiety z kanału.

Wymagania wstępne

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 .

    Zrzut ekranu przedstawiający opcje tworzenia nowego kanału informacyjnego w usługach Azure DevOps Services.

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

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

  3. Podaj Nazwa dla swojego kanału, wybierz Widoczność, co zdefiniuje, kto może wyświetlać Twoje pakiety, zaznacz opcję Uwzględnij pakiety z powszechnych źródeł publicznych, jeśli chcesz uwzględnić pakiety ze źródeł, takich jak nuget.org lub npmjs.com, a dla Zakreszdecyduj, czy kanał powinien być przypisany do Twojego projektu, czy całej organizacji.

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

    Zrzut ekranu przedstawiający opcje tworzenia nowego kanału informacyjnego w usłudze Azure DevOps 2022.

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

    Zrzut ekranu przedstawiający opcje tworzenia nowego kanału informacyjnego w usłudze Azure DevOps 2020.

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

  2. Wybierz pozycję Artefakty, a następnie wybierz Nowy kanał.

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

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

    Jeśli chcesz dołączyć pakiety ze źródeł publicznych, wybierz opcję Użyj pakietów ze źródeł publicznych za pośrednictwem tego kanału informacyjnego .

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

    Zrzut ekranu przedstawiający opcje tworzenia nowego źródła danych w usłudze Azure DevOps 2019.

Uwaga

Domyślnie nowo utworzone kanały informacyjne mają ustawioną wartość Usługi kompilacji projektu na Kanał informacyjny i Czytelnik strumieni (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 kanał 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.

    Zrzut ekranu przedstawiający przycisk łączenia się z kanałem informacyjnym.

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

    Zrzut ekranu przedstawiający instrukcje dotyczące konfigurowania projektu na ekranie.

  1. Zaloguj się do serwera 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 po lewej stronie.

  4. Postępuj zgodnie z instrukcjami w sekcji Konfiguracja projektu, aby nawiązać połączenie ze źródłem danych.

    Zrzut ekranu przedstawiający instrukcje na ekranie dotyczące konfigurowania projektu NuGet w usługach Azure DevOps Server 2020 i 2022.

  1. Zaloguj się do serwera 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 w okienku po lewej stronie.

  4. Postępuj zgodnie z instrukcjami, aby dodać adres URL źródła pakietu do pliku nuget.config.

    Zrzut ekranu przedstawiający instrukcje na ekranie dotyczące konfigurowania projektu NuGet w usłudze Azure DevOps Server 2019.

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 swój kanał informacyjny z menu rozwijanego, a następnie wybierz pozycję Połącz z kanałem informacyjnym.

  3. Wybierz pozycję NuGet z lewego panelu nawigacyjnego, a następnie skopiuj adres URL źródła pakietu.

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

  2. Wybierz Artefakty, wybierz swój kanał z menu rozwijanego, a następnie wybierz Połącz z kanałem.

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

    Zrzut ekranu przedstawiający sposób znajdowania źródłowego adresu URL kanału informacyjnego.

2. Konfigurowanie programu Visual Studio

  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 oraz 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 swoim kanale, odznacz pole wyboru nuget.org.

  5. Po zakończeniu wybierz przycisk OK .

    Zrzut ekranu przedstawiający opcje konfigurowania programu Visual Studio w systemie Windows.

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 Przeglądaj, a następnie z menu rozwijanego Źródło pakietu wybierz swój kanał.

    Zrzut ekranu przedstawiający wybór źródła pakietu w programie Visual Studio.

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

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 repozytorium, 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 w obrębie 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.

Powiązana zawartość