Node.js-Pakete in Artifact Registry speichern
In dieser Kurzanleitung erfahren Sie, wie Sie ein privates Node.js-Paket-Repository für Artifact Registry einrichten und ein Paket in dieses hochladen.
Hinweise
- Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Artifact Registry API aktivieren.
- Installieren Sie die Google Cloud CLI.
-
Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Artifact Registry API aktivieren.
- Installieren Sie die Google Cloud CLI.
-
Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:
gcloud init
- Installieren Sie PowerShell, wenn Sie über Windows eine Verbindung zu einem Node.js-Paket-Repository herstellen möchten.
Cloud Shell starten
In dieser Kurzanleitung verwenden Sie Cloud Shell, eine Shell-Umgebung zum Verwalten von Ressourcen, die in Google Cloud gehostet werden.
In Cloud Shell ist die Google Cloud CLI vorinstalliert. Die gcloud CLI bietet die primäre Befehlszeilenschnittstelle für Google Cloud.
Cloud Shell aufrufen
Rufen Sie die Google Cloud Console auf.
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-Paket-Repository erstellen
Erstellen Sie das Repository für Ihre Node.js-Artefakte:
Im Folgenden wird gezeigt, wie Sie das Repository anlegen.
Console
Öffnen Sie in der Cloud Console die Seite Repositories.
Klicken Sie auf Repository erstellen.
Geben Sie
quickstart-nodejs-repo
als Repository-Namen an.Wählen Sie als Format npm und als Modus Standard aus.
Wählen Sie unter Standorttyp die Option Region und dann den Standort
us-central1
aus.Klicken Sie auf Erstellen.
Das Repository wird der Repository-Liste hinzugefügt.
gcloud
Führen Sie den folgenden Befehl aus, um ein neues Node.js-Paket-Repository namens
quickstart-nodejs-repo
am Standortus-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"
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
.Um die
gcloud
-Befehle zu vereinfachen, legen Sie für das Standard-Repository den Wertquickstart-nodejs-repo
und für den Standard-Speicherortus-central1
fest. Nachdem Sie die Werte festgelegt haben, müssen Sie diese nicht mehr ingcloud
-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
Zum Hochladen und Herunterladen von Paketen müssen Sie Ihre npm-Projekte mit Einstellungen zur Authentifizierung bei dem von Ihnen erstellten Repository konfigurieren. Für diese Kurzanleitung laden Sie ein einfaches Paket hoch und installieren es dann als Abhängigkeit in einem zweiten Paket.
Laden Sie das Paket emoji-regex herunter. Dieses einfache Paket enthält einen regulären Ausdruck für alle Emoji-Symbole und -sequenzen.
npm pack emoji-regex
Mit dem Befehl wird ein Archiv des Pakets heruntergeladen.
Extrahieren Sie das Archiv in ein
emoji-regex
-Verzeichnis. Der folgende Befehl gilt für ein Archiv deremoji-regex
-Version 10.1.0:mkdir emoji-regex && tar xvf emoji-regex-10.1.0.tgz -C emoji-regex --strip-components 1
Erstellen Sie ein zweites npm-Paket, mit dem Sie das Paket
emoji-regex
aus Artifact Registry installieren. Verwenden Sie für dieses Paket den Befehlnpm init
, um ein Basispaket zu erstellen.mkdir npm-package2 cd npm-package2 npm init -y
Übernehmen Sie die Standardwerte, wenn Sie dazu aufgefordert werden.
Konfigurieren Sie die Projekte
emoji-regex
undnpm-package2
so, dass sie sich mit dem von Ihnen erstellten Artifact Registry-Repository authentifizieren.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 so aus: PROJECT ist Ihre Google Cloud-Projekt-ID.@quickstart:registry=https://us-central1-npm.pkg.dev/PROJECT/quickstart-nodejs-repo/ //us-central1-npm.pkg.dev/PROJECT/quickstart-nodejs-repo/:always-auth=true
Fügen Sie in jedem npm-Projekt die Konfigurationseinstellungen aus dem vorherigen Schritt in die Projektdatei
.npmrc
ein. Die Datei befindet sich im selben Verzeichnis wie die Dateipackage.json
.Weitere Informationen zur Datei
.npmrc
finden Sie in der Übersicht zu Node.js.Jedes Node.js-Paket-Repository für Artifact Registry ist einem npm-Registry-Endpunkt
https://LOCATION-npm.pkg.dev/PROJECT/REPOSITORY
zugeordnet. Wenn Sie ein anderes Artifact Registry-Node.js-Paket-Repository erstellen, interagiert npm mit diesem als separate Registry mit eigenem Bereich.
Bearbeiten Sie
package.json
im Projektemoji-regex
undnpm-package2
.Achten Sie darauf, dass der Wert für
name
den Bereichquickstart
enthält.- Für
emoji-regex
:
"name": "@quickstart/emoji-regex"
- Für
npm-package2
:
"name": "@quickstart/npm-package2"
- Für
Fügen Sie unter
scripts
ein Skript für google-artifactregistry-auth hinzu, eine Clientbibliothek, die die Anmeldedaten für Artifact Registry-Repositories aktualisiert."scripts": { "artifactregistry-login": "npx google-artifactregistry-auth" }
Paket in das Repository hochladen
Aktualisieren Sie das Zugriffstoken für die Verbindung mit dem Repository.
npm run artifactregistry-login
Fügen Sie das Paket dem Repository hinzu. Sie können dazu einen
npm
- oderyarn
-Befehl verwenden.npm publish
yarn publish
Paket im Repository aufrufen
So prüfen Sie, ob das Paket dem Repository hinzugefügt wurde:
Console
Öffnen Sie in der Cloud Console die Seite Repositories.
Klicken Sie in der Repository-Liste auf das Repository
quickstart-nodejs-repo
.Auf der Seite Pakete sind die Pakete des Repositorys aufgeführt.
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
Installieren Sie das Paket emoji-regex
aus Ihrem Artifact Registry-Repository 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
Der Befehl installiert das Paket emoji-regex
im Projekt npm-package2
.
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 auf dieser Seite 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
Öffnen Sie in der Cloud Console die Seite Repositories.
Wählen Sie in der Repository-Liste das Repository
quickstart-nodejs-repo
aus.Klicken Sie auf Löschen.
gcloud
Um das Repository
quickstart-nodejs-repo
zu löschen, führen Sie folgenden Befehl aus:gcloud artifacts repositories delete quickstart-nodejs-repo
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
- Authentifizierung konfigurieren
- Repositories verwalten
- Pakete verwalten
- Lesen Sie unser Infomaterial zu DevOps und informieren Sie sich über unser Forschungsprogramm.