Publikowanie pakietów npm za pomocą usługi Azure Pipelines (YAML/Classic)

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

Usługa Azure Pipelines umożliwia publikowanie pakietów npm w źródłach danych usługi Azure Artifacts i publicznych rejestrach, takich jak npmjs.com. Ten artykuł przeprowadzi Cię przez proces publikowania pakietów npm przy użyciu potoków YAML i klasycznych.

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.

• Źródło danych usługi Azure Artifacts. Utwórz je bezpłatnie.

Publikowanie w źródłach danych usługi Azure Artifacts

Uwaga

Aby opublikować pakiety w kanale informacyjnym przy użyciu usługi Azure Pipelines, upewnij się, że zarówno usługa Project Collection Build Service, jak i tożsamość usługi kompilacji projektu są skonfigurowane jako wydawca kanału informacyjnego (współautor). Aby uzyskać więcej informacji, zobacz Dodawanie nowych użytkowników/grup .

YAML

- task: Npm@1
  inputs:
    command: publish
    publishRegistry: useFeed
    publishFeed: <FEED_NAME>        ## For project-scoped feeds, use: <PROJECT_NAME>/<FEED_NAME> 

• publishRegistry: wybierz pozycję UseFeed , aby użyć kanału informacyjnego w organizacji. Opcje: useExternalRegistry, useFeed
• publishFeed: kanał informacyjny, do którego chcesz opublikować. Wymagane podczas publikowaniaRegistry = useFeed.

Napiwek

Podczas dodawania zadania npm do potoku YAML przy użyciu edytora YAML identyfikatory projektu i źródła danych zostaną publishFeed wygenerowane automatycznie.

Klasyczny

1. Przejdź do portalu usługi Azure DevOps, a następnie wybierz projekt.

2. Wybierz pozycję Potoki, a następnie wybierz definicję potoku.

3. Wybierz pozycję Edytuj, a następnie wybierz + znak, aby dodać nowe zadanie. Wyszukaj zadanie npm, a następnie wybierz pozycję Dodaj, aby dodać je do potoku.

   

4. Nazwij zadanie, a następnie wybierz pozycję Publikuj z menu rozwijanego poleceń. Określ ścieżkę package.json, lokalizację rejestru i rejestr docelowy.

   • Folder roboczy zawierający package.json: ścieżka do folderu zawierającego package.json docelowe i pliki npmrc. Pozostaw to pole puste, jeśli te pliki znajdują się w katalogu głównym repozytorium.
   • Lokalizacja rejestru: wybierz pozycję Rejestr wybieram tutaj , aby opublikować w kanale informacyjnym.
   • Rejestr docelowy: wybierz źródło danych z menu rozwijanego.

   

Publikowanie w rejestrze publicznym

Przed opublikowaniem pakietów w publicznym rejestrze npm, na przykład npmjs.com, należy najpierw utworzyć połączenie usługi w celu uwierzytelnienia przy użyciu żądanej usługi zewnętrznej.

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

2. Wybierz pozycje Ustawienia projektu>Połączenia usługi, a następnie wybierz opcję Utwórz połączenie usługi.

   

3. Wybierz pozycję npm , a następnie wybierz pozycję Dalej. Wypełnij wymagane pola, a następnie wybierz pozycję Zapisz po zakończeniu.

YAML

- task: Npm@1
  inputs:
    command: publish
    publishRegistry: useExternalRegistry
    publishEndpoint: '<NAME_OF_YOUR_SERVICE_CONNECTION>'

• publishRegistry: wybierz pozycję useExternalRegistry , aby opublikować w rejestrze publicznym. Opcje: useExternalRegistry | useFeed.
• publishEndpoint: zastąp symbol zastępczy nazwą utworzonego wcześniej połączenia usługi. wymagane podczas publikowaniaRegistry == useExternalRegistry.

Klasyczny

1. Przejdź do portalu usługi Azure DevOps, a następnie wybierz projekt.

2. Wybierz pozycję Potoki, a następnie wybierz definicję potoku.

3. Wybierz pozycję Edytuj, a następnie wybierz + znak, aby dodać nowe zadanie. Wyszukaj zadanie npm, a następnie wybierz pozycję Dodaj, aby dodać je do potoku.

   

4. Nazwij zadanie, a następnie wybierz pozycję Publikuj z menu rozwijanego poleceń. Określ ścieżkę package.json, lokalizację rejestru i rejestr zewnętrzny.

   • Folder roboczy zawierający package.json: ścieżka do folderu zawierającego package.json docelowe i pliki npmrc. Pozostaw to pole puste, jeśli te pliki znajdują się w katalogu głównym repozytorium.
   • Lokalizacja rejestru: wybierz pozycję Zewnętrzny rejestr npm, aby opublikować go w rejestrze publicznym, takim jak npmjs.com.
   • Rejestr zewnętrzny: wybierz utworzone wcześniej połączenie usługi.

   

Powiązane artykuły

• Publikowanie i przywracanie pakietów npm z wiersza polecenia.
• Użyj pakietów z npmjs.com.
• Publikowanie i pobieranie artefaktów potoku.