Virtuelle Repositories erstellen

Auf dieser Seite wird beschrieben, wie Sie eine virtuelle Artifact Registry Repositories.

Virtuelle Repositories fungieren als zentrale Zugangspunkt zum Herunterladen, Installieren oder Stellen Sie Artefakte im selben Format aus einem oder mehreren vorgelagerten Repositories bereit. Ein Upstream-Repository kann ein Artifact Registry-Standard- oder Remote-Repository sein zu erstellen.

Die anderen Repository-Modi sind:

  • Standard: Der Standard-Repository-Modus. Sie laden Artefakte wie private Pakete direkt in Standard-Repositories hoch oder veröffentlichen sie dort. Sie können zwar direkt aus einzelnen Standard-Repositories herunterladen, Der Zugriff auf Gruppen von Repositories mit einem virtuellen Repository Konfiguration des Tools.
  • Remote (nur Sprachpaket-Repositories): Ein Pull-through für Artefakte in öffentlichen Repositories wie Maven Central oder PyPI. Es fungiert als Proxy für die öffentlichen Repositories, sodass Sie mehr Kontrolle über Ihre externen Abhängigkeiten haben.

Weitere Informationen zur Funktionsweise virtueller Repositories finden Sie in der Virtuelles Repository – Übersicht

Hinweis

Artifact Registry aktivieren darunter das Aktivieren der Artifact Registry API die neueste Version der Google Cloud CLI installieren.

Erforderliche Rollen

Um die Berechtigungen zu erhalten, die Sie zum Verwalten von Repositories benötigen, bitten Sie Ihren Administrator, Ihnen folgenden IAM-Rollen:

  • Erstellen Sie virtuelle Repositories und gewähren Sie Zugriff auf einzelne Repositories: Artifact Registry-Administrator (roles/artifactregistry.admin) im Google Cloud-Projekt
  • Gewähren Sie Zugriff auf Repositories auf Projektebene: Projekt-IAM-Administrator (roles/resourcemanager.projectIamAdmin) im Google Cloud-Projekt
  • Gewähren Sie Zugriff auf Repositories auf Ordnerebene: Ordneradministrator (roles/resourcemanager.folderAdmin) für den Ordner
  • Gewähren Sie Zugriff auf Repositories auf Organisationsebene: Administrator der Organisation (roles/resourcemanager.organizationAdmin) in der Google Cloud-Organisation

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Befinden sich vorgelagerte Repositories in anderen Projekten, Die Projekte mit vorgelagerten Repositories müssen Berechtigungen zum Verwalten Zugriff auf diese Repositories.

Upstream-Repositories erstellen

Erstellen Sie vor dem Einrichten eines virtuellen Repositorys die vorgelagerten Repositories, die die Sie mit dem virtuellen Repository zur Verfügung stellen möchten.

  1. Erstellen Sie die Upstream-Repositories in derselben Google Cloud-Region, in der Sie das virtuelle Repository erstellen möchten.

  2. Virtuelle Repositories verwenden den Artifact Registry Service Agent, um sich bei Upstream-Repositories zu authentifizieren. Sie müssen dem Dienst Lesezugriff des Agents auf Upstream-Repositories.

    Sie können dem Artifact Registry-Dienst-Agent die Rolle „Artifact Registry-Leser“ auf Projektebene zuweisen, damit Sie keinen Zugriff auf einzelne vorgelagerte Repositories gewähren müssen.

    Führen Sie in jedem Projekt mit vorgelagerten Repositories den folgenden Befehl aus:

    gcloud projects add-iam-policy-binding UPSTREAM_PROJECT_ID \
        --member serviceAccount:service-VIRTUAL-REPO-PROJECT_NUMBER@gcp-sa-artifactregistry.iam.gserviceaccount.com \
        --role roles/artifactregistry.reader
    

    Dabei gilt:

    • UPSTREAM_PROJECT_ID ist die ID des Google Cloud-Projekts mit dem Upstream-Repository.
    • VIRTUAL_REPO_PROJECT_NUMBER ist der/die/das Projektnummer des Google Cloud-Projekts für Ihr virtuelles Repository.

    Wenn Sie dem Dienst eine Rolle mit engerem Geltungsbereich zuweisen möchten, Kundenservicemitarbeiter, füge die Berechtigung hinzu artifactregistry.repositories.readViaVirtualRepository auf eine benutzerdefinierte Rolle und weisen Sie dem Dienst-Agent diese Rolle zu.

    Weitere Informationen zum Gewähren von Berechtigungen finden Sie in der Dokumentation zur Zugriffssteuerung.

