Artefaktmetadaten verwalten

Auf dieser Seite wird beschrieben, wie Sie Metadaten verwalten, die mit einem Artefakt verknüpft sind, das als Anhang in Artifact Registry gespeichert ist.

Anhänge sind Dateien, in denen Metadaten zu einem zugehörigen Artefakt gespeichert sind, das in Artifact Registry gespeichert ist. Informationen zum Erstellen einer Anlage finden Sie unter Artefaktmetadaten in Anlagen speichern.

Hinweise

Optional: Standardeinstellungen für Google Cloud CLI-Befehle konfigurieren.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Repository zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Verwalten von Anhängen benötigen:

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.

Listenanhänge

Ein Artefakt in Artifact Registry kann beliebig viele Anhänge haben, die darauf verweisen. Sie können Anhänge mit der Google Cloud Console, der gcloud CLI oder, nur für Container-Images im Docker-Format, Oras auflisten.

Konsole (nur Docker)

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

    Zur Seite „Repositories“

  2. Klicken Sie auf den Namen des Repositorys, um die Bilder darin aufzurufen.

  3. Klicken Sie auf den Namen des Bildes, um die Versionen eines Bildes aufzurufen.

  4. Klicken Sie auf die gewünschte Bildversion.

  5. Wenn Sie die Anhänge für diese Version aufrufen möchten, klicken Sie auf den Tab Anhänge.

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

  • TARGET: Der vollständig qualifizierte Versionsname. Nur für Docker-Images können Sie auch den Artifact Registry-URI des Artefakts verwenden, auf das sich die Anlage bezieht. Im URI können Sie den Digest oder, für Docker-Images, das Tag verwenden, z. B. us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud artifacts attachments list \
    --target=TARGET

Windows (PowerShell)

gcloud artifacts attachments list `
    --target=TARGET

Windows (cmd.exe)

gcloud artifacts attachments list ^
    --target=TARGET
 Weitere Informationen finden Sie im Befehl gcloud artifacts attachments list.

Oras (nur Docker)

Bevor Sie den Befehl ausführen, ersetzen Sie die folgenden Werte:

  • IMAGE_URI: Der URI des Zielbildes, auf das in den aufgeführten Anhängen verwiesen wird.
oras discover --distribution-spec v1.1-referrers-api IMAGE_URI

Im folgenden Beispiel werden Anhänge für ein Container-Image (my-image) aufgeführt, das durch seinen URI und sein Tag identifiziert wird:

oras discover --distribution-spec v1.1-referrers-api \
us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1

Wobei:

  • v1.1-referrers-api ist die verwendete Referrer API. Weitere Informationen finden Sie in der Verteilungsspezifikation.

  • us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1 ist der URI einschließlich des Tags der Container-Image-Version, für die Anhänge aufgeführt werden sollen.

Eine vollständige Anleitung und weitere Beispiele finden Sie in der Dokumentation zu oras discover.

Anhänge beschreiben

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

  • ATTACHMENT: Der voll qualifizierte Name des Anhangs, z. B. projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment. Alternativ können Sie nur die Anhänge-ID angeben und die Flags --location und --repository verwenden.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud artifacts attachments describe ATTACHMENT

Windows (PowerShell)

gcloud artifacts attachments describe ATTACHMENT

Windows (cmd.exe)

gcloud artifacts attachments describe ATTACHMENT
 Weitere Informationen finden Sie im Befehl gcloud artifacts attachments describe.

Anhänge herunterladen

Sie können Anhänge mit der gcloud CLI oder, nur für Container-Images im Docker-Format, mit Oras herunterladen.

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

  • ATTACHMENT: Der voll qualifizierte Name des Anhangs, z. B. projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment. Alternativ können Sie nur die Anhänge-ID angeben und die Flags --location und --repository verwenden.
  • DESTINATION: Der Pfad in Ihrem lokalen Dateisystem, in den die Anlage heruntergeladen werden soll.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud artifacts attachments download ATTACHMENT \
    --destination=DESTINATION

Windows (PowerShell)

gcloud artifacts attachments download ATTACHMENT `
    --destination=DESTINATION

Windows (cmd.exe)

gcloud artifacts attachments download ATTACHMENT ^
    --destination=DESTINATION
 Für Anhänge in Docker-Format-Repositories können Sie anstelle von ATTACHMENT das Flag --oci-version-name gefolgt vom vollständigen Versionsnamen oder dem Artifact Registry-URI des Anhangs angeben. Sie können entweder den Digest oder das Tag verwenden, z. B. projects/my-project/locations/us-west1/repositories/my-repo/packages/my-package/versions/sha256:abc123.

Weitere Informationen finden Sie im gcloud artifacts attachments download-Befehl.

Oras (nur Docker)

Bevor Sie den Befehl ausführen, ersetzen Sie die folgenden Werte:

  • DESTINATION: Das Zielverzeichnis für den Anhang.

  • ATTACHMENT_URI: Der URI des herunterzuladenden Anhangs. Dies ist der URI für den Image-Container, auf den sich der Anhang bezieht, gefolgt vom eindeutigen SHA des Anhangs.

oras pull -o DESTINATION ATTACHMENT_URI

Im folgenden Beispiel wird ein Anhang heruntergeladen, der durch seinen URI und Digest identifiziert wird:

oras pull -o . us-west1-docker.pkg.dev/my-project/my-repo/my-image@sha256:xxxx

Wobei:

  • Mit -o . wird das aktuelle Verzeichnis als Downloadziel angegeben.

  • us-west1-docker.pkg.dev/my-project/my-repo/my-image@sha256:xxxx ist der Bild-URI einschließlich des Digests des herunterzuladenden Anhangs.

Eine vollständige Anleitung und weitere Beispiele finden Sie in der Dokumentation zu oras pull.

Anhänge löschen

Sie können Anhänge direkt über die Google Cloud Console oder die gcloud CLI löschen. Sie können Anhänge indirekt löschen, indem Sie das Artefakt löschen, auf das sie verweisen.

Anhänge direkt löschen

Sie haben folgende Möglichkeiten, Anhänge direkt zu löschen:

Konsole (nur Docker)

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

    Zur Seite „Repositories“

  2. Klicken Sie auf den Namen des Repositorys, um die Bilder darin aufzurufen.

  3. Klicken Sie auf den Namen des Bildes, um die Versionen des Bildes aufzurufen.

  4. Klicken Sie auf die Version des Bildes, für die Sie Anhänge aufrufen möchten.

  5. Klicken Sie auf den Tab Anhänge, um die Anhänge für diese Version aufzurufen.

  6. Klicken Sie auf den Kurztext des Anhangs, den Sie löschen möchten.

  7. Klicken Sie auf Delete.

  8. Klicken Sie im Bestätigungsdialogfeld auf LÖSCHEN.

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

  • ATTACHMENT: Der voll qualifizierte Name des Anhangs, z. B. projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment. Alternativ können Sie nur die Anhänge-ID angeben und die Flags --location und --repository verwenden.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud artifacts attachments delete ATTACHMENT

Windows (PowerShell)

gcloud artifacts attachments delete ATTACHMENT

Windows (cmd.exe)

gcloud artifacts attachments delete ATTACHMENT
 Weitere Informationen finden Sie im gcloud artifacts attachments delete-Befehl.

Anhänge indirekt löschen

Wenn ein Artefakt gelöscht wird, werden auch alle Anhänge mit dem Versionsnamen des gelöschten Artefakts als target gelöscht. Dies gilt sowohl für das manuelle Löschen von Artefakten als auch für das Löschen aufgrund von Bereinigungsrichtlinien.

Nächste Schritte