Go-Module in Artifact Registry speichern

Privates Artifact Registry-Go-Repository einrichten und Modul hochladen und das Modul als Abhängigkeit verwenden.

Hinweise

  1. Melden Sie sich bei Ihrem Google-Konto an.

    Wenn Sie noch kein Konto haben, melden Sie sich hier für ein neues Konto an.

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

    Go to project selector

  3. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

  4. Artifact Registry API aktivieren.

    Aktivieren Sie die API

  5. Install the Google Cloud CLI.

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

    gcloud init
    7.

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

    Go to project selector

  8. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

  9. Artifact Registry API aktivieren.

    Aktivieren Sie die API

  10. Install the Google Cloud CLI.

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

    gcloud init
    12.
  12. Installieren Sie Go 1.15 oder höher.
  13. Installieren Sie das package-go-module-Add-on für die gcloud CLI: 
    gcloud components install package-go-module

Repository erstellen

So erstellen und konfigurieren Sie ein neues Repository:

  1. 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 Ort für das Repository. Sie können dieses Flag weglassen, wenn Sie default: Führen Sie den folgenden Befehl aus, um eine Liste der unterstützten Standorte aufzurufen: gcloud artifacts locations list
    • DESCRIPTION ist eine optionale Beschreibung des Repositorys. Das sollten Sie nicht tun: enthalten sensible Daten, da Repository-Beschreibungen nicht verschlüsselt sind.

  2. 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 Standardeinstellungen konfigurieren für Projekt-, Repository- und Standortwerte. Nach der Konfiguration der Standardeinstellungen --project-, --location- und --repository-Tags sind nicht erforderlich.

Go-Modul verpacken und hochladen

Das gcloud CLI-Add-on package-go-module erstellt Pakete für Ihre Go-Module, Sie können Versionen mithilfe der gcloud versionieren und in Artifact Registry hochladen. .

Go-Modul erstellen

Erstellen Sie zuerst ein einfaches Go-Modul zum Hochladen in Ihr Repository.

  1. Erstellen Sie in Ihrem Basisverzeichnis ein Verzeichnis namens „foo“. für Ihr Modul

    mkdir foo

  2. Wechseln Sie in das Verzeichnis Ihres Moduls und führen Sie go mod init aus, um ein neues eine go.mod-Datei für Ihr Modul an.

      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 .

  3. 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 der Paket gespeichert.
  • LOCATION durch das regionale oder multiregionale Element Ort des Repositorys.
  • example.com/foo durch den Modulpfad. Weitere Informationen finden Sie in der Referenz zu Go-Modulen .
  • VERSION mit dem semantische Version des Moduls im Format vX.Y.Z, wobei X die Hauptversion und Y die Nebenversion und Z die Patchversion.
  • SOURCE_LOCATION durch den Pfad zum Stammverzeichnis Ihrer Go -Modul. 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 diesem Anleitung

Module auflisten

Führen Sie den folgenden Befehl aus, um das hochgeladene Go-Modul in der Standardeinstellung zu überprüfen Projekt, Repository und Standort, 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 in der Standardeinstellung anzusehen Projekt, Repository und Standort, Standardwerte konfiguriert:

  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

Um in Artifact Registry gespeicherte Module zu importieren, müssen Sie Go anweisen, Abhängigkeiten von Artifact Registry zu ermitteln und den Prüfsummendatenbank.

Go-Umgebung einrichten

  1. Go zum Herunterladen von Modulen aus Artifact Registry, dem öffentlichen Go Module-Proxy und Quellen in dieser Reihenfolge:

      export GOPROXY=https://LOCATION-go.pkg.dev/PROJECT/REPOSITORY,https://proxy.golang.org,direct

    Ersetzen Sie Folgendes:

    • LOCATION ist der regionale oder multiregionale Ort des Repositorys.
    • PROJECT ist Ihre Google Cloud-Projekt-ID.
    • REPOSITORY ist der Name des Repositorys, in dem der Paket gespeichert.

  2. 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 Regex wenn Sie mehrere Module ausschließen möchten.

    So schließen Sie aus, dass Ihr Modul example.com/foo öffentlich geprüft wird Prüfsummendatenbank, führen Sie den folgenden Befehl aus:

      export GONOSUMDB=example.com/foo

    Wenn Sie möchten, dass alle Module mit Modulpfaden, die mit example.com beginnen, von der öffentlichen Prüfsummendatenbank ausgeschlossen werden soll, führen Sie den folgenden Befehl:

      export GONOSUMDB=example.com/*

Bei Artifact Registry authentifizieren

Beim Herunterladen gepackter Go-Module zur Verwendung als Abhängigkeiten von Artifact Registry verwendet das Go-Binärprogramm die Anmeldedaten in der netrc-Datei um sich bei Artifact Registry zu authentifizieren. Um die Authentifizierung zu vereinfachen können Sie mit dem Credential Helper Go die Tokens in Ihrem netrc-Datei zur Authentifizierung bei Artifact Registry.

Der Speicherort der netrc-Datei kann mit der Umgebungsvariable netrc festgelegt werden. Wenn die Variable NETRC nicht festgelegt ist, liest der Befehl go $HOME/.netrc auf UNIX-ähnlichen Plattformen oder %USERPROFILE%\_netrc unter Windows.

Artifact Registry unterstützt die folgenden Authentifizierungsmethoden.

Kurzlebige Anmeldedaten (empfohlen)
Artifact Registry Go Credential Helper-Tool verwenden um die Authentifizierungstokens in der netrc-Datei zu aktualisieren.
Dienstkontoschlüssel verwenden

Verwenden Sie diese Option, wenn Sie in Ihrer Umgebung keine Anmeldedaten für Authentifizierung. Fügen Sie der netrc-Datei den unverschlüsselten Dienstkontoschlüssel hinzu.

Go Credential Helper zu GONOPROXY hinzufügen

Bevor Sie den Credential Helper Go verwenden können, müssen Sie ihn der GONOPROXY-Liste hinzufügen damit Go ihn direkt von GitHub herunterlädt. Wenn Sie andere Module haben, direkt aus der Quelle herunterladen möchten, können Sie sie durch Kommas getrennt eingeben. wie im folgenden Beispiel gezeigt:

  export GONOPROXY=MODULE_PATH1, MODULE_PATH2

Dabei sind MODULE_PATH1 und MODULE_PATH2 die Modulpfade der Module, die heruntergeladen werden sollen. aus der Quelle.

Fügen Sie Go Credential Helper Ihrer GONOPROXY-Liste hinzu und führen Sie es aus, um Ihr Anmeldedaten:

  1. Go Credential Helper zu GONOPROXY hinzufügen

      export GONOPROXY=github.com/GoogleCloudPlatform/artifact-registry-go-tools

  2. Führen Sie den folgenden Befehl aus, um Ihre Artifact Registry-Anmeldedaten zu Ihrem netrc-Datei mit dem Go-Modulpakettool hinzu:

      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 Ort Ihres Repositorys. Wenn Sie mehrere Standorte hinzufügen möchten, trennen Sie sie durch ein Komma. getrennten Liste hinzugefügt.

    Go Credential Helper fügt Ihrer Netrc-Datei Einstellungen für die Authentifizierung hinzu an Artifact Registry senden. Wenn Sie das Flag --json_key übergeben, wird der Schlüssel Ihre Netrc-Datei für die Passwortauthentifizierung.

Modul als Abhängigkeit verwenden

  1. Wenn Sie kurzlebige Anmeldedaten für die Authentifizierung verwenden an Artifact Registry senden, müssen Sie Ihr OAuth-Token aktualisieren, indem Sie folgenden Befehl:

      GOPROXY=proxy.golang.org \
  go run github.com/GoogleCloudPlatform/artifact-registry-go-tools/cmd/auth@v0.1.0 refresh

  2. Erstellen Sie im Basisverzeichnis ein Verzeichnis mit dem Namen „bar“.

      mkdir bar

  3. Wechseln Sie in das Verzeichnis Ihres Moduls und führen Sie go mod init aus, um ein neues eine go.mod-Datei für Ihr Paket.

      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 .

  4. Wenn Sie die in Artifact Registry gespeicherte foo-Version verlangen möchten, bearbeiten Sie Ihre go.mod-Datei so aussehen:

    
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 Moduls
    • v0.1.0 ist die in Artifact Registry gespeicherte Version

  5. Erstellen Sie eine main.go-Datei in Ihrem bar-Verzeichnis mit folgendem Befehl: Inhalt:

      
  package main

  import (
    "fmt"

    foo "example.com/foo"
  )

  func main() {
    fmt.Println(foo.HelloWorld)
  }

  6. Führen Sie go mod tidy aus, um Abhängigkeiten herunterzuladen, einschließlich des Pakets foo:

      go mod tidy

  7. 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 in dieser Anleitung 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: Stellen Sie vor dem Entfernen des Repositorys sicher, dass alle Module, die Sie behalten möchten, an einem anderen Ort verfügbar sind.

  1. So löschen Sie das Repository:

      gcloud artifacts repositories delete \
      --location=LOCATION \
      --project=PROJECT \
      REPOSITORY

    Ersetzen Sie Folgendes:

    • LOCATION durch das regionale oder multiregionale Element Ort des Repositorys.
    • PROJECT durch ihre Google Cloud-Projekt-ID.
    • REPOSITORY durch den Namen des Repositorys.

  2. Wenn Sie die Standardeinstellungen für Repository und Speicherorte entfernen möchten, die für die aktive gcloud-Konfiguration konfiguriert ist, führen Sie die folgenden Befehle aus:

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

Nächste Schritte