Virtuelles Repository erstellen

Beim Erstellen eines Repositorys müssen Sie die folgenden Einstellungen konfigurieren, die kann nach dem Erstellen des Repositorys nicht mehr geändert werden:

Artifact Registry erzwingt Einschränkungen von Organisationsrichtlinien, die die Verschlüsselung von Ressourcen mit CMEK erfordern oder einschränken, welche Cloud KMS-Schlüssel für den CMEK-Schutz verwendet werden können.

Virtuelles Repository mit der Google Cloud Console erstellen

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

    Zur Seite „Repositories“

  2. Klicken Sie auf Repository erstellen.

  3. Geben Sie den Repository-Namen an. Repository-Namen können für jeden Repository-Speicherort in einem Projekt nur einmal vorkommen.

  4. Wählen Sie das Repository-Format aus.

  5. Wählen Sie unter Repository-Modus die Option Virtuell aus.

  6. Klicken Sie unter Upstreams des virtuellen Repositorys auf Upstream hinzufügen, um ein Upstream-Repository hinzuzufügen.

    • Ein Upstream-Repository kann ein Standard-, Remote- oder virtuelles Repository sein.
    • Ein Upstream-Repository muss sich am selben Standort wie das virtuelle Repository befinden Repository, kann sich aber in einem anderen Google Cloud-Projekt befinden.
    • Ein Upstream-Repository muss dasselbe Artefaktformat wie das virtuelle Repository haben.

    Geben Sie für jedes Upstream-Repository eine Priorität und einen Richtliniennamen an. Höhere Prioritätswerte haben Vorrang vor niedrigeren Werten. Lassen Sie zwischen den Prioritätswerten Platz, damit Sie Upstream-Repositories mit Prioritäten hinzufügen können, die zwischen den vorhandenen Werten liegen.

  7. Wählen Sie unter Standorttyp den Speicherort für das Repository aus:

    1. Wählen Sie als Speicherort „Region“ oder „Mehrere Regionen“ aus. Die Liste der Speicherorte ändert sich entsprechend Ihrer Auswahl.

    2. Wählen Sie in der Liste Region oder Mehrere Regionen einen Speicherort aus.

    Informationen zu Standorttypen und unterstützten Standorten finden Sie unter Speicherorte des Repositorys

  8. Fügen Sie eine Beschreibung für das Repository hinzu. Beschreibungen helfen dabei, den Zweck des Repositorys und die darin enthaltenen Artefakte zu ermitteln.

    Geben Sie keine vertraulichen Daten an, da Repository-Beschreibungen nicht verschlüsselt sind.

  9. Wenn Sie Ihre Daten mithilfe von Labels organisieren möchten, auf Add Label (Label hinzufügen) klicken und das Schlüssel/Wert-Paar . Sie können Labels hinzufügen, bearbeiten oder entfernen, nachdem Sie das Repository erstellt haben.

  10. Wählen Sie im Abschnitt Verschlüsselung den Verschlüsselungsmechanismus für das Repository aus.

    • Von Google verwalteter Schlüssel: Verschlüsselung des Repository-Inhalts mit einem von Google verwalteten Schlüssel, der zu Google gehört.
    • Vom Kunden verwalteter Schlüssel: Verschlüsselung des Repository-Inhalts mit einem Schlüssel, den Sie über Cloud Key Management Service steuern. Eine grundlegende Einrichtungsanleitung finden Sie unter Vom Kunden verwalteten Schlüssel für Repositories einrichten.
  11. Klicken Sie auf Erstellen.

