Erste Schritte mit npm-Paketen in Azure Artefakten

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

Mit Azure-Artefakten können Sie npm-Pakete aus Feeds und öffentlichen Registrierungen wie npmjs.com veröffentlichen und herunterladen. Diese Schnellstartanleitung führt 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-Artefakte-Feed.

Lizenz der Azure Artifacts-Erweiterung

Um Azure-Artefakte in TFS zu verwenden, müssen Sie ein Upgrade auf Visual Studio Team Foundation Server 2017 durchführen. 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 "30 Tage starten" auswählen. Jeder Benutzer in Ihrer Organisation erhält dann 30 Tage Zugriff auf Azure-Artefakte. Nach dem 30-tägigen Testzeitraum wird Ihre Organisation wieder auf fünf berechtigte Benutzer zurückgesetzt, und Sie müssen einzelnen Benutzern Lizenzen zuweisen. Wenn Sie an diesem Punkt zusätzliche Lizenzen benötigen, können Sie sie von Visual Studio Marketplace erwerben. Wenn Sie über eine Lizenz für Visual Studio Enterprise verfügen, haben Sie bereits Zugriff auf Azure-Artefakte 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 endet.

  1. Zeigen Sie in einer beliebigen Auflistung in Team Foundation Server auf das Einstellungsmenü, und wählen Sie "Benutzer" aus. Wählen Sie dann "Paketverwaltung" aus.

    Screenshot der Benutzerseite in TFS

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

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

    • Benutzer, die eine Instanz von Team Foundation Server verwenden, die vom Internet getrennt ist (und somit keine Lizenzen von Visual Studio Marketplace erwerben können) können weiterhin Lizenzen zuweisen, die über einen Enterprise-Vertrag 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-Artefakte unterstützen das Speichern mehrerer Pakettypen in einem einzelnen Feed wie NuGet, npm, Maven, Python und Universelle Pakete.

  1. Wählen Sie Artefakte und dann " Feed erstellen" aus.

    Erstellen einer Feedschaltfläche

  2. Geben Sie Ihrem Feed einen Namen , und wählen Sie die Sichtbarkeit (wer Pakete in diesem Feed anzeigen kann), vorgelagerte Quellen und Bereichseinstellungen (Projektbereich oder Organisationsbereich) aus.

    Dialogfeld „Neuer Feed“

  3. Wählen Sie Erstellen, wenn Sie fertig sind.

Hinweis

Standardmäßig werden der Project Collection Build Service (organisationsbezogene) und der Projektebene-Builddienst (Projektbereich) auf Mitarbeiter festgelegt, wenn Sie einen neuen Feed erstellen.

Azure Artefakte werden in TFS 2018 vorinstalliert. Wenn dies beim ersten Verwenden Ihres Feeds der Fall ist, werden Sie möglicherweise aufgefordert, eine Lizenz zuzuweisen.

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

    Wechseln zu Azure Artefakte TFS

  2. Wählen Sie +Neuer Feed aus.

    Neue Feedschaltfläche TFS

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

    Dialogfeld

  4. Wählen Sie Erstellen, wenn Sie fertig sind.

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. Die erste sollte im selben Verzeichnis wie ihre datei "package.json" platziert werden. Die zweite sollte im $home Verzeichnis (Linux/macOS) oder $env platziert werden . HOME (Windows), um Ihre Anmeldeinformationen zu speichern. Der npm-Client kann dann diese Datei nachschlagen und Ihre Anmeldeinformationen für die Authentifizierung abrufen. Auf diese Weise können Sie Ihre Konfigurationsdatei freigeben, während Ihre Anmeldeinformationen sicher bleiben.

  1. Wählen Sie Artefakte aus, und wählen Sie dann "Mit Feed verbinden" aus.

    Screenshot, der zeigt, wie eine Verbindung mit einem Feed hergestellt wird

  2. Wählen Sie npm aus. Wenn sie zum ersten Mal Azure-Artefakte verwenden, wählen Sie "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, der zeigt, wie Sie Ihr Projekt einrichten

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 unter Windows entwickeln, empfiehlt es sich, sich vsts-npm-auth mit Azure-Artefakten zu authentifizieren. Führen Sie die Ausführung npm install -g vsts-npm-auth aus, um das Paket global zu installieren, und fügen Sie dann ihrem package.json ein Ausführungsskript hinzu.

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

Herstellen einer Verbindung mit Feed

  1. Wählen Sie "Pakete" und dann " Mit Feed verbinden" aus.

  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, der zeigt, wie Anmeldeinformationen generiert werden

Veröffentlichen von Paketen

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

npm publish

Wichtig

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

Pakete wiederherstellen

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

npm install --save <package>

Nächste Schritte