Erste Schritte mit npm Paketen in Azure Artifacts

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Mit Azure Artifacts können Sie npm Pakete aus Feeds und öffentlichen Registrierungen wie npmjs.com veröffentlichen und herunterladen. In diesem Schnellstart werden Sie durch das Erstellen Ihres eigenen Feeds, das Einrichten Ihres Projekts und das Veröffentlichen und Herunterladen von npm Paketen in und aus Ihrem Azure Artifacts Feed unterstützt.

Lizenz für die Azure Artifacts-Erweiterung

Um Azure Artifacts in TFS zu verwenden, müssen Sie auf Visual Studio Team Foundation Server 2017 aktualisieren. Wenn die Azure Artifacts-Erweiterung entfernt wurde, können Sie sie aus dem Visual Studio Marketplace installieren.

Zuweisen von Lizenzen in Team Foundation Server

Jede Organisation erhält fünf kostenlose Lizenzen. Wenn Sie mehr als fünf Lizenzen benötigen, wechseln Sie zum Visual Studio Marketplace, und wählen Sie "Kostenlos abrufen" aus.

Wenn Sie nicht sicher sind, können Sie die kostenlose Testversion von 30 Tagen auswählen. Jeder Benutzer in Ihrer Organisation erhält dann Zugriff auf Azure Artifacts für 30 Tage. Nach dem 30-tägigen Testzeitraum wird Ihre Organisation wieder auf fünf berechtigte Benutzer zurückgesetzt, und Sie müssen Lizenzen einzelnen Benutzern zuweisen. Wenn Sie zusätzliche Lizenzen an diesem Punkt benötigen, können Sie sie von Visual Studio Marketplace kaufen. Wenn Sie über eine Lizenz für Visual Studio Enterprise verfügen, haben Sie bereits Zugriff auf Azure Artifacts und müssen keine Lizenz zugewiesen werden. Stellen Sie einfach sicher, dass Sie der Zugriffsstufe "Visual Studio Enterprise" zugewiesen wurden.

Hinweis

Wenn Sie die kostenlose Testversion "Start 30 Tage" ausgewählt haben und sich weiterhin im Testzeitraum befinden, erhält jeder Benutzer Zugriff. Lizenzen müssen erst zugewiesen werden, wenn der Testzeitraum beendet wird.

  1. Zeigen Sie in jeder Auflistung in Team Foundation Server auf das Menü "Einstellungen" und wählen Sie "Benutzer" aus. Wählen Sie dann "Paketverwaltung" aus.

    Screenshot showing the user page in TFS

  2. Wählen Sie " Zuweisen" aus, geben Sie die Benutzer ein, die Lizenzen zuweisen möchten, und wählen Sie dann "OK" aus.

    • Benutzer mit Visual Studio Enterprise Abonnements erhalten kostenlos Azure Artifacts. Stellen Sie sicher, dass Ihre Visual Studio Enterprise Abonnenten über die entsprechende Zugriffsstufe verfügen. Weitere Informationen finden Sie unter Ändern von Zugriffsstufen.

    • Benutzer, die eine Instanz von Team Foundation Server verwenden, die vom Internet getrennt sind (und somit keine Lizenzen aus Visual Studio Marketplace kaufen können) können weiterhin Lizenzen zuweisen, die über eine Unternehmensvereinbarung erworben wurden.

Erstellen eines Feeds

Ein Feed ist ein Organisationskonstrukt, mit dem Benutzer ihre Pakete speichern und steuern können, wer darauf zugreifen kann. Azure Artifacts unterstützen das Speichern mehrerer Pakettypen in einem einzelnen Feed wie NuGet, npm, Maven, Python und Universelle Pakete.

  1. Wählen Sie Artifacts aus, und wählen Sie dann "Feed erstellen" aus.

    Create a feed button

  2. Geben Sie Ihrem Feed einen Namen und wählen Sie ihre Sichtbarkeit aus (wer Pakete in diesem Feed anzeigen kann), vorgelagerte Quellen und Bereich (Projektbereichs- oder Organisationsbereichseinstellungen).

    New feed dialog box

  3. Wenn Sie fertig sind, wählen Sie Erstellen aus.

