Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Usługi Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022
Azure Artifacts umożliwia deweloperom publikowanie i pobieranie pakietów npm z źródeł danych lub publicznych rejestrów.
Ten artykuł przeprowadzi Cię przez proces tworzenia kanału informacyjnego, konfigurowania projektu oraz publikowania i pobierania pakietów npm.
Wymagania wstępne
- Organizacja usługi Azure DevOps.
- Projekt Azure DevOps.
- Pobierz i zainstaluj Node.js i narzędzie npm.
Tworzenie kanału informacyjnego
Zaloguj się do organizacji usługi Azure DevOps i przejdź do projektu.
Wybierz pozycję Artefakty, a następnie wybierz pozycję Utwórz kanał informacyjny.
Wprowadź nazwę kanału informacyjnego.
Wybierz ustawienie Widoczność, aby określić, kto może wyświetlać pakiety w źródle danych.
Wybierz pozycję Uwzględnij pakiety z typowych źródeł publicznych, jeśli źródło danych ma używać pakietów nadrzędnych ze źródeł, takich jak nuget.org lub npmjs.com.
W obszarze Zakres wybierz, czy kanał informacyjny ma zakres dla bieżącego projektu, czy całej organizacji.
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.
Wprowadź nazwę kanału informacyjnego.
Wybierz ustawienie Widoczność, aby określić, kto może wyświetlać pakiety w źródle danych.
Wybierz pozycję Uwzględnij pakiety z typowych źródeł publicznych, jeśli źródło danych ma używać pakietów nadrzędnych ze źródeł, takich jak nuget.org lub npmjs.com.
W obszarze Zakres wybierz, czy kanał informacyjny ma zakres dla bieżącego projektu, czy całej organizacji.
Po zakończeniu wybierz pozycję Utwórz .
Uwaga
Podczas tworzenia kanału konto projektu Build Service, takie jak projectName Build Service (orgName), jest domyślnie przypisywane do roli Feed and Upstream Reader (Collaborator).
Konfigurowanie uwierzytelniania npm
Zanim połączysz się z kanałem, skonfiguruj uwierzytelnianie klienta npm na swoim komputerze. Kroki różnią się w zależności od systemu operacyjnego:
Windows
Zainstaluj program vsts-npm-auth, który generuje i odświeża poświadczenia używane przez narzędzie npm w celu nawiązania połączenia z kanałem informacyjnym Azure Artifacts.
npm install -g vsts-npm-auth --registry https://registry.npmjs.com
macOS i Linux
vsts-npm-auth nie jest obsługiwany w systemie macOS lub Linux. Zamiast tego utwórz osobisty token dostępu (PAT) z uprawnieniami Pakiety>. Użyj tego tokenu pat podczas konfigurowania pliku npmrc na poziomie użytkownika w następnej sekcji.
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.
Korzystając z tej konfiguracji, możesz udostępnić konfigurację projektu zespołowi bez uwidaczniania poświadczeń w kontroli źródła. Aby uzyskać więcej informacji, zobacz Łączenie się z kanałem informacyjnym Azure Artifacts — npm.
Zaloguj się do organizacji usługi Azure DevOps, a następnie przejdź do projektu.
Wybierz pozycję Artifacts, wybierz źródło danych z menu rozwijanego, a następnie wybierz pozycję Connect to feed.
Wybierz npm w lewym panelu nawigacyjnym.
W obszarze Konfiguracja projektu wybierz Windows lub Inne jako system operacyjny, a następnie postępuj zgodnie z podanymi instrukcjami, aby zaktualizować pliki .npmrc na poziomie użytkownika i projektu.
Uwaga
Element vsts-npm-auth nie jest obsługiwany w usłudze Azure DevOps Server.
Zaloguj się do kolekcji usługi Azure DevOps, a następnie przejdź do projektu.
Wybierz pozycję Artifacts, wybierz źródło danych z menu rozwijanego, a następnie wybierz pozycję Connect to feed.
Wybierz npm w lewym panelu nawigacyjnym.
W obszarze Konfiguracja projektu wybierz Windows lub Inne jako system operacyjny, a następnie postępuj zgodnie z podanymi instrukcjami, aby zaktualizować pliki .npmrc na poziomie użytkownika i projektu.
Ważne
npm obsługuje tylko jedno ustawienie registry w pliku .npmrc. Jeśli potrzebujesz pakietów z wielu źródeł, użyj nadrzędnych źródeł lub zakresów zamiast dodawać wiele registry wpisów.
Publikowanie pakietów w kanale informacyjnym
Uwaga
Aby publikować pakiety do kanału, musisz być Publikatorem Kanału (Kontrybutorem) lub wyższym. Aby uzyskać więcej informacji, zobacz Zarządzanie uprawnieniami .
Przed opublikowaniem pakietów upewnij się, że uwierzytelnisz 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 instrukcjami w poniższej sekcji.
W katalogu projektu uruchom następujące polecenie, aby opublikować pakiet zdefiniowany w pliku
package.jsonw swoim kanale informacyjnym: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
Przed przywróceniem pakietów upewnij się, że uwierzytelnisz się za pomocą źródła danych i zaktualizuj pliki npmrc dla projektu. Jeśli jeszcze tego nie zrobiono, wykonaj kroki opisane w temacie Nawiązywanie połączenia z kanałem informacyjnym, a następnie kontynuuj.
W katalogu projektu uruchom następujące polecenie, aby przywrócić wszystkie pakiety wymienione w
package.jsonpliku:npm installAby zainstalować określony pakiet ze źródła danych i dodać go jako zależność w
package.jsonpliku, uruchom następujące polecenie:npm install --save <PACKAGE_NAME>