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
Organizacja: Azure DevOps. Utwórz je bezpłatnie.
Projekt usługi Azure DevOps. Utwórz nowy projekt , jeśli jeszcze go nie masz.
Tworzenie kanału informacyjnego
Zaloguj się do organizacji usługi Azure DevOps, a następnie przejdź do projektu.
Wybierz pozycję Artefakty, a następnie wybierz pozycję Utwórz kanał informacyjny.
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ą.
Po zakończeniu wybierz pozycję Utwórz .
Zaloguj się do serwera usługi Azure DevOps, a następnie przejdź do projektu.
Wybierz pozycję Artefakty, a następnie wybierz pozycję Utwórz kanał informacyjny.
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ą.
Po zakończeniu wybierz pozycję Utwórz .
Po zakończeniu wybierz pozycję Utwórz .
Zaloguj się do serwera usługi Azure DevOps, a następnie przejdź do projektu.
Wybierz pozycję Artefakty, a następnie wybierz pozycję Nowe źródło danych.
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, wybierz opcję Użyj pakietów ze źródeł publicznych za pośrednictwem tego kanału informacyjnego .
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
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 .
Zaloguj się do organizacji usługi Azure DevOps, a następnie przejdź do projektu.
Wybierz pozycję Artefakty, a następnie wybierz pozycję Połącz z kanałem informacyjnym.
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.
Postępuj zgodnie z instrukcjami w sekcji Konfiguracja projektu, aby skonfigurować plik konfiguracji i nawiązać połączenie ze źródłem danych.
Zaloguj się do kolekcji usługi Azure DevOps, a następnie przejdź do projektu.
Wybierz pozycję Artefakty, a następnie wybierz pozycję Połącz z kanałem informacyjnym.
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.
Zaloguj się do kolekcji usługi Azure DevOps, a następnie przejdź do projektu.
Wybierz pozycję Artefakty, a następnie wybierz pozycję Połącz z kanałem informacyjnym.
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.
Zaloguj się do kolekcji usługi Azure DevOps, a następnie przejdź do projektu.
Wybierz pozycję Artefakty, a następnie wybierz pozycję Połącz z kanałem informacyjnym.
Zostanie otwarte nowe okno. W okienku nawigacji po lewej stronie wybierz pozycję npm i postępuj zgodnie z instrukcjami, aby skonfigurować projekt i pliki npmrc użytkownika.
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>