Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# 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](ecr-eventbridge.md#ecr-eventbridge-bus).
## 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](https://console.aws.amazon.com/ecr/repositories).
1. Dalla barra di navigazione, scegli la regione del registro di origine da cui effettuare il backfill.
1. Nel pannello di navigazione, seleziona **Private registry (Registro privato)**.
1. Sul **Registro privato** pagina, scegli ** Impostazioni** e poi scegli **Modifica** sotto **Configurazione della replica**.
1. Sul **Replica** pagina, scegli **Lavori di backfill** scheda.
1. Scegli **Inizia il lavoro di backfill**.
1. Scegli fino a 10 destinazioni per le quali desideri effettuare il backfill.
1. 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](https://console.aws.amazon.com/ecr/repositories).
1. Dalla barra di navigazione, scegli la regione che contiene i backfill di replica.
1. Nel pannello di navigazione, seleziona **Private registry (Registro privato)**.
1. Sul **Registro privato** pagina, scegli ** Impostazioni** e poi scegli **Modifica** sotto **Configurazione della replica**.
1. 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
```
1. 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](https://console.aws.amazon.com/ecr/repositories).
1. Dalla barra di navigazione, scegli la regione che contiene i backfill di replica.
1. Nel pannello di navigazione, seleziona **Private registry (Registro privato)**.
1. Sul **Registro privato** pagina, scegli ** Impostazioni** e poi scegli **Modifica** sotto **Configurazione della replica**.
1. Sul **Replica** pagina, scegli **Lavori di backfill** scheda.
1. Scegli il backfill di replica che desideri interrompere.
1. 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}}
```