Node.js-Pakete in Artifact Registry speichern

In dieser Kurzanleitung erfahren Sie, wie Sie ein privates Node.js in Artifact Registry einrichten Paket-Repository und laden ein Paket in dieses hoch.

Hinweise

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Artifact Registry API.

    Enable the API

  5. Install the Google Cloud CLI.

  6. To initialize the gcloud CLI, run the following command: 

    gcloud init

  7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  8. Make sure that billing is enabled for your Google Cloud project.

  9. Enable the Artifact Registry API.

    Enable the API

  10. Install the Google Cloud CLI.

  11. To initialize the gcloud CLI, run the following command: 

    gcloud init
  12. Installieren Sie PowerShell, wenn Sie eine Verbindung zu einem Node.js-Paket-Repository aus Windows

Cloud Shell starten

In dieser Kurzanleitung verwenden Sie Cloud Shell, eine Shell-Umgebung für die Verwaltung von Ressourcen, die in Google Cloud gehostet werden.

In Cloud Shell ist das Google Cloud CLI Die gcloud CLI stellt die primäre Befehlszeile für Google Cloud bereit.

Cloud Shell aufrufen

  1. Rufen Sie die Google Cloud Console auf.

    Google Cloud Console

  2. Klicken Sie in der Symbolleiste der Google Cloud Console auf Cloud Shell aktivieren:

In einem Frame im unteren Teil der Console wird eine Cloud Shell-Sitzung geöffnet. Mit dieser Shell führen Sie gcloud-Befehle aus.

Node.js-Package Repository erstellen

Erstellen Sie das Repository für Ihre Node.js-Artefakte:

  1. Im Folgenden wird gezeigt, wie Sie das Repository anlegen.

    Console

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

      Zur Seite „Repositories“

    2. Klicken Sie auf Repository erstellen.

    3. Geben Sie quickstart-nodejs-repo als Repository-Namen an.

    4. Wählen Sie npm als Format und Standard als Modus aus.

    5. Wählen Sie unter Standorttyp die Option Region und dann den Standort us-central1 aus.

    6. Klicken Sie auf Erstellen.

    Das Repository wird der Repository-Liste hinzugefügt.

    gcloud

    1. Führen Sie den folgenden Befehl aus, um ein neues Node.js-Paket-Repository mit dem Namen quickstart-nodejs-repo am Speicherort us-central1 mit der Beschreibung „Node.js-Repository“ zu erstellen.

      gcloud artifacts repositories create quickstart-nodejs-repo --repository-format=npm \
--location=us-central1 --description="Node.js package repository"

    2. Führen Sie den folgenden Befehl aus, um zu prüfen, ob Ihr Repository erstellt wurde:

      gcloud artifacts repositories list

    Weitere Informationen zu Artifact Registry-Befehlen erhalten Sie mit dem Befehl gcloud artifacts.

  2. Um die gcloud-Befehle zu vereinfachen, legen Sie für das Standard-Repository den Wert quickstart-nodejs-repo und für den Standard-Speicherort us-central1 fest. Nachdem Sie die Werte festgelegt haben, müssen Sie diese nicht mehr in gcloud-Befehlen angeben, für die ein Repository oder Speicherort erforderlich ist.

    Um das Repository festzulegen, führen Sie folgenden Befehl aus:

    gcloud config set artifacts/repository quickstart-nodejs-repo

    Führen Sie den folgenden Befehl aus, um den Standort festzulegen:

    gcloud config set artifacts/location us-central1

    Weitere Informationen zu diesen Befehlen finden Sie in der Dokumentation zu gcloud config set.

npm konfigurieren

Wenn Sie Pakete hoch- und herunterladen möchten, müssen Sie Ihre npm-Projekte mit Einstellungen konfigurieren, um sich beim von Ihnen erstellten Repository zu authentifizieren. In dieser Kurzanleitung laden Sie ein einfaches Paket hoch und installieren es in einem zweiten Paket als Abhängigkeit.

  1. Laden Sie das einfache Paket emoji-regex herunter, stellt einen regulären Ausdruck für alle Emoji-Symbole und -Sequenzen bereit.

    npm pack emoji-regex

    Mit dem Befehl wird ein Archiv des Pakets heruntergeladen.

  2. Extrahieren Sie das Archiv in ein emoji-regex-Verzeichnis. Der folgende Befehl lautet für ein Archiv der emoji-regex-Version 10.1.0:

    mkdir emoji-regex && tar xvf emoji-regex-10.1.0.tgz -C emoji-regex --strip-components 1

  3. Erstellen Sie ein zweites npm-Paket, mit dem Sie das emoji-regex-Paket aus der Artifact Registry installieren. Verwende für dieses Paket die Methode npm init zum Erstellen eines Basispakets.

    mkdir npm-package2
cd npm-package2

