Skip to main content
Uma regra de cache associa um prefixo de repositório da conta a um registry de origem. Por exemplo, o prefixo hub com origem docker.io e prefixo de origem library permite baixar hub/nginx:stable pela URI do Registry da conta:
A regra fornece o namespace library, omitido da referência da imagem. Use outra regra com o prefixo apropriado para imagens de outros namespaces do Docker Hub. Crie uma regra com POST /v1/pull-through-cache-rules. Os campos obrigatórios são prefix e upstream_registry. A resposta retorna uri_prefix; acrescente o restante do nome e a tag da imagem. Prefixos podem conter um ou dois componentes de nome de repositório.

​
Credenciais

Para origem autenticada, forneça upstream_username e upstream_secret. O segredo é somente para escrita; leituras retornam has_credential. PATCH preserva campos omitidos. Para remover credenciais, envie usuário e segredo vazios juntos. Somente destinos públicos de origem compatíveis são aceitos. Disponibilidade, credenciais e limites ainda afetam buscas sem cache. O recurso não permite acesso a endpoints de rede privada.

​
Permissões e propriedade

Importar sem cache exige registry:BatchImportUpstreamImage além das ações de pull. Um leitor sem essa permissão pode usar imagens já armazenadas, mas não iniciar importações. O conteúdo importado consome armazenamento da conta e segue suas cotas e regras de ciclo de vida. Gerencie regras pelo prefixo em /v1/pull-through-cache-rules/{prefix}. Excluir uma regra interrompe novas importações por ela; não remove repositórios ou imagens importadas. Revise essas imagens separadamente.