View a markdown version of this page

Relleno de replicación - Amazon ECR
Cómo funciona el backfill de replicaciónCiclo de vida de backup de la replicaciónConsideraciones para el backfill de replicaciónIniciar un relleno de replicaciónSupervisar el progreso del backfill de la replicación y ver los resultadosDetener un relleno de replicación

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.

Iniciar un relleno de replicación

  1. Abra la consola de Amazon ECR en https://console.aws.amazon.com/ecr/repositories.

  2. En la barra de navegación, elija la región del registro de origen desde la que desea rellenar el registro.

  3. En el panel de navegación, elija Private registry (Registro privado).

  4. En el Registro privado página, elige Ajustes y luego elige Editar debajo de Configuración de replicación.

  5. En el Replicación página, elija Trabajos de relleno pestaña.

  6. Elige Iniciar el trabajo de relleno.

  7. Elige hasta 10 destinos en los que quieras rellenar.

  8. Elige Comience a rellenar trabajos.

  • 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

  1. Abra la consola de Amazon ECR en https://console.aws.amazon.com/ecr/repositories.

  2. En la barra de navegación, elija la región que contiene sus rellenos de replicación.

  3. En el panel de navegación, elija Private registry (Registro privado).

  4. En el Registro privado página, elige Ajustes y luego elige Editar debajo de Configuración de replicación.

  5. 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.

  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

  2. 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

  1. Abra la consola de Amazon ECR en https://console.aws.amazon.com/ecr/repositories.

  2. En la barra de navegación, elija la región que contiene sus rellenos de replicación.

  3. En el panel de navegación, elija Private registry (Registro privado).

  4. En el Registro privado página, elige Ajustes y luego elige Editar debajo de Configuración de replicación.

  5. En el Replicación página, elija Trabajos de relleno pestaña.

  6. Elija el relleno de replicación que desea detener.

  7. Elija Detener el trabajo de relleno.

  • 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