Veröffentlichen von npm-Paketen (YAML/Classic)

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

Mithilfe von Azure Pipelines können Sie Ihre npm-Pakete in Azure Artifacts-Feeds oder öffentlichen Registrierungen wie npmjs.com veröffentlichen. In diesem Artikel erfahren Sie, wie Sie Ihre npm-Pakete mithilfe von YAML und klassischen Pipelines veröffentlichen.

Veröffentlichen in Azure Artifacts-Feeds

YAML

Hinweis

Der Builddienst für Projektsammlung und der Builddienst Ihrer Projektidentität müssen auf Feedherausgeber (Mitwirkender) gesetzt erden, damit Sie Ihre Pakete in einem Feed mit Azure Pipelines veröffentlichen können. Weitere Informationen finden Sie unter Hinzufügen neuer Benutzer/Gruppen.

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

• publishRegistry: Optionen: useExternalRegistry, useFeed. Wählen Sie „useFeed“ aus, um einen Feed in Ihrer Organisation zu verwenden.
• publishFeed: Erforderlich, wenn publishRegistry = useFeed. Der Feed, in dem Sie veröffentlichen möchten.

Tipp

Wenn Sie die npm-Veröffentlichungsaufgabe mithilfe des YAML-Editors hinzufügen, werden die Projekt- und Feed-IDs für Ihre publishFeed generiert.

Klassisch

1. Wählen Sie in Ihrer Pipeline das +-Zeichen aus, um Ihrer Pipeline eine Aufgabe hinzuzufügen, und suchen Sie dann nach der npm-Aufgabe. Wählen Sie Hinzufügen (Add) aus, um sie Ihrer Pipeline hinzuzufügen.

   

2. Benennen Sie Ihre Aufgabe und wählen Sie im Dropdownmenü Veröffentlichen (Publish) aus. Wählen Sie Ihren Package.json-Pfad, Ihren Registrierungsspeicherort und Ihre Zielregistrierung aus

   

• Arbeitsordner, der „package.json“ enthält: Pfad zum Ordner, der die Zieldateien „package.json“ und „.npmrc“ enthält. Lassen Sie dies leer, wenn sich diese Dateien im Stammverzeichnis Ihres Repositorys befinden.
• Registrierungsspeicherort: Wählen Sie Hier ausgewählte Registrierung (Registry I select here) aus, um in einem Azure Artifacts-Feed zu veröffentlichen. Wählen Sie Ihren Feed im Dropdownmenü aus.

Veröffentlichen in einer öffentlichen Registrierung

Um Ihre Pakete in einer öffentlichen npm-Registrierung wie npmjs.com zu veröffentlichen, müssen Sie zuerst eine Dienstverbindung für die Verbindung mit dem gewünschten externen Dienst herstellen.

1. Wählen Sie Projekteinstellungen (Project settings) und dann Dienstverbindungen (Service Connections) aus.

2. Wählen Sie Dienstverbindung erstellen aus, um eine neue Dienstverbindung zu erstellen.

   

3. Wählen Sie npm und anschließend Weiter (Next) aus. Füllen Sie die erforderlichen Felder aus, und klicken Sie auf Speichern, wenn Sie fertig sind.

YAML

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

• publishRegistry: Wählen Sie useExternalRegistry aus, um in einer öffentlichen Registrierung zu veröffentlichen. Optionen: useExternalRegistry | useFeed.
• publishEndpoint: erforderlich, wenn publishRegistry == useExternalRegistry. Ersetzen Sie den Platzhalter durch den Namen der zuvor erstellten Dienstverbindung.

Klassisch

1. Wählen Sie in Ihrer Pipeline das +-Zeichen aus, um Ihrer Pipeline eine Aufgabe hinzuzufügen, und suchen Sie dann nach der npm-Aufgabe. Wählen Sie Hinzufügen (Add) aus, um sie Ihrer Pipeline hinzuzufügen.

   

2. Benennen Sie Ihre Aufgabe und wählen Sie dann im Dropdownmenü Veröffentlichen (Publish) aus. Wählen Sie Ihren package.json-Pfad, Ihren Registrierungsspeicherort und Ihre externe Registrierung aus.

   

• Arbeitsordner, der „package.json“ enthält: Pfad zum Ordner, der die Zieldateien „package.json“ und „.npmrc“ enthält. Lassen Sie dies leer, wenn sich diese Dateien im Stammverzeichnis Ihres Repositorys befinden.
• Registrierungsspeicherort: Wählen Sie Externe npm-Registrierung (External npm registry) aus, um in öffentlichen Registrierungen wie „npmjs.com“ zu veröffentlichen. Geben Sie den Namen der Dienstverbindung ein, die Sie zuvor erstellt haben.

Verwandte Artikel

• Veröffentlichen und Herunterladen von Artefakten in Azure Pipelines.
• Veröffentlichen von npm-Paketen über die Befehlszeile.
• Verwenden von Paketen von „npmjs.com“.