Container Registry รจ deprecato. A partire dal 18 marzo 2025, Container Registry verrร chiuso e la scrittura di immagini in Container Registry non sarร piรน disponibile. Per ulteriori informazioni sul ritiro di Container Registry e su come eseguire la migrazione ad Artifact Registry, consulta Ritiro di Container Registry.
Pull delle immagini Docker Hub memorizzate nella cache
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Container Registry memorizza nella cache le immagini Docker Hub pubbliche a cui viene eseguito l'accesso con frequenza su
mirror.gcr.io. Puoi configurare il daemon Docker in modo che utilizzi un'immagine pubblica memorizzata nella cache, se disponibile, o estrarre l'immagine da Docker Hub se non รจ disponibile una copia memorizzata nella cache.
Google Cloud servizi come Cloud Build e Google Kubernetes Engine controllano automaticamente la presenza di immagini memorizzate nella cache prima di tentare di estrarre un'immagine da Docker Hub.
Le immagini memorizzate nella cache il giorno mirror.gcr.io sono:
Memorizzati in un repository gestito da Google.
Piรน al riparo dalle interruzioni di Docker Hub.
Si integra facilmente con l' Google Cloud ecosistema.
Mantenuto sincronizzato con Docker Hub.
Configurazione del daemon Docker
Per configurare il daemon Docker in modo da estrarre le immagini dalla cache di Container Registry:
Interfaccia a riga di comando
Configura il daemon in uno dei seguenti modi:
Per configurare automaticamente il daemon Docker all'avvio, imposta
il seguente valore in /etc/docker/daemon.json
{"registry-mirrors":["https://mirror.gcr.io"]}
Quando avvii il daemon, passa il nome host di Container Registry:
dockerd--registry-mirror=https://mirror.gcr.io
Aggiungi la seguente riga al file /etc/default/docker:
Container Registry aggiunge le immagini richieste di frequente alla cache
in modo che siano disponibili per le richieste future. Inoltre, rimuove periodicamente le immagini
che non vengono piรน richieste.
Dopo aver configurato il daemon Docker per utilizzare la cache di Container Registry,
Docker esegue i seguenti passaggi quando esegui il pull di un'immagine Docker Hub pubblica
con un comando docker pull:
Il daemon Docker controlla la cache di Container Registry e recupera le immagini, se esistenti. Se la configurazione del daemon include altri mirror Docker, il daemon li controlla tutti per trovare una copia memorizzata nella cache dell'immagine.
Se l'immagine non viene ancora trovata, il daemon Docker la recupera dal
repository canonico su Docker Hub.
Il pull delle immagini memorizzate nella cache non viene conteggiato ai fini del calcolo dei limiti di frequenza di Docker Hub. Tuttavia, non vi รจ alcuna garanzia che una determinata immagine rimanga memorizzata nella cache per un periodo di tempo prolungato. Ottieni solo le immagini memorizzate nella cache su mirror.gcr.ioconfigurando il daemon Docker. Una richiesta di estrazione diretta da
mirror.gcr.io non andrร a buon fine se non esiste una copia memorizzata nella cache dell'immagine.
Passaggi successivi
Puoi creare i tuoi mirror Docker locali per memorizzare nella cache le immagini. Per maggiori dettagli, consulta la documentazione di Docker.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema รจ stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-03 UTC."],[[["\u003cp\u003eContainer Registry caches frequently-accessed public Docker Hub images on \u003ccode\u003emirror.gcr.io\u003c/code\u003e, improving image pull performance and reliability.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Cloud services automatically check for cached images before pulling from Docker Hub, streamlining workflows within the Google Cloud ecosystem.\u003c/p\u003e\n"],["\u003cp\u003eConfiguring the Docker daemon to use \u003ccode\u003emirror.gcr.io\u003c/code\u003e allows it to prioritize pulling images from the cache, falling back to Docker Hub if the image is not found there.\u003c/p\u003e\n"],["\u003cp\u003ePulling images from the Container Registry cache does not count against Docker Hub rate limits, offering a workaround to potential restrictions on the Docker Free plan.\u003c/p\u003e\n"],["\u003cp\u003eCached images are stored in a Google-managed repository, are kept in sync with Docker Hub, and offer greater insulation from Docker Hub outages.\u003c/p\u003e\n"]]],[],null,["# Pulling cached Docker Hub images\n\nContainer Registry caches frequently-accessed public Docker Hub images on\n`mirror.gcr.io`. You can configure the Docker daemon to use a cached public\nimage if one is available, or pull the image from Docker Hub if a cached copy\nis unavailable.\n\nGoogle Cloud services such as Cloud Build and Google Kubernetes Engine automatically\ncheck for cached images before attempting to pull an image from Docker Hub.\n| **Note:** As of November 1, 2020, Docker Hub\n| [rate limits](https://www.docker.com/blog/scaling-docker-to-serve-millions-more-developers-network-egress/) apply to unauthenticated or authenticated pull requests on the\n| Docker Free plan. To avoid disruptions and have greater control over your\n| software supply chain, you can migrate your dependencies to [Artifact Registry](/artifact-registry/docs/docker/migrate-external-containers).\n\nCached images at `mirror.gcr.io` are:\n\n- Stored in a repository that Google manages.\n- More insulated from Docker Hub outages.\n- Easily integrated with the Google Cloud ecosystem.\n- Kept in sync with Docker Hub.\n\nConfiguring the Docker daemon\n-----------------------------\n\nTo configure your Docker daemon to pull images from the Container Registry\ncache: \n\n### CLI\n\n1. Configure the daemon in one of the following ways:\n\n - To configure the Docker daemon automatically on startup, set\n the following value in `/etc/docker/daemon.json`\n\n {\n \"registry-mirrors\": [\"https://mirror.gcr.io\"]\n }\n\n - When you start the daemon, pass in the Container Registry\n hostname:\n\n dockerd --registry-mirror=https://mirror.gcr.io\n\n - Add the following line to your `/etc/default/docker` file:\n\n DOCKER_OPTS=\"${DOCKER_OPTS} --registry-mirror=https://mirror.gcr.io\"\n\n2. Restart the Docker daemon.\n\n - On Linux, run one of the following commands:\n\n sudo service docker restart\n\n or \n\n sudo service docker stop && sudo service docker start\n\n - On macOS or Windows, run the following command:\n\n docker-machine restart\n\n### Docker UI\n\n1. Open Docker's **Preferences** menu.\n2. Click **Daemon**.\n3. Click **Advanced** . In the JSON field, add a `registry-mirrors` key with\n `https://mirror.gcr.io` as a value:\n\n {\n \"registry-mirrors\" : [\n \"https://mirror.gcr.io\"\n ]\n }\n\n4. Click **Apply \\& Restart**.\n\nTo verify that the cache is correctly configured, run: \n\n docker system info\n\nThe output should include `Registry Mirrors`, and should look similar to\nthe following: \n\n Containers: 2\n Running: 0\n Paused: 0\n Stopped: 2\n Images: 2\n Server Version: 17.03.1-ce\n Storage Driver: overlay2\n Backing Filesystem: extfs\n Supports d_type: true\n Native Overlay Diff: true\n Logging Driver: json-file\n ...\n Registry Mirrors:\n https://mirror.gcr.io\n\nPulling cached images\n---------------------\n\nContainer Registry adds frequently requested images to the cache\nso they are available for future requests. It also periodically removes images\nthat are no longer requested.\n\nAfter you configure the Docker daemon to use the Container Registry cache,\nDocker performs the following steps when you pull a public Docker Hub image\nwith a `docker pull` command:\n\n1. The Docker daemon checks the Container Registry cache and fetches the images if it exists. If your daemon configuration includes other Docker mirrors, the daemon checks each one in order for a cached copy of the image.\n2. If the image still isn't found, the Docker daemon fetches the image from the canonical repository on Docker Hub.\n\nPulling cached images does not count against Docker Hub rate limits. However,\nthere is no guarantee that a particular image will remain cached for an extended\nperiod of time. Only obtain cached images on `mirror.gcr.io` by\n[configuring the Docker daemon](#configure). A request to pull directly from\n`mirror.gcr.io` will fail if a cached copy of the image does not exist.\n\nWhat's next\n-----------\n\n- You can create your own local Docker mirrors to cache images. For details, see the [Docker documentation](https://docs.docker.com/registry/recipes/mirror/).\n- Read the [Docker Hub documentation](https://docs.docker.com/docker-hub/)."]]