Container Registry está obsoleto. A partir del 18 de marzo del 2025, Container Registry se retirará y no se podrán escribir imágenes en él. Para obtener más información sobre la retirada de Container Registry y cómo migrar a Artifact Registry, consulta el artículo Retirada de Container Registry.
Extraer imágenes de Docker Hub almacenadas en caché
Organízate con las colecciones
Guarda y clasifica el contenido según tus preferencias.
Container Registry almacena en caché las imágenes públicas de Docker Hub a las que se accede con frecuencia en mirror.gcr.io. Puedes configurar el daemon de Docker para que use una imagen pública almacenada en caché si hay alguna disponible o para que extraiga la imagen de Docker Hub si no hay ninguna copia almacenada en caché.
Google Cloud Servicios como Cloud Build y Google Kubernetes Engine comprueban automáticamente si hay imágenes almacenadas en caché antes de intentar extraer una imagen de Docker Hub.
Las imágenes almacenadas en caché a las mirror.gcr.io son:
Se almacenan en un repositorio que gestiona Google.
Mayor aislamiento frente a las interrupciones de Docker Hub.
Se integra fácilmente con el ecosistema de Google Cloud .
Se mantiene sincronizado con Docker Hub.
Configurar el daemon de Docker
Para configurar el daemon de Docker de forma que extraiga imágenes de la caché de Container Registry, sigue estos pasos:
CLI
Configure el daemon de una de las siguientes formas:
Para configurar el daemon de Docker automáticamente al inicio, define el siguiente valor en /etc/docker/daemon.json:
{"registry-mirrors":["https://mirror.gcr.io"]}
Cuando inicies el daemon, introduce el nombre de host de Container Registry:
dockerd--registry-mirror=https://mirror.gcr.io
Añade la siguiente línea a tu archivo /etc/default/docker:
Container Registry añade al caché las imágenes que se solicitan con frecuencia para que estén disponibles en futuras solicitudes. También elimina periódicamente las imágenes que ya no se solicitan.
Después de configurar el daemon de Docker para que use la caché de Container Registry, Docker sigue estos pasos cuando extraes una imagen pública de Docker Hub con un comando docker pull:
El daemon de Docker comprueba la caché de Container Registry y obtiene las imágenes si existen. Si la configuración de tu daemon incluye otros espejos de Docker, el daemon comprueba cada uno de ellos en orden para buscar una copia en caché de la imagen.
Si la imagen sigue sin encontrarse, el daemon de Docker la obtiene del repositorio canónico de Docker Hub.
Extraer imágenes almacenadas en caché no se tiene en cuenta en los límites de frecuencia de Docker Hub. Sin embargo, no se garantiza que una imagen concreta permanezca en la caché durante un periodo prolongado. Solo se obtienen imágenes almacenadas en caché en mirror.gcr.io si configuras el daemon de Docker. Una solicitud para extraer contenido directamente de mirror.gcr.io fallará si no existe una copia en caché de la imagen.
Siguientes pasos
Puedes crear tus propios espejos de Docker locales para almacenar imágenes en caché. Para obtener más información, consulta la documentación de Docker.
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-21 (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/)."]]