Replikationsauffüllung

Sie können bereits vorhandene Images in Ihrer privaten Amazon ECR-Registry auf Ihre konfigurierten Replikationsziele replizieren. Standardmäßig gilt die Replikation nur für Images, die übertragen werden, nachdem die Replikationskonfiguration angewendet wurde. Mit Replikations-Backfill können Sie Images replizieren, die Sie vor der Konfiguration der Replikation übertragen haben.

So funktioniert das Replikations-Backfill

Wenn Sie ein Replikations-Backfill starten, geben Sie ein einzelnes Ziel an, das aus einer Region und einer Registrierungs-ID besteht. Amazon ECR bewertet Ihre bestehende Replikationskonfiguration, um zu ermitteln, welche Images in Ihrer Registrierung für das Backfill an das angegebene Ziel in Frage kommen. Nur Images, die Ihren aktuellen Replikationskonfigurationsregeln entsprechen, werden in das Backfill aufgenommen.

Jedes Replikations-Backfill zielt auf ein einzelnes Ziel ab. Um Bilder an mehrere Ziele aufzufüllen, starten Sie für jedes Ziel eine separate Replikationsauffüllung. Jedes ist durch ein Unikat gekennzeichnet replicationBackfillId das Sie verwenden, um den Fortschritt zu überwachen, Ergebnisse anzuzeigen und ihn bei Bedarf zu stoppen.

Lebenszyklus des Backfill-Replizierens

Ein Replikations-Backfill durchläuft die folgenden Status:

• PREPARING: Amazon ECR identifiziert qualifizierende Bilder in Ihrer Registrierung.

• IN_PROGRESS: Amazon ECR repliziert aktiv Bilder an das Ziel.

• COMPLETE: Alle qualifizierten Bilder wurden erfolgreich repliziert.

• FAILED: Ein Replikations-Backfill schlägt automatisch fehl, wenn mindestens 50% der zugrunde liegenden Replikationen fehlschlagen. Dieser Schwellenwert wird erst bewertet, wenn mindestens 100 Replikationen verarbeitet wurden.

• STOPPING: Ein Stopp wurde angefordert und Amazon ECR wartet darauf, dass die Replikationen während des Fluges abgeschlossen sind.

• STOPPED: Sie haben das Replikations-Backfill gestoppt und alle Replizierungen während des Fluges sind beendet.

Anmerkung

Sie können ein Replikations-Backfill nur stoppen, wenn es sich im PREPARING oder IN_PROGRESS Status.

Überlegungen zum Replikations-Backfill

Folgendes sollte bei der Verwendung von Replikations-Backfill berücksichtigt werden.

• Nur Images, die Ihrer aktuellen Replikationskonfiguration für das angegebene Ziel entsprechen, sind in der Auffüllung enthalten. Wenn Sie Images für ein Ziel auffüllen müssen, das nicht in Ihrer Replikationskonfiguration enthalten ist, müssen Sie dieses Ziel zuerst zu Ihren Replikationsregeln hinzufügen.

• Sie können pro Registrierung bis zu 10 Replikations-Backfills gleichzeitig ausführen. Wenn Sie mehr beginnen, gibt Amazon ECR eine LimitExceededException Fehler.

• Sie können jeweils nur eine aktive Replikationsauffüllung für eine bestimmte Zielregion haben. Eine zweite Anfrage für dieselbe Zielregion gibt eine zurück ReplicationBackfillInProgressException Fehler.

• Amazon ECR behält Replikations-Backfills im Terminalzustand bei (COMPLETE, FAILED, oder STOPPED) für 90 Tage nach Abschluss. Während dieser Zeit bleiben sie sichtbar in ListReplicationBackfills Antworten.

• Durch das Stoppen einer Replikationsauffüllung werden Bilder, die bereits repliziert wurden, nicht rückgängig gemacht. Diese Images verbleiben in der Zielregistrierung.

• Beim Replikations-Backfill wird dieselbe serviceverknüpfte Rolle verwendet, die Amazon ECR erstellt, wenn Sie die Replikation zum ersten Mal für Ihre private Registrierung konfigurieren.

