Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Mit Node.js-Paketen arbeiten

Artifact Registry unterstützt Node.js-Pakete, die Sie mit npm verwalten.

Die Paketverwaltung befindet sich in der Alphaphase. Sie ist nur für Alphanutzer verfügbar und umfasst möglicherweise nicht alle Features der Containerverwaltung. Wenn Sie sich für die Alphaversion anmelden möchten, füllen Sie das Anmeldeformular aus.

Übersicht

Wenn Sie sich mit Node.js-Paketen in Artifact Registry vertraut machen möchten, verwenden Sie die Kurzanleitung.

Wenn Sie mehr erfahren möchten, lesen Sie die folgenden Informationen:

  1. Wenn Sie mit npm noch nicht vertraut sind, lesen Sie die Informationen zu folgenden Konzepten:
  2. Erstellen eines npm-Repository für Ihre Pakete.
  3. Weisen Sie dem Konto Berechtigungen zu, die eine Verbindung zum Repository herstellen. Dienstkonten für gängige Integrationen mit Artifact Registry haben Standardberechtigungen für Repositories im selben Projekt.
  4. Konfigurieren von npm, sodass Sie sich beim Repository authentifizieren.
  5. Informationen zum Verwalten von Paketen.

Bereiche verwenden

Ein npm-Bereich ist ein Label zum Gruppieren von Paketen. Bereiche sind erforderlich, wenn Sie mit mehreren npm-Registries arbeiten, einschließlich:

  • Veröffentlichen und Installieren von Paketen in verschiedenen Registries, ohne dass Sie von einer Registry zu einer anderen wechseln müssen. Ihre Builds können beispielsweise Pakete aus der öffentlichen npm-Registry und einem Artifact Registry-Repository enthalten.
  • Veröffentlichen derselben Pakete in mehreren Artifact Registry-Repositories in Google Cloud-Projekten und anderen npm-Registries ohne Paketnamenkonflikte.

Es wird empfohlen, immer einen Bereich für Ihre Repositories festzulegen. Wenn Sie keinen Bereich angeben und das Paket veröffentlichen oder installieren, verwendet npm die konfigurierte Standard-Registry, z. B. die öffentliche npm-Registry.

Sie legen den Bereich für jedes Artifact Registry-Repository in der Konfigurationsdatei .npmrc fest. Die Anmeldedaten für die Authentifizierung gelten für alle Repositories.

Das folgende Beispiel zeigt die Konfiguration für zwei Artifact Registry-Repositories in verschiedenen Projekten.

  • Der Bereich @blue gilt für das Repository im Projekt blue-project.
  • Der Bereich @green gilt für das Repository im Projekt green-project.
@blue:registry=https://us-central1-npm.pkg.dev/blue-project/blue-npm-repo/
//us-central1-npm.pkg.dev/blue-project/blue-npm-repo/:_authToken=""
//us-central1-npm.pkg.dev/blue-project/blue-npm-repo/:always-auth=true

@green:registry=https://us-central1-npm.pkg.dev/green-project/green-npm-repo/
//us-central1-npm.pkg.dev/green-project/green-npm-repo/:_authToken=""
//us-central1-npm.pkg.dev/green-project/green-npm-repo/:always-auth=true

Nach der Authentifizierung bei Artifact Registry können Sie ein Paket mit dem entsprechenden Bereich in ein bestimmtes Repository hochladen. Beispiel: Mit dem folgenden Befehl wird ein Paket in blue-npm-repo im Projekt blue-project hochgeladen:

npm publish @blue/blue-npm-repo

Weitere Informationen zu Bereichen finden Sie in der npm-Dokumentation.

Anmeldedaten speichern

Die für die Authentifizierung verwendeten Einstellungen werden in npm-Konfigurationsdateien gespeichert. Diese Dateien heißen .npmrc. Die folgenden Einstellungen werden für Artifact Registry verwendet.

  • Anmeldedaten für die öffentliche npm-Registry

    Speichern Sie Ihre Anmeldedaten für die öffentliche npm-Registry (https://registry.npmjs.org/) in der nutzerspezifischen Konfigurationsdatei, damit sie für andere Nutzer nicht verfügbar sind. Diese Datei befindet sich im Basisverzeichnis des Nutzers oder wird mit dem npm-Parameter --userconfig oder $NPM_CONFIG_USERCONFIG festgelegt. Die Artifact Registry-Tools für die Authentifizierung mit Artifact Registry-Repositories befinden sich in der öffentlichen npm-Registry.

  • Einstellungen zum Herstellen einer Verbindung zu Artifact Registry-Repositories

    Sie können die Artifact Registry-Repository-Einstellungen in einer dieser npm-Konfigurationsdateien speichern:

    • Projektspezifische Konfigurationsdatei. Diese .npmrc-Datei befindet sich normalerweise im selben Verzeichnis wie die package.json-Datei in Ihrem npm-Projekt. Dies ist die einfachste Option.

    • Nutzerspezifische Konfigurationsdatei. Diese Datei befindet sich im Basisverzeichnis des Nutzers oder wird mit dem npm-Parameter --userconfig oder $NPM_CONFIG_USERCONFIG festgelegt.

    • Globale Konfigurationsdatei $PREFIX/etc/npmrc. Führen Sie den Befehl npm prefix -g aus, um den Wert für $PREFIX zu erhalten.

Sie sollten die vorhandene Standard-Registry beibehalten, die in Ihrer npmrc-Datei konfiguriert ist. Die Standardeinstellung ist normalerweise auf die öffentliche npm-Registry unter https://registry.npmjs.org/ festgelegt.

Führen Sie folgenden Befehl aus, um den aktuellen Standardwert der Registry zu prüfen:

npm get registry

Weitere Informationen zu npm-Konfigurationsdateien finden Sie in der Dokumentation zu npm-Konfigurationsdateien.