Erste Schritte mit npm-Paketen in Azure Artifacts

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

Mithilfe von Azure Artifacts können Sie Ihre npm-Pakete aus Feeds und öffentlichen Registrierungen wie npmjs.com veröffentlichen und herunterladen. Diese Schnellstartanleitung führt Sie durch das Erstellen Ihres Feeds, das Konfigurieren Ihres Projekts und das Verwalten von npm-Paketen mit Ihrem Azure Artifacts-Feed.

Voraussetzungen

• Eine Azure DevOps-Organisation. Erstellen Sie ein kostenloses Konto.

• Ein Azure DevOps-Projekt. Erstellen Sie ein neues Projekt, wenn Sie noch keins haben.

• Laden Sie Node.js und npm herunter, und installieren Sie es.

Einen Feed erstellen

1. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und wechseln Sie dann zu Ihrem Projekt.

2. Wählen Sie Artefakte und dann Ihren Feed erstellen aus.

3. Geben Sie für "Name" einen beschreibenden Namen für Ihren Feed ein.

   Wählen Sie für sichtbarkeit eine Option aus, um anzugeben, wer Pakete innerhalb des Feeds anzeigen kann.

   Wenn Sie Pakete aus öffentlichen Quellen einschließen möchten, aktivieren Sie das Kontrollkästchen unter Upstreamquellen.

   Geben Sie für "Scope" an, ob der Bereich Ihres Feeds das Projekt oder die Organisation ist.

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

   

Hinweis

Standardmäßig haben neu erstellte Feeds den Builddienstwert ihres Projekts auf Feed und Upstream Reader (Mitarbeiter) festgelegt.

Herstellen einer Verbindung mit einem Feed

Hinweis

vsts-npm-auth wird in Azure DevOps Server nicht unterstützt.

Azure Artifacts empfiehlt die Verwendung von zwei NPMRC-Dateien. Der erste sollte im $home Verzeichnis (Linux/macOS) oder $env platziert werden. HOME (Windows), um Ihre Anmeldeinformationen sicher zu speichern. Auf diese Weise kann der npm-Client die Datei suchen und Ihre Anmeldeinformationen für die Authentifizierung abrufen, sodass Sie Ihre Konfigurationsdatei freigeben können, ohne Ihre Anmeldeinformationen verfügbar zu machen. In diesem Abschnitt richten wir die zweite NPMRC-Datei ein, die in demselben Verzeichnis wie Ihre package.json Datei platziert werden sollte.

1. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und navigieren Sie dann zu Ihrem Projekt.

2. Wählen Sie Artefakte und dann "Mit Feed verbinden" aus.

3. Wählen Sie npm aus dem linken Navigationsbereich aus. Wenn Sie Azure Artifacts zum ersten Mal mit npm verwenden, stellen Sie sicher, dass Sie die erforderlichen Komponenten installiert haben.

4. Befolgen Sie die Anweisungen im Abschnitt "Project-Setup ", um Ihre Konfigurationsdatei einzurichten und eine Verbindung mit Ihrem Feed herzustellen.

   

Wichtig

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

Veröffentlichen von Paketen

Führen Sie den folgenden Befehl in Ihrem Projektverzeichnis aus, um Ihre npm-Pakete zu veröffentlichen:

npm publish

Wichtig

Die Verwendung der publishConfig Eigenschaft zum Überschreiben des Registrierungskonfigurationsparameters zur Veröffentlichungszeit wird nicht unterstützt.

Pakete wiederherstellen

Führen Sie den folgenden Befehl in Ihrem Projektverzeichnis aus, um die npm-Pakete wiederherzustellen:

npm install

Führen Sie zum Wiederherstellen eines bestimmten npm-Pakets den folgenden Befehl aus Ihrem Projektverzeichnis aus:

npm install --save <PACKAGE_NAME>

Verwandte Artikel

• Veröffentlichen von npm-Paketen (YAML/Classic)
• Verwenden von Paketen aus npmjs.com
• Verwenden von npm-Bereichen