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 npm-Pakete aus Feeds und öffentlichen Registrierungen wie npmjs.com veröffentlichen und herunterladen. Diese Schnellstartanleitung führt Sie durch den Prozess zum Erstellen Ihres Feeds, zum Konfigurieren Ihres Projekts und zum Veröffentlichen und Herunterladen von npm-Paketen in und aus Ihrem Azure Artifacts-Feed.

Einen Feed erstellen

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 einzigen Feed wie NuGet, npm, Maven, Python, Cargo und Universal-Pakete.

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

2. Wählen Sie Artefakte und dann "Feed erstellen" aus, um einen neuen Feed zu erstellen.

3. Geben Sie einen beschreibenden Namen für Ihren Feed ein, und definieren Sie die Sichtbarkeit (die angibt, wer Pakete innerhalb des Feeds anzeigen kann). Geben Sie den Bereich Ihres Feeds an, und wenn Sie Pakete aus öffentlichen Quellen einschließen möchten, markieren Sie das Kontrollkästchen "Upstream-Quellen ".

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

   

Hinweis

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

Einrichten Ihrer NPMRC-Dateien

Hinweis

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

Es wird empfohlen, zwei NPMRC-Dateien zu verwenden. Der erste sollte sich im selben Verzeichnis wie Ihre package.json Datei befinden. Die zweite sollte im $home Verzeichnis (Linux/macOS) oder $env platziert werden. HOME (Windows), um Ihre Anmeldeinformationen sicher zu speichern. Der npm-Client kann diese Datei dann 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. Melden Sie sich bei Ihrer Azure DevOps-Organisation an, und navigieren Sie dann zu Ihrem Projekt.

2. Wählen Sie Artefakte aus, und wählen Sie dann Verbinden aus, um zu feeden.

3. Wählen Sie npm aus dem linken Navigationsbereich aus. Wenn Sie Azure Artifacts zum ersten Mal mit npm verwenden, wählen Sie "Tools abrufen" aus, und führen Sie die Schritte aus, um Node.js herunterzuladen und Ihren Computer einzurichten.

4. Fügen Sie den folgenden Codeausschnitt in die NPMRC-Datei ein, die sich im selben Verzeichnis wie Ihre package.json Datei befindet. Ersetzen Sie die Platzhalter durch die entsprechenden Werte.

   • Feed mit Organisationsbereich:

   registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/ 
   
   always-auth=true
   

   • Projektbezogener Feed:

   registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/ 
   
   always-auth=true
   

Einrichten von Anmeldeinformationen

Wichtig

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

Windows

Wenn Sie unter Windows entwickeln, empfehlen wir die Verwendung der vsts-npm-auth zur Authentifizierung mit Azure Artifacts. Stellen Sie sicher, dass vsts-npm-auth über "Tools abrufen" installiert ist, und führen Sie dann vsts-npm-auth aus, um ein Azure Artifacts-Token abzurufen, das Ihrer npmrc-Datei auf Benutzerebene hinzugefügt wurde:

vsts-npm-auth -config .npmrc

Andere

Wenn Sie auf einer Nicht-Windows-Plattform entwickeln und sich bei Azure Artifacts authentifizieren müssen, müssen Sie ein persönliches Zugriffstoken erstellen, es in Base 64 codieren und dann der npmrc-Datei auf Benutzerebene hinzufügen.

1. Generieren Sie ein persönliches Zugriffstoken mit Lese- und Schreibbereichen .

2. Codieren Sie Ihr neu generiertes persönliches Zugriffstoken wie folgt:

   1. Führen Sie den folgenden Befehl in einem Eingabeaufforderungsfenster aus, um Ihren PAT zu codieren:

      node -e "require('readline') .createInterface({input:process.stdin,output:process.stdout,historySize:0}) .question('PAT> ',p => { b64=Buffer.from(p.trim()).toString('base64');console.log(b64);process.exit(); })"
      

   2. Fügen Sie Ihr persönliches Zugriffstoken ein, und drücken Sie dann die EINGABETASTE.

   3. Kopieren Sie das base64-codierte persönliche Zugriffstoken.

3. Kopieren Sie den folgenden Codeausschnitt in die NPMRC-Datei auf Benutzerebene, und ersetzen Sie den [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] Platzhalter durch Ihr Base64 Personal Access Token:

   • Feed mit Organisationsbereich:

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:username=[ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

   • Projektbezogener Feed:

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

---

Veröffentlichen von Paketen

Führen Sie zum Veröffentlichen des npm-Pakets den folgenden Befehl in Ihrem Projektverzeichnis aus:

npm publish

Wichtig

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

Pakete wiederherstellen

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

npm install --save <package>

Führen Sie zum Wiederherstellen aller npm-Pakete den folgenden Befehl aus Ihrem Projektverzeichnis aus:

npm install

Verwandte Artikel

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