Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Sincronización de un registro principal con un registro privado de Amazon ECR
Mediante las reglas de caché de extracción, puede sincronizar el contenido de un registro principal con su registro privado de Amazon ECR.
Amazon ECR permite actualmente crear reglas de caché de extracción para los siguientes registros ascendentes:
-
Amazon ECR Public, el registro de imágenes de contenedores de Kubernetes y Quay (no requiere autenticación)
-
Docker Hub, Microsoft Azure Container Registry, GitHub Container Registry y Chainguard Registry (requiere autenticación con AWS Secrets Manager secreto) GitLab
-
Amazon ECR (requiere autenticación con AWS la función de IAM)
En el GitLab caso del registro de contenedores, Amazon ECR admite la extracción de caché únicamente con GitLab la oferta de software como servicio (SaaS). Para obtener más información sobre el uso de la oferta GitLab de SaaS, consulte. GitLab.com
En el caso de los registros iniciales que requieren autenticación con secretos (como Docker Hub), debes guardar tus credenciales en secreto. AWS Secrets Manager Utilice la consola de Amazon ECR para crear secretos de Secrets Manager para cada registro ascendente autenticado. Para obtener más información acerca de la creación de un secreto de Secrets Manager mediante la consola de Secrets Manager, consulte Almacenar las credenciales de su repositorio principal en un AWS Secrets Manager secreta.
En el caso de Amazon ECR, debe crear un rol de IAM si los registros ascendentes y descendentes de Amazon ECR pertenecen a una cuenta diferente. AWS Para obtener más información sobre cómo crear un rol de IAM, consulte Las políticas de IAM son obligatorias para transferir el caché de extracción de ECR a ECR entre cuentas.
Después de crear una regla de caché de extracción para el registro ascendente, extraiga una imagen de ese registro mediante el URI del registro privado de Amazon ECR. A continuación, Amazon ECR crea un repositorio y guarda en caché la imagen en su registro privado. En el caso de la siguiente solicitud de extracción de la imagen en caché con una etiqueta determinada, Amazon ECR verificará el registro ascendente para una nueva versión de la imagen con esa etiqueta específica e intentará actualizar la imagen en su registro privado al menos una vez cada 24 horas.
Plantillas de creación de repositorios
Amazon ECR ha agregado soporte para las plantillas de creación de repositorios, lo que le permite especificar las configuraciones iniciales de los nuevos repositorios creados por Amazon ECR en su nombre mediante reglas de caché de extracción. Cada plantilla contiene un prefijo de espacio de nombres de repositorio que se utiliza para hacer coincidir los nuevos repositorios con una plantilla específica. Las plantillas pueden especificar la configuración de todos los ajustes del repositorio, incluidas las políticas de acceso basadas en los recursos, la inmutabilidad de las etiquetas, el cifrado y las políticas de ciclo de vida. La configuración de una plantilla de creación de repositorios solo se aplica durante la creación del repositorio y no tiene ningún efecto en los repositorios existentes ni en los repositorios creados mediante cualquier otro método. Para obtener más información, consulte Plantillas para controlar los repositorios creados durante una acción de extracción, creación mediante inserción o replicación.
Consideraciones para utilizar las reglas de caché de extracción
Tenga en cuenta lo siguiente al utilizar las reglas de caché de extracción de Amazon ECR.
-
AWS Lambda no permite extraer imágenes de contenedores de Amazon ECR mediante una regla de extracción de caché.
-
Al extraer imágenes mediante caché de extracción, los puntos de conexión de servicio de FIPS de Amazon ECR no se admiten la primera vez que se extrae una imagen. Sin embargo, el uso de los puntos de conexión de servicio de FIPS de Amazon ECR funciona en extracciones posteriores.
-
En el caso de los repositorios ascendentes que requieren autenticación, cuando se extrae una imagen a través del URI del registro privado de Amazon ECR por primera vez o para actualizar la caché, el usuario asociado a las credenciales configuradas en la regla de extracción de la caché inicia la extracción de imágenes. Las extracciones posteriores devolverán la imagen directamente de la caché del registro privado del cliente.
-
En el caso de los repositorios iniciales que no requieren autenticación, cuando se extrae una imagen a través de la URI del registro privado de Amazon ECR, las direcciones IP inician la extracción de la imagen. AWS
-
Cuando un cliente extrae una imagen en caché a través del URI del registro privado de Amazon ECR, Amazon ECR comprueba si ha validado la imagen con el registro anterior en las últimas 24 horas. Si el período de 24 horas ha caducado, Amazon ECR envía una solicitud desde arriba para comprobar si hay una versión más reciente y actualiza la caché si existe. Si el plazo no ha caducado, Amazon ECR entrega la imagen almacenada en caché sin contactar con la instancia anterior.
-
Al llamar a la
ListImageReferrersAPI a un repositorio creado mediante una caché de extracción, los artefactos de OCI-compliant referencia se devuelven a la caché privada. -
Amazon ECR comprueba si los artefactos de referencia se han actualizado en las últimas 6 horas. Si el período de 6 horas ha caducado, Amazon ECR envía una solicitud en sentido ascendente para comprobar si hay versiones más recientes y actualiza la caché si existen.
-
Si Amazon ECR no puede actualizar la imagen desde el registro original por algún motivo y se extrae la imagen, se seguirá extrayendo la última imagen en caché.
-
Al crear el secreto de Secrets Manager que contiene las credenciales de registro anteriores, el nombre del secreto debe usar el
ecr-pullthroughcache/prefijo. El secreto también debe estar en la misma cuenta y región en las que se creó la regla de caché de extracción. -
Cuando se extrae una imagen multiarquitectura mediante una regla de caché de extracción, la lista de manifiestos y cada imagen a la que se hace referencia en la lista de manifiestos se extraen al repositorio de Amazon ECR. Si solo desea extraer una arquitectura específica, puede extraer la imagen mediante el resumen de imagen o la etiqueta asociada a la arquitectura en lugar de la etiqueta asociada a la lista de manifiestos.
-
Amazon ECR utiliza un rol de IAM vinculada al servicio, que proporciona los permisos necesarios para que Amazon ECR cree el repositorio, recupere el valor secreto de Secrets Manager para la autenticación y envíe la imagen almacenada en caché en su nombre. El rol de IAM vinculado a servicios se crea automáticamente cuando se crea una regla de caché de extracción. Para obtener más información, consulte Rol vinculado a servicios de Amazon ECR para la caché de extracción.
-
De forma predeterminada, la entidad principal de IAM que extrae la imagen almacenada en caché tiene los permisos otorgados a través de su política de IAM. Puede utilizar la política de permisos de registro privado de Amazon ECR para ampliar los permisos de una entidad de IAM. Para obtener más información, consulte Uso de permisos de registro.
-
Los repositorios de Amazon ECR creados mediante el flujo de trabajo de caché de extracción se tratan como cualquier otro repositorio de Amazon ECR. Se admiten todas las características del repositorio, como la replicación y el escaneo de imágenes.
-
Cuando Amazon ECR crea un repositorio nuevo en su nombre mediante una acción de caché de extracción, se aplican las siguientes configuraciones predeterminadas al repositorio, a menos que haya una plantilla de creación de repositorios coincidente. Puede utilizar una plantilla de creación de repositorios para definir la configuración que se aplicará a los repositorios creados por Amazon ECR en su nombre. Para obtener más información, consulte Plantillas para controlar los repositorios creados durante una acción de extracción, creación mediante inserción o replicación.
-
Inmutabilidad de la etiqueta: la inmutabilidad de la etiqueta especifica si las etiquetas de imagen se pueden sobrescribir. Por defecto, las etiquetas de imagen son mutables (se pueden sobrescribir). Puede modificar el comportamiento de las etiquetas al configurar los filtros de exclusión de etiquetas en el cuadro de texto de Exclusión de etiquetas mutables cuando se selecciona Mutable, o en el cuadro de texto de Exclusión de etiquetas inmutables cuando se selecciona Inmutable.
-
Cifrado: se usa el cifrado predeterminado
AES256. -
Permisos de repositorio: se omiten, no se aplica ninguna política de permisos de repositorio.
-
Política de ciclo de vida: se omite, no se aplica ninguna política de ciclo de vida.
-
Etiquetas de recursos: se omiten, no se aplica ninguna etiqueta de recursos.
-
-
Al activar la inmutabilidad de las etiquetas de imagen en los repositorios mediante una regla de caché de extracción impedirá que Amazon ECR actualice las imágenes que utilicen la misma etiqueta.
-
Cuando se extrae una imagen mediante la regla de caché de extracción por primera vez, es posible que se requiera una ruta a Internet. Hay ciertas circunstancias en las que se requiere una ruta a Internet, por lo que es mejor configurar una ruta para evitar errores. Por lo tanto, si ha configurado Amazon ECR para usar una interfaz de punto final de VPC AWS PrivateLink , debe asegurarse de que la primera extracción tenga una ruta a Internet. Una forma de hacerlo es crear una subred pública en la misma VPC, con una puerta de enlace de Internet, y luego enrutar todo el tráfico saliente a Internet desde su subred privada a la subred pública. Esto no será necesario la próxima vez que realice una extracción de imágenes mediante la regla de caché de extracción. Para obtener más información, consulte Opciones de enrutamiento de ejemplo en la guía de usuarios de Amazon Virtual Private Cloud.
-
No se admite el envío de imágenes directamente a un repositorio de caché extraíble. Esta práctica puede provocar una incoherencia temporal, ya que las posteriores extracciones de imágenes siguen devolviendo la versión previamente almacenada en caché en lugar de la imagen recién insertada. Para resolver esta incoherencia, borra la imagen y vuelve a extraerla para actualizar la copia en caché. Como alternativa, espere hasta 24 horas para que se actualice la caché y, a continuación, vuelva a extraer la imagen.