View a markdown version of this page

Preenchimento de replicação - Amazon ECR
Como funciona o preenchimento de replicaçãoCiclo de vida do preenchimento retroativo de replicaçãoConsiderações sobre preenchimento de replicaçãoIniciando um preenchimento de replicaçãoMonitorando o progresso do preenchimento de replicação e visualizando os resultadosInterrompendo um preenchimento de replicação

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Preenchimento de replicação

Você pode replicar imagens preexistentes em seu registro privado do Amazon ECR para seus destinos de replicação configurados. Por padrão, a replicação só se aplica às imagens enviadas após a aplicação da configuração de replicação. O preenchimento de replicação permite que você replique imagens enviadas antes de configurar a replicação.

Como funciona o preenchimento de replicação

Ao iniciar um preenchimento de replicação, você especifica um único destino que consiste em uma região e uma ID de registro. O Amazon ECR avalia sua configuração de replicação existente para determinar quais imagens em seu registro se qualificam para preenchimento no destino especificado. Somente imagens que correspondam às suas regras atuais de configuração de replicação são incluídas no preenchimento.

Cada preenchimento de replicação tem como alvo um único destino. Para preencher imagens em vários destinos, inicie um preenchimento de replicação separado para cada destino. Cada um é identificado por um único replicationBackfillId que você usa para monitorar o progresso, visualizar os resultados e interrompê-lo, se necessário.

Ciclo de vida do preenchimento retroativo de replicação

Um preenchimento de replicação passa pelos seguintes status:

  • PREPARING: O Amazon ECR está identificando imagens qualificadas em seu registro.

  • IN_PROGRESS: O Amazon ECR está replicando ativamente as imagens até o destino.

  • COMPLETE: Todas as imagens qualificadas foram replicadas com sucesso.

  • FAILED: um preenchimento de replicação falha automaticamente se 50% ou mais das replicações subjacentes falharem. Esse limite só é avaliado quando pelo menos 100 replicações são processadas.

  • STOPPING: Uma parada foi solicitada e o Amazon ECR está aguardando a conclusão das replicações em voo.

  • STOPPED: Você interrompeu o preenchimento de replicação e todas as replicações em andamento foram encerradas.

nota

Você pode interromper um preenchimento de replicação somente quando ele estiver no PREPARING ou IN_PROGRESS status.

Considerações sobre preenchimento de replicação

O seguinte deve ser considerado ao usar o preenchimento de replicação.

  • Somente imagens que correspondam à sua configuração de replicação atual para o destino especificado são incluídas no preenchimento. Se você precisar preencher imagens em um destino que não esteja em sua configuração de replicação, primeiro adicione esse destino às suas regras de replicação.

  • Você pode executar até 10 preenchimentos de replicação simultaneamente por registro. Se você começar mais, o Amazon ECR retornará um LimitExceededException erro.

  • Você pode ter somente um preenchimento de replicação ativo para uma determinada região de destino por vez. Uma segunda solicitação para a mesma região de destino retorna um ReplicationBackfillInProgressException erro.

  • O Amazon ECR retém os preenchimentos de replicação em um estado terminal (COMPLETE, FAILED, ou STOPPED) por 90 dias após a conclusão. Durante esse tempo, eles permanecem visíveis em ListReplicationBackfills respostas.

  • Interromper um preenchimento de replicação não reverte as imagens que ele já replicou. Essas imagens permanecem no registro de destino.

  • O preenchimento de replicação usa a mesma função vinculada ao serviço que o Amazon ECR cria quando você configura a replicação pela primeira vez para seu registro privado.

  • Espera-se que a maioria dos registros seja preenchida em uma hora. No entanto, um registro que contém uma grande quantidade de dados pode levar horas ou até dias para ser totalmente preenchido.

  • O preenchimento de replicação ignora imagens cujo repositório de origem foi excluído. Essas imagens aparecem com um FAILED status nos resultados do preenchimento.

  • O Amazon ECR envia um EventBridge evento quando um preenchimento de replicação atinge o status de terminal. Para obter mais informações, consulte Amostra de eventos do Amazon ECR.

Iniciando um preenchimento de replicação

  1. Abra o console do Amazon ECR em https://console.aws.amazon.com/ecr/repositories.

  2. Na barra de navegação, escolha a região do registro de origem a partir da qual preencher.

  3. No painel de navegação, escolha Private registry (Registro privado).

  4. Na Registro privado página, escolha Configurações e, em seguida, escolha Editar embaixo Configuração de replicação.

  5. Na Replicação página, escolha o Trabalhos de preenchimento aba.

  6. Escolha Inicie o trabalho de preenchimento.

  7. Escolha até 10 destinos para os quais você deseja preencher.

  8. Escolha Inicie trabalhos de preenchimento.

  • Inicie um preenchimento de replicação.

    aws ecr start-replication-backfill \
    --region us-west-2 \
    --registry-id aws_account_id \
    --destination region=destination_region,registryId=destination_aws_account_id

Monitorando o progresso do preenchimento de replicação e visualizando os resultados

  1. Abra o console do Amazon ECR em https://console.aws.amazon.com/ecr/repositories.

  2. Na barra de navegação, escolha a região que contém seus preenchimentos de replicação.

  3. No painel de navegação, escolha Private registry (Registro privado).

  4. Na Registro privado página, escolha Configurações e, em seguida, escolha Editar embaixo Configuração de replicação.

  5. Na Replicação página, escolha o Trabalhos de preenchimento guia para monitorar o progresso e visualizar os resultados de seus preenchimentos de replicação.

  1. Para monitorar o progresso ou visualizar os resultados de um preenchimento de replicação, execute o comando a seguir. Enquanto o preenchimento de replicação estiver em andamento, a resposta contém somente contagens de progresso. Per-image os resultados e a paginação estão disponíveis somente após sua conclusão.

    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 visualizar informações resumidas de todos os preenchimentos de replicação, execute o comando a seguir.

    aws ecr list-replication-backfills \
    --region us-west-2 \
    --registry-id aws_account_id \
    --max-results 50

Interrompendo um preenchimento de replicação

  1. Abra o console do Amazon ECR em https://console.aws.amazon.com/ecr/repositories.

  2. Na barra de navegação, escolha a região que contém seus preenchimentos de replicação.

  3. No painel de navegação, escolha Private registry (Registro privado).

  4. Na Registro privado página, escolha Configurações e, em seguida, escolha Editar embaixo Configuração de replicação.

  5. Na Replicação página, escolha o Trabalhos de preenchimento aba.

  6. Escolha o preenchimento de replicação que você deseja interromper.

  7. Escolha Pare o trabalho de preenchimento.

  • Para interromper um preenchimento de replicação, execute o comando a seguir.

    aws ecr stop-replication-backfill \
    --region us-west-2 \
    --registry-id aws_account_id \
    --replication-backfill-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111