Gestire i metadati degli elementi

Gli allegati di Artifact Registry ti consentono di archiviare e gestire i file di metadati associati ai tuoi artefatti. Puoi elencare, esaminare, scaricare ed eliminare gli allegati utilizzando la console Google Cloud , gcloud CLI o le immagini container Oras per Docker.

Per scoprire come creare un allegato, consulta Memorizzare i metadati degli artefatti negli allegati.

Prima di iniziare

(Facoltativo) Configura i valori predefiniti per i comandi Google Cloud CLI.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire gli allegati, chiedi all'amministratore di concederti i seguenti ruoli IAM nel repository:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Allegati elenco

Un artefatto in Artifact Registry può avere un numero qualsiasi di allegati che fanno riferimento a esso. Puoi elencare gli allegati utilizzando la console Google Cloud , gcloud CLI o, solo per le immagini container in formato Docker, Oras.

Console

  1. Nella console Google Cloud , apri la pagina Repository.

    Apri la pagina Repositori

  2. Fai clic sul nome del repository per visualizzare le immagini al suo interno.

  3. Per visualizzare le versioni di un'immagine, fai clic sul nome dell'immagine.

  4. Fai clic sulla versione dell'immagine appropriata.

  5. Per visualizzare gli allegati di quella versione, fai clic sulla scheda Allegati.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • TARGET: il nome completo della versione. Solo per le immagini Docker, puoi utilizzare anche l'URI Artifact Registry dell'artefatto a cui fa riferimento l'allegato. Nell'URI puoi utilizzare il digest o, per le immagini Docker, il tag, ad esempio, us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1.

Esegui questo comando:

Linux, macOS o 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
 Per ulteriori informazioni, consulta il comando gcloud artifacts attachments list.

Oras (solo Docker)

Prima di eseguire il comando, effettua la seguente sostituzione:

  • IMAGE_URI: l'URI dell'immagine di destinazione a cui fanno riferimento gli allegati elencati.
oras discover --distribution-spec v1.1-referrers-api IMAGE_URI

L'esempio seguente elenca gli allegati per un'immagine container, my-image, identificata dal relativo URI e tag:

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

Dove:

  • Viene utilizzata l'API Referrer v1.1-referrers-api. Per ulteriori informazioni, consulta i dettagli nella specifica di distribuzione.

  • us-west1-docker.pkg.dev/my-project/my-repo/my-image:tag1 è l'URI che include il tag della versione dell'immagine container per cui elencare gli allegati.

Per una guida completa e altri esempi, consulta la documentazione di oras discover.

Descrivere gli allegati

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • ATTACHMENT: il nome completo dell'allegato, ad esempio projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment. In alternativa, fornisci solo l'ID allegato e utilizza i flag --location e --repository.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud artifacts attachments describe ATTACHMENT

Windows (PowerShell)

gcloud artifacts attachments describe ATTACHMENT

Windows (cmd.exe)

gcloud artifacts attachments describe ATTACHMENT
 Per ulteriori informazioni, consulta il comando gcloud artifacts attachments describe.

Scaricare gli allegati

Puoi scaricare gli allegati utilizzando gcloud CLI o, solo per le immagini container in formato Docker, Oras.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • ATTACHMENT: il nome completo dell'allegato, ad esempio projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment. In alternativa, fornisci solo l'ID allegato e utilizza i flag --location e --repository.
  • DESTINATION: il percorso nel file system locale in cui scaricare l'allegato.

Esegui questo comando:

Linux, macOS o 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
 Per gli allegati nei repository in formato Docker, in alternativa a ATTACHMENT, puoi fornire il flag --oci-version-name seguito dal nome completo della versione dell'allegato o dall'URI Artifact Registry. Puoi utilizzare il digest o il tag, ad esempio projects/my-project/locations/us-west1/repositories/my-repo/packages/my-package/versions/sha256:abc123.

Per ulteriori informazioni, consulta il comando gcloud artifacts attachments download.

Oras (solo Docker)

Prima di eseguire il comando, effettua le seguenti sostituzioni:

  • DESTINATION: la directory di destinazione per l'allegato.

  • ATTACHMENT_URI: l'URI dell'allegato da scaricare. Questo è l'URI del container dell'immagine a cui fa riferimento l'allegato, seguito dall'SHA univoco dell'allegato.

oras pull -o DESTINATION ATTACHMENT_URI

L'esempio seguente scarica un allegato identificato dal relativo URI e digest:

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

Dove:

  • -o . assegna alla directory corrente il nome della destinazione di download.

  • us-west1-docker.pkg.dev/my-project/my-repo/my-image@sha256:xxxx è l'URI dell'immagine, incluso il digest dell'allegato da scaricare.

Per una guida completa e altri esempi, consulta la documentazione di oras pull.

Elimina allegati

Puoi eliminare gli allegati direttamente utilizzando la console Google Cloud o gcloud CLI. Puoi eliminare gli allegati indirettamente eliminando l'artefatto a cui fanno riferimento.

Eliminare gli allegati direttamente

Puoi eliminare gli allegati direttamente con una delle seguenti opzioni:

Console (solo Docker)

  1. Nella console Google Cloud , apri la pagina Repository.

    Apri la pagina Repositori

  2. Fai clic sul nome del repository per visualizzare le immagini al suo interno.

  3. Fai clic sul nome dell'immagine per visualizzarne le versioni.

  4. Fai clic sulla versione dell'immagine per cui vuoi visualizzare gli allegati.

  5. Fai clic sulla scheda Allegati per visualizzare gli allegati per quella versione.

  6. Fai clic sul riepilogo dell'allegato da eliminare.

  7. Fai clic su ELIMINA.

  8. Nella finestra di dialogo di conferma, fai clic su ELIMINA.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • ATTACHMENT: il nome completo dell'allegato, ad esempio projects/my-project/locations/us-west1/repositories/my-repo/attachments/my-attachment. In alternativa, fornisci solo l'ID allegato e utilizza i flag --location e --repository.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud artifacts attachments delete ATTACHMENT

Windows (PowerShell)

gcloud artifacts attachments delete ATTACHMENT

Windows (cmd.exe)

gcloud artifacts attachments delete ATTACHMENT
 Per ulteriori informazioni, consulta il comando gcloud artifacts attachments delete.

Eliminare gli allegati indirettamente

Se un artefatto viene eliminato, vengono eliminati anche tutti gli allegati con il nome della versione dell'artefatto eliminato come target. Ciò vale sia per l'eliminazione manuale degli artefatti sia per le eliminazioni causate dalle policy di pulizia.

Passaggi successivi