Artifact Registry erstellt das Repository und fügt es der Liste der Repositories.

Nachdem Sie das Repository erstellt haben:

Virtuelles Repository mit der gcloud CLI erstellen

Zum Erstellen eines virtuellen Repositorys definieren Sie Ihre vorgelagerten Repositories in einer Richtliniendatei und dann das Repository mithilfe der Richtliniendatei erstellen.

  1. Erstellen Sie eine Upstream-Richtliniendatei im JSON-Format mit den folgenden Einstellungen:

    [{
    "id" : "POLICY_ID",
    "repository" : "UPSTREAM_REPOSITORY_RESOURCE_NAME",
    "priority" : PRIORITY
    }, {...}]
    
    • POLICY_ID ist ein Name für die Richtlinie. Jede vorgelagerte Das Repository in der Richtlinie muss eine eindeutige Richtlinien-ID haben.
    • UPSTREAM_REPO_RESOURCE_NAME ist der Name des Upstream-Repositorys im folgenden Format:

      projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY
      
      • Ein Upstream-Repository kann ein Standard-, Remote- oder virtuelles Repository sein.
      • Ein Upstream-Repository muss sich am selben Standort wie das virtuelle Repository befinden Repository, kann sich aber in einem anderen Google Cloud-Projekt befinden.
      • Ein Upstream-Repository muss dasselbe Artefaktformat wie das virtuelle Repository haben zu erstellen.
    • PRIORITY ist eine Ganzzahl, die die Priorität für das Upstream-Repository angibt. Höhere Priorität Vorrang vor niedrigeren Werten.

    Das folgende Beispiel zeigt eine Richtliniendatei namens policies.json mit vier Upstream-Repositories. upstream1 hat den höchsten Wert für priority, sodass Artifact Registry sie zuerst durchsucht. upstream-test hat den niedrigsten priority-Wert, daher wird es in Artifact Registry als Letztes durchsucht. upstream2 und upstream3 haben dieselbe Priorität. Wenn Artifact Registry findet ein angefordertes Paket in Repositories mit der mit derselben Priorität hat, kann das Paket aus beiden Repositories bereitgestellt werden.

    [{
    "id" : "upstream1",
    "repository" : "projects/myproject/locations/us-west1/repositories/python-repo1",
    "priority" : 100
    }, {
    "id" : "upstream2",
    "repository" : "projects/myproject/locations/us-west1/repositories/python-repo2",
    "priority" : 80
    }, {
    "id" : "upstream3",
    "repository" : "projects/myproject/locations/us-west1/repositories/python-repo2",
    "priority" : 80
    }, {
    "id" : "upstream-test",
    "repository" : "projects/myproject/locations/us-west1/repositories/python-test-repo",
    "priority" : 20
    }]
    

    In diesem Beispiel wird auch zwischen den Prioritätswerten ein Leerraum gelassen. Diese Lücken bieten Flexibilität, um Upstream-Repositories mit Prioritäten hinzuzufügen, die zwischen den vorhandenen Werten liegen. Sie können beispielsweise upstream-3 Repository mit der Priorität 70, damit in Artifact Registry gesucht wird vor dem upstream-test.

    Sie können die Upstream-Richtliniendatei in Ihrem Versionskontrollsystem speichern, damit Sie sie später wiederverwenden können, um Änderungen an den Upstream-Repository-Einstellungen vorzunehmen und bisherige Änderungen zu verfolgen.

  2. Führen Sie im Verzeichnis mit Ihrer Upstream-Richtliniendatei den folgenden Befehl aus, um das virtuelle Repository zu erstellen:

    gcloud artifacts repositories create VIRTUAL-REPOSITORY-NAME \
        --project=PROJECT_ID \
        --repository-format=FORMAT \
        --mode=virtual-repository \
        --location=LOCATION \
        --description="DESCRIPTION" \
        --upstream-policy-file=UPSTREAM_POLICY_FILE
    

    Ersetzen Sie Folgendes:

    • VIRTUAL-REPOSITORY-NAME ist der Name des virtuellen zu erstellen.
    • PROJECT_ID ist die ID des Projekts, in dem Sie das virtuelle Repository erstellen. Wenn dieses Flag nicht angegeben ist, wird das aktuelle Projekt oder das Standardprojekt verwendet.
    • FORMAT ist das Format des Repositorys. Die folgenden sind folgende Werte verfügbar:
      • apt (private Vorschau)
      • docker
      • maven
      • npm
      • python
      • yum (private Vorschau)
    • LOCATION ist der regionale oder multiregionale Standort für das Repository. Sie können dieses Flag weglassen, wenn Sie einen Standard-Speicherort festgelegt haben. Führen Sie den folgenden Befehl aus, um eine Liste der unterstützten Speicherorte aufzurufen:

      gcloud artifacts locations list
      
    • DESCRIPTION ist eine optionale Beschreibung des Repositorys. Geben Sie keine sensiblen Daten an, da Repository-Beschreibungen nicht verschlüsselt.

    • UPSTREAM_POLICY_FILE ist der Pfad zur Upstream-Richtliniendatei.

    Mit dem folgenden Befehl wird beispielsweise ein virtuelles Repository mit dem Namen virtual-repo für Python-Pakete in der Region us-west1 mit Einstellungen in policies.json

    gcloud artifacts repositories create virtual-repo \
    --repository-format=python \
    --mode=virtual-repository \
    --location=us-west1 \
    --description="Python virtual repository" \
    --upstream-policy-file=policies.json
    

