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

npm-Pakete verwalten

Auf dieser Seite werden die folgenden Aufgaben beschrieben:

  • Pakete und Paketversionen ansehen und löschen
  • Tags anzeigen, erstellen, aktualisieren und löschen

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. Weitere Informationen finden Sie unter Voraussetzungen für den Zugriff auf Alphafunktionen.

Hinweis

  1. Wenn das Ziel-Repository nicht vorhanden ist, erstellen Sie ein neues Repository.
  2. Prüfen Sie, ob Sie die erforderlichen Berechtigungen für das Repository haben.
  3. Konfigurieren Sie die Authentifizierung für npm.
  4. (Optional) Konfigurieren Sie die Standardeinstellungen für gcloud-Befehle.

Pakete hinzufügen

Sie können jeweils nur eine bestimmte Version eines Pakets veröffentlichen. Dies ist eine npm-Einschränkung, damit der Inhalt einer veröffentlichten Paketversion immer gleich ist. Folgendes ist dann nicht möglich:

  • Überschreiben einer Paketversion durch erneutes Veröffentlichen im Repository.
  • Entfernen eines Pakets oder seiner Version aus dem Repository und Veröffentlichen eines Pakets mit demselben Namen und derselben Versionsnummer.

So fügen Sie ein Paket hinzu:

  1. Der Paketname in package.json muss den für Ihr Repository konfigurierten Bereich enthalten. Das folgende Beispiel zeigt ein Paket mit dem Bereich dev-repo.

    "name": "@dev-repo/my-package"
    
  2. Aktualisieren Sie das Zugriffstoken für die Verbindung mit dem Repository. google-artifactregistry-auth ist eine Clientbibliothek, die Anmeldedaten für Artifact Registry-Repositories aktualisiert.

    Zum Aktualisieren von Anmeldedaten verwenden Sie eine der folgenden Optionen:

    • Verwenden Sie direkt npx, um das Zugriffstoken zu aktualisieren. Wenn Sie npm ab Version 5.2.0 verwenden, ist es in npm enthalten.

      1. Die Anmeldedaten für die Verbindung zur öffentlichen npm-Registry befinden sich in der npm-Konfigurationsdatei des Nutzers ~/.npmrc.

      2. Führen Sie den folgenden Befehl in dem Ordner über dem npm-Projekt aus.

      npx google-artifactregistry-auth PROJECT-NPMRC
      

      Dabei ist PROJECT-NPMRC der Pfad zur Datei .npmrc in Ihrem Projektverzeichnis.

      Sie müssen den Befehl außerhalb Ihres Projektverzeichnisses ausführen, damit npx Ihre öffentlichen npm-Registry-Anmeldedaten in ~/.npmrc verwendet, um google-artifactregistry-auth herunterzuladen.

    • Fügen Sie der Datei package.json in Ihrem Projekt ein Skript hinzu.

      "scripts": {
        "artifactregistry-login": "npx google-artifactregistry-auth"
      }
      
      npm run artifactregistry-login PROJECT-NPMRC --registry https://registry.npmjs.org/
      

      Dabei ist PROJECT-NPMRC der Pfad zur Datei .npmrc in Ihrem Projektverzeichnis.

    • Für Versionen von npm, die älter als 5.2.0 sind, führen Sie die folgenden Schritte aus:

      1. Führen Sie diesen Befehl aus:
      npm install google-artifactregistry-auth --save-dev --registry https://registry.npmjs.org/
      
      1. Fügen Sie die Datei einem Authentifizierungsskript hinzu:
      "scripts": {
          "artifactregistry-login": "./node_modules/.bin/artifactregistry-auth",
      }
      

      Skript ausführen

      npm run artifactregistry-login PROJECT-NPMRC
      

      Dabei ist PROJECT-NPMRC der Pfad zur Datei .npmrc in Ihrem Projektverzeichnis.

  3. Fügen Sie dem Repository Pakete hinzu. Sie können dazu einen npm- oder yarn-Befehl verwenden.

    npm publish
    
    yarn publish
    

Pakete und Versionen ansehen

Führen Sie den entsprechenden Befehl aus, um Paketinformationen mit npm oder yarn abzurufen:

npm view
yarn info

So rufen Sie die Pakete und Paketversionen mit der Google Cloud Console oder gcloud ab:

Console

  1. Öffnen Sie in der Cloud Console die Seite Repositories.

    Zur Seite „Repositories“

  2. Klicken Sie in der Liste der Repositories auf das entsprechende Repository.

    Auf der Seite Pakete sind die Pakete des Repositorys aufgeführt.

  3. Klicken Sie auf das Paket, um die Versionen des Pakets aufzurufen.

gcloud

Führen Sie den folgenden Befehl aus, um die Pakete in einem Repository aufzulisten:

gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]

Wo

  • REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.
  • LOCATION ist ein regionaler oder multiregionaler Speicherort. Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standard-Speicherort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.

