Artefaktmetadaten in Anhängen speichern

gcloud (alle Formate)

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.
• 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.
• TYPE: das Attribut type des Anhangs. Für Docker-Images muss type den OCI-Spezifikationen für das Attribut artifactType entsprechen.
• ATTACHMENT_NAMESPACE: Eine anhangsspezifische Variable, die die Datenquelle des Anhangs identifiziert, z. B. example.com.
• FILES: Eine durch Kommas getrennte Liste lokaler Dateien, die in den Anhang aufgenommen werden sollen.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

gcloud artifacts attachments create ATTACHMENT \
    --target=TARGET \
    --attachment-type=TYPE \
    --attachment-namespace=ATTACHMENT_NAMESPACE \
    --files=FILES

Windows (PowerShell)

gcloud artifacts attachments create ATTACHMENT `
    --target=TARGET `
    --attachment-type=TYPE `
    --attachment-namespace=ATTACHMENT_NAMESPACE `
    --files=FILES

Windows (cmd.exe)

gcloud artifacts attachments create ATTACHMENT ^
    --target=TARGET ^
    --attachment-type=TYPE ^
    --attachment-namespace=ATTACHMENT_NAMESPACE ^
    --files=FILES

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

Oras (nur Docker)

Wenn Sie mit Oras einen Anhang erstellen, generiert Artifact Registry eine zufällige UUID, die als Name des Anhangs verwendet wird.

Führen Sie vor der Verwendung von Oras die folgenden Schritte aus:

1. Installieren Sie Oras 1.2 oder höher. Führen Sie den Befehl oras version aus, um Ihre Version zu prüfen.

2. Konfigurieren Sie Oras für die Authentifizierung bei Artifact Registry.

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

• ARTIFACT_TYPE: die artifactType des Anhangs.

• IMAGE_URI: Der URI des Bildcontainers, auf den sich der Anhang bezieht.

• FILE: Eine lokale Datei, die als Metadaten in den Anhang aufgenommen werden soll.

• MEDIA_TYPE: die mediaType der Ebene.

  oras attach --artifact-type ARTIFACT_TYPE IMAGE_URI FILE:MEDIA_TYPE

Im folgenden Beispiel wird ein Anhang erstellt, der aus einer Datei (hello-world.txt) besteht, die auf ein Container-Image (my-image) verweist, das durch seinen URI und sein Tag identifiziert wird:

  oras attach --artifact-type doc/example \
  us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1 \
  hello-world.txt:application/vnd.me.hi

Wobei:

• doc/example definiert das Attribut artifactType der Anlage.

• us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1 ist der URI einschließlich des Tags der Container-Image-Version, auf die sich die Anlage bezieht.

• hello-world.txt ist die lokale Datei, die die Daten des Anhangs enthält.

• application/vnd.me.hi definiert die mediaType der Ebene.

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