Extrair imagens do Docker Hub armazenadas em cache

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.

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.

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;
  • Integrado ao ecossistema Google Cloud .
  • Sincronizadas com o Docker Hub.

Configurar o daemon do Docker

Para configurar o daemon do Docker para extrair imagens do cache do Artifact Registry:

CLI

  1. 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, passe no nome do host do Artifact Registry:

      dockerd --registry-mirror=https://mirror.gcr.io

    • Adicione a seguinte linha ao arquivo /etc/default/docker:

      DOCKER_OPTS="${DOCKER_OPTS} --registry-mirror=https://mirror.gcr.io"

  2. Reinicie o daemon do Docker.

    • No Linux, execute um dos seguintes comandos:

      sudo service docker restart

      ou

      sudo service docker stop && sudo service docker start

    • No macOS ou Windows, execute o seguinte comando:

      docker-machine restart

IU do Docker

  1. Abra o menu Preferences do Docker.
  2. Clique em Daemon.

  3. Clique em Advanced. No campo JSON, adicione uma chave registry-mirrors com https://mirror.gcr.io como um valor:

    {
  "registry-mirrors" : [
    "https://mirror.gcr.io"
  ]
}

  4. Clique em Apply & Restart.

Para verificar se o cache está configurado corretamente, execute:

docker system info

A saída deve incluir Registry Mirrors e deve ser semelhante a esta:

Containers: 2
 Running: 0
 Paused: 0
 Stopped: 2
Images: 2
Server Version: 17.03.1-ce
Storage Driver: overlay2
 Backing Filesystem: extfs
 Supports d_type: true
 Native Overlay Diff: true
Logging Driver: json-file
...
Registry Mirrors:
 https://mirror.gcr.io

Extrair imagens armazenadas em cache

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:

  1. 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.
  2. 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.io configurando o daemon do Docker.

Para autenticar no Docker Hub imagens que não estão em cache no mirror.gcr.io, use os repositórios remotos do Artifact Registry. Os repositórios remotos são compatíveis com a autenticação no Docker Hub. Recomendamos que você se autentique no Docker Hub mesmo que esteja usando apenas imagens públicas, porque isso aumenta 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.

Considerações

Ao usar o cache do Docker Hub do Artifact Registry, considere o seguinte:

  • O Artifact Registry funciona apenas como um cache para as imagens armazenadas no Docker Hub.O Google Cloud não valida, verifica nem corrige vulnerabilidades em imagens armazenadas em cache do Docker Hub. Você é responsável por garantir que as imagens armazenadas no Docker Hub atendam aos requisitos de segurança e conformidade da sua organização. Se você precisar de verificação ativa de vulnerabilidades, use a Artifact Analysis.

  • O cache do Artifact Registry foi projetado para melhorar a estabilidade e não exclui imediatamente as imagens quando elas são removidas do Docker Hub. As imagens excluídas do Docker Hub podem permanecer disponíveis no cache do Artifact Registry por até vários dias antes de serem removidas.Os serviços Google Cloud que pré-configuram o uso do cache, como o Cloud Build e o Google Kubernetes Engine, podem continuar usando automaticamente imagens não limpas do cache do Artifact Registry.

A seguir