• Bei den meisten Registern wird erwartet, dass das Auffüllen innerhalb einer Stunde abgeschlossen ist. Es kann jedoch Stunden oder sogar Tage dauern, bis ein Register, das eine große Datenmenge enthält, vollständig gefüllt ist.

• Beim Replikations-Backfill werden Bilder übersprungen, deren Quell-Repository gelöscht wurde. Diese Bilder erscheinen mit einem FAILED Status in den Backfill-Ergebnissen.

• Amazon ECR sendet eine EventBridge Ereignis, wenn ein Replikations-Backfill einen Terminalstatus erreicht. Weitere Informationen finden Sie unter Beispielereignisse von Amazon ECR.

Ein Replikations-Backfill wird gestartet

Um ein Replikations-Backfill zu starten (AWS-Managementkonsole)

1. Öffnen Sie die Amazon ECR-Konsole unter https://console.aws.amazon.com/ecr/repositories.

2. Wählen Sie in der Navigationsleiste die Region der Quellregistrierung aus, aus der das Backfill erfolgen soll.

3. Wählen Sie im Navigationsbereich die Option Private Registrierung.

4. Auf der Privates Register Seite, wähle Einstellungen und dann wähle Bearbeiten unter Konfiguration der Replikation.

5. Auf der Replikation Seite, wählen Sie die Jobs auffüllen Tab.

6. Wählen Sie Backfill-Job starten.

7. Wählen Sie bis zu 10 Ziele aus, die Sie als Backfill verwenden möchten.

8. Wählen Sie Starten Sie Backfill-Jobs.

Um ein Replikations-Backfill zu starten (AWS CLI)

• Starten Sie ein Replikations-Backfill.

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

Überwachen Sie den Fortschritt der Replikationsauffüllung und sehen Sie sich die Ergebnisse an

Um den Fortschritt der Replikationsauffüllung zu überwachen und die Ergebnisse der Replikationsauffüllung anzuzeigen (AWS-Managementkonsole)

1. Öffnen Sie die Amazon ECR-Konsole unter https://console.aws.amazon.com/ecr/repositories.

2. Wählen Sie in der Navigationsleiste die Region aus, die Ihre Replikations-Backfills enthält.

3. Wählen Sie im Navigationsbereich die Option Private Registrierung.

4. Auf der Privates Register Seite, wähle Einstellungen und dann wähle Bearbeiten unter Konfiguration der Replikation.

5. Auf der Replikation Seite, wählen Sie die Jobs auffüllen Registerkarte, um den Fortschritt zu überwachen und die Ergebnisse Ihrer Replikations-Backfills einzusehen.

Um den Fortschritt der Replikationsauffüllung zu überwachen und die Ergebnisse der Replikationsauffüllung anzuzeigen (AWS CLI)

1. Führen Sie den folgenden Befehl aus, um den Fortschritt zu überwachen oder die Ergebnisse einer Replikationsauffüllung anzuzeigen. Während der Replikationsauffüllung enthält die Antwort nur Fortschrittszähler. Per-image Ergebnisse und Seitennummerierung sind erst verfügbar, wenn der Vorgang abgeschlossen ist.

   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. Führen Sie den folgenden Befehl aus, um eine Zusammenfassung aller Replikations-Backfills anzuzeigen.

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

Stoppen eines Replikations-Backfills

Um ein Replikations-Backfill zu stoppen (AWS-Managementkonsole)

1. Öffnen Sie die Amazon ECR-Konsole unter https://console.aws.amazon.com/ecr/repositories.

2. Wählen Sie in der Navigationsleiste die Region aus, die Ihre Replikations-Backfills enthält.

3. Wählen Sie im Navigationsbereich die Option Private Registrierung.

4. Auf der Privates Register Seite, wähle Einstellungen und dann wähle Bearbeiten unter Konfiguration der Replikation.

5. Auf der Replikation Seite, wählen Sie die Jobs auffüllen Tab.

6. Wählen Sie das Replikations-Backfill aus, das Sie beenden möchten.

7. Wählen Sie Stoppen Sie den Backfill-Job.

Um ein Replikations-Backfill zu stoppen (AWS CLI)

• Führen Sie den folgenden Befehl aus, um ein Replikations-Backfill zu stoppen.

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