npm init -y

    Wenn Sie dazu aufgefordert werden, übernehmen Sie die Standardwerte.

  4. Die beiden Projekte emoji-regex und npm-package2 für die Authentifizierung konfigurieren durch das von Ihnen erstellte Artifact Registry-Repository.

    1. Führen Sie den folgenden Befehl aus: Der Befehl gibt Konfigurationseinstellungen zurück, die Ihrer npm-Konfigurationsdatei hinzugefügt werden können.

      gcloud artifacts print-settings npm --scope=@quickstart

      Der Bereich quickstart ist mit Ihrem Repository verknüpft. Wenn Sie den Bereich in Befehle zum Veröffentlichen oder Installieren von Paketen einfügen, verwendet npm Ihr Repository. Wenn Sie Pakete ohne Bereich veröffentlichen oder installieren, wird Ihr konfiguriertes Standard-Repository verwendet. Weitere Informationen finden Sie in der Übersicht zu Node.js.

      Die Ausgabe des Befehls gcloud sieht in etwa so aus: PROJECT ist die ID Ihres Google Cloud-Projekts.

      @quickstart:registry=https://us-central1-npm.pkg.dev/PROJECT/quickstart-nodejs-repo/
//us-central1-npm.pkg.dev/PROJECT/quickstart-nodejs-repo/:always-auth=true

    2. Fügen Sie dem Projekt die Konfigurationseinstellungen aus dem vorherigen Schritt hinzu .npmrc-Datei in jedem npm-Projekt. Die Datei befindet sich im selben Verzeichnis wie die Datei package.json.

      Weitere Informationen zur Datei .npmrc finden Sie in der Übersicht zu Node.js.

      Jedes Node.js-Paket-Repository in Artifact Registry ist mit einem npm-Registry-Endpunkt https://LOCATION-npm.pkg.dev/PROJECT/REPOSITORY verknüpft. Wenn Sie ein weiteres Node.js-Paket-Repository für Artifact Registry erstellen, nutzt npm dieses Repository als separate Registry mit eigenem Bereich.

  5. Bearbeiten Sie package.json sowohl im Projekt emoji-regex als auch im Projekt npm-package2.

    1. Achten Sie darauf, dass der Wert für name den Bereich quickstart enthält.

      • Für emoji-regex:
      "name": "@quickstart/emoji-regex"
      • Für npm-package2:
      "name": "@quickstart/npm-package2"

    2. Fügen Sie unter scripts ein Skript für google-artifactregistry-auth, eine Clientbibliothek zum Aktualisieren der Anmeldedaten für Artifact Registry-Repositories.

      "scripts": {
  "artifactregistry-login": "npx google-artifactregistry-auth"
}

Paket in das Repository hochladen

  1. Aktualisieren Sie das Zugriffstoken für die Verbindung mit dem Repository.

    npm run artifactregistry-login

  2. Fügen Sie das Paket dem Repository hinzu. Sie können dazu einen npm- oder yarn-Befehl verwenden.

    npm publish

    yarn publish

Paket im Repository aufrufen

So prüfen Sie, ob das Paket dem Repository hinzugefügt wurde:

Console

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

    Zur Seite „Repositories“

  2. Klicken Sie in der Repository-Liste auf das Repository quickstart-nodejs-repo.

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

  3. Klicken Sie auf ein Paket, um die Paketversionen aufzurufen.

gcloud

Um die Images im Standard-Repository quickstart-nodejs-repo aufzulisten, führen Sie folgenden Befehl aus:

 gcloud artifacts packages list

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

gcloud artifacts versions list --package=PACKAGE

Dabei ist PACKAGE die Paket-ID.

Pakete installieren

emoji-regex-Paket aus Ihrem Artifact Registry-Repository installieren in npm-package2

Führen Sie im Verzeichnis npm-package2 den Befehl npm install oder yarn add aus:

npm install @quickstart/emoji-regex

yarn add @quickstart/emoji-regex

Mit dem Befehl wird das emoji-regex-Paket im npm-package2-Projekt installiert. Außerdem wird package.json aktualisiert, um emoji-regex als Abhängigkeit festzulegen.

"dependencies": {
  "@quickstart/emoji-regex": "^10.1.0"
}

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen in Rechnung gestellt werden:

Prüfen Sie vor dem Entfernen eines Repositorys, ob alle Pakete, die Sie beibehalten möchten, an einem anderen Speicherort verfügbar sind.

So löschen Sie das Repository:

Console

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

    Zur Seite „Repositories“

  2. Wählen Sie in der Repository-Liste das Repository quickstart-nodejs-repo aus.

  3. Klicken Sie auf Löschen.

gcloud

  1. Um das Repository quickstart-nodejs-repo zu löschen, führen Sie folgenden Befehl aus:

    gcloud artifacts repositories delete quickstart-nodejs-repo

  2. Wenn Sie die Einstellungen für das Standard-Repository und den Standard-Speicherort entfernen möchten, die Sie für die aktive gcloud-Konfiguration festgelegt haben, führen Sie die folgenden Befehle aus:

    gcloud config unset artifacts/repository
gcloud config unset artifacts/location

Nächste Schritte