Archiviare immagini container Docker in Artifact Registry
Artifact Registry fornisce un'unica posizione per la gestione di pacchetti privati e immagini container Docker.
Questa guida rapida illustra come:
- Crea un repository Docker privato in Artifact Registry
- Configura l'autenticazione
- Esegui il push di un'immagine nel repository
- Esegui il pull dell'immagine dal repository
Per seguire le indicazioni dettagliate per questa attività direttamente nella console Google Cloud, fai clic su Procedura guidata:
Prima di iniziare
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Attiva l'API Artifact Registry.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Attiva l'API Artifact Registry.
Scegli una shell
Per completare questa guida rapida, utilizza Cloud Shell o la tua shell locale.
- Cloud Shell
- Cloud Shell è un ambiente shell per la gestione delle risorse ospitate su Google Cloud. Sono preinstallati Docker e Google Cloud CLI, l'interfaccia a riga di comando principale per Google Cloud.
- Shell locale
- Se preferisci utilizzare la tua shell locale, devi installare Docker e gcloud CLI nel tuo ambiente.
Avviare Cloud Shell
Per avviare Cloud Shell, segui questi passaggi:
Vai alla console Google Cloud.
Fai clic sul pulsante Attiva Cloud Shell: .
Si apre una sessione di Cloud Shell all'interno di un frame più in basso nella console.
Utilizzerai questa shell per eseguire i comandi gcloud
.
Configurazione di una shell locale
Per installare gcloud CLI e Docker, segui questi passaggi:
Installa gcloud CLI. Per aggiornare un'installazione esistente, esegui il comando
gcloud components update
.Installa Docker, se non è già installato.
Docker richiede un accesso privilegiato per interagire con i registri. Su Linux o Windows, aggiungi l'utente che utilizzi per eseguire i comandi Docker al gruppo di sicurezza Docker. Questo passaggio non è richiesto su macOS, perché Docker Desktop viene eseguito su una macchina virtuale come utente root.
Linux
Il gruppo di sicurezza Docker si chiama
docker
. Per aggiungere il tuo nome utente, esegui questo comando:sudo usermod -a -G docker ${USER}
Windows
Il gruppo di sicurezza Docker si chiama
docker-users
. Per aggiungere un utente dal prompt dei comandi dell'amministratore, esegui questo comando:net localgroup docker-users DOMAIN\USERNAME /add
Dove
- DOMAIN è il tuo dominio Windows.
- USERNAME è il tuo nome utente.
Esci e accedi nuovamente per rendere effettive le modifiche di appartenenza al gruppo. Se utilizzi una macchina virtuale, potrebbe essere necessario riavviarla affinché le modifiche all'appartenenza abbiano effetto.
Per assicurarti che Docker sia in esecuzione, esegui questo comando Docker, che restituisce la data e l'ora attuali:
docker run --rm busybox date
Il flag --rm
elimina l'istanza di container all'uscita.
crea un repository Docker
Crea un repository Docker in cui archiviare l'immagine di esempio per questa guida rapida.
Console
Apri la pagina Repository nella console Google Cloud.
Fai clic su add Crea repository.
Specifica
quickstart-docker-repo
come nome del repository.Scegli Docker come formato e Standard come modalità.
In Tipo di località, seleziona Regione, quindi scegli la località
us-west1
.Fai clic su Crea.
Il repository viene aggiunto all'elenco di repository.
gcloud
Esegui questo comando per creare un nuovo repository Docker denominato
quickstart-docker-repo
nella localitàus-west1
con la descrizione "docker repository".gcloud artifacts repositories create quickstart-docker-repo --repository-format=docker \ --location=us-west1 --description="Docker repository" \ --project=PROJECT
Dove PROJECT è l'ID progetto Google Cloud.
Esegui questo comando per verificare che il repository sia stato creato.
gcloud artifacts repositories list \ --project=PROJECT
Per ulteriori informazioni sui comandi di Artifact Registry, esegui il comando gcloud artifacts
.
Configura autenticazione
Prima di eseguire il push o il pull delle immagini, configura Docker in modo che utilizzi Google Cloud CLI per autenticare le richieste ad Artifact Registry.
Per configurare l'autenticazione nei repository Docker della regione us-west1
, esegui questo comando:
gcloud auth configure-docker us-west1-docker.pkg.dev
Il comando aggiorna la configurazione Docker. Ora puoi connetterti con Artifact Registry nel tuo progetto Google Cloud per eseguire il push e il pull delle immagini.
Per informazioni sugli altri metodi di autenticazione, vedi Metodi di autenticazione.
Ottieni un'immagine di cui eseguire il push
Per questa guida rapida, eseguirai il push di un'immagine di esempio denominata
hello-app
.
Esegui questo comando per eseguire il pull della versione 1.0 dell'immagine.
docker pull us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0
I percorsi delle immagini in Artifact Registry includono più parti. Per questa immagine di esempio:
us
è la località del repository.docker.pkg.dev
è il nome host per le immagini container archiviate nei repository Docker di Artifact Registry.google-samples
è l'ID repository.containers/gke/
è il percorso dell'immagine ingoogle-samples
.
Aggiungi l'immagine al repository
Prima di eseguire il push dell'immagine Docker ad Artifact Registry, devi taggarla con il nome del repository.
Contrassegna l'immagine con un nome di registro
L'assegnazione di tag all'immagine Docker con il nome di un repository configura il comando docker push
per eseguire il push dell'immagine in una posizione specifica. Per questa guida rapida, la località dell'host è us-west1-docker.pkg.dev
.
Esegui questo comando per taggare l'immagine come
quickstart-image:tag1
:
docker tag us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0 \ us-west1-docker.pkg.dev/PROJECT/quickstart-docker-repo/quickstart-image:tag1
Dove
us-west1
è la località del repository.docker.pkg.dev
è il nome host del repository Docker che hai creato.- PROJECT è il tuo ID progetto Google Cloud. Se l'ID progetto contiene i due punti (":"), vedi Progetti con ambito dominio.
quickstart-docker-repo
è l'ID del repository che hai creato.quickstart-image
è il nome dell'immagine che vuoi utilizzare nel repository. Il nome dell'immagine può essere diverso dal nome dell'immagine locale. Per questa guida rapida, archivierai l'immagine direttamente sotto l'ID repositoryquickstart-docker-repo
.tag1
è un tag che stai aggiungendo all'immagine Docker. Se non hai specificato un tag, Docker applicherà il tag predefinitolatest
.
Ora è tutto pronto per eseguire il push dell'immagine nel repository che hai creato.
Esegui il push dell'immagine ad Artifact Registry
Dopo aver configurato l'autenticazione e aggiunto un tag all'immagine locale, puoi eseguire il push nel repository che hai creato.
Per effettuare il push dell'immagine Docker, esegui questo comando:
docker push us-west1-docker.pkg.dev/PROJECT/quickstart-docker-repo/quickstart-image:tag1
Sostituisci PROJECT con il tuo ID progetto Google Cloud. Se l'ID progetto contiene i due punti (":"), vedi Progetti con ambito dominio.
Estrai l'immagine da Artifact Registry
Per eseguire il pull dell'immagine da Artifact Registry sulla tua macchina locale, esegui questo comando:
docker pull us-west1-docker.pkg.dev/PROJECT/quickstart-docker-repo/quickstart-image:tag1
Sostituisci PROJECT con il tuo ID progetto Google Cloud. Se l'ID progetto contiene i due punti (":"), vedi Progetti con ambito dominio. Dovresti vedere un output simile al seguente:
latest: Pulling from [PROJECT-ID]/quickstart-image:tag1 Digest: sha256:70c42... Status: Image is up to date for us-west1-docker.pkg.dev/PROJECT/quickstart-docker-repo/quickstart-image:tag1
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.
Prima di rimuovere il repository, assicurati che le immagini che vuoi conservare siano disponibili in un'altra posizione.
Per eliminare il repository:
Console
Apri la pagina Repository nella console Google Cloud.
Nell'elenco dei repository, seleziona il repository
quickstart-docker-repo
.Fai clic su Elimina.
gcloud
Per eliminare il repository quickstart-docker-repo
, esegui questo comando:
gcloud artifacts repositories delete quickstart-docker-repo --location=us-west1
Passaggi successivi
- Scopri di più sull'utilizzo delle immagini container.
- Scopri di più su Docker.
- Leggi le nostre risorse su DevOps ed esplora il programma di ricerca DevOps Research and Assessment (DORA).