Udostępnij przez

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

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

Za pomocą usługi Azure Artifacts można publikować i pobierać pakiety npm zarówno z własnych źródeł danych, jak i rejestrów publicznych, takich jak npmjs.com. Ten przewodnik Szybki start przeprowadzi Cię przez proces tworzenia kanału informacyjnego, konfigurowania projektu i zarządzania pakietami npm przy użyciu usługi Azure Artifacts.

Wymagania wstępne

produkt Wymagania
Azure DevOps — Organizacja usługi Azure DevOps .
— Projekt usługi Azure DevOps .
- Pobierz i zainstaluj Node.js i narzędzie npm.

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

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

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

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

Usługa Azure Artifacts zaleca używanie dwóch oddzielnych plików konfiguracji. Pierwszy powinien być przechowywany lokalnie w katalogu $HOME (Linux/macOS) lub $env. STRONA GŁÓWNA (Windows) do bezpiecznego przechowywania poświadczeń. Dzięki temu klient npm może uzyskać dostęp do poświadczeń na potrzeby uwierzytelniania.

W tej sekcji skonfigurujesz drugi plik npmrc , który powinien zostać umieszczony w tym samym katalogu co plik package.json .

Ta konfiguracja umożliwia udostępnianie pliku konfiguracji bez uwidaczniania poświadczeń.

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

  2. Wybierz pozycję Artifacts, wybierz źródło danych z menu rozwijanego, a następnie wybierz pozycję Connect to feed.

  3. W okienku nawigacji po lewej stronie wybierz pozycję npm. Jeśli po raz pierwszy używasz usługi Azure Artifacts z narzędziem npm, upewnij się, że zainstalowano wymagania wstępne.

  4. W sekcji Konfiguracja projektu wybierz pozycję Windows lub Inne w zależności od systemu operacyjnego, a następnie postępuj zgodnie z podanymi instrukcjami, aby skonfigurować plik konfiguracji i nawiązać połączenie ze źródłem danych usługi Azure Artifacts.

    Zrzut ekranu przedstawiający sposób konfigurowania projektu npm i nawiązywania połączenia z kanałem informacyjnym w usługach Azure DevOps Services.

Uwaga

Element vsts-npm-auth nie jest obsługiwany w usłudze Azure DevOps Server.

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

  2. Wybierz pozycję Artifacts, wybierz źródło danych z menu rozwijanego, a następnie wybierz pozycję Connect to feed.

  3. W okienku nawigacji po lewej stronie wybierz pozycję npm. Jeśli po raz pierwszy używasz usługi Azure Artifacts z narzędziem npm, upewnij się, że zainstalowano wymagania wstępne.

  4. W sekcji Konfiguracja projektu wybierz pozycję Windows lub Inne w zależności od systemu operacyjnego, a następnie postępuj zgodnie z podanymi instrukcjami, aby skonfigurować plik konfiguracji i nawiązać połączenie ze źródłem danych usługi Azure Artifacts.

    Zrzut ekranu przedstawiający sposób konfigurowania projektu npm i nawiązywania połączenia z kanałem informacyjnym usługi Azure Artifacts w usłudze Azure DevOps Server 2022.

Ważne

npm wspiera tylko jedno registry ustawienie w pliku npmrc. Aby używać wielu rejestrów, należy użyć nadrzędnych źródeł lub zakresów.

Publikowanie pakietów w kanale informacyjnym

Aby pomyślnie uruchomić polecenie publikowania, musisz najpierw uwierzytelnić się przy użyciu kanału informacyjnego. Jeśli jeszcze tego nie zrobiono, wykonaj kroki opisane w sekcji Łączenie z kanałem informacyjnym , a następnie postępuj zgodnie z poniższymi instrukcjami.

  • W katalogu projektu uruchom następujące polecenie, aby opublikować pakiet npm zdefiniowany w package.json:

    npm publish

Ważne

Użycie właściwości publishConfig do zastąpienia konfiguracji rejestru w momencie publikacji nie jest obsługiwane.

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

Aby pomyślnie uruchomić polecenie przywracania, musisz najpierw uwierzytelnić się za pomocą swojego źródła. Jeśli jeszcze tego nie zrobiono, wykonaj kroki opisane w sekcji Łączenie z kanałem informacyjnym , a następnie postępuj zgodnie z poniższymi instrukcjami.

  1. W katalogu projektu uruchom następujące polecenie, aby przywrócić wszystkie pakiety npm:

    npm install

  2. Aby przywrócić określony pakiet npm, uruchom następujące polecenie z katalogu projektu:

    npm install --save <PACKAGE_NAME>

Treści powiązane

  • Last updated on