Go-Module in Artifact Registry speichern
Privates Artifact Registry Go-Repository einrichten, ein Modul in dieses hochladen und das Modul als Abhängigkeit verwenden.
Hinweise
-
Melden Sie sich bei Ihrem Google-Konto an.
Wenn Sie noch kein Konto haben, melden Sie sich hier für ein neues Konto an.
-
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 Go 1.15 oder höher.
- Installieren Sie das gcloud CLI-Add-on
package-go-module
:
gcloud components install package-go-module
Repository erstellen
So erstellen und konfigurieren Sie ein neues Repository:
Führen Sie den folgenden Befehl aus, um ein neues Repository zu erstellen:
gcloud artifacts repositories create REPOSITORY \ --repository-format=go \ --location=LOCATION \ --description=DESCRIPTION
Ersetzen Sie Folgendes:
- REPOSITORY ist der Name des Repositorys. Repository-Namen können für jeden Repository-Speicherort in einem Projekt nur einmal vorkommen.
- LOCATION ist der regionale oder multiregionale Standort für das Repository. Sie können dieses Flag weglassen, wenn Sie einen Standardwert festlegen.
Führen Sie den Befehl
gcloud artifacts locations list
aus, um eine Liste der unterstützten Standorte aufzurufen. - DESCRIPTION ist eine optionale Beschreibung des Repositorys. Geben Sie keine sensiblen Daten an, da Repository-Beschreibungen nicht verschlüsselt sind.
Führen Sie den folgenden Befehl aus, um die Repository-Details aufzurufen.
gcloud artifacts repositories describe --location=LOCATION REPOSITORY
Die Ausgabe sollte so aussehen:
Encryption: Google-managed key Repository Size: 0.000MB createTime: '2022-06-03T20:20:01.644813Z' format: GO mode: STANDARD_REPOSITORY name: projects/my-project/locations/us-west1/repositories/my-repo updateTime: '2022-06-03T20:20:01.644813Z'
Standardeinstellungen für gcloud-Befehle festlegen
Sie können Ihre gcloud CLI
-Befehle vereinfachen, indem Sie die Standardeinstellungen für Projekt-, Repository- und Standortwerte konfigurieren. Wenn die Standardeinstellungen konfiguriert sind, werden --project
-, --location
- und --repository
-Tags nicht mehr benötigt.
Go-Modul verpacken und hochladen
Das gcloud CLI-Add-on package-go-module
bündelt Ihre Go-Module, sodass Sie mit dem Befehl gcloud
Versionen erstellen und in Artifact Registry hochladen können.
Go-Modul erstellen
Erstellen Sie zuerst ein einfaches Go-Modul zum Hochladen in Ihr Repository.
Erstellen Sie in Ihrem Basisverzeichnis ein Verzeichnis namens „foo“ für Ihr Modul
mkdir foo
Wechseln Sie in das Verzeichnis Ihres Moduls und führen Sie
go mod init
aus, um eine go.mod-Datei für das Modul zu erstellen.cd foo \ go mod init example.com/foo
Ersetzen Sie
example.com/foo
durch den Modulpfad. Weitere Informationen finden Sie in der Referenz zu Go-Modulen.Erstellen Sie in Ihrem foo-Verzeichnis eine
foo.go
-Datei mit folgendem Inhalt:package foo const HelloWorld = "Hello World!"
Paket verpacken und Modul hochladen
Verpacken Sie das Modul und laden Sie es in Ihr Repository hoch:
gcloud artifacts go upload --project=PROJECT \ --repository=REPOSITORY \ --location=LOCATION \ --module-path=example.com/foo \ --version=VERSION \ --source=SOURCE_LOCATION
Ersetzen Sie Folgendes:
- PROJECT durch ihre Google Cloud-Projekt-ID.
- REPOSITORY durch den Namen des Repositorys, in dem das Paket gespeichert ist.
- LOCATION durch den regionalen oder multiregionalen Standort des Repositorys.
example.com/foo
durch den Modulpfad. Weitere Informationen finden Sie in der Referenz zu Go-Modulen.- VERSION durch die semantische Version des Moduls im Format
vX.Y.Z
, wobeiX
die Hauptversion,Y
die Nebenversion undZ
die Patchversion ist. - SOURCE_LOCATION durch den Pfad zum Stammverzeichnis Ihres Go-Moduls. Wenn Sie das Flag
--source
weglassen, wird standardmäßig das aktuelle Verzeichnis verwendet.
Das Modul wird in Artifact Registry hochgeladen.
Weitere Informationen zum Erstellen von Go-Modulen finden Sie in dieser Anleitung.
Module auflisten
Führen Sie den folgenden Befehl aus, um das hochgeladene Go-Modul im Standardprojekt, im Repository und am Speicherort zu prüfen, wenn die Standardwerte konfiguriert sind:
gcloud artifacts packages list
Die Ausgabe sollte so aussehen:
Listing items under project my-project, location us-west1, repository my-repo. PACKAGE CREATE_TIME UPDATE_TIME example.com/foo 2022-06-03T20:43:39 2022-06-20T20:37:40
Details zur Modulversion ansehen
Führen Sie den folgenden Befehl aus, um die Versionen Ihres Moduls im Standardprojekt, im Repository und am Speicherort anzusehen, wenn die Standardwerte konfiguriert sind:
gcloud artifacts versions list --package=MODULE_PATH
Die Ausgabe sollte so aussehen:
Listing items under project my-project, location us-west1, repository my-repo, package example.com/foo. VERSION DESCRIPTION CREATE_TIME UPDATE_TIME v0.1.0 2022-06-03T20:43:39 2022-06-03T20:43:39 v0.1.1 2022-06-20T20:37:40 2022-06-20T20:37:40
Module herunterladen
Zum Importieren von Modulen, die in Artifact Registry gespeichert sind, müssen Sie Go anweisen, nach Abhängigkeiten aus Artifact Registry zu suchen und die Prüfsummendatenbank zu umgehen.
Go-Umgebung einrichten
Weisen Sie Go an, Module aus Artifact Registry, dem öffentlichen Go-Modulproxy und der Quelle in dieser Reihenfolge herunterzuladen:
export GOPROXY=https://LOCATION-go.pkg.dev/PROJECT/REPOSITORY,https://proxy.golang.org,direct
Ersetzen Sie Folgendes:
- LOCATION ist der regionale oder multiregionale Standort des Repositorys.
- PROJECT ist Ihre Google Cloud-Projekt-ID.
- REPOSITORY ist der Name des Repositorys, in dem das Paket gespeichert ist.
Schließen Sie Ihr Modul von der Prüfung mit der öffentlichen Prüfsummendatenbank aus:
export GONOSUMDB=MODULE_PATH_REGEX
Ersetzen Sie MODULE_PATH_REGEX durch Ihren Modulpfad oder einen regulären Ausdruck, wenn Sie mehrere Module ausschließen möchten.
Führen Sie den folgenden Befehl aus, um auszuschließen, dass das Modul
example.com/foo
mit der öffentlichen Prüfsummendatenbank geprüft wird:export GONOSUMDB=example.com/foo
Wenn Sie möchten, dass alle Module mit Modulpfaden, die mit
example.com
beginnen, von der Prüfung mit der öffentlichen Prüfsummendatenbank ausgeschlossen werden sollen, führen Sie den folgenden Befehl aus:export GONOSUMDB=example.com/*
Bei Artifact Registry authentifizieren
Beim Herunterladen gepackter Go-Module, die als Abhängigkeiten von Artifact Registry verwendet werden sollen, verwendet das Go-Binärprogramm die Anmeldedaten in Ihrer netrc-Datei zur Authentifizierung bei Artifact Registry. Sie können den Authentifizierungsprozess vereinfachen, indem Sie mit Go Credential Helper die Tokens in Ihrer Netrc-Datei für die Authentifizierung bei Artifact Registry aktualisieren.
Der Speicherort der netrc-Datei kann mit der Umgebungsvariable netrc festgelegt werden.
Wenn die Variable NETRC
nicht festgelegt ist, liest der go
-Befehl $HOME/.netrc
auf UNIX-ähnlichen Plattformen oder %USERPROFILE%\_netrc
unter Windows.
Artifact Registry unterstützt die folgenden Authentifizierungsmethoden.
- Kurzlebige Anmeldedaten (empfohlen)
- Verwenden Sie das Go Credential Helper-Tool von Artifact Registry, um die Authentifizierungstokens in Ihrer netrc-Datei zu aktualisieren.
- Dienstkontoschlüssel verwenden
Verwenden Sie diese Option, wenn Sie in Ihrer Umgebung keine Anmeldedaten zur Authentifizierung verwenden können. Fügen Sie der netrc-Datei den unverschlüsselten Dienstkontoschlüssel hinzu.
Go Credential Helper zu GONOPROXY
hinzufügen
Bevor Sie Go Credential Helper verwenden können, müssen Sie es der Liste GONOPROXY
hinzufügen, damit Go es direkt von GitHub herunterlädt. Wenn Sie weitere Module direkt aus der Quelle herunterladen möchten, können Sie sie in eine durch Kommas getrennte Liste einfügen, wie im folgenden Beispiel gezeigt:
export GONOPROXY=MODULE_PATH1, MODULE_PATH2
Dabei sind MODULE_PATH1 und MODULE_PATH2 Modulpfade der Module, die aus der Quelle heruntergeladen werden sollen.
So fügen Sie Go Credential Helper Ihrer GONOPROXY
-Liste hinzu und führen es aus, um Ihre Anmeldedaten einzurichten:
Go Credential Helper zu
GONOPROXY
hinzufügenexport GONOPROXY=github.com/GoogleCloudPlatform/artifact-registry-go-tools
Führen Sie den folgenden Befehl aus, um Ihre Artifact Registry-Anmeldedaten mit dem Go-Modulpakettool zu Ihrer Netrc-Datei hinzuzufügen:
GOPROXY=proxy.golang.org \ go run github.com/GoogleCloudPlatform/artifact-registry-go-tools/cmd/auth@v0.1.0 \ add-locations --locations=LOCATION \ [--json_key=path/to/service/account/key.json]
Dabei ist LOCATION der regionale oder multiregionale Standort Ihres Repositorys. Wenn Sie mehrere Standorte hinzufügen möchten, geben Sie sie als durch Kommas getrennte Liste ein.
Go Credential Helper fügt Ihrer Netrc-Datei Einstellungen für die Authentifizierung bei Artifact Registry hinzu. Wenn Sie das Flag
--json_key
übergeben, wird der Schlüssel zur Passwortauthentifizierung der netrc-Datei hinzugefügt.
Modul als Abhängigkeit verwenden
Wenn Sie kurzlebige Anmeldedaten für die Authentifizierung bei Artifact Registry verwenden, müssen Sie Ihr OAuth-Token aktualisieren. Dazu führen Sie den folgenden Befehl aus:
GOPROXY=proxy.golang.org \ go run github.com/GoogleCloudPlatform/artifact-registry-go-tools/cmd/auth@v0.1.0 refresh
Erstellen Sie im Basisverzeichnis ein Verzeichnis mit dem Namen „bar“.
mkdir bar
Wechseln Sie in das Verzeichnis Ihres Moduls und führen Sie
go mod init
aus, um einego.mod
-Datei für Ihr Paket zu erstellen.cd bar \ go mod init example.com/bar
Ersetzen Sie
example.com/bar
durch den Modulpfad. Weitere Informationen finden Sie in der Referenz zu Go-Modulen.Wenn Sie die in Artifact Registry gespeicherte Version von foo verlangen möchten, bearbeiten Sie die Datei
go.mod
in etwa so:module example.com/bar go 1.19 require example.com/foo v0.1.0
Ersetzen Sie Folgendes:
example.com/foo
ist der Modulpfad des erforderlichen Modulsv0.1.0
ist die in Artifact Registry gespeicherte Version
Erstellen Sie in Ihrem
bar
-Verzeichnis einemain.go
-Datei mit folgendem Inhalt:package main import ( "fmt" foo "example.com/foo" ) func main() { fmt.Println(foo.HelloWorld) }
Führen Sie go mod tidy aus, um Abhängigkeiten herunterzuladen, einschließlich des Pakets foo:
go mod tidy
Führen Sie das Balkenmodul aus:
go run .
Die Ausgabe sollte so aussehen:
Hello World!
Bereinigen
Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud-Konto die auf dieser Seite verwendeten Ressourcen in Rechnung gestellt werden.
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 des Repositorys, ob alle Module, die Sie behalten möchten, an einem anderen Speicherort verfügbar sind.
So löschen Sie das Repository:
gcloud artifacts repositories delete \ --location=LOCATION \ --project=PROJECT \ REPOSITORY
Ersetzen Sie Folgendes:
- LOCATION durch den regionalen oder multiregionalen Standort des Repositorys.
- PROJECT durch ihre Google Cloud-Projekt-ID.
- REPOSITORY durch den Namen des Repositorys.
Wenn Sie die Standardeinstellungen für das Repository und den Standort entfernen möchten, die Sie für die aktive gcloud-Konfiguration konfiguriert haben, führen Sie die folgenden Befehle aus:
gcloud config unset artifacts/repository gcloud config unset artifacts/location
Nächste Schritte
- Weitere Informationen zum Konfigurieren der Authentifizierung
- Weitere Informationen zum Verwalten von Repositories
- Weitere Informationen zum Verwalten von Go-Modulen
- Hier finden Sie unsere Ressourcen zu DevOps und das Forschungsprogramm DevOps Research and Assessment.