Um die Versionen für ein Paket aufzurufen, führen Sie folgenden Befehl aus:

gcloud artifacts versions list --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION]

Wo

  • PACKAGE ist die ID des Pakets oder die vollqualifizierte Kennzeichnung für das Paket.
  • REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.
  • LOCATION ist ein regionaler oder multiregionaler Speicherort. Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standard-Speicherort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.

Pakete taggen

Sie können Tags aufrufen, hinzufügen, aktualisieren und löschen.

Tags aufrufen

So rufen Sie Tags für ein Paket auf:

Console

  1. Öffnen Sie in der Cloud Console die Seite Repositories.

    Zur Seite „Repositories“

  2. Klicken Sie auf das Paket, um die Versionen und die zugehörigen Tags aufzurufen.

  3. Wählen Sie die Paketversion aus, die getaggt werden soll.

  4. Klicken Sie in der Zeile der ausgewählten Version auf Weitere Aktionen (Weitere Aktionen) und dann auf Tags bearbeiten.

  5. Geben Sie neue Tags in das Feld ein und klicken Sie danach auf SPEICHERN.

gcloud

Führen Sie diesen Befehl aus:

gcloud artifacts tags list --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION]

Dabei gilt:

  • PACKAGE ist der Name des Pakets im Repository.
  • REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.
  • LOCATION ist ein regionaler oder multiregionaler Speicherort. Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standard-Speicherort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.

Beispielsweise werden mit dem folgenden Befehl die Tags für das Paket my-package im Repository my-repo am Standard-Speicherort angezeigt:

gcloud artifacts tags list --package=my-pkg --repository=my-repo

Tags erstellen

Sie können ein Tag für eine bestimmte Version eines Pakets erstellen.

So taggen Sie ein vorhandenes Image in einem Repository:

Console

  1. Öffnen Sie in der Cloud Console die Seite Repositories.

    Zur Seite „Repositories“

  2. Klicken Sie auf das Paket, um die Versionen des Pakets aufzurufen.

  3. Wählen Sie die Paketversion aus, die getaggt werden soll.

  4. Klicken Sie in der Zeile der ausgewählten Version auf Weitere Aktionen (Weitere Aktionen) und dann auf Tags bearbeiten.

  5. Geben Sie neue Tags in das Feld ein und klicken Sie danach auf SPEICHERN.

gcloud

Führen Sie folgenden Befehl aus:

gcloud artifacts tags create TAG --package=PACKAGE \
    version=VERSION [--location=LOCATION] [--repository=REPOSITORY]

Dabei gilt:

  • TAG ist das Tag, das Sie auf das Paket anwenden möchten.
  • PACKAGE ist der Name des Pakets im Repository.
  • VERSION ist die Version des Pakets, das Sie taggen möchten.
  • LOCATION ist ein regionaler oder multiregionaler Speicherort. Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standard-Speicherort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.
  • REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.

Mit dem folgenden Befehl wird beispielsweise das Tag release-candidate für die Version 1.0.0 des Pakets my-package im Repository my-repo am Standard-Speicherort erstellt:

gcloud artifacts tags create release-candidate --version=1.0.0 \
    --package=my-pkg --repository=my-repo

Tags aktualisieren

Sie können ein Tag ändern, das einer Paketversion zugeordnet ist.

So ändern Sie ein vorhandenes Tag:

Console

  1. Öffnen Sie in der Cloud Console die Seite Repositories.

    Zur Seite „Repositories“

  2. Klicken Sie auf das Paket, um die Versionen des Pakets aufzurufen.

  3. Wählen Sie die Paketversion mit dem Tag aus, das geändert werden soll.

  4. Klicken Sie in der Zeile der ausgewählten Version auf Weitere Aktionen (Weitere Aktionen) und dann auf Tags bearbeiten.

  5. Bearbeiten Sie das Tag und klicken Sie danach auf SPEICHERN.

gcloud

Führen Sie folgenden Befehl aus:

gcloud artifacts tags update TAG --package=PACKAGE \
    version=VERSION [--location=LOCATION] [--repository=REPOSITORY]

Dabei gilt:

  • TAG ist das Tag, das Sie auf das Paket anwenden möchten.
  • PACKAGE ist der Name des Pakets im Repository.
  • VERSION ist die Version des Pakets, das Sie taggen möchten.
  • LOCATION ist ein regionaler oder multiregionaler Speicherort. Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standard-Speicherort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.
  • REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.

Mit dem folgenden Befehl wird beispielsweise das Tag 1.0.0 für die Version my-package des Pakets production im Repository my-repo am Standard-Speicherort geändert:

gcloud artifacts tags update production --version=1.0.0 \
    --package=my-pkg --repository=my-repo

Tags von Paketversionen entfernen

Sie können ein vorhandenes Tag aus einer Paketversion entfernen.

So entfernen Sie ein Tag:

