Skip to main content
Una regla de caché asocia un prefijo de repositorio de la cuenta a un registry de origen. Por ejemplo, el prefijo hub con origen docker.io y prefijo de origen library permite descargar hub/nginx:stable mediante la URI de Registry de la cuenta:
La regla proporciona el namespace library, omitido en la referencia de imagen. Use otra regla con el prefijo adecuado para imágenes de otros namespaces de Docker Hub. Cree una regla con POST /v1/pull-through-cache-rules. Los campos obligatorios son prefix y upstream_registry. La respuesta devuelve uri_prefix; añada el resto del nombre y la etiqueta de imagen. Los prefijos pueden contener uno o dos componentes de nombre de repositorio.

​
Credenciales

Para un origen autenticado, proporcione upstream_username y upstream_secret. El secreto es de solo escritura; las lecturas devuelven has_credential. PATCH conserva los campos omitidos. Para eliminar credenciales, envíe usuario y secreto vacíos juntos. Solo se aceptan destinos públicos de origen compatibles. La disponibilidad, credenciales y límites siguen afectando a búsquedas sin caché. La función no permite acceso a endpoints de red privada.

​
Permisos y propiedad

Importar sin caché exige registry:BatchImportUpstreamImage además de las acciones de pull. Un lector sin ese permiso puede usar imágenes ya almacenadas, pero no iniciar importaciones. El contenido importado consume almacenamiento de la cuenta y sigue sus cuotas y reglas de ciclo de vida. Administre reglas por prefijo en /v1/pull-through-cache-rules/{prefix}. Eliminar una regla detiene nuevas importaciones mediante ella; no elimina repositorios ni imágenes importadas. Revise esas imágenes por separado.