Artifact Registry erstellt das virtuelle Repository.

Virtuelles Repository mit Terraform erstellen

Verwenden Sie die Ressource google_artifact_registry_repository, um Repositories zu erstellen. terraform-provider-google Version 5.0.0 oder höher ist erforderlich.

Wenn Sie Terraform für Google Cloud noch nicht kennen, lesen Sie die Seite Erste Schritte: Google Cloud auf der HashiCorp-Website.

Im folgenden Beispiel werden der Anbieter, ein virtuelles Repository mit dem Terraform-Ressourcennamen my-repo und ein Upstream-Repository mit dem Terraform-Ressourcennamen my-repo-upstream definiert.

Docker

provider "google" {
    project = "PROJECT-ID"
}
resource "google_artifact_registry_repository" "my-repo-upstream" {
  location      = "UPSTREAM_LOCATION"
  repository_id = "UPSTREAM_REPOSITORY_ID"
  description   = "UPSTREAM_REPOSITORY_DESCRIPTION"
  format        = "docker"
}

resource "google_artifact_registry_repository" "my-repo" {
  depends_on    = []
  location      = "LOCATION"
  repository_id = "REPOSITORY_ID"
  description   = "VIRTUAL_REPOSITORY_DESCRIPTION"
  format        = "docker"
  kms_key_name = "KEY"
  mode          = "VIRTUAL_REPOSITORY"
  virtual_repository_config {
    upstream_policies {
      id          = "UPSTREAM_REPOSITORY_ID"
      repository  = google_artifact_registry_repository.my-repo-upstream.id
      priority    = PRIORITY
    }
  }
}

Dabei gilt:

  • PROJECT-ID ist die Google Cloud-Projekt-ID.
  • UPSTREAM_LOCATION ist der Speicherort des Upstream-Repositorys. Das virtuelle Repository und das Upstream-Repository müssen sich in derselben Region oder in mehreren Regionen befinden.
  • UPSTREAM_REPOSITORY_ID ist die Upstream-Repository-ID.
  • UPSTREAM_REPOSITORY_DESCRIPTION ist die optionale Beschreibung des Upstream-Repositories.
  • LOCATION ist der Speicherort des virtuellen Repositorys.
  • REPOSITORY_ID ist die ID des virtuellen Repositorys.
  • DESCRIPTION ist die optionale Beschreibung für das virtuelle Repository. Geben Sie keine sensiblen Daten an, da Repository-Beschreibungen vorliegen sind nicht verschlüsselt.
  • KEY ist der Name des Cloud Key Management Service-Schlüssels, wenn Sie für die Verschlüsselung vom Kunden verwaltete Verschlüsselungsschlüssel (Customer-Managed Encryption Keys, CMEK) verwenden. Omit dieses Arguments, um die Standardeinstellung (Google-eigene und von Google verwaltete Schlüssel) zu verwenden.
  • PRIORITY ist der optionale Prioritätswert. Höchste Priorität ist 1. Einträge mit einem höheren Prioritätswert haben in der Pull-Reihenfolge Vorrang.

