Udostępnij za pośrednictwem


Wprowadzenie do pakietów npm w usłudze Azure Artifacts

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

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

Wymagania wstępne

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 źródło danych , aby utworzyć nowe źródło danych.

  3. Wprowadź opisową nazwę źródła danych i zdefiniuj jego widoczność (wskazującą, kto może wyświetlać pakiety w kanale informacyjnym). Określ zakres źródła danych, a jeśli chcesz uwzględnić pakiety ze źródeł publicznych, zaznacz pole wyboru Upstream sources (Źródła nadrzędne).

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

    Zrzut ekranu przedstawiający sposób tworzenia nowego źródła danych w usłudze 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 źródło danych , aby utworzyć nowe źródło danych.

  3. Wprowadź opisową nazwę źródła danych i zdefiniuj jego widoczność (wskazującą, kto może wyświetlać pakiety w kanale informacyjnym). Określ zakres źródła danych, a jeśli chcesz uwzględnić pakiety ze źródeł publicznych, zaznacz pole wyboru Upstream sources (Źródła nadrzędne).

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

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

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

    Zrzut ekranu przedstawiający sposób tworzenia nowego źródła danych 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 pozycję Nowe źródło danych.

  3. Wprowadź opisową nazwę źródła danych i zdefiniuj jego widoczność (wskazującą, kto może wyświetlać pakiety w kanale informacyjnym). 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 sposób tworzenia nowego źródła danych w usłudze Azure DevOps 2019.

Uwaga

Domyślnie nowo utworzone kanały informacyjne mają ustawioną usługę kompilacji projektu na Źródło danych i Czytelnik nadrzędny (współpracownicy).

Połączenie do kanału informacyjnego

Uwaga

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

Usługa Azure Artifacts zaleca używanie dwóch plików npmrc. Pierwszy należy umieścić w katalogu $home (Linux/macOS) lub $env. STRONA GŁÓWNA (Windows) do bezpiecznego przechowywania poświadczeń. Dzięki temu klient npm może zlokalizować plik i pobrać poświadczenia na potrzeby uwierzytelniania, umożliwiając udostępnianie pliku konfiguracji bez ujawniania poświadczeń. W tej sekcji skonfigurujemy drugi plik npmrc , który powinien zostać umieszczony w tym samym katalogu co plik package.json .

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

  2. Wybierz pozycję Artefakty, a następnie wybierz pozycję Połączenie do kanału informacyjnego.

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

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

    Zrzut ekranu przedstawiający sposób konfigurowania projektu npm i nawiązywania połączenia ze źródłem danych usługi Azure Artifacts w usłudze Azure DevOps Services.

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

  2. Wybierz pozycję Artefakty, a następnie wybierz pozycję Połączenie do kanału informacyjnego.

  3. Wybierz pozycję npm po lewej stronie, a następnie postępuj zgodnie z instrukcjami w sekcji Konfiguracja projektu, aby nawiązać połączenie ze źródłem danych.

    Zrzut ekranu przedstawiający sposób konfigurowania projektu npm i nawiązywania połączenia ze źródłem danych usługi Azure Artifacts w usłudze Azure DevOps Server 2022.

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

  2. Wybierz pozycję Artefakty, a następnie wybierz pozycję Połączenie do kanału informacyjnego.

  3. Wybierz pozycję npm po lewej stronie, a następnie postępuj zgodnie z instrukcjami w temacie Konfiguracja programu Project, aby skonfigurować plik konfiguracji i nawiązać połączenie z kanałem informacyjnym.

    Zrzut ekranu przedstawiający sposób konfigurowania projektu npm i nawiązywania połączenia ze źródłem danych usługi Azure Artifacts w usłudze Azure DevOps Server 2020.

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

  2. Wybierz pozycję Artefakty, a następnie wybierz pozycję Połączenie do kanału informacyjnego.

  3. Zostanie otwarte nowe okno. W okienku nawigacji po lewej stronie wybierz pozycję npm i postępuj zgodnie z instrukcjami, aby skonfigurować pliki project i user.npmrc.

    Zrzut ekranu przedstawiający sposób konfigurowania projektu npm i nawiązywania połączenia ze źródłem danych usługi Azure Artifacts w usłudze Azure DevOps Server 2019.

Ważne

Narzędzie npm obsługuje pojedynczy element registry w pliku npmrc. Istnieje wiele rejestrów z zakresami i źródłami nadrzędnymi.

Publikowanie pakietów

Uruchom następujące polecenie w katalogu projektu, aby opublikować pakiety npm:

npm publish

Ważne

publishConfig Użycie właściwości w celu zastąpienia parametru konfiguracji rejestru w czasie publikowania nie jest obsługiwane.

Przywracanie pakietów

Uruchom następujące polecenie w katalogu projektu, aby przywrócić pakiety npm:

npm install

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

npm install --save <PACKAGE_NAME>