Virtuelle Repositories erstellen

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

Virtuelle Repositories dienen als einzelner Zugangspunkt zum Herunterladen, Installieren oder Bereitstellen von Artefakten im selben Format aus einem oder mehreren vorgelagerten Repositories. Ein Upstream-Repository kann ein Artifact Registry-Standard- oder ein Remote-Repository sein.

Die anderen Repository-Modi sind:

Standard: Der standardmäßige Repository-Modus. Sie laden Artefakte wie private Pakete direkt in Standard-Repositories hoch oder veröffentlichen sie. Obwohl Sie Inhalte direkt aus einzelnen Standard-Repositories herunterladen können, vereinfacht der Zugriff auf Gruppen von Repositories über ein virtuelles Repository die Toolkonfiguration.
Remote (nur Sprachpaket-Repositories): Ein Pull-Through-Cache für Artefakte in öffentlichen Repositories wie Maven Central oder PyPI. Er fungiert als Proxy für die öffentlichen Repositories, sodass Sie mehr Kontrolle über Ihre externen Abhängigkeiten haben.

Weitere Informationen zur Funktionsweise von virtuellen Repositories finden Sie unter Virtuelle Repositories – Übersicht.

Hinweise

Aktivieren Sie Artifact Registry. Dazu gehört auch die Aktivierung der Artifact Registry API und die Installation der neuesten Version der Google Cloud CLI.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Verwalten von Repositories benötigen:

Erstellen Sie virtuelle Repositories und gewähren Sie Zugriff auf einzelne Repositories: Artifact Registry-Repository-Administrator (roles/artifactregistry.repoAdmin) für das Google Cloud-Projekt
Gewähren Sie Zugriff auf Repositories auf Projektebene: Project IAM Admin (roles/resourcemanager.projectIamAdmin) für das 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: Organization Admin (roles/resourcemanager.organizationAdmin) in der Google Cloud-Organisation

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

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

Wenn sich Upstream-Repositories in anderen Projekten befinden, muss ein Administrator in diesen Projekten über Berechtigungen zum Verwalten des Zugriffs auf diese Repositories verfügen.

Upstream-Repositories erstellen

Bevor Sie ein virtuelles Repository einrichten, erstellen Sie die Upstream-Repositories, die Sie mit dem virtuellen Repository verfügbar machen möchten.

Erstellen Sie die Upstream-Repositories in derselben Google Cloud-Region, in der Sie das virtuelle Repository erstellen möchten.
- Standard-Repository erstellen
- Remote-Repository erstellen
Virtuelle Repositories verwenden den Artifact Registry-Dienst-Agent, um sich bei Upstream-Repositories zu authentifizieren. Sie müssen dem Dienst-Agent Lesezugriff auf Upstream-Repositories gewähren.

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

Führen Sie in jedem Projekt mit Upstream-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
```
Wo
- UPSTREAM_PROJECT_ID ist die ID des Google Cloud-Projekts mit dem Upstream-Repository.
- VIRTUAL_REPO_PROJECT_NUMBER ist die Projektnummer des Google Cloud-Projekts für Ihr virtuelles Repository.
Wenn Sie dem Dienst-Agent eine enger gefasste Rolle zuweisen möchten, fügen Sie einer benutzerdefinierten Rolle die Berechtigung artifactregistry.repositories.readViaVirtualRepository hinzu und weisen Sie diese Rolle dann dem Dienst-Agent zu.

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

Virtuelles Repository erstellen

Wenn Sie ein Repository erstellen, müssen Sie die folgenden Einstellungen konfigurieren, die nach dem Erstellen des Repositorys nicht mehr geändert werden können:

Artefaktformat.
Repository-Modus, wenn für das ausgewählte Format mehrere Modi verfügbar sind.
Repository-Speicherort.
Verschlüsselung mit von Google verwalteten Schlüsseln oder vom Kunden verwalteten Verschlüsselungsschlüsseln. Artifact Registry verwendet standardmäßig von Google verwaltete Verschlüsselungsschlüssel.

Artifact Registry erzwingt Einschränkungen für Organisationsrichtlinien, die erfordern, dass CMEK Ressourcen verschlüsselt oder begrenzt, welche Cloud KMS-Schlüssel für den CMEK-Schutz verwendet werden können.

Virtuelles Repository mit der Google Cloud Console erstellen

Öffnen Sie in der Cloud Console die Seite Repositories.

Zur Seite „Repositories“
Klicken Sie auf Repository erstellen.
Geben Sie den Repository-Namen an. Repository-Namen können für jeden Repository-Speicherort in einem Projekt nur einmal vorkommen.
Wählen Sie das Repository-Format aus.
Wählen Sie unter Repository-Modus die Option Virtuell aus.
Klicken Sie unter Virtual Repository Upstreams auf Add Upstream, um ein Upstream-Repository hinzuzufügen.
- Ein Upstream-Repository kann ein Standard-, Remote- oder virtuelles Repository sein.
- Ein Upstream-Repository muss sich am selben Speicherort wie das virtuelle Repository befinden, kann sich jedoch 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 vorgelagerte Repositories mit Prioritäten, die zwischen den vorhandenen Werten liegen, flexibel hinzufügen können.
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 Repository-Standorte.
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 sensiblen Daten an, da Repository-Beschreibungen nicht verschlüsselt sind.
Wenn Sie Labels zum Organisieren Ihrer Repositories verwenden möchten, klicken Sie auf Label hinzufügen und geben Sie das Schlüssel/Wert-Paar für das Label ein. Sie können Labels hinzufügen, bearbeiten oder entfernen, nachdem Sie das Repository erstellt haben.
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 Verschlüsselungsschlüssel.
- 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.
Klicken Sie auf Erstellen.

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

Nachdem Sie das Repository erstellt haben:

Gewähren Sie Zugriff auf das Repository.
Docker, Paketmanager und andere Clients von Drittanbietern für die Authentifizierung bei Repositories konfigurieren
- Container-Images: Docker, Helm
- Sprachpakete: Java, Node.js, Python, Go
- Sonstige: Kubeflow-Pipeline-Vorlagen

Virtuelles Repository mit der gcloud CLI erstellen

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

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 der Name der Richtlinie. Jedes Upstream-Repository in der Richtlinie muss eine eindeutige Richtlinien-ID haben.
- UPSTREAM_REPO_RESOURCE_NAME ist der Name des Upstream-Repositorys im 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 Speicherort wie das virtuelle Repository befinden, kann sich jedoch in einem anderen Google Cloud-Projekt befinden.
  - Ein Upstream-Repository muss dasselbe Artefaktformat wie das virtuelle Repository haben.
- PRIORITY ist eine Ganzzahl, die die Priorität für das Upstream-Repository angibt. Höhere Prioritätswerte haben Vorrang vor niedrigeren Werten.
Das folgende Beispiel zeigt eine Richtliniendatei mit dem Namen policies.json und vier vorgelagerten Repositories. upstream1 hat den höchsten Wert für priority, daher sucht Artifact Registry zuerst danach. upstream-test hat den niedrigsten priority-Wert, sodass Artifact Registry ihn zuletzt durchsucht. „upstream2“ und „upstream3“ haben die gleiche Priorität. Wenn Artifact Registry ein angefordertes Paket in Repositories mit derselben Priorität findet, 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 bleibt auch ein Abstand zwischen den Prioritätswerten. Diese Lücken bieten Flexibilität, um Upstream-Repositories mit Prioritäten zwischen vorhandenen Werten hinzuzufügen. Sie können beispielsweise ein upstream-3-Repository mit der Priorität 70 hinzufügen, sodass Artifact Registry es vor upstream-test durchsucht.

Erwägen Sie, die vorgelagerte Richtliniendatei in Ihrem Versionsverwaltungssystem zu speichern, damit Sie sie später wiederverwenden können, um Änderungen an den Einstellungen des Upstream-Repositorys vorzunehmen und bisherige Änderungen zu verfolgen.
Führen Sie im Verzeichnis mit der vorgelagerten 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 Repositorys.
- 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. Folgende Werte sind 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 sind.
- UPSTREAM_POLICY_FILE ist ein Pfad zur vorgelagerten Richtliniendatei.
Mit dem folgenden Befehl wird beispielsweise ein virtuelles Repository namens virtual-repo für Python-Pakete in der Region us-west1 mit Einstellungen in policies.json erstellt.
```
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 zum ersten Mal verwenden, lesen Sie die Seite Erste Schritte – Google Cloud auf der HashiCorp-Website.

Im folgenden Beispiel wird 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
    }
  }
}

PROJECT-ID ist die Google Cloud-Projekt-ID.
UPSTREAM_LOCATION ist der Speicherort des Upstream-Repositorys. Das virtuelle Repository und der Upstream müssen sich in derselben Region oder am multiregionalen Standort befinden.
UPSTREAM_REPOSITORY_ID ist die Upstream-Repository-ID.
UPSTREAM_REPOSITORY_DESCRIPTION ist die optionale Beschreibung des Upstream-Repositorys.
LOCATION ist der Speicherort des virtuellen Repositorys.
REPOSITORY_ID ist die ID des virtuellen Repositorys.
DESCRIPTION ist die optionale Beschreibung des virtuellen Repositorys. Geben Sie keine sensiblen 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 von Google verwaltete Standardeinstellung 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.

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
    }
  }
}

PROJECT-ID ist die Google Cloud-Projekt-ID.
UPSTREAM_LOCATION ist der Speicherort des Upstream-Repositorys. Das virtuelle Repository und der Upstream müssen sich in derselben Region oder am multiregionalen Standort befinden.
UPSTREAM_REPOSITORY_ID ist die Upstream-Repository-ID.
UPSTREAM_REPOSITORY_DESCRIPTION ist die optionale Beschreibung des Upstream-Repositorys.
LOCATION ist der Speicherort des virtuellen Repositorys.
REPOSITORY_ID ist die ID des virtuellen Repositorys.
DESCRIPTION ist die optionale Beschreibung des virtuellen Repositorys. Geben Sie keine sensiblen 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 von Google verwaltete Standardeinstellung 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.

Wenn Sie Snapshot- und Release-Versionen in verschiedenen Repositories speichern möchten, geben Sie mit einem maven_config-Block eine Versionsrichtlinie für das Repository an. Dieser Block unterstützt die folgenden Einstellungen:

version_policy legt die Versionsrichtlinie auf einen der folgenden Werte fest:
- VERSION_POLICY_UNSPECIFIED: Snapshot- und Release-Pakete speichern. Das ist die Standardeinstellung.
- FREIGABE: Nur Release-Pakete speichern.
- SNAPSHOT: Nur Snapshot-Pakete speichern.
allow_snapshot_overwrites konfiguriert ein Repository mit einer Richtlinie der Version SNAPSHOT, um nicht eindeutige Snapshots zu akzeptieren, die vorhandene Versionen im Repository überschreiben.

Im folgenden Beispiel wird ein Maven-Repository mit einer Richtlinie für Releaseversionen 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
    }
  }
}

PROJECT-ID ist die Google Cloud-Projekt-ID.
UPSTREAM_LOCATION ist der Speicherort des Upstream-Repositorys. Das virtuelle Repository und der Upstream müssen sich in derselben Region oder am multiregionalen Standort befinden.
UPSTREAM_REPOSITORY_ID ist die Upstream-Repository-ID.
UPSTREAM_REPOSITORY_DESCRIPTION ist die optionale Beschreibung des Upstream-Repositorys.
LOCATION ist der Speicherort des virtuellen Repositorys.
REPOSITORY_ID ist die ID des virtuellen Repositorys.
DESCRIPTION ist die optionale Beschreibung des virtuellen Repositorys. Geben Sie keine sensiblen 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 von Google verwaltete Standardeinstellung 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.

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
    }
  }
}

PROJECT-ID ist die Google Cloud-Projekt-ID.
UPSTREAM_LOCATION ist der Speicherort des Upstream-Repositorys. Das virtuelle Repository und der Upstream müssen sich in derselben Region oder am multiregionalen Standort befinden.
UPSTREAM_REPOSITORY_ID ist die Upstream-Repository-ID.
UPSTREAM_REPOSITORY_DESCRIPTION ist die optionale Beschreibung des Upstream-Repositorys.
LOCATION ist der Speicherort des virtuellen Repositorys.
REPOSITORY_ID ist die ID des virtuellen Repositorys.
DESCRIPTION ist die optionale Beschreibung des virtuellen Repositorys. Geben Sie keine sensiblen 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 von Google verwaltete Standardeinstellung 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.

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

gcloud artifacts repositories describe REPOSITORY \
    --location=LOCATION

Nachdem Sie das Repository erstellt haben:

Gewähren Sie Zugriff auf das Repository.
Docker, Paketmanager und andere Clients von Drittanbietern für die Authentifizierung bei Repositories konfigurieren
- Container-Images: Docker, Helm
- Sprachpakete: Java, Node.js, Python, Go
- Betriebssystempakete: Debian, RPM
- Sonstiges: Kubeflow-Vorlagen

Upstream-Repositories aktualisieren

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

Console

Öffnen Sie in der Cloud Console die Seite Repositories.

Zur Seite „Repositories“
Wählen Sie in der Repository-Liste das virtuelle Repository aus und klicken Sie auf Repository bearbeiten.
Nehmen Sie in der Liste Virtual Repository Upstream die erforderlichen Änderungen vor. Sie können Repositories hinzufügen und entfernen oder die Priorität von Repositories in der Liste ändern
Klicken Sie auf Speichern.

gcloud

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

Wenn Sie alle Upstream-Repositories entfernen möchten, sollte die Richtliniendatei einen leeren Satz von Repositories enthalten.
```
[]
```
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 vorgelagerten Richtliniendatei.

Weitere Informationen zu dem Befehl finden Sie in der Referenzdokumentation zu gcloudStores update.

Repository-Beschreibungen bearbeiten

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

Console

Öffnen Sie in der Cloud Console die Seite Repositories.

Zur Seite „Repositories“
Wählen Sie in der Repository-Liste das Repository aus und klicken Sie auf Repository bearbeiten.
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 die folgenden Werte:

REPOSITORY ist der Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen des Flags dieses Standard-Repository verwendet.
PROJECT ist die Google Cloud-Projekt-ID. Wenn dieses Flag nicht angegeben ist, wird das aktuelle Projekt oder das Standardprojekt verwendet.
LOCATION ist ein regionaler oder multiregionaler Speicherort. Verwenden Sie dieses Flag, um Repositories an einem bestimmten Speicherort aufzurufen. Wenn Sie einen Standard-Speicherort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.
DESCRIPTION ist eine Beschreibung für das Repository.