Console

  1. Öffnen Sie in der Cloud Console die Seite Repositories.

    Zur Seite „Repositories“

  2. Klicken Sie auf das Image, um die Versionen des Images aufzurufen.

  3. Wählen Sie die Image-Version aus, dessen Tag entfernt werden soll.

  4. Klicken Sie in der Zeile der ausgewählten Version auf Weitere Aktionen (Weitere Aktionen) und dann auf Tags bearbeiten.

  5. Löschen Sie das Tag und klicken Sie danach auf SPEICHERN.

gcloud

Führen Sie folgenden Befehl aus:

gcloud artifacts tags delete TAG --package=PACKAGE \
    [--location=<LOCATION] [--repository=REPOSITORY]

Dabei gilt:

  • TAG ist das Tag, das Sie auf das Paket anwenden möchten.
  • PACKAGE ist der Name des Pakets im Repository.
  • LOCATION ist ein regionaler oder multiregionaler Speicherort. Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standard-Speicherort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.
  • REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.

Beispielsweise wird mit dem folgenden Befehl das Tag release-candidate aus dem Paket my-package im Repository my-repo am Standard-Speicherort entfernt:

gcloud artifacts tags delete release-candidate --package=my-pkg \
    --repository=my-repo

Pakete installieren

Ein Paket aus dem npm-Repository kann mit dem Befehl npm install oder yarn add installiert werden.

npm install @SCOPE/PACKAGE
yarn add @SCOPE/PACKAGE

Dabei gilt:

  • SCOPE ist der mit dem Repository verknüpfte Bereich.
  • PACKAGE ist der Name des Pakets im Repository.

Wenn das npm-Repository nicht mit einem Bereich konfiguriert ist, lassen Sie den Bereich aus dem Befehl weg:

npm install PACKAGE
yarn add PACKAGE

Wenn Sie ein Paket als Abhängigkeit in package.json angeben, muss der Bereich für das Repository enthalten sein. Das folgende Beispiel zeigt den Bereich @dev-repo für ein Paket mit dem Namen my-package.

"dependencies": {
  "@dev-repo/my-package": ">=1.0.0"
}

Pakete löschen

Bevor Sie ein Paket oder eine Paketversion löschen, prüfen Sie, ob Sie alle wichtigen Abhängigkeiten davon kommuniziert oder behoben haben.

Nach der Veröffentlichung einer Paketversion können Sie ein Paket mit demselben Namen und derselben Versionskombination nicht noch einmal veröffentlichen, auch wenn diese Version gelöscht wurde. Dies ist eine npm-Einschränkung, damit der Inhalt einer veröffentlichten Paketversion immer gleich ist.

Wenn Sie die Nutzer auffordern möchten, eine aktualisierte Paketversion zu installieren, verwenden Sie den Befehl npm deprecate, um die alte Version des Pakets als verworfen zu kennzeichnen. Wenn ein Nutzer versucht, das verworfene Paket zu installieren, gibt Artifact Registry eine Warnung zurück, dass diese Version verworfen wurde.

So löschen Sie ein Paket:

Console

  1. Öffnen Sie in der Cloud Console die Seite Repositories.

    Zur Seite „Repositories“

  2. Klicken Sie in der Liste der Repositories auf das entsprechende Repository.

    Auf der Seite Pakete sind die Pakete des Repositorys aufgeführt.

  3. Wählen Sie das Paket aus, das Sie löschen möchten.

  4. Klicken Sie auf Löschen.

  5. Klicken Sie im Bestätigungsdialogfeld auf Löschen.

gcloud

Führen Sie folgenden Befehl aus:

gcloud artifacts packages delete PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] [--async]

Wo

  • PACKAGE ist der Name des Pakets im Repository.
  • REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.
  • LOCATION ist ein regionaler oder multiregionaler Speicherort. Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standard-Speicherort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.
  • --async wird sofort zurückgegeben, ohne auf den Abschluss des Vorgangs zu warten.

So löschen Sie Versionen eines Pakets:

Console

  1. Öffnen Sie in der Cloud Console die Seite Repositories.

    Zur Seite „Repositories“

  2. Klicken Sie in der Liste der Repositories auf das entsprechende Repository.

    Auf der Seite Pakete sind die Pakete des Repositorys aufgeführt.

  3. Klicken Sie auf das Paket, um die Versionen des Pakets aufzurufen.

  4. Wählen Sie die Versionen aus, die Sie löschen möchten.

  5. Klicken Sie auf Löschen.

  6. Klicken Sie im Bestätigungsdialogfeld auf Löschen.

gcloud

Führen Sie folgenden Befehl aus:

gcloud artifacts versions delete VERSION \
    --package=PACKAGE \
    [--repository=REPOSITORY] [--location=LOCATION] \
    [--async]

Wo

  • PACKAGE ist der Name des Pakets im Repository.
  • REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.
  • LOCATION ist ein regionaler oder multiregionaler Speicherort. Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standard-Speicherort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.
  • --async wird sofort zurückgegeben, ohne auf den Abschluss des Vorgangs zu warten.

Nächste Schritte