Diese Seite wurde von der Cloud Translation API übersetzt.

Virtuelle Repositories erstellen

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

Virtuelle Repositories dienen als einzelner Zugriffspunkt, um Artefakte im selben Format aus einem oder mehreren Upstream-Repositories herunterzuladen, zu installieren oder bereitzustellen. Ein Upstream-Repository kann ein Artifact Registry-Standard- oder Remote-Repository sein.

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, aber der Zugriff auf Repositoriegruppen mit einem virtuellen Repository vereinfacht die Toolkonfiguration.
Remote (nur Sprachpaket-Repositories): Ein Pull-Through-Cache 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 unter Virtuelle Repositories – Übersicht.

Hinweise

Aktivieren Sie Artifact Registry, einschließlich der Artifact Registry API, und installieren Sie die neueste Version der Google Cloud CLI.

Erforderliche Rollen

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

Virtuelle Repositories erstellen und Zugriff auf einzelne Repositories gewähren: 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: Organisationsadministrator (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.

Wenn sich vorgelagerte Repositories in anderen Projekten befinden, muss ein Administrator in den Projekten mit vorgelagerten Repositories Berechtigungen zum Verwalten des Zugriffs auf diese Repositories haben.

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.
- Standardrepository erstellen
- Remote-Repository erstellen
Virtuelle Repositories verwenden den Artifact Registry Service Agent, um sich bei Upstream-Repositories zu authentifizieren. Sie müssen dem Dienstagenten Lesezugriff auf die Upstream-Repositories gewähren.

Sie können dem Artifact Registry-Dienst-Agent die Rolle „Artifact Registry Reader“ auf Projektebene gewähren, damit Sie keinen Zugriff auf einzelne vorgelagerte 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
```
Dabei gilt:
- 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 Rolle mit engeren Berechtigungen zuweisen möchten, fügen Sie die Berechtigung artifactregistry.repositories.readViaVirtualRepository einer benutzerdefinierten Rolle hinzu und gewähren Sie dem Dienst-Agent diese Rolle.

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 nach dem Erstellen des Repositorys nicht mehr geändert werden können:

Artefaktformat.
Repository-Modus, falls für das ausgewählte Format mehrere Modi verfügbar sind.
Speicherort des Repositorys
Verschlüsselung mit Google-eigenen und von Google verwalteten Verschlüsselungsschlüsseln oder vom Kunden verwalteten Verschlüsselungsschlüsseln. Artifact Registry verwendet standardmäßigGoogle-eigene und von Google verwaltete Verschlüsselungsschlüssel.

Artifact Registry erzwingt Einschränkungen von Organisationsrichtlinien, die CMEK zum Verschlüsseln von Ressourcen 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

Öffnen Sie in der Google Cloud -Konsole 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 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 Speicherort wie das virtuelle Repository befinden, 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. Werte mit höherer Priorität haben Vorrang vor Werten mit niedrigerer Priorität. Lassen Sie zwischen den Prioritätswerten Platz, damit Sie Upstream-Repositories mit Prioritäten hinzufügen können, die zwischen den vorhandenen Werten liegen.
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 Typen von Speicherorten und unterstützten Speicherorten finden Sie unter Repository-Speicherorte.
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.
Wenn Sie Ihre Repositories mit Labels strukturieren 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 Verschlüsselungsschlü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, gehen Sie so vor:

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

Virtuelles Repository mit der gcloud CLI erstellen

Wenn Sie ein virtuelles Repository erstellen möchten, definieren Sie Ihre Upstream-Repositories in einer Richtliniendatei und erstellen Sie dann das Repository 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 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 Speicherort wie das virtuelle Repository befinden, kann sich aber 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. Werte mit höherer Priorität haben Vorrang vor Werten mit niedrigerer Priorität.
Das folgende Beispiel zeigt eine Richtliniendatei namens policies.json mit vier Upstream-Repositories. upstream1 hat den höchsten Wert für priority. Daher wird in Artifact Registry zuerst danach gesucht. upstream-test hat den niedrigsten priority-Wert, daher wird in Artifact Registry zuerst danach gesucht. upstream2 und upstream3 haben dieselbe Priorität. Wenn Artifact Registry ein angefordertes Paket in Repositories mit derselben Priorität findet, kann es das Paket aus einem beliebigen Repository bereitstellen.
```
[{
"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 ein upstream-3-Repository mit der Priorität 70 hinzufügen, damit die Artifact Registry darin vor upstream-test sucht.

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.
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 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 vertraulichen Daten an, da Repository-Beschreibungen nicht verschlüsselt werden.
- UPSTREAM_POLICY_FILE ist der Pfad zur Upstream-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 Cloudnoch 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-Repositories. Das virtuelle Repository und das Upstream-Repository müssen sich in derselben Region oder in mehreren Regionen befinden.
UPSTREAM_REPOSITORY_ID ist die ID des Upstream-Repositorys.
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 für das virtuelle Repository. 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: Google-eigene und von Google verwaltete Verschlüsselungsschlüssel, die von Google Cloud bereitgestellt werden.
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
    }
  }
}

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 ID des Upstream-Repositorys.
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 für das virtuelle Repository. 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: Google-eigene und von Google verwaltete Verschlüsselungsschlüssel, die von Google Cloud bereitgestellt werden.
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 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-Versionierungsrichtlinie, um nicht eindeutige Snapshots zu akzeptieren, die vorhandene Versionen im Repository überschreiben.

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 ID des Upstream-Repositorys.
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 für das virtuelle Repository. 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: Google-eigene und von Google verwaltete Verschlüsselungsschlüssel, die von Google Cloud bereitgestellt werden.
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
    }
  }
}

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 ID des Upstream-Repositorys.
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 für das virtuelle Repository. 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: Google-eigene und von Google verwaltete Verschlüsselungsschlüssel, die von Google Cloud bereitgestellt werden.
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 aufzurufen:

gcloud artifacts repositories describe REPOSITORY \
    --location=LOCATION

Nachdem Sie das Repository erstellt haben, gehen Sie so vor:

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

Upstream-Repositories aktualisieren

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

Console

Öffnen Sie in der Google Cloud -Konsole 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 Virtuelles 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 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 eine leere Liste von Repositories enthalten.
```
[]
```
Führen Sie den folgenden Befehl aus, um die Ä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 ändern.

Console

Öffnen Sie in der Google Cloud -Konsole 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 Folgendes:

REPOSITORY: Name des Repositorys. Wenn Sie ein Standard-Repository konfiguriert haben, wird bei Weglassen dieses Flags dieses Standard-Repository verwendet.
PROJECT: die Projekt-ID der Google Cloud. Wenn dieses Flag nicht angegeben ist, wird das aktuelle Projekt oder das Standardprojekt verwendet.
LOCATION ist der regionale oder multiregionale Speicherort des Repositorys. Mit diesem Flag können Sie Repositories an einem bestimmten Speicherort aufrufen. Wenn Sie einen Standard-Speicherort konfiguriert haben, wird bei Weglassen dieses Flags dieser Standardwert verwendet.
DESCRIPTION: eine Beschreibung für das Repository.