Azure Artifacts wird standardmäßig für TFS 2017-Kunden installiert. Sie müssen auf TFS 2017 aktualisieren, um Azure Artifacts zu verwenden. Wenn dies das erste Mal die Verwendung Ihres Feeds ist, werden Sie möglicherweise aufgefordert, eine Lizenz zuzuweisen.

  1. Wechseln Sie zu "Release erstellen&", und wählen Sie "Pakete" aus.

    Go to Azure Artifacts TFS

  2. Wählen Sie +Neuer Feed aus.

    New feed button TFS

  3. Geben Sie Ihrem Feed einen Namen, eine Beschreibung und richten Sie ein, wer lesen kann, wer mitwirken kann und wenn Sie externe Pakete einschließen möchten.

    New feed dialog box TFS

  4. Wenn Sie fertig sind, wählen Sie Erstellen aus.

Einrichten ihrer NPmrc-Dateien

Hinweis

vsts-npm-authwird in TFS und Azure DevOps Server nicht unterstützt.

Es wird empfohlen, zwei NPMRC-Dateien zu haben. Der erste sollte in demselben Verzeichnis wie ihre package.json-Datei platziert werden. Der zweite sollte im $home Verzeichnis (Linux/macOS) oder $env platziert werden. HOME (Windows) zum Speichern Ihrer Anmeldeinformationen. Der npm-Client kann dann diese Datei nachschlagen und Ihre Anmeldeinformationen für die Authentifizierung abrufen. Dadurch können Sie Ihre Konfigurationsdatei freigeben, während Sie Ihre Anmeldeinformationen sicher halten.

  1. Wählen Sie Artifacts aus, und wählen Sie dann Verbinden zum Feed aus.

    Screenshot showing how to connect to a feed

  2. Wählen Sie npm aus. Wenn sie zum ersten Mal Azure Artifacts verwenden, wählen Sie die Tools abrufen aus, und führen Sie dann die Schritte aus, um Node.js herunterzuladen und den Anmeldeinformationenanbieter einzurichten.

  3. Folgen Sie den Anweisungen im Project Setup, um Ihr Projekt einzurichten.

    Screenshot showing how to set up your project

Einrichten der Authentifizierung auf Ihrem Entwicklungscomputer

Wichtig

npm unterstützt eine einzelne registry in Ihrer NPMRC-Datei. Mehrere Registrierungen sind mit Bereichen und Upstreamquellen möglich.

Wenn Sie sich auf Windows entwickeln, empfehlen vsts-npm-auth wir, sich mit Azure Artifacts zu authentifizieren. Führen Sie npm install -g vsts-npm-auth die Installation des Pakets global aus, und fügen Sie ihrem Package.json dann ein Ausführungsskript hinzu.

"scripts": {
    "refreshVSToken": "vsts-npm-auth -config .npmrc"
}

Verbinden zum Feed

  1. Wählen Sie "Pakete" aus, und wählen Sie dann Verbinden aus, um zu feeden.

  2. Wählen Sie npm aus.

  3. Wählen Sie "Npm Anmeldeinformationen generieren" aus. Kopieren Sie die Anmeldeinformationen, und fügen Sie sie ihrer NPMRC-Datei hinzu.

    Screenshot showing how generate credentials

Veröffentlichen von Paketen

Führen Sie den folgenden Befehl in Ihrem Projektverzeichnis aus, um Ihr npm-Paket zu veröffentlichen.

npm publish

Wichtig

Die Verwendung der Eigenschaft zum Außerkraftsetzen des publishConfig Registrierungskonfigurationsparam zur Veröffentlichungszeit wird nicht unterstützt.

Pakete wiederherstellen

Führen Sie den folgenden Befehl in Ihrem Projektverzeichnis aus, um ein npm-Paket wiederherzustellen.

npm install --save <package>

Nächste Schritte