View a markdown version of this page

Konfiguration und Verwendung von npm - Amazon CodeCatalyst

Amazon CodeCatalyst ist nicht mehr offen für neue Kunden. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Wie migriert man von CodeCatalyst.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Konfiguration und Verwendung von npm

Um npm mit zu verwenden CodeCatalyst, müssen Sie eine Verbindung npm zu Ihrem Paket-Repository herstellen und ein persönliches Zugriffstoken (PAT) für die Authentifizierung bereitstellen. Anweisungen zum Herstellen einer Verbindung npm zu Ihrem Paket-Repository finden Sie in der CodeCatalyst Konsole.

Konfiguration von npm mit CodeCatalyst

Die folgenden Anweisungen erklären, wie Sie sich authentifizieren und eine Verbindung npm zu Ihrem CodeCatalyst Paket-Repository herstellen. Weitere Informationen zu npm finden Sie in der offiziellen npm-Dokumentation.

Um npm mit deinem Paket-Repository zu verbinden CodeCatalyst
  1. Öffnen Sie die CodeCatalyst Konsole unter. https://codecatalyst.aws/

  2. Navigieren Sie zu Ihrem Projekt.

  3. Wählen Sie im Navigationsbereich Packages (Pakete) aus.

  4. Wählen Sie Ihr Paket-Repository aus der Liste aus.

  5. Wählen Sie Mit Repository verbinden.

  6. Wählen Sie in den Konfigurationsdetails im Package Manager Client die Option npm client aus.

  7. Wählen Sie Ihr Betriebssystem aus, um die entsprechenden Konfigurationsschritte anzuzeigen.

  8. Für die Authentifizierung von npm ist ein persönliches Zugriffstoken (PAT) erforderlich. CodeCatalyst Wenn Sie bereits ein Token haben, können Sie es verwenden. Wenn nicht, können Sie mithilfe der folgenden Schritte eines erstellen.

    1. (Optional): Aktualisieren Sie den PAT-Namen und das Ablaufdatum.

    2. Wählen Sie Create token aus.

    3. Kopieren Sie Ihre PAT und speichern Sie sie an einem sicheren Ort.

      Warnung

      Sie können Ihre PAT nicht mehr sehen oder kopieren, nachdem Sie das Dialogfeld geschlossen haben. Anmeldeinformationen sollten kurzlebig sein, um die Zeit zu minimieren, die ein Angreifer nach einer missbräuchlichen Verwendung der Anmeldeinformationen verwenden kann.

  9. Führen Sie die folgenden Befehle im Stammverzeichnis Ihres Projekts aus, um npm mit Ihrem Paket-Repository zu konfigurieren. Die Befehle bewirken Folgendes:

    • Erstellen Sie eine .npmrc Datei auf Projektebene, falls Ihr Projekt keine hat.

    • Fügen Sie die Endpunktinformationen des Paket-Repositorys zu Ihrer Datei auf .npmrc Projektebene hinzu.

    • Fügen Sie Ihre Anmeldeinformationen (PAT) zu Ihrer Datei auf .npmrc Benutzerebene hinzu.

    Ersetzen Sie die folgenden Werte.

    Anmerkung

    Wenn Sie Anweisungen aus der Konsole kopieren, werden die Werte in den folgenden Befehlen für Sie aktualisiert und müssen nicht geändert werden.

    • usernameErsetzen Sie durch Ihren CodeCatalyst Benutzernamen.

    • Ersetzen Sie PAT durch Ihre CodeCatalyst PAT.

    • Ersetze es space_name durch deinen CodeCatalyst Space-Namen.

    • Ersetze es proj_name durch deinen CodeCatalyst Projektnamen.

    • Ersetzen Sie es durch repo_name den Namen Ihres CodeCatalyst Paket-Repositorys.

    npm set registry=https://packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/ --location project npm set //packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/:_authToken=username:PAT

    Für npm 6 oder niedriger: Damit npm das Auth-Token auch bei GET Anfragen immer an übergibt CodeCatalyst, setzen Sie die Always-Auth-Konfigurationsvariable wie folgt. npm config set

    npm set //packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/:always-auth=true --location project

Installation von NPM-Paketen aus einem Paket-Repository CodeCatalyst

Nachdem Sie npm mit Ihrem Repository verbunden haben, indem Sie die Schritte unter ausgeführt habenKonfiguration von npm mit CodeCatalyst, können Sie npm Befehle in Ihrem Repository ausführen.

Mit dem Befehl können Sie ein npm-Paket installieren, das sich in Ihrem CodeCatalyst Paket-Repository oder einem seiner Upstream-Repositorys befindet. npm install

npm install lodash

Installation von NPM-Paketen von npmjs über CodeCatalyst

Sie können npm-Pakete von npmjs.com über ein CodeCatalyst Repository installieren, indem Sie das Repository mit einer Upstream-Verbindung zum Gateway-Repository konfigurieren, das mit npmjs.com, npm-public-registry-gateway, verbunden ist. Pakete, die von npmjs installiert werden, werden aufgenommen und im Gateway-Repository und im am weitesten flussabwärts gelegenen Paket-Repository gespeichert.

Um Pakete von npmjs zu installieren
  1. Falls Sie dies noch nicht getan haben, konfigurieren Sie es npm mit Ihrem CodeCatalyst Paket-Repository, indem Sie den Schritten unter folgen. Konfiguration von npm mit CodeCatalyst

  2. Vergewissern Sie sich, dass Ihr Projektarchiv das Gateway-Repository npm-public-registry-gateway als Upstream-Verbindung hinzugefügt hat. Du kannst überprüfen, welche Upstream-Quellen hinzugefügt wurden, oder npm-public-registry-gateway als Upstream-Quelle hinzufügen, indem du den Anweisungen in folgst und das npm-public-registry-gateway-Repository auswählst. Ein Upstream-Repository hinzufügen

  3. npm installInstallieren Sie Pakete mit dem Befehl.

    npm install package_name

Weitere Hinweise zum Anfordern von Paketen aus Upstream-Repositorys finden Sie unterEine Paketversion mit Upstream-Repositorys anfordern.

Veröffentlichen Sie npm-Pakete in Ihrem CodeCatalyst Paket-Repository

Nachdem Sie fertig sindKonfiguration von npm mit CodeCatalyst, können Sie npm Befehle ausführen.

Sie können ein NPM-Paket mit dem npm publish Befehl in einem CodeCatalyst Paket-Repository veröffentlichen.

npm publish

Informationen zum Erstellen von NPM-Paketen finden Sie unter Node.js Module erstellen in den npm-Dokumenten.

Unterstützung für npm-Befehle

In den folgenden Abschnitten werden die npm Befehle zusammengefasst, die von CodeCatalyst Paket-Repositorys unterstützt werden. Außerdem werden bestimmte Befehle aufgeführt, die nicht unterstützt werden.

Unterstützte Befehle, die mit einem Paket-Repository interagieren

In diesem Abschnitt npm werden Befehle aufgeführt, bei denen der npm Client eine oder mehrere Anforderungen an die Registrierung stellt, für die er konfiguriert ist (z. B.npm config set registry). Es wurde überprüft, ob diese Befehle korrekt funktionieren, wenn sie in einem CodeCatalyst Paket-Repository aufgerufen werden.

Befehl Description

Bugs

Errät den Speicherort der Bugtracker-URL eines Pakets und versucht dann, es zu öffnen.

Ci

Installiert ein Projekt mit einem Neuanfang.

missbilligen

Veraltet eine Version eines Pakets.

Dist-Tag

Ändert die Tags für die Paketverteilung.

Dokumente

Errät den Speicherort der Dokumentations-URL eines Pakets und versucht dann, es mithilfe des --browser Config-Parameters zu öffnen.

Arzt

Führt eine Reihe von Prüfungen durch, um zu überprüfen, ob Ihre NPM-Installation Ihre JavaScript Pakete verwalten kann.

install

Installiert ein Paket.

install-ci-test

Installiert ein Projekt mit einem Neuanfang und führt Tests durch. Alias:npm cit. Mit diesem Befehl wird ein ausgeführtnpm ci, unmittelbar gefolgt von einemnpm test.

installieren-test

Installiert das Paket und führt Tests aus. Führt eine ausnpm install, unmittelbar gefolgt von einernpm test.

veraltet

Überprüft die konfigurierte Registrierung, um festzustellen, ob installierte Pakete veraltet sind.

Ping

Pingt die konfigurierte oder angegebene NPM-Registrierung und überprüft die Authentifizierung.

veröffentlichen

Veröffentlicht eine Paketversion in der Registrierung.

update

Errät den Speicherort der Repository-URL eines Pakets und versucht dann, es mithilfe des --browser Config-Parameters zu öffnen.

anzeigen

Zeigt Paket-Metadaten an. Kann auch zum Drucken von Metadateneigenschaften verwendet werden.

Unterstützte clientseitige Befehle

Diese Befehle erfordern keine direkte Interaktion mit einem Paket-Repository und benötigen daher CodeCatalyst nichts, um sie zu unterstützen.

Befehl Description

bin (veraltet)

Zeigt das bin npm-Verzeichnis an.

Build

Erstellt ein Paket.

zwischenspeichern

Manipuliert den Paket-Cache.

Fertigstellung

Aktiviert die Tabulatorvervollständigung in allen npm-Befehlen.

Config

Aktualisiert den Inhalt der Benutzer- und globalen npmrc Dateien.

deduplizieren

Durchsucht den lokalen Paketbaum und versucht, die Struktur zu vereinfachen, indem Abhängigkeiten im Baum weiter nach oben verschoben werden, wo sie effektiver von mehreren abhängigen Paketen gemeinsam genutzt werden können.

bearbeiten

Bearbeitet ein installiertes Paket. Wählt eine Abhängigkeit im aktuellen Arbeitsverzeichnis aus und öffnet das Paketverzeichnis im Standardeditor.

erkunden

Durchsucht ein installiertes Paket. Erzeugt eine Subshell im Verzeichnis des angegebenen installierten Pakets. Wenn ein Befehl angegeben ist, wird er in der Subshell ausgeführt, die dann sofort heruntergefahren wird.

help

Ruft Hilfe bei npm ab.

Hilfe-Suche

Durchsucht die NPM-Hilfedokumentation.

initiieren

Erzeugt eine package.json Datei.

verlinken

Verknüpft ein Paketverzeichnis mit Symlinks.

ls

Listet installierte Pakete auf.

packen

Erzeugt einen Tarball aus einem Paket.

prefix

Zeigt ein Präfix an. Dies ist das übergeordnete Verzeichnis, das einer package.json Datei am nächsten liegt, sofern es nicht ebenfalls angegeben -g ist.

Pflaume

Entfernt Pakete, die nicht in der Abhängigkeitsliste des übergeordneten Pakets aufgeführt sind.

neu aufbauen

Führt den npm build Befehl für die passenden Ordner aus.

neu starten

Führt die Stopp-, Restart- und Startskripte eines Pakets sowie die zugehörigen Vor- und Nachskripte aus.

Root

Druckt das aktuelle node_modules Verzeichnis im Standard-Out-Format aus.

Skript ausführen

Führt beliebige Paketskripte aus.

Shrinkwrap

Sperrt Abhängigkeitsversionen für die Veröffentlichung.

deinstallieren

Deinstalliert ein Paket.

Nicht unterstützte Befehle

Diese npm Befehle werden von CodeCatalyst Paket-Repositorys nicht unterstützt.

Befehl Description Hinweise

Zugriff

Legt die Zugriffsebene für veröffentlichte Pakete fest.

CodeCatalyst verwendet ein Berechtigungsmodell, das sich vom öffentlichen npmjs-Repository unterscheidet.

Benutzer hinzufügen

Fügt ein Registrierungsbenutzerkonto hinzu

CodeCatalyst verwendet ein Benutzermodell, das sich vom öffentlichen npmjs-Repository unterscheidet.

Audit

Führt eine Sicherheitsüberprüfung durch.

CodeCatalyst verkauft derzeit keine Daten zu Sicherheitslücken.

Haken

Verwaltet NPM-Hooks, einschließlich Hinzufügen, Entfernen, Auflisten und Aktualisieren.

CodeCatalyst unterstützt derzeit keinen Mechanismus zur Benachrichtigung über Änderungen.

login

Authentifiziert einen Benutzer. Dies ist ein Alias für npm adduser.

CodeCatalyst verwendet ein Authentifizierungsmodell, das sich vom öffentlichen npmjs-Repository unterscheidet. Weitere Informationen finden Sie unter Konfiguration von npm mit CodeCatalyst.

logout

Meldet sich von der Registrierung ab.

CodeCatalyst verwendet ein Authentifizierungsmodell, das sich vom öffentlichen npmjs-Repository unterscheidet. Es gibt keine Möglichkeit, sich von einem CodeCatalyst Repository abzumelden, aber die Authentifizierungstoken laufen nach ihrer konfigurierbaren Ablaufzeit ab. Die Standarddauer des Tokens beträgt 12 Stunden.

Besitzer

Verwaltet Paketbesitzer.

CodeCatalyst verwendet ein Berechtigungsmodell, das sich vom öffentlichen npmjs-Repository unterscheidet.

profile

Ändert die Einstellungen in Ihrem Registrierungsprofil.

CodeCatalyst verwendet ein Benutzermodell, das sich vom öffentlichen npmjs-Repository unterscheidet.

search

Durchsucht die Registrierung nach Paketen, die den Suchbegriffen entsprechen.

CodeCatalyst unterstützt den search Befehl nicht.

Stern

Markiert deine Lieblingspakete.

CodeCatalyst unterstützt derzeit keinen Favoriten-Mechanismus.

Sterne

Zeigt Pakete an, die als Favoriten markiert sind.

CodeCatalyst unterstützt derzeit keinen Favoriten-Mechanismus.

Mannschaft

Verwaltet Teams und Teammitgliedschaften.

CodeCatalyst verwendet ein Benutzer- und Gruppenmitgliedschaftsmodell, das sich vom öffentlichen npmjs-Repository unterscheidet.

Token

Verwaltet Ihre Authentifizierungstoken.

CodeCatalyst verwendet ein anderes Modell zum Abrufen von Authentifizierungstoken. Weitere Informationen finden Sie unter Konfiguration von npm mit CodeCatalyst.

Veröffentlichung rückgängig machen

Entfernt ein Paket aus der Registrierung.

CodeCatalyst unterstützt nicht das Entfernen einer Paketversion aus einem Repository mithilfe des npm-Clients. Sie können ein Paket in der Konsole löschen.

Whoam

Zeigt den NPM-Benutzernamen an.

CodeCatalyst verwendet ein Benutzermodell, das sich vom öffentlichen npmjs-Repository unterscheidet.