Gestire le immagini

Questa pagina spiega come gestire le immagini container in un repository Docker. La gestione delle immagini include l'elenco delle immagini in un repository, l'aggiunta di tag, l'eliminazione di tag, la copia delle immagini in un nuovo repository e l'eliminazione delle immagini.

Per informazioni sul push e sul pull delle immagini, vedi Push e pull delle immagini.

Prima di iniziare

1. Se il repository di destinazione non esiste, creane uno nuovo.
2. Verifica di disporre delle autorizzazioni richieste per il repository.
3. (Facoltativo) Configura le impostazioni predefinite per i comandi gcloud.

Ruoli obbligatori

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

• Visualizza immagini, file nelle immagini e tag: Lettore Artifact Registry (roles/artifactregistry.reader)
• Tagga le immagini o modifica i tag utilizzando Artifact Registry: Artifact Registry Writer (roles/artifactregistry.writer)
• Elimina immagini o rimuovi tag: Amministratore repository Artifact Registry (roles/artifactregistry.repoAdmin)

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.

Immagini della scheda

Modalità repository: standard, remoto

Puoi elencare le immagini utilizzando la Google Cloud console o gcloud CLI.

gcloud artifacts docker images list

gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY

gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE \
--include-tags

us-west1-docker.pkg.dev/my-project/my-repo

us-west1-docker.pkg.dev/my-project/my-repo/my-image

Elenco dei file

Modalità repository: standard, remoto

Puoi elencare i file in un repository, i file in tutte le versioni di un'immagine container specificata o i file in una versione specifica di un'immagine.

Per tutti i comandi seguenti, puoi impostare un numero massimo di file da restituire aggiungendo il flag --limit al comando.

Per elencare tutti i file nel progetto, nel repository e nella posizione predefiniti quando sono configurati i valori predefiniti:

gcloud artifacts files list

Per elencare i file in un progetto, un repository e una posizione specificati, esegui il comando:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION

Per elencare i file per tutte le versioni di un'immagine container specifica:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE

Per elencare i file per una versione specifica dell'immagine container:

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --version=VERSION

gcloud artifacts files list \
    --project=PROJECT \
    --repository=REPOSITORY \
    --location=LOCATION \
    --package=PACKAGE \
    --tag=TAG

Sostituisci i seguenti valori:

• LOCATION: la posizione regionale o multiregionale del repository.
• PROJECT: il tuo Google Cloud ID progetto. Se l'ID progetto contiene due punti (:), consulta Progetti basati sul dominio.
• REPOSITORY: il nome del repository in cui è archiviata l'immagine.
• PACKAGE: il nome dell'immagine.
• VERSION: il digest dell'immagine, una stringa che inizia con sha256:.
• TAG: il tag associato all'immagine del container.

Esempi

Considera le seguenti informazioni sull'immagine:

• Progetto: my-project
• Repository: my-repo
• Posizione del repository: us-west1
• Immagine: my-app

Il comando seguente elenca tutti i file nel repository my-repo nella posizione us-west1 all'interno del progetto predefinito:

gcloud artifacts files list \
    --location=us-west1 \
    --repository=my-repo

gcloud artifacts files list \
    --project=my-project \
    --location=us-west1 \
    --repository=my-repo \
    --package=my-app \
    --version=sha256:88b205d7995332e10e836514fbfd59ecaf8976fc15060cd66e85cdcebe7fb356

gcloud artifacts files list \
    --project=my-project \
    --location=us-west1 \
    --repository=my-repo \
    --package=my-app \
    --tag=1.0-dev

Tagging delle immagini

Puoi taggare le immagini esistenti in un repository Artifact Registry oppure puoi taggarle prima di eseguirne il push in un repository.

Tagging delle immagini in un repository

Modalità repository: standard

Puoi aggiungere un tag a un'immagine in un repository Artifact Registry utilizzando Google Cloud console o la riga di comando. In un repository, i tag sono univoci per una versione di un'immagine. Pertanto, se hai più versioni di un'immagine, ogni tag si applica solo a una delle versioni. Se assegni a un'immagine un tag già in uso, il tag verrà spostato dalla versione originale a quella appena taggata.

gcloud artifacts docker tags add IMAGE-VERSION TAG

gcloud artifacts docker tags add \
us-west1-docker.pkg.dev/my-project/my-repo/my-image:iteration6-final \
us-west1-docker.pkg.dev/my-project/my-repo/my-image:release-candidate

Tagging delle immagini locali

Per eseguire il push di qualsiasi immagine locale in Artifact Registry, devi prima taggarla con il nome del repository ed eseguire il push dell'immagine. Per istruzioni, vedi Spingere e tirare.

Rimozione dei tag dalle immagini

Modalità repository: standard

Puoi rimuovere un tag da un'immagine in Artifact Registry utilizzando Google Cloud console o la riga di comando.

 gcloud artifacts docker tags delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE:TAG

Eliminazione delle immagini

Modalità repository: standard, remoto

Puoi eliminare un'intera immagine container o una versione specifica dell'immagine associata a un tag o un digest.

• Una volta eliminata un'immagine, non puoi annullare l'azione.
• L'eliminazione delle immagini non comporta l'eliminazione immediata dei livelli a cui fanno riferimento. I livelli senza riferimenti vengono eliminati ogni giorno.
• Per i repository remoti, la copia memorizzata nella cache dell'immagine viene rimossa. L'immagine rimane disponibile dalla sorgente upstream. Se il repository remoto riceve una nuova richiesta per la stessa immagine, il repository la scaricherà e la memorizzerà nuovamente nella cache.

Sono disponibili altri strumenti per aiutarti a gestire le immagini inutilizzate. Ad esempio, lo strumento gcr-cleaner trova ed elimina le immagini precedenti in base a diversi criteri. La rimozione delle immagini non utilizzate può aiutarti a ridurre i costi di archiviazione. Lo strumento gcr-cleaner non è un prodotto Google ufficiale.

Per eliminare un'immagine dalla console Google Cloud o da gcloud CLI:

gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE --delete-tags

gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE:TAG [--delete-tags]

gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE@IMAGE-DIGEST [--delete-tags]

Passaggi successivi

• Scarica singoli file memorizzati all'interno di un'immagine senza utilizzare i comandi Docker. Questa opzione può essere utile per ispezionare rapidamente i file manifest.