Amazon CodeCatalyst ist nicht mehr offen für Neukunden. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter [Wie migriert man von CodeCatalyst](migration.md).

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
<a name="packages-npm-use"></a>

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

**Contents**
+ [Konfiguration von npm mit CodeCatalyst](#npm-configure)
+ [NPM-Pakete aus einem Paket-Repository installieren CodeCatalyst](#npm-install)
+ [Installation von NPM-Paketen von npmjs bis CodeCatalyst](#npm-install-npmjs)
+ [Veröffentlichen Sie npm-Pakete in Ihrem CodeCatalyst Paket-Repository](#npm-publish)
+ [Unterstützung für npm-Befehle](#npm-commands)
  + [Unterstützte Befehle, die mit einem Paket-Repository interagieren](#supported-commands-that-interact-with-a-repository)
  + [Unterstützte clientseitige Befehle](#supported-client-side-commands)
  + [Nicht unterstützte Befehle](#unsupported-commands)

## Konfiguration von npm mit CodeCatalyst
<a name="npm-configure"></a>

In den folgenden Anweisungen wird erklärt, 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](https://docs.npmjs.com/).

**Um eine Verbindung `npm` zu Ihrem Paket-Repository CodeCatalyst herzustellen**

1. Öffnen Sie die CodeCatalyst Konsole unter [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navigieren Sie zu Ihrem Projekt.

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

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

1. Wählen Sie **Mit Repository verbinden**.

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

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

1. Für die Authentifizierung von npm ist ein Personal Access Token (PAT) erforderlich. CodeCatalyst Wenn Sie bereits ein Token haben, können Sie es verwenden. Wenn nicht, können Sie eines mit den folgenden Schritten erstellen.

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

   1. Wählen Sie „**Token erstellen**“.

   1. Kopieren Sie Ihr PAT und bewahren Sie es an einem sicheren Ort auf.
**Warnung**  
Sie können Ihr PAT nicht mehr sehen oder kopieren, nachdem Sie das Dialogfeld geschlossen haben. Anmeldeinformationen sollten kurzlebig sein, um die Zeit zu minimieren, für die ein Angreifer die Anmeldeinformationen verwenden kann, nachdem sie missbraucht wurden.

1. 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 noch 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.
   + *username*Ersetzen Sie es durch Ihren CodeCatalyst Benutzernamen.
   + Ersetzen Sie es *PAT* durch Ihr CodeCatalyst PAT.
   + *space\$1name*Ersetzen Sie es durch Ihren CodeCatalyst Bereichsnamen.
   + Ersetze es *proj\$1name* durch deinen CodeCatalyst Projektnamen.
   + Ersetzen Sie es durch *repo\$1name* 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 weitergibt CodeCatalyst, setzen Sie die Konfigurationsvariable always-auth wie folgt. `npm config set`

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

## NPM-Pakete aus einem Paket-Repository installieren CodeCatalyst
<a name="npm-install"></a>

Nachdem Sie npm mit Ihrem Repository verbunden haben, indem Sie die Schritte unter ausgeführt haben[Konfiguration von npm mit CodeCatalyst](#npm-configure), können Sie `npm` Befehle in Ihrem Repository ausführen.

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

```
npm install lodash
```

## Installation von NPM-Paketen von npmjs bis CodeCatalyst
<a name="npm-install-npmjs"></a>

Sie können npm-Pakete von [npmjs.com](https://www.npmjs.com/) über ein CodeCatalyst Repository installieren, indem Sie das Repository mit einer Upstream-Verbindung zum Gateway-Repository konfigurieren, das mit npmjs.com verbunden ist,. **npm-public-registry-gateway** Pakete, die über npmjs installiert wurden, werden im Gateway-Repository und im Paket-Repository am weitesten unten aufgenommen und 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 die Schritte unter befolgen. [Konfiguration von npm mit CodeCatalyst](#npm-configure) 

1. Vergewissern Sie sich, dass Ihr Repository das Gateway-Repository, **npm-public-registry-gateway**, als Upstream-Verbindung hinzugefügt hat. Sie können überprüfen, welche Upstream-Quellen hinzugefügt oder **npm-public-registry-gateway**als Upstream-Quelle hinzugefügt wurden, indem Sie den Anweisungen unter folgen [Ein Upstream-Repository hinzufügen](packages-upstream-repositories-add.md) und das **npm-public-registry-gateway**Repository auswählen.

1. Installieren Sie Pakete mit dem `npm install` Befehl.

   ```
   npm install package_name
   ```

Weitere Hinweise zum Anfordern von Paketen aus Upstream-Repositorys finden Sie unter[Eine Paketversion mit Upstream-Repositorys anfordern](packages-upstream-repositories-request.md).

## Veröffentlichen Sie npm-Pakete in Ihrem CodeCatalyst Paket-Repository
<a name="npm-publish"></a>

Nachdem Sie den Vorgang abgeschlossen haben[Konfiguration von npm mit CodeCatalyst](#npm-configure), können Sie `npm` Befehle ausführen.

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

```
npm publish
```

Informationen zum Erstellen von npm-Paketen finden Sie unter [Creating Node.js Modules](https://docs.npmjs.com/getting-started/creating-node-modules) in *npm* Docs.

## Unterstützung für npm-Befehle
<a name="npm-commands"></a>

In den folgenden Abschnitten werden die `npm` Befehle zusammengefasst, die von CodeCatalyst Paket-Repositorys unterstützt werden, sowie spezifische Befehle aufgeführt, die nicht unterstützt werden.

**Topics**
+ [Unterstützte Befehle, die mit einem Paket-Repository interagieren](#supported-commands-that-interact-with-a-repository)
+ [Unterstützte clientseitige Befehle](#supported-client-side-commands)
+ [Nicht unterstützte Befehle](#unsupported-commands)

### Unterstützte Befehle, die mit einem Paket-Repository interagieren
<a name="supported-commands-that-interact-with-a-repository"></a>

In diesem Abschnitt sind `npm` Befehle aufgeführt, bei denen der `npm` Client eine oder mehrere Anfragen an die Registry 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](https://docs.npmjs.com/cli/bugs)   |  Errät die Adresse der Bugtracker-URL eines Pakets und versucht dann, es zu öffnen.  | 
|   [Ci](https://docs.npmjs.com/cli/ci)   |  Installiert ein Projekt mit einem Neuanfang.  | 
|   [verwerfen](https://docs.npmjs.com/cli/deprecate)   |  Weist eine Version eines Pakets ab.  | 
|   [dist-tag](https://docs.npmjs.com/cli/dist-tag)   |  Ändert die Tags für die Paketverteilung.  | 
|   [Dokumente](https://docs.npmjs.com/cli/docs)   |  Errät den Speicherort der Dokumentations-URL eines Pakets und versucht dann, es mithilfe des `--browser` Konfigurationsparameters zu öffnen.  | 
|   [Arzt](https://docs.npmjs.com/cli/doctor)   |  Führt eine Reihe von Prüfungen durch, um zu überprüfen, ob Ihre npm-Installation Ihre JavaScript Pakete verwalten kann.  | 
|   [install](https://docs.npmjs.com/cli/install)   |  Installiert ein Paket.  | 
|   [install-ci-test](https://docs.npmjs.com/cli/install-ci-test)   |  Installiert ein Projekt mit einem Neuanfang und führt Tests durch. Alias:`npm cit`. Dieser Befehl führt einen aus`npm ci`, unmittelbar gefolgt von einem`npm test`.  | 
|   [installieren/testen](https://docs.npmjs.com/cli/install-test)   |  Installiert das Paket und führt Tests aus. Führt einen aus`npm install`, unmittelbar gefolgt von einem`npm test`.  | 
|   [veraltet](https://docs.npmjs.com/cli/outdated)   |  Überprüft die konfigurierte Registrierung, um festzustellen, ob installierte Pakete veraltet sind.  | 
|   [pingen](https://docs.npmjs.com/cli/ping)   |  Pingt die konfigurierte oder angegebene npm-Registrierung an und überprüft die Authentifizierung.  | 
|   [veröffentlichen](https://docs.npmjs.com/cli/publish)   |  Veröffentlicht eine Paketversion in der Registrierung.  | 
|   [update](https://docs.npmjs.com/cli/update)   |  Errät den Speicherort der Repository-URL eines Pakets und versucht dann, es mithilfe des `--browser` Konfigurationsparameters zu öffnen.  | 
|   [anzeigen](https://docs.npmjs.com/cli/view)   |  Zeigt Paket-Metadaten an. Kann auch zum Drucken von Metadateneigenschaften verwendet werden.  | 

### Unterstützte clientseitige Befehle
<a name="supported-client-side-commands"></a>

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)](https://docs.npmjs.com/cli/v8/commands/npm-bin)   |  Zeigt das `bin` NPM-Verzeichnis an.  | 
|   [Build](https://docs.npmjs.com/cli/v6/commands/npm-build)   |  Baut ein Paket.  | 
|   [Cache](https://docs.npmjs.com/cli/cache)   |  Manipuliert den Paket-Cache.  | 
|   [Vervollständigung](https://docs.npmjs.com/cli/completion)   |  Aktiviert die Tabulatorvervollständigung in allen npm-Befehlen.  | 
|   [Konfiguration](https://docs.npmjs.com/cli/config)   |  Aktualisiert den Inhalt der Benutzer- und `npmrc` Globaldateien.  | 
|   [deduplizieren](https://docs.npmjs.com/cli/dedupe)   |  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](https://docs.npmjs.com/cli/edit)   |  Bearbeitet ein installiertes Paket. Wählt eine Abhängigkeit im aktuellen Arbeitsverzeichnis aus und öffnet das Paketverzeichnis im Standardeditor.  | 
|   [erkunden](https://docs.npmjs.com/cli/explore)   |  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](https://docs.npmjs.com/cli/help)   |  Ruft Hilfe zu npm ab.  | 
|   [Hilfesuche](https://docs.npmjs.com/cli/help-search)   |  Durchsucht die NPM-Hilfedokumentation.  | 
|   [init](https://docs.npmjs.com/cli/init)   |  Erzeugt eine `package.json` Datei.  | 
|   [Link](https://docs.npmjs.com/cli/link)   |  Verweist symbolisch auf ein Paketverzeichnis.  | 
|   [ls](https://docs.npmjs.com/cli/ls)   |  Listet die installierten Pakete auf.  | 
|   [packen](https://docs.npmjs.com/cli/pack)   |  Erzeugt einen Tarball aus einem Paket.  | 
|   [prefix](https://docs.npmjs.com/cli/prefix)   |  Zeigt ein Präfix an. Dies ist das nächstgelegene übergeordnete Verzeichnis, das eine `package.json` Datei enthält, sofern nicht `-g` zusätzlich angegeben.  | 
|   [pflaumen](https://docs.npmjs.com/cli/prune)   |  Entfernt Pakete, die nicht in der Abhängigkeitsliste des übergeordneten Pakets aufgeführt sind.  | 
|   [neu aufbauen](https://docs.npmjs.com/cli/rebuild)   |  Führt den `npm build` Befehl für die entsprechenden Ordner aus.  | 
|   [neu starten](https://docs.npmjs.com/cli/restart)   |  Führt die Stopp-, Restart- und Start-Skripte eines Pakets sowie die zugehörigen Vor- und Nachskripte aus.  | 
|   [Root](https://docs.npmjs.com/cli/root)   |  Druckt das aktuelle `node_modules` Verzeichnis auf die Standardausgabe aus.  | 
|   [Run-Skript](https://docs.npmjs.com/cli/run-script)   |  Führt beliebige Paketskripten aus.  | 
|   [shrinkwrap](https://docs.npmjs.com/cli/shrinkwrap)   |  Sperrt abhängige Versionen für die Veröffentlichung.  | 
|   [deinstallieren](https://docs.npmjs.com/cli/uninstall)   |  Deinstalliert ein Paket.  | 

### Nicht unterstützte Befehle
<a name="unsupported-commands"></a>

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


****  

| Befehl | Description | Hinweise | 
| --- | --- | --- | 
|   [Zugriff](https://docs.npmjs.com/cli/access)   |  Legt die Zugriffsebene für veröffentlichte Pakete fest.  |  CodeCatalyst verwendet ein Berechtigungsmodell, das sich vom öffentlichen npmjs-Repository unterscheidet.  | 
|   [Benutzer hinzufügen](https://docs.npmjs.com/cli/adduser)   |  Fügt ein Registrierungsbenutzerkonto hinzu  |  CodeCatalyst verwendet ein Benutzermodell, das sich vom öffentlichen npmjs-Repository unterscheidet.  | 
|   [Prüfung](https://docs.npmjs.com/cli/audit)   |  Führt ein Sicherheitsaudit durch.  |  CodeCatalyst verkauft derzeit keine Daten zu Sicherheitslücken.  | 
|   [Haken](https://docs.npmjs.com/cli/v9/commands/npm-hook)   |  Verwaltet NPM-Hooks, einschließlich Hinzufügen, Entfernen, Auflisten und Aktualisieren.  |  CodeCatalyst unterstützt derzeit keinen Mechanismus zur Benachrichtigung über Änderungen.  | 
|   [login](https://docs.npmjs.com/cli-commands/adduser.html)   |  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](#npm-configure).  | 
|   [logout](https://docs.npmjs.com/cli/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 Authentifizierungstoken laufen nach ihrer konfigurierbaren Ablaufzeit ab. Die Standarddauer des Tokens beträgt 12 Stunden.   | 
|   [Besitzer](https://docs.npmjs.com/cli/owner)   |  Verwaltet die Besitzer von Paketen.  |  CodeCatalyst verwendet ein Berechtigungsmodell, das sich vom öffentlichen npmjs-Repository unterscheidet.  | 
|   [profile](https://docs.npmjs.com/cli/profile)   |  Ändert die Einstellungen in Ihrem Registrierungsprofil.  |  CodeCatalyst verwendet ein Benutzermodell, das sich vom öffentlichen npmjs-Repository unterscheidet.  | 
|   [search](https://docs.npmjs.com/cli/search)   |  Durchsucht die Registrierung nach Paketen, die den Suchbegriffen entsprechen.  |  CodeCatalyst unterstützt den `search` Befehl nicht.  | 
|   [Stern](https://docs.npmjs.com/cli/star)   |  Markiert deine Lieblingspakete.  |  CodeCatalyst unterstützt derzeit keinen Favoriten-Mechanismus.  | 
|   [Sterne](https://docs.npmjs.com/cli/stars)   |  Zeigt Pakete an, die als Favoriten markiert sind.  |  CodeCatalyst unterstützt derzeit keinen Favoriten-Mechanismus.  | 
|   [Team](https://docs.npmjs.com/cli/team)   |  Verwaltet Teams und Teammitgliedschaften.  |  CodeCatalyst verwendet ein Benutzer- und Gruppenmitgliedschaftsmodell, das sich vom öffentlichen npmjs-Repository unterscheidet.  | 
|   [T](https://docs.npmjs.com/cli/token)oken   |  Verwaltet Ihre Authentifizierungstoken.  |  CodeCatalyst verwendet ein anderes Modell zum Abrufen von Authentifizierungstoken. Weitere Informationen finden Sie unter [Konfiguration von npm mit CodeCatalyst](#npm-configure).  | 
|   [Veröffentlichung rückgängig machen](https://docs.npmjs.com/cli/unpublish)   |  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.  | 
|   [Whoami](https://docs.npmjs.com/cli/whoami)   |  Zeigt den NPM-Benutzernamen an.  |  CodeCatalyst verwendet ein Benutzermodell, das sich vom öffentlichen npmjs-Repository unterscheidet.  |