Uso de repositorios de caché extraíbles
Descubra cómo los repositorios de caché de extracción recuperan y almacenan en caché imágenes de un registro ascendente.
Un repositorio de caché de recuperación es un repositorio privado de solo lectura: los clientes pueden extraer imágenes de él, pero no pueden transferir imágenes a él. Container Registry recupera las imágenes solicitadas del registro ascendente configurado para el repositorio y las almacena en caché en la región que contiene el repositorio de caché de transferencia.
Los registros ascendentes soportados son puntos finales de Container Registry en una región de OCI diferente dentro del mismo dominio de OCI que el repositorio de caché de transferencia.
Los clientes se autentican en Container Registry y extraen imágenes de un repositorio de caché desplegable de la misma forma que de otros repositorios privados.
Para crear un repositorio de caché de recuperación, siga el procedimiento descrito en Creación de un repositorio, seleccione Repositorio de caché de recuperación como tipo de repositorio y especifique valores para URL ascendente, Nombre de usuario de flujo ascendente e ID de secreto de flujo ascendente.
Autenticación de registro ascendente
Container Registry utiliza el nombre de usuario ascendente configurado para el repositorio de caché de recuperación para autenticarse en el registro ascendente. La credencial de autenticación correspondiente se almacena en un secreto de OCI Vault, identificado por el ID de secreto de flujo superior.
Para un proceso ascendente de Container Registry, esta credencial es el token de autenticación de OCI del usuario ascendente.
La credencial de autenticación ascendente debe estar codificada en Base64 cuando se envía a OCI Vault. Si el PAT tiene una fecha de caducidad, sustitúyala y actualice la credencial almacenada en OCI Vault antes de que caduque.
Las credenciales ascendentes son necesarias incluso al extraer imágenes públicas de Container Registry. No se admite el acceso ascendente anónimo.
El usuario ascendente debe tener permiso para extraer las imágenes solicitadas. Una política de IAM de su arrendamiento también debe permitir que la entidad de recurso de transferencia de Container Registry lea el secreto:
allow resource ocir ocirpullthrough to read secret-bundles in compartment <secret-compartment-name> where target.secret.name = '<secret-name>'Sustituya <secret-compartment-name> por el compartimento que contiene el secreto y <secret-name> por el nombre del secreto.
Por ejemplo:
allow resource ocir ocirpullthrough to read secret-bundles in compartment registry-secrets where target.secret.name = 'upstream-ocir-auth-token'Cómo se almacenan en caché las imágenes
Cuando un cliente extrae una imagen, Container Registry sirve la imagen de la caché local cuando está disponible, sujeto al comportamiento de refrescamiento de etiquetas que se describe a continuación. Si la imagen o las capas necesarias no se almacenan en caché, Container Registry las recupera del registro ascendente configurado, las envía al cliente y las almacena en caché localmente para las extracciones posteriores.
Las imágenes se almacenan en caché a demanda. La creación de un repositorio de caché de recuperación no copia automáticamente las imágenes del registro ascendente.
Las imágenes en caché se almacenan en la región que contiene el repositorio de caché de extracción y están sujetas a las mismas políticas de uso y retención de almacenamiento que otras imágenes de Container Registry.
Comportamiento de etiquetado y resumen
Tirando por etiqueta
Al extraer una imagen por etiqueta, Container Registry utiliza la versión almacenada en caché hasta que venza una comprobación de actualización. El intervalo de refrescamiento por defecto es de una hora para cada etiqueta, medido a partir de su última comprobación ascendente registrada.
La primera solicitud después de ese intervalo dispara una comprobación del registro ascendente. Si la etiqueta apunta a una imagen diferente, Container Registry actualiza la etiqueta almacenada en caché y recupera las imágenes o capas necesarias que aún no estén almacenadas en caché. Si la etiqueta no ha cambiado, Container Registry devuelve la versión en caché.
Las etiquetas se refrescan solo cuando se solicitan. Container Registry no actualiza las etiquetas automáticamente en segundo plano.
Comportamiento cuando falla una comprobación ascendente
Si el registro ascendente informa que ya no existe una etiqueta en caché, Container Registry puede seguir devolviendo la imagen en caché. La supresión de una imagen o etiqueta del registro ascendente no la suprime automáticamente del repositorio de caché de recuperación.
Si falla una actualización debido a un problema temporal, como un timeout o una interrupción del servicio ascendente, Container Registry puede devolver la imagen en caché si está disponible localmente. Una extracción posterior puede volver a intentar el refrescamiento.
Cuando Container Registry necesita ponerse en contacto con el registro ascendente, las credenciales ascendentes no válidas, la configuración ascendente incorrecta o los permisos ascendentes insuficientes hacen que falle la extracción, incluso si se almacena en caché una versión anterior de la imagen.
Extracción por resumen
Al extraer una imagen por resumen, Container Registry sirve la imagen en caché sin comprobar las actualizaciones en el registro ascendente. Si la imagen o las capas necesarias no se almacenan en caché, Container Registry las recupera del registro ascendente y las almacena en caché local.
Formatos de manifiesto de imagen admitidos
Los repositorios de caché de recuperación soportan el manifiesto de imagen de Docker V2, el esquema 2, las listas de manifiestos de Docker, los manifiestos de imagen de OCI y los índices de imagen de OCI. Los manifiestos de imagen de la versión 1 del esquema de Docker no están soportados.
Gestión de un Repositorio de Caché de Recuperación
Después de crear un repositorio de caché de recuperación, puede actualizar el nombre de usuario ascendente y el ID de secreto ascendente. No puede cambiar la URL ascendente ni el tipo de repositorio. Para obtener más información, consulte Edición de un repositorio.
Para obtener información sobre la supresión de imágenes almacenadas en caché y el uso de políticas de retención, consulte Supresión de una imagen y Retención y supresión de imágenes mediante políticas de retención. Para obtener información sobre la firma y exploración de imágenes almacenadas en caché, consulte Firma de imágenes para seguridad y Exploración de imágenes para vulnerabilidades.