Push e pull delle immagini

Il push (caricamento) e il pull (download) delle immagini sono due delle attività più comuni di Container Registry. Questo documento si concentra sul push e sul pull delle immagini con Docker.

Se utilizzi Cloud Build, consulta la documentazione di Cloud Build per informazioni sulla creazione e sul push dei container in Container Registry.

Per istruzioni su come elencare, taggare ed eliminare immagini, consulta Gestione delle immagini.

Prima di iniziare

Assicurati di avere:

  1. Abilitare Container Registry nel progetto.

  2. Ha installato e configurato Docker.

Aggiunta di un registro

A un progetto puoi aggiungere i seguenti registry Container Registry:

Nome host Località di archiviazione
gcr.io Memorizza le immagini in data center negli Stati Uniti
asia.gcr.io Archivia immagini nei data center in Asia
eu.gcr.io Archivia immagini nei data center all'interno degli stati membri dell'Unione Europea
us.gcr.io Archivia immagini nei data center negli Stati Uniti

Il primo push di un'immagine a un nome host attiva la creazione del registro in di un progetto e del bucket Cloud Storage corrispondente. Questo push iniziale richiede autorizzazioni a livello di progetto per creare bucket di archiviazione.

Una volta che nel progetto è presente un host del registry, puoi configurare le autorizzazioni sul bucket di archiviazione per controllare l'accesso alle immagini nel registry.

Per aggiungere un registry e configurare le autorizzazioni:

  1. Verifica di disporre delle autorizzazioni richieste. Devi disporre del ruolo Amministratore archiviazione (roles/storage.admin) o di un ruolo personalizzato o ruolo predefinito con le stesse autorizzazioni.

    Per istruzioni su come concedere il ruolo Amministratore archiviazione a livello di progetto, consulta la documentazione di IAM.

  2. Esegui il push di un'immagine iniziale sull'host. Ad esempio, i seguenti comandi:

    • Esegui il pull dell'immagine busybox da Docker Hub
    • Tagga l'immagine con il relativo percorso di destinazione in Container Registry, inclusi l'gcr.io host del registry e l'ID progetto my-project
    • esegui il push dell'immagine nel registry
    docker pull busybox
docker tag busybox gcr.io/my-project/busybox
docker push gcr.io/my-project/busybox

Container Registry aggiunge il registro al progetto, crea uno spazio di archiviazione bucket per il registry e archivia l'immagine.

Ora puoi configurare il controllo dell'accesso nel bucket di archiviazione del registry per concedere l'accesso al registry ad altri utenti.

Eseguire il push di un'immagine in un registry

Per eseguire il push di qualsiasi immagine locale in Container Registry utilizzando Docker o un altro strumento di terze parti, devi prima contrassegnarla con il nome del registry ed eseguire il push dell'immagine.

I seguenti fattori potrebbero influire sui caricamenti di immagini di grandi dimensioni:

Tempo di caricamento
Qualsiasi richiesta inviata a Container Registry ha un limite di timeout di 2 ore. Se esegui l'autenticazione in Container Registry utilizzando un token di accesso, il token scade dopo 60 minuti. Se prevedi che il tempo di caricamento supererà i 60 minuti, utilizza un altro metodo di autenticazione.
Dimensioni dell'immagine
Container Registry si avvale di Cloud Storage per la capacità di archiviazione sottostante di ogni registro. A ogni registry si applicano le quote e i limiti di Cloud Storage, inclusa la dimensione massima di 5 TB per un oggetto nello spazio di archiviazione.
Container Registry non supporta i caricamenti a blocchi Docker. Alcuni strumenti supportano il caricamento di immagini di grandi dimensioni tramite caricamenti a blocchi o un un singolo caricamento monolitico. Devi utilizzare caricamenti monolitici per eseguire il push delle immagini e Container Registry.

Autorizzazioni obbligatorie

Per eseguire il push di un'immagine è necessario uno dei seguenti ruoli Cloud Storage o un ruolo con le stesse autorizzazioni:

Eseguire il push della prima immagine in un registry nel progetto

Ruolo: Amministratore Storage (roles/storage.admin) presso A livello di progetto Google Cloud. Il ruolo Proprietario predefinito include queste autorizzazioni.

La prima volta che esegui il push di un'immagine a un host del registro nel tuo progetto (ad esempio gcr.io), Container Registry crea un bucket di archiviazione per registro di sistema. Il ruolo Amministratore Storage dispone delle autorizzazioni necessarie per creare il bucket di archiviazione.

Push delle immagini in un registro esistente nel progetto

Ruolo: Writer bucket legacy Storage (roles/storage.legacyBucketWriter) nella di archiviazione del registry.

Questo ruolo dispone delle autorizzazioni per eseguire il push e il pull delle immagini per gli host del registro esistenti nel tuo progetto. Ad esempio, se il progetto contiene solo gcr.io , un utente con il ruolo Writer bucket legacy Storage può eseguire il push delle immagini gcr.io ma non può eseguire il push delle immagini a asia.gcr.io.

Per informazioni su come concedere autorizzazioni a un registry, consulta Configurare il controllo dell'accesso.

Contrassegna l'immagine locale con il nome del registro

Per taggare un'immagine:

  1. Verifica di aver configurato l'autenticazione su e Container Registry.

  2. Determina il nome dell'immagine in Container Registry:

    1. Scegli un nome host che specifichi la posizione in cui memorizzerai l'immagine.

      • gcr.io ospita immagini nei data center negli Stati Uniti, ma la località potrebbe cambiare in futuro
      • us.gcr.io ospita immagini nei data center negli Stati Uniti, in una bucket di archiviazione separato dalle immagini ospitate da gcr.io
      • eu.gcr.io ospita le immagini nell'Unione europea
      • asia.gcr.io ospita immagini nei data center in Asia

      Queste località corrispondono più regioni per di archiviazione di Cloud Storage. Quando esegui il push di un'immagine in un registry con un nuovo nome host, Container Registry crea un bucket di archiviazione nella regione multipla specificata. Questo bucket è lo spazio di archiviazione sottostante registro di sistema. All'interno di un progetto, tutti i registry con lo stesso nome host condividono un bucket di archiviazione.

      Nella console, il nome host delle immagini sarà elencato in Posizione.

    2. Scegli un nome per l'immagine di destinazione, che può essere diverso dal nome dell'immagine. sul tuo computer locale. Ad esempio, l'immagine locale potrebbe essere web-image, ma vuoi archiviarlo in Container Registry come web-site

    3. Combina il nome host, l'ID progetto della console Google Cloud e il nome dell'immagine di destinazione:

      HOSTNAME/PROJECT-ID/TARGET-IMAGE

      Considera l'esempio seguente:

      • Nome host: gcr.io
      • Progetto Google Cloud: my-project
      • Nome dell'immagine target: web-site

      La combinazione del nome host, del progetto e dell'immagine di destinazione fornisce il percorso completo dell'immagine da utilizzare per il tagging:

      gcr.io/my-project/web-site

      Se l'ID progetto contiene due punti (:), consulta Progetti basati sul dominio.

  3. Tagga l'immagine locale con il nome del passaggio precedente. Se vuoi etichettare questa versione dell'immagine con un tag, includi il nome del tag.

    docker tag SOURCE_IMAGE HOSTNAME/PROJECT-ID/TARGET-IMAGE:TAG

    Sostituisci quanto segue:

    • SOURCE_IMAGE è il nome o l'ID immagine locale.
    • HOSTNAME è l'host del registry che hai scelto nel passaggio 2.
    • PROJECT è l'ID del progetto Google Cloud.
    • TARGET-IMAGE è il nome dell'immagine quando è archiviata in Container Registry.
    • TAG è il tag che vuoi associare a questa versione dell'immagine.

    Ad esempio, questo comando contrassegna l'immagine locale web-image come gcr.io/my-project/web-site in Container Registry con il tag v1.5

    docker tag web-image gcr.io/my-project/web-site:v1.5

    Se non specifichi un tag, Docker aggiunge il tag predefinito latest. Dal giorno latest è un tag predefinito e rappresenta la versione dell'immagine più recente con il tag latest e non necessariamente la versione più recente di un dell'immagine.

Docker assegna un tag all'immagine con il nome e il tag specificati nel comando.

Esegui il push dell'immagine con tag in Container Registry

  1. Verifica di aver configurato l'autenticazione per Container Registry.

  2. Esegui il push dell'immagine taggata in Container Registry:

    Esegui questo comando per eseguire il push di un'immagine con un tag specifico:

    docker push HOSTNAME/PROJECT-ID/IMAGE:TAG

    Se ometti :TAG, Docker spinge la versione dell'immagine con il tag latest.

    Ad esempio, questo comando spinge l'immagine gcr.io/my-project/web-site con il tag v1.5:

    docker push gcr.io/my-project/web-site:v1.5

Quando esegui il push di un'immagine in un host del registro che non esiste ancora progetto, Container Registry crea un bucket di archiviazione per l'host del registro.

Per visualizzare l'immagine che hai inviato:

  • Vai alla console Google Cloud per visualizzare il registry e l'immagine.

  • Esegui gcloud container images list-tags per visualizzare il tag immagine e il digest generato automaticamente:

    gcloud container images list-tags HOSTNAME/PROJECT-ID/IMAGE

    L'output del comando è simile al seguente:

    DIGEST        TAGS        TIMESTAMP
44bde...      test        2017-..-..

Pull delle immagini da un registro

Il pull di un'immagine richiede Visualizzatore oggetti Storage per il bucket di archiviazione del registry o un ruolo con le stesse autorizzazioni.

Per eseguire il pull da Container Registry, utilizza il comando:

docker pull HOSTNAME/PROJECT-ID/IMAGE:TAG

o

docker pull HOSTNAME/PROJECT-ID/IMAGE@IMAGE_DIGEST

dove:

  • HOSTNAME è elencato in Posizione nella console. È uno di quattro opzioni: gcr.io, us.gcr.io, eu.gcr.io o asia.gcr.io.
  • PROJECT-ID è l'ID progetto della console Google Cloud. Se l'ID progetto contiene i due punti (:), consulta Progetti con ambito dominio.
  • IMAGE è il nome dell'immagine in Container Registry.
  • TAG è il tag applicato all'immagine. In un registry, i tag sono univoci per un'immagine.
  • IMAGE_DIGEST è il valore hash sha256 dei contenuti dell'immagine. Nella console Google Cloud, fai clic sull'immagine specifica per visualizzarne i metadati. Il digest è elencato come Digest immagine.

Per ottenere il comando pull per un'immagine specifica:

  1. Fai clic sul nome di un'immagine per accedere al registro specifico.

  2. Nel Registro di sistema, seleziona la casella accanto alla versione dell'immagine che vuoi estrarre.

  3. Fai clic su MOSTRA COMANDO PULL nella parte superiore della pagina.

  4. Copia il comando pull, che identifica l'immagine utilizzando il tag o il digest.

Passaggi successivi