Maven

Wenn Sie keine Versionsrichtlinie angeben, erstellt Artifact Registry ein Maven-Repository, in dem standardmäßig sowohl Snapshot- als auch Release-Versionen von Paketen gespeichert werden.

provider "google" {
    project = "PROJECT-ID"
}
resource "google_artifact_registry_repository" "my-repo-upstream" {
  location      = "UPSTREAM_LOCATION"
  repository_id = "UPSTREAM_REPOSITORY_ID"
  description   = "UPSTREAM_REPOSITORY_DESCRIPTION"
  format        = "maven"
}

resource "google_artifact_registry_repository" "my-repo" {
  depends_on    = []
  location      = "LOCATION"
  repository_id = "REPOSITORY_ID"
  description   = "VIRTUAL_REPOSITORY_DESCRIPTION"
  format        = "maven"
  kms_key_name = "KEY"
  mode          = "VIRTUAL_REPOSITORY"
  virtual_repository_config {
    upstream_policies {
      id          = "UPSTREAM_REPOSITORY_ID"
      repository  = google_artifact_registry_repository.my-repo-upstream.id
      priority    = PRIORITY
    }
  }
}

Dabei gilt:

  • PROJECT-ID ist die Google Cloud-Projekt-ID.
  • UPSTREAM_LOCATION ist der Speicherort des Upstream-Repositorys. Das virtuelle Repository und das Upstream-Repository müssen sich in derselben Region oder in mehreren Regionen befinden.
  • UPSTREAM_REPOSITORY_ID ist die Upstream-Repository-ID.
  • UPSTREAM_REPOSITORY_DESCRIPTION ist die optionale Beschreibung des Upstream-Repositories.
  • LOCATION ist der Speicherort des virtuellen Repositorys.
  • REPOSITORY_ID ist die ID des virtuellen Repositorys.
  • DESCRIPTION ist die optionale Beschreibung für das virtuelle Repository. Geben Sie keine sensiblen Daten an, da Repository-Beschreibungen vorliegen sind nicht verschlüsselt.
  • KEY ist der Name des Cloud Key Management Service-Schlüssels, wenn Sie für die Verschlüsselung vom Kunden verwaltete Verschlüsselungsschlüssel (Customer-Managed Encryption Keys, CMEK) verwenden. Omit dieses Arguments, um die Standardeinstellung (Google-eigene und von Google verwaltete Schlüssel) zu verwenden.
  • PRIORITY ist der optionale Prioritätswert. Die höchste Priorität ist 1. Einträge mit einem höheren Prioritätswert haben in der Pull-Reihenfolge Vorrang.

Um Snapshot- und Release-Versionen in unterschiedlichen Repositories, geben Sie eine Versionsrichtlinie für die mit einem maven_config-Block. Dieser Block unterstützt die folgenden Einstellungen:

  • version_policy legt die Versionsrichtlinie mit einem der folgenden Werte fest:
    • VERSION_POLICY_UNSPECIFIED: Snapshot- und Release-Pakete speichern Das ist die Standardeinstellung.
    • RELEASE: Nur Store-Release-Pakete.
    • SNAPSHOT: Nur Snapshot-Pakete speichern.
  • allow_snapshot_overwrites konfiguriert ein Repository mit einer SNAPSHOT Versionsrichtlinie zum Akzeptieren nicht eindeutiger Snapshots, die vorhandene überschreiben Versionen im Repository.

Im folgenden Beispiel wird ein Maven-Repository mit einer Richtlinie für Release-Versionen definiert.

provider "google" {
project = "my-project"
}

resource "google_artifact_registry_repository" "my-repo" {
provider = google-beta

location = "us-central1"
repository_id = "my-repo"
description = "Maven repository"
format = "MAVEN"
maven_config {
  version_policy = "RELEASE"
}
}

npm

provider "google" {
    project = "PROJECT-ID"
}
resource "google_artifact_registry_repository" "my-repo-upstream" {
  location      = "UPSTREAM_LOCATION"
  repository_id = "UPSTREAM_REPOSITORY_ID"
  description   = "UPSTREAM_REPOSITORY_DESCRIPTION"
  format        = "npm"
}

resource "google_artifact_registry_repository" "my-repo" {
  depends_on    = []
  location      = "LOCATION"
  repository_id = "REPOSITORY_ID"
  description   = "VIRTUAL_REPOSITORY_DESCRIPTION"
  format        = "npm"
  kms_key_name = "KEY"
  mode          = "VIRTUAL_REPOSITORY"
  virtual_repository_config {
    upstream_policies {
      id          = "UPSTREAM_REPOSITORY_ID"
      repository  = google_artifact_registry_repository.my-repo-upstream.id
      priority    = PRIORITY
    }
  }
}

Dabei gilt:

  • PROJECT-ID ist die Google Cloud-Projekt-ID.
  • UPSTREAM_LOCATION ist der Speicherort des Upstream-Repositorys. Das virtuelle Repository und das Upstream-Repository müssen sich in derselben Region oder in mehreren Regionen befinden.
  • UPSTREAM_REPOSITORY_ID ist die Upstream-Repository-ID.
  • UPSTREAM_REPOSITORY_DESCRIPTION ist die optionale Beschreibung des Upstream-Repositories.
  • LOCATION ist der Speicherort des virtuellen Repositorys.
  • REPOSITORY_ID ist die ID des virtuellen Repositorys.
  • DESCRIPTION ist die optionale Beschreibung für das virtuelle zu erstellen. Geben Sie keine vertraulichen Daten an, da Repository-Beschreibungen nicht verschlüsselt sind.
  • KEY ist der Name des Cloud Key Management Service-Schlüssels, wenn Sie für die Verschlüsselung vom Kunden verwaltete Verschlüsselungsschlüssel (Customer-Managed Encryption Keys, CMEK) verwenden. Lassen Sie dieses Argument aus, um die Standardeinstellung zu verwenden, d. h. Google-eigene und von Google verwaltete Schlüssel.
  • PRIORITY ist der optionale Prioritätswert. Höchste Priorität ist 1. Einträge mit einem höheren Prioritätswert haben in der Pull-Reihenfolge Vorrang.

Python

provider "google" {
    project = "PROJECT-ID"
}
resource "google_artifact_registry_repository" "my-repo-upstream" {
  location      = "UPSTREAM_LOCATION"
  repository_id = "UPSTREAM_REPOSITORY_ID"
  description   = "UPSTREAM_REPOSITORY_DESCRIPTION"
  format        = "python"
}

resource "google_artifact_registry_repository" "my-repo" {
  depends_on    = []
  location      = "LOCATION"
  repository_id = "REPOSITORY_ID"
  description   = "VIRTUAL_REPOSITORY_DESCRIPTION"
  format        = "python"
  kms_key_name = "KEY"
  mode          = "VIRTUAL_REPOSITORY"
  virtual_repository_config {
    upstream_policies {
      id          = "UPSTREAM_REPOSITORY_ID"
      repository  = google_artifact_registry_repository.my-repo-upstream.id
      priority    = PRIORITY
    }
  }
}

Dabei gilt:

  • PROJECT-ID ist die Google Cloud-Projekt-ID.
  • UPSTREAM_LOCATION ist der Speicherort des Upstream-Repositorys. Das virtuelle Repository und das Upstream-Repository müssen sich in derselben Region oder in mehreren Regionen befinden.
  • UPSTREAM_REPOSITORY_ID ist die Upstream-Repository-ID.
  • UPSTREAM_REPOSITORY_DESCRIPTION ist die optionale Beschreibung des Upstream-Repositories.
  • LOCATION ist der Speicherort des virtuellen Repositorys.
  • REPOSITORY_ID ist die ID des virtuellen Repositorys.
  • DESCRIPTION ist die optionale Beschreibung für das virtuelle zu erstellen. Geben Sie keine vertraulichen Daten an, da Repository-Beschreibungen nicht verschlüsselt sind.
  • KEY ist der Name des Cloud Key Management Service-Schlüssels, wenn Sie für die Verschlüsselung vom Kunden verwaltete Verschlüsselungsschlüssel (Customer-Managed Encryption Keys, CMEK) verwenden. Lassen Sie dieses Argument aus, um die Standardeinstellung zu verwenden, d. h. Google-eigene und von Google verwaltete Schlüssel.
  • PRIORITY ist der optionale Prioritätswert. Höchste Priorität ist 1. Einträge mit einem höheren Prioritätswert haben in der Pull-Reihenfolge Vorrang.

Artifact Registry erstellt Ihr Repository. Führen Sie den folgenden Befehl aus, um eine Beschreibung des Repositorys:

gcloud artifacts repositories describe REPOSITORY \
    --location=LOCATION

Nachdem Sie das Repository erstellt haben:

Upstream-Repositories aktualisieren

Sie können die Liste der Upstream-Repositories ändern oder die Priorität der Upstream-Repositories anpassen.

Console

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

    Zur Seite „Repositories“

  2. Wählen Sie in der Repository-Liste das virtuelle Repository aus und klicken Sie auf Repository bearbeiten.

  3. Nehmen Sie in der Liste Virtuelles Repository – Upstream die erforderlichen Änderungen vor. Sie können Repositories hinzufügen und entfernen oder die Priorität von Repositories in der Liste

  4. Klicken Sie auf Speichern.

gcloud

  1. Bearbeiten Sie die Upstream-Richtliniendatei mit den Änderungen. Sie können beispielsweise ein Upstream-Repository hinzufügen oder die Prioritätseinstellungen anpassen.

    Wenn Sie alle Upstream-Repositories entfernen möchten, sollte Ihre Richtliniendatei einen leeren Satz von Repositories enthalten.

    []
    
  2. Führen Sie den folgenden Befehl aus, um Ihre Änderungen auf das virtuelle Repository anzuwenden.

    gcloud artifacts repositories update REPOSITORY \
        --upstream-policy-file=UPSTREAM_POLICY_FILE
    

    Ersetzen Sie UPSTREAM_POLICY_FILE durch den Pfad zur Upstream-Richtliniendatei.

    Weitere Informationen zum Befehl finden Sie in der Referenzdokumentation zu gcloud artifacts repositories update.

Repository-Beschreibungen bearbeiten

Sie können die Repository-Beschreibung über die Google Cloud Console oder die gcloud CLI verwenden können.

Console

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

    Zur Seite „Repositories“

  2. Wählen Sie das Repository aus der Repository-Liste aus und klicken Sie auf Repository bearbeiten.

  3. Bearbeiten Sie die Repository-Beschreibung und klicken Sie dann auf Speichern.

gcloud

Führen Sie den folgenden Befehl aus, um die Repository-Beschreibung zu aktualisieren:

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT \
    --location=LOCATION \
    --description="DESCRIPTION"

Ersetzen Sie Folgendes:

  • REPOSITORY: Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen des Flags dieses Standard-Repository verwendet.
  • PROJECT: die Google Cloud-Projekt-ID. Wenn dieses Flag nicht angegeben ist, wird das aktuelle Projekt oder das Standardprojekt verwendet.
  • LOCATION: a regional oder multiregional Standort Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standardstandort konfiguriert, können Sie dieses Flag weglassen, um die Standardeinstellung zu verwenden.
  • DESCRIPTION: eine Beschreibung für das Repository.