Extrair imagens do Docker Hub armazenadas em cache
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Artifact Registry armazena em cache as imagens públicas do Docker Hub acessadas com frequência em
mirror.gcr.io. Você pode configurar o daemon do Docker para usar uma imagem
pública armazenada em cache, se houver uma disponível, ou extrair a imagem do Docker Hub se uma cópia em cache
não estiver disponível.
Os
Google Cloud serviços, como o Cloud Build e o Google Kubernetes Engine, verificam automaticamente
se há imagens em cache antes de tentar extrair uma imagem do Docker Hub.
Os
Imagens em cache em mirror.gcr.io são:
Armazenadas em um repositório gerenciado por Google Cloud.
mais protegidas das interrupções do Docker Hub;
Integrada ao ecossistema Google Cloud .
Sincronizadas com o Docker Hub.
Como configurar o daemon do Docker
Para configurar o daemon do Docker para extrair imagens do cache do Artifact
Registry:
CLI
Configure o daemon de uma das seguintes maneiras:
Para configurar o daemon do Docker automaticamente na inicialização,
defina o seguinte valor em /etc/docker/daemon.json
{"registry-mirrors":["https://mirror.gcr.io"]}
Ao iniciar o daemon, transmita o nome do host do
Artifact Registry:
dockerd--registry-mirror=https://mirror.gcr.io
Adicione a linha a seguir ao arquivo /etc/default/docker:
O Artifact Registry adiciona imagens solicitadas com frequência ao cache
para que elas sejam disponibilizadas para solicitações futuras. Ele também remove periodicamente imagens
que não são mais solicitadas.
Depois de configurar o daemon do Docker para usar o cache do Artifact Registry,
o Docker executa as seguintes etapas quando você extrai uma imagem pública do Docker Hub
com um comando docker pull:
O daemon do Docker verifica o cache do Artifact Registry e busca
as imagens, se elas existirem. Se a configuração do daemon incluir outros espelhos
do Docker, ele verificará cada um deles para uma cópia em cache da imagem.
Se a imagem ainda não for encontrada, o daemon do Docker busca a imagem
no repositório canônico no Docker Hub.
Extrair imagens em cache não é contabilizado em limites de taxa do Docker Hub. No entanto, não há garantia de que uma imagem específica será armazenada em cache por um longo período. Consiga imagens em cache em mirror.gcr.ioconfigurando o daemon do Docker.
Para fazer a autenticação no Docker Hub para imagens que não estão armazenadas em cache no mirror.gcr.io,
use os repositórios remotos do Artifact Registry. Os repositórios
remotos oferecem suporte à autenticação no Docker Hub. Recomendamos a autenticação
no Docker Hub mesmo que você esteja usando apenas imagens públicas, porque isso vai aumentar seu
limite de taxa de download. Para mais informações sobre os limites de taxa de download do Docker Hub,
consulte Limite de taxa do Docker Hub.
A seguir
É possível criar repositórios remotos do Artifact Registry para armazenar imagens do Docker Hub em cache.
É possível criar seus próprios espelhos do Docker locais para armazenar imagens em cache. Para saber detalhes, consulte a documentação do Docker.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-18 UTC."],[[["\u003cp\u003eArtifact Registry caches frequently accessed public Docker Hub images on \u003ccode\u003emirror.gcr.io\u003c/code\u003e, allowing for faster access and increased insulation from Docker Hub outages.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Cloud services automatically prioritize checking for cached images on \u003ccode\u003emirror.gcr.io\u003c/code\u003e before pulling from Docker Hub.\u003c/p\u003e\n"],["\u003cp\u003eYou can configure your Docker daemon to utilize the Artifact Registry cache by modifying the \u003ccode\u003e/etc/docker/daemon.json\u003c/code\u003e file, using the \u003ccode\u003edockerd\u003c/code\u003e command, modifying \u003ccode\u003e/etc/default/docker\u003c/code\u003e, or using the Docker UI.\u003c/p\u003e\n"],["\u003cp\u003eWhen pulling a public Docker Hub image after configuring the cache, the Docker daemon will first check the \u003ccode\u003emirror.gcr.io\u003c/code\u003e cache, then any other configured mirrors, and lastly, Docker Hub itself.\u003c/p\u003e\n"],["\u003cp\u003ePulling images from the Artifact Registry cache on \u003ccode\u003emirror.gcr.io\u003c/code\u003e does not count against Docker Hub rate limits, and you can use remote repositories for images not in the cache.\u003c/p\u003e\n"]]],[],null,["# Pull cached Docker Hub images\n\nArtifact 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.\nGoogle Cloud services such as Cloud Build and Google Kubernetes Engine automatically check for cached images before attempting to pull an image from Docker Hub.\n\nCached images at `mirror.gcr.io` are:\n\n- Stored in a repository managed by Google Cloud.\n- More insulated from Docker Hub outages.\n- 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 Artifact 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 Artifact 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\nArtifact 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 Artifact 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 Artifact 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).\n\nTo authenticate to Docker Hub for images that aren't cached on `mirror.gcr.io`,\nuse Artifact Registry [remote repositories](/artifact-registry/docs/repositories/remote-overview). Remote\nrepositories support authentication to Docker Hub. We recommend authenticating\nto Docker Hub even if you are only using public images, as it will increase your\ndownload rate limit. For more information on Docker Hub download rate limits,\nsee [Docker Hub rate limit](https://docs.docker.com/docker-hub/download-rate-limit/).\n\nWhat's next\n-----------\n\n- You can create Artifact Registry [remote repositories](/artifact-registry/docs/repositories/remote-overview) to cache Docker Hub images.\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/)."]]