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.
# Relleno de replicación
Puede replicar las imágenes preexistentes de su registro privado de Amazon ECR en los destinos de replicación configurados. De forma predeterminada, la replicación solo se aplica a las imágenes insertadas después de aplicar la configuración de replicación. El relleno de replicación le permite replicar las imágenes que introdujo antes de configurar la replicación.
## Cómo funciona el backfill de replicación
Cuando se inicia un relleno de replicación, se especifica un único destino compuesto por una región y un identificador de registro. Amazon ECR evalúa la configuración de replicación existente para determinar qué imágenes de su registro cumplen los requisitos para rellenarse en el destino especificado. En el relleno solo se incluyen las imágenes que coinciden con sus reglas de configuración de replicación actuales.
Cada relleno de replicación se dirige a un único destino. Para rellenar imágenes en varios destinos, inicie un relleno de replicación independiente para cada destino. Cada uno se identifica con un identificador único `replicationBackfillId` que se utilizan para supervisar el progreso, ver los resultados y detenerlo si es necesario.
## Ciclo de vida de backup de la replicación
El backfill de replicación pasa por los siguientes estados:
+ `PREPARING`: Amazon ECR identifica las imágenes que cumplen los requisitos en su registro.
+ `IN_PROGRESS`: Amazon ECR está replicando las imágenes de forma activa en el destino.
+ `COMPLETE`: Todas las imágenes que cumplían los requisitos se replicaron correctamente.
+ `FAILED`: La recarga de réplicas falla automáticamente si fallan el 50% o más de las replicaciones subyacentes. Este umbral solo se evalúa una vez que se procesan al menos 100 replicaciones.
+ `STOPPING`: Se solicitó una parada y Amazon ECR está esperando a que se completen las replicaciones en curso.
+ `STOPPED`: Ha dejado de completar las replicaciones y todas las replicaciones en curso han finalizado.
**nota**
Puede detener un backfill de replicación solo cuando está en `PREPARING` o `IN_PROGRESS` estado.
## Consideraciones para el backfill de replicación
Al utilizar el relleno de replicación, se debe tener en cuenta lo siguiente.
+ En el relleno solo se incluyen las imágenes que coinciden con la configuración de replicación actual para el destino especificado. Si necesita rellenar imágenes en un destino que no está en su configuración de replicación, primero debe agregar ese destino a sus reglas de replicación.
+ Puede ejecutar hasta 10 rellenos de replicación de forma simultánea por registro. Si empieza más, Amazon ECR devuelve un `LimitExceededException` error.
+ Solo puede tener un relleno de replicación activo para una región de destino determinada a la vez. Una segunda solicitud para la misma región de destino devuelve un `ReplicationBackfillInProgressException` error.
+ Amazon ECR conserva los rellenos de replicación en estado terminal (`COMPLETE`, `FAILED`, o `STOPPED`) durante 90 días después de la finalización. Durante ese tiempo, permanecen visibles en `ListReplicationBackfills` respuestas.
+ Al detener un relleno de replicación no se deshacen las imágenes que ya se han replicado. Esas imágenes permanecen en el registro de destino.
+ El relleno de replicación utiliza la misma función vinculada a un servicio que Amazon ECR crea cuando configura la replicación por primera vez para su registro privado.
+ Se espera que la mayoría de los registros se complete en el plazo de una hora. Sin embargo, un registro que contiene una gran cantidad de datos puede tardar horas o incluso días en rellenarse por completo.
+ El relleno de replicación omite las imágenes cuyo repositorio de origen se eliminó. Esas imágenes aparecen con un `FAILED` estado en los resultados del relleno.
+ Amazon ECR envía un EventBridge evento en el que un relleno de replicación alcanza el estado terminal. Para obtener más información, consulte [Eventos de ejemplo de Amazon ECR](ecr-eventbridge.md#ecr-eventbridge-bus).
## Iniciar un relleno de replicación
### Para iniciar un relleno de replicación (Consola de administración de AWS)
1. Abra la consola de Amazon ECR en [https://console.aws.amazon.com/ecr/repositories](https://console.aws.amazon.com/ecr/repositories).
1. En la barra de navegación, elija la región del registro de origen desde la que desea rellenar el registro.
1. En el panel de navegación, elija **Private registry (Registro privado)**.
1. En el **Registro privado** página, elige ** Ajustes** y luego elige **Editar** debajo de **Configuración de replicación**.
1. En el **Replicación** página, elija **Trabajos de relleno** pestaña.
1. Elige **Iniciar el trabajo de relleno**.
1. Elige hasta 10 destinos en los que quieras rellenar.
1. Elige **Comience a rellenar trabajos**.
### Para iniciar un relleno de replicación (AWS CLI)
+ Inicie un relleno de replicación.
```
aws ecr start-replication-backfill \
--region {{us-west-2}} \
--registry-id {{aws_account_id}} \
--destination region={{destination_region}},registryId={{destination_aws_account_id}}
```
## Supervisar el progreso del backfill de la replicación y ver los resultados
### Para monitorear el progreso del backfill de la replicación y ver los resultados del backfill de la replicación (Consola de administración de AWS)
1. Abra la consola de Amazon ECR en [https://console.aws.amazon.com/ecr/repositories](https://console.aws.amazon.com/ecr/repositories).
1. En la barra de navegación, elija la región que contiene sus rellenos de replicación.
1. En el panel de navegación, elija **Private registry (Registro privado)**.
1. En el **Registro privado** página, elige ** Ajustes** y luego elige **Editar** debajo de **Configuración de replicación**.
1. En el **Replicación** página, elija **Trabajos de relleno** pestaña para supervisar el progreso y ver los resultados de los rellenamientos de replicación.
### Para supervisar el progreso del reabastecimiento de la replicación y ver los resultados del reabastecimiento de la replicación (AWS CLI)
1. Para supervisar el progreso o ver los resultados de un relleno de replicación, ejecute el siguiente comando. Mientras el relleno de la replicación está en curso, la respuesta solo contiene los recuentos de progreso. Per-image los resultados y la paginación solo están disponibles una vez que se haya completado.
```
aws ecr describe-replication-backfill-results \
--region {{us-west-2}} \
--registry-id {{aws_account_id}} \
--replication-backfill-id {{a1b2c3d4-5678-90ab-cdef-EXAMPLE11111}} \
--max-results 1000 \
--result-status-filter COMPLETE
```
1. Para ver la información resumida de todos los rellenos de replicación, ejecute el siguiente comando.
```
aws ecr list-replication-backfills \
--region {{us-west-2}} \
--registry-id {{aws_account_id}} \
--max-results 50
```
## Detener un relleno de replicación
### Para detener un relleno de replicación (Consola de administración de AWS)
1. Abra la consola de Amazon ECR en [https://console.aws.amazon.com/ecr/repositories](https://console.aws.amazon.com/ecr/repositories).
1. En la barra de navegación, elija la región que contiene sus rellenos de replicación.
1. En el panel de navegación, elija **Private registry (Registro privado)**.
1. En el **Registro privado** página, elige ** Ajustes** y luego elige **Editar** debajo de **Configuración de replicación**.
1. En el **Replicación** página, elija **Trabajos de relleno** pestaña.
1. Elija el relleno de replicación que desea detener.
1. Elija **Detener el trabajo de relleno**.
### Para detener un relleno de replicación (AWS CLI)
+ Para detener un relleno de replicación, ejecute el siguiente comando.
```
aws ecr stop-replication-backfill \
--region {{us-west-2}} \
--registry-id {{aws_account_id}} \
--replication-backfill-id {{a1b2c3d4-5678-90ab-cdef-EXAMPLE11111}}
```