Backfill di replica

Puoi replicare immagini preesistenti nel tuo registro privato Amazon ECR nelle destinazioni di replica configurate. Per impostazione predefinita, la replica si applica solo alle immagini inviate dopo l'applicazione della configurazione di replica. Il backfill di replica consente di replicare le immagini inviate prima della configurazione della replica.

Come funziona il backfill di replica

Quando si avvia un backfill di replica, si specifica un'unica destinazione composta da una regione e da un ID di registro. Amazon ECR valuta la configurazione di replica esistente per determinare quali immagini del registro sono idonee per il backfill verso la destinazione specificata. Solo le immagini che corrispondono alle regole di configurazione di replica correnti sono incluse nel backfill.

Ogni backfill di replica è destinato a una singola destinazione. Per eseguire il backfill delle immagini su più destinazioni, avvia un backfill di replica separato per ciascuna destinazione. Ognuna è identificata da un codice univoco replicationBackfillId che utilizzi per monitorare i progressi, visualizzare i risultati e interromperli se necessario.

Ciclo di vita del backfill delle repliche

Un backfill di replica passa attraverso i seguenti stati:

• PREPARING: Amazon ECR sta identificando le immagini idonee nel tuo registro.

• IN_PROGRESS: Amazon ECR replica attivamente le immagini verso la destinazione.

• COMPLETE: Tutte le immagini idonee sono state replicate correttamente.

• FAILED: un backfill di replica fallisce automaticamente se il 50% o più delle repliche sottostanti fallisce. Questa soglia viene valutata solo dopo l'elaborazione di almeno 100 repliche.

• STOPPING: è stato richiesto un arresto e Amazon ECR è in attesa del completamento delle repliche in volo.

• STOPPED: hai interrotto il backfill delle repliche e tutte le repliche in corso sono terminate.

Nota

È possibile interrompere un backfill di replica solo quando si trova in PREPARING o IN_PROGRESS stato.

Considerazioni per il backfill delle repliche

Quando si utilizza il backfill di replica, è necessario considerare quanto segue.

• Nel backfill sono incluse solo le immagini che corrispondono alla configurazione di replica corrente per la destinazione specificata. Se è necessario eseguire il backfill delle immagini in una destinazione che non è inclusa nella configurazione di replica, è necessario innanzitutto aggiungere tale destinazione alle regole di replica.

• È possibile eseguire fino a 10 backfill di replica contemporaneamente per registro. Se inizi di nuovo, Amazon ECR restituisce un LimitExceededException errore.

• È possibile avere un solo backfill di replica attivo per una determinata regione di destinazione alla volta. Una seconda richiesta per la stessa regione di destinazione restituisce un ReplicationBackfillInProgressException errore.

• Amazon ECR mantiene i backfill delle repliche in uno stato terminale (COMPLETE, FAILED, o STOPPED) per 90 giorni dopo il completamento. Durante questo periodo, rimangono visibili in ListReplicationBackfills risposte.

• L'interruzione del backfill di replica non comporta il ripristino delle immagini già replicate. Tali immagini rimangono nel registro di destinazione.

• Il backfill di replica utilizza lo stesso ruolo collegato ai servizi che Amazon ECR crea quando configuri per la prima volta la replica per il tuo registro privato.

• La maggior parte dei registri dovrebbe completare il backfill entro un'ora. Tuttavia, il completamento completo di un registro che contiene una grande quantità di dati può richiedere ore o addirittura giorni.

• Il backfill della replica salta le immagini il cui repository di origine è stato eliminato. Queste immagini vengono visualizzate con un FAILED stato nei risultati del backfill.

• Amazon ECR invia un EventBridge evento in cui un backfill di replica raggiunge lo stato di terminale. Per ulteriori informazioni, consulta Esempi di eventi da Amazon ECR.

Avvio di un backfill di replica

Per avviare un backfill di replica (Console di gestione AWS)

1. Apri la console Amazon ECR all'indirizzo https://console.aws.amazon.com/ecr/repositories.

2. Dalla barra di navigazione, scegli la regione del registro di origine da cui effettuare il backfill.

3. Nel pannello di navigazione, seleziona Private registry (Registro privato).

4. Sul Registro privato pagina, scegli Impostazioni e poi scegli Modifica sotto Configurazione della replica.

5. Sul Replica pagina, scegli Lavori di backfill scheda.

6. Scegli Inizia il lavoro di backfill.

7. Scegli fino a 10 destinazioni per le quali desideri effettuare il backfill.

8. Scegli Inizia i lavori di backfill.

Per avviare un backfill di replica (AWS CLI)

• Avviare un backfill di replica.

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

Monitoraggio dell'avanzamento del backfill di replica e visualizzazione dei risultati

Per monitorare l'avanzamento del backfill di replica e visualizzare i risultati del backfill (Console di gestione AWS)

1. Apri la console Amazon ECR all'indirizzo https://console.aws.amazon.com/ecr/repositories.

2. Dalla barra di navigazione, scegli la regione che contiene i backfill di replica.

3. Nel pannello di navigazione, seleziona Private registry (Registro privato).

4. Sul Registro privato pagina, scegli Impostazioni e poi scegli Modifica sotto Configurazione della replica.

5. Sul Replica pagina, scegli Lavori di backfill scheda per monitorare lo stato di avanzamento e visualizzare i risultati dei backfill di replica.

Per monitorare l'avanzamento del backfill di replica e visualizzare i risultati del backfill di replica (AWS CLI)

1. Per monitorare l'avanzamento o visualizzare i risultati di un backfill di replica, esegui il comando seguente. Mentre il backfill della replica è in corso, la risposta contiene solo i conteggi dei progressi. Per-image i risultati e l'impaginazione sono disponibili solo dopo il completamento.

   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. Per visualizzare le informazioni di riepilogo di tutti i backfill delle repliche, esegui il comando seguente.

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

Interruzione di un backfill di replica

Per interrompere un backfill di replica (Console di gestione AWS)

1. Apri la console Amazon ECR all'indirizzo https://console.aws.amazon.com/ecr/repositories.

2. Dalla barra di navigazione, scegli la regione che contiene i backfill di replica.

3. Nel pannello di navigazione, seleziona Private registry (Registro privato).

4. Sul Registro privato pagina, scegli Impostazioni e poi scegli Modifica sotto Configurazione della replica.

5. Sul Replica pagina, scegli Lavori di backfill scheda.

6. Scegli il backfill di replica che desideri interrompere.

7. Scegli Interrompi il processo di backfill.

Per interrompere un backfill di replica (AWS CLI)

• Per interrompere un backfill di replica, esegui il comando seguente.

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