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 e l'eliminazione di tag, copia delle immagini in un nuovo repository ed eliminazione delle immagini.
Per informazioni su come eseguire il push e il pull delle immagini, consulta la pagina Push e pull delle immagini.
Prima di iniziare
- Se il repository di destinazione non esiste, creane uno nuovo.
- Verifica di disporre delle autorizzazioni necessarie per il repository.
- (Facoltativo) Configura i valori predefiniti 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 e tag:
Artifact Registry Reader (
roles/artifactregistry.reader
) -
Tagga le immagini o modifica i tag utilizzando Artifact Registry:
Artifact Registry Writer (
roles/artifactregistry.writer
) -
Elimina le immagini o rimuovi i tag:
Amministratore repository di Artifact Registry (
roles/artifactregistry.repoAdmin
)
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.
Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Immagini scheda
Modalità repository: standard, remoto
Puoi elencare le immagini utilizzando la console Google Cloud o gcloud CLI.
L'elenco dei repository include i repository Artifact Registry e Container Registry. Per lavorare con le immagini in un repository di Container Registry, consulta la documentazione di Container Registry per la gestione delle immagini.Console
Per visualizzare le immagini in un repository:
Apri la pagina Repositories nella console Google Cloud.
Fai clic sul repository con l'immagine container.
Fai clic su un'immagine per visualizzarne le versioni.
gcloud
Per elencare tutte le immagini nel progetto, nel repository e nella località predefiniti quando sono configurati i valori predefiniti:
gcloud artifacts docker images list
Per elencare le immagini in un repository in una località specifica, esegui il comando:
gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY
Per elencare tutti i digest e i tag per un'immagine specifica, esegui il comando:
gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE \
--include-tags
Sostituisci i seguenti valori:
- LOCATION è lalocalità a una o più regionia livello di una località del repository.
- PROJECT è il tuo ID progetto Google Cloud. Se l'ID progetto contiene i due punti (":"), consulta Progetti con ambito di dominio.
- REPOSITORY è il nome del repository in cui è archiviata l'immagine.
- IMAGE è il nome dell'immagine nel repository.
--include-tags
mostra tutte le versioni delle immagini, inclusi digest e tag. Se questo flag viene omesso, l'elenco restituito include solo le immagini container di primo livello.
Ad esempio, considera un'immagine con le seguenti caratteristiche:
- Località del repository:
us-west1
- Nome repository:
my-repo
- ID progetto:
my-project
- Nome immagine:
my-image
Il nome completo del repository è:
us-west1-docker.pkg.dev/my-project/my-repo
Il nome completo dell'immagine è:
us-west1-docker.pkg.dev/my-project/my-repo/my-image
Per maggiori dettagli sul formato del nome delle immagini, consulta Nomi di repository e immagini.
Elenco dei file
Modalità repository: standard, remoto
Puoi elencare i file di 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 il 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 di 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
Per elencare i file relativi a un tag specifico:
gcloud artifacts files list \
--project=PROJECT \
--repository=REPOSITORY \
--location=LOCATION \
--package=PACKAGE \
--tag=TAG
Sostituisci i seguenti valori:
LOCATION
: la una o più regioni località del repository.PROJECT
: il tuo ID progetto Google Cloud. Se l'ID progetto contiene i due punti (":"), consulta Progetti con ambito di dominio.REPOSITORY
: il nome del repository in cui è archiviata l'immagine.PACKAGE
: il nome dell'immagine.VERSION
: il digest immagine, una stringa che inizia consha256:
.TAG
: il tag associato all'immagine container.
Esempi
Considera le seguenti informazioni sull'immagine:
- Progetto:
my-project
- Repository:
my-repo
- Località del repository:
us-west1
- Immagine:
my-app
Il seguente comando 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
Il comando seguente elenca i file nella versione dell'immagine con il
digest sha256:88b205d7995332e10e836514fbfd59ecaf8976fc15060cd66e85cdcebe7fb356
gcloud artifacts files list \
--project=my-project \
--location=us-west1 \
--repository=my-repo \
--package=my-app \
--version=sha256:88b205d7995332e10e836514fbfd59ecaf8976fc15060cd66e85cdcebe7fb356
Il comando seguente elenca i file che si trovano nella versione dell'immagine con il
tag 1.0-dev
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 codificarle 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 la console Google Cloud o la riga di comando. In un repository, i tag sono univoci per la versione di un'immagine. Quindi, se disponi di più versioni di un'immagine, ogni tag viene applicato solo a una delle versioni. Se tagghi un'immagine con un tag già in uso, sposterai il tag dalla versione originale alla nuova versione con tag.
Console
Per taggare un'immagine in un repository:
Apri la pagina Repositories nella console Google Cloud.
Fai clic sull'immagine per visualizzarne le versioni.
Seleziona la versione dell'immagine da taggare.
Nella riga della versione selezionata, fai clic su Altre azioni (
) e poi su Modifica tag.
Digita i nuovi tag nel campo e fai clic su SALVA.
gcloud
Per taggare le immagini in un repository, specifica la versione dell'immagine utilizzando il digest dell'immagine o il tag, quindi specifica il tag da aggiungere. Esegui uno dei seguenti comandi:
gcloud artifacts docker tags add IMAGE-VERSION TAG
Dove
- IMAGE-VERSION è il nome completo della versione dell'immagine da taggare, utilizzando il digest dell'immagine o un tag esistente nella versione dell'immagine.
- TAG è il nome completo del tag da aggiungere.
Ad esempio, considera un'immagine con le seguenti caratteristiche:
- Località del repository:
us-west1
- Nome repository:
my-repo
- ID progetto:
my-project
- Nome immagine:
my-image
- Tag esistente:
iteration6-final
- Tag da aggiungere:
release-candidate
Per aggiungere il tag release-candidate
alla versione dell'immagine con il tag
iteration6-final
, esegui questo comando:
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
Per maggiori dettagli sul formato del nome delle immagini, compresa la gestione dei progetti con ambito di dominio, consulta Nomi di repository e immagini.
Taggare le 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 le istruzioni, consulta la sezione Push e pull.
Annullamento del tagging delle immagini
Modalità repository: standard
Puoi rimuovere un tag da un'immagine in Artifact Registry utilizzando la console Google Cloud o la riga di comando.
Console
Apri la pagina Repositories nella console Google Cloud.
Fai clic sull'immagine per visualizzarne le versioni.
Seleziona la versione dell'immagine di cui rimuovere il tag.
Nella riga della versione selezionata, fai clic su Altre azioni (
) e poi su Modifica tag.
Elimina il tag e fai clic su SALVA.
gcloud
Per eliminare un tag e rimuoverlo dall'immagine, esegui questo comando:
gcloud artifacts docker tags delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE:TAG
Dove
- LOCATION è lalocalità a una o più regionia livello di una località del repository.
- PROJECT è il tuo ID progetto Google Cloud. Se l'ID progetto contiene i due punti (":"), consulta Progetti con ambito di dominio.
- REPOSITORY è il nome del repository in cui è archiviata l'immagine.
- IMAGE è il nome dell'immagine nel repository.
- TAG è il tag relativo alla versione da eliminare.
Eliminazione delle immagini
Modalità repository: standard, remoto
Puoi eliminare un'intera immagine container o una versione specifica dell'immagine associata a un tag o a un digest.
- Una volta eliminata un'immagine, non potrai annullare l'azione.
- L'eliminazione delle immagini non comporta l'eliminazione immediata dei livelli a cui viene fatto 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 a monte. Se il repository remoto riceve una nuova richiesta per la stessa immagine, verrà scaricata e memorizzata nuovamente nella cache.
Sono disponibili altri strumenti per aiutarti a gestire le immagini inutilizzate. Ad esempio, lo strumento gcr-cleaner trova ed elimina le vecchie immagini in base a criteri diversi. La rimozione delle immagini inutilizzate può aiutarti a ridurre i costi di archiviazione. Lo strumento gcr-cleaner
non è un
prodotto ufficiale di Google.
Per eliminare un'immagine dalla console Google Cloud o da gcloud CLI:
Console
Apri la pagina Repositories nella console Google Cloud.
Fai clic sul nome dell'immagine per visualizzarne le versioni.
Seleziona le versioni che vuoi eliminare.
Fai clic su ELIMINA.
Nella finestra di dialogo di conferma, fai clic su ELIMINA.
gcloud
Per eliminare un'immagine e tutti i relativi tag, esegui il comando:
gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE --delete-tags
Per eliminare una versione specifica dell'immagine, utilizza uno dei seguenti comandi.
gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE:TAG [--delete-tags]
o
gcloud artifacts docker images delete LOCATION-docker.pkg.dev/PROJECT/REPOSITORY/IMAGE@IMAGE-DIGEST [--delete-tags]
Dove
- LOCATION è lalocalità a una o più regionia livello di una località del repository.
- PROJECT è il tuo ID progetto Google Cloud. Se l'ID progetto contiene i due punti (":"), consulta Progetti con ambito di dominio.
- REPOSITORY è il nome del repository in cui è archiviata l'immagine.
- IMAGE è il nome dell'immagine nel repository.
- TAG è il tag relativo alla versione da eliminare.
Se più tag sono associati alla stessa versione dell'immagine, devi includere
--delete-tags
per eliminare la versione dell'immagine senza rimuovere prima i tag. - IMAGE-DIGEST è il valore hash sha256 della versione
che vuoi eliminare. Se un tag è associato al digest immagine, devi includere
--delete-tags
per eliminare la versione dell'immagine senza rimuovere prima il tag. --delete-tags
rimuove tutti i tag applicati alla versione immagine. Questo flag consente di forzare l'eliminazione di una versione dell'immagine quando:- Hai specificato un tag, ma altri tag sono associati alla versione dell'immagine.
- Hai specificato un digest immagine con almeno un tag.
Passaggi successivi
- Scarica singoli file archiviati in un'immagine senza utilizzare i comandi Docker. Questo può essere utile per controllare rapidamente i file manifest.