Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Replikation privater Images in Amazon ECR Sie können Ihre private Amazon-ECR-Registrierung so konfigurieren, dass sie die Replikation Ihrer Repositorys unterstützt. Amazon ECR unterstützt sowohl die regionen- als auch die kontoübergreifende Replikation. Damit eine kontoübergreifende Replikation stattfinden kann, muss das Zielkonto eine Richtlinie für Registrierungsberechtigungen konfigurieren, um die Replikation aus dem Quell-Registry zu ermöglichen. Weitere Informationen finden Sie unter [Private Registrierungsberechtigungen in Amazon ECR](registry-permissions.md). **Topics** + [Anforderungen an die Richtlinien für die kontoübergreifende Replikation](#replication-policy-clarification) + [Überlegungen zur privaten Image-Replikation](#replication-considerations) + [Beispiele für die Replikation privater Images für Amazon ECR](registry-settings-examples.md) + [Konfiguration der privaten Image-Replikation in Amazon ECR](registry-settings-configure.md) + [Replikationseinstellungen für private Bilder in Amazon ECR entfernen](registry-settings-remove.md) ## Anforderungen an die Richtlinien für die kontoübergreifende Replikation Damit die kontenübergreifende ECR-Replikation ordnungsgemäß funktioniert, müssen Sie wissen, für welches Konto welche Richtlinien konfiguriert werden müssen. In diesem Abschnitt werden die Richtlinienanforderungen für Quell- und Zielkonten erläutert. ### Überblick über die Richtlinienkonfiguration Für die kontenübergreifende ECR-Replikation ist eine Richtlinienkonfiguration nur für das **Zielkonto** erforderlich. Für das Quellkonto sind keine speziellen Repository- oder Registrierungsrichtlinien erforderlich. + **Quellkonto**: Konfigurieren Sie die Replikationsregeln in den Registrierungseinstellungen. Für Quell-Repositorys sind keine zusätzlichen Richtlinien erforderlich. + **Zielkonto**: Konfigurieren Sie eine Richtlinie für Registrierungsberechtigungen, damit das Quellkonto Bilder replizieren kann. ### Anforderungen an die Zielregistrierungsrichtlinie Das Zielkonto muss eine Registrierungsberechtigungsrichtlinie konfigurieren, die dem Quellkonto die Erlaubnis erteilt, die folgenden Aktionen auszuführen: + `ecr:ReplicateImage`— Ermöglicht dem Quellkonto, Bilder in die Zielregistrierung zu replizieren + `ecr:CreateRepository`- Ermöglicht ECR, automatisch Repositorys in der Zielregistrierung zu erstellen, falls sie noch nicht existieren **Wichtig** Wenn Sie die `ecr:CreateRepository` Erlaubnis nicht erteilen, müssen Sie manuell Repositorys mit denselben Namen im Zielkonto erstellen, bevor die Replikation erfolgreich sein kann. Beispiel für eine Zielregistrierungsrichtlinie: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowCrossAccountReplication", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:root" }, "Action": [ "ecr:ReplicateImage", "ecr:CreateRepository" ], "Resource": "*" } ] } ``` ------ ### Anforderungen an das Quellkonto Das Quellkonto muss nur: + Konfigurieren Sie die Replikationsregeln in den Registrierungseinstellungen, um das Zielkonto und die Regionen anzugeben + Stellen Sie sicher, dass der IAM-Prinzipal, der die Replikation konfiguriert, über die erforderlichen ECR-Berechtigungen verfügt **Für Quell-Repositorys sind keine zusätzlichen Richtlinien erforderlich.** Die Quell-Repositorys benötigen keine Repository-Richtlinien, die Replikationsberechtigungen gewähren. ### Häufige Missverständnisse Im Folgenden finden Sie häufige Missverständnisse zu kontenübergreifenden ECR-Replikationsrichtlinien: + **Irrtum**: Das Quell-Repository benötigt eine Richtlinie, die es dem Zielkonto ermöglicht, Bilder zu replizieren. **Realität**: Quell-Repositorys benötigen keine speziellen Richtlinien für die Replikation. + **Irrtum**: Sowohl Quell- als auch Zielkonten benötigen Registrierungsrichtlinien. **Realität**: Nur das Zielkonto benötigt eine Registrierungsberechtigungsrichtlinie. + **Irrtum**: Repository-Richtlinien und Registrierungsrichtlinien sind dasselbe. **Realität**: Repository-Richtlinien kontrollieren den Zugriff auf einzelne Repositorys, während Registry-Richtlinien Operationen wie Replikation auf Registrierungsebene steuern. ### Behebung von Replikationsfehlern Wenn die kontoübergreifende Replikation fehlschlägt, überprüfen Sie Folgendes: + Stellen Sie sicher, dass für das Zielkonto eine Registrierungsberechtigungsrichtlinie konfiguriert ist + Stellen Sie sicher, dass die Registrierungsrichtlinie `ecr:ReplicateImage` sowohl `ecr:CreateRepository` Aktionen als auch umfasst + Vergewissern Sie sich, dass die Quellkonto-ID in der Zielregistrierungsrichtlinie korrekt angegeben ist + Prüfen Sie, ob die Ziel-Repositorys existieren (falls `ecr:CreateRepository` nicht gewährt) + Überprüfen Sie die CloudTrail Protokolle auf fehlgeschlagene `CreateRepository` Aufrufe oder `ReplicateImage` API-Aufrufe ## Überlegungen zur privaten Image-Replikation Bei der Verwendung der privaten Image-Replikation sollte Folgendes beachtet werden. + Nur Repository-Inhalte, die nach der Konfiguration der Replikation in ein Repository übertragen oder wiederhergestellt wurden, werden repliziert. Bereits vorhandener Inhalt in einem Repository wird nicht repliziert. Wenn ein Image wiederhergestellt wird, nachdem die Replikation aktiviert wurde, wird es repliziert. Wenn es wiederhergestellt wird, bevor die Replikation aktiviert wurde, wird es nicht repliziert. + Der Repository-Name bleibt in allen Regionen und Konten gleich, wenn die Replikation stattgefunden hat. Amazon ECR unterstützt das Ändern des Repository-Namens während der Replikation nicht. + Wenn Sie Ihre private Registrierung zum ersten Mal für die Replikation konfigurieren, erstellt Amazon ECR in Ihrem Namen eine serviceverknüpfte IAM-Rolle. Die serviceverknüpfte IAM-Rolle gewährt dem Amazon-ECR-Replikationsservice die Berechtigung, Repositorys zu erstellen und Images in Ihrer Registrierung zu replizieren. Weitere Informationen finden Sie unter [Verwendung von dienstgebundenen Rollen für Amazon ECR](using-service-linked-roles.md). + Damit eine kontoübergreifende Replikation stattfinden kann, muss das Ziel der privaten Registrierung die Erlaubnis erteilen, dass die Quellregistrierung ihre Images replizieren kann. Dies geschieht durch die Festlegung einer Richtlinie für private Registrierungsberechtigungen. Weitere Informationen finden Sie unter [Private Registrierungsberechtigungen in Amazon ECR](registry-permissions.md). + Wenn die Berechtigungsrichtlinie für eine private Registrierung geändert wird, um eine Berechtigung zu entfernen, können alle laufenden Replikationen, die zuvor gewährt wurden, abgeschlossen werden. + Damit eine regionsübergreifende Replikation stattfinden kann, müssen sowohl das Quell- als auch das Zielkonto für die Region aktiviert sein, bevor Replikationsaktionen innerhalb oder zu dieser Region durchgeführt werden. Weitere Informationen finden Sie unter [Verwalten von AWS -Regionen](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html) im *Allgemeine Amazon Web Services-Referenz*. + Die regionsübergreifende Replikation zwischen AWS Partitionen wird nicht unterstützt. Zum Beispiel ein Repository in `us-west-2` kann nicht in ` cn-north-1` repliziert werden. Weitere Informationen zu AWS Partitionen finden Sie unter [ARN-Format](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arns-syntax) in der *AWS Allgemeinen Referenz*. + Die Replikationskonfiguration für eine private Registrierung kann bis zu 25 eindeutige Ziele für alle Regeln enthalten, wobei die Gesamtzahl der Regeln 10 nicht überschreiten darf. Jede Regel kann bis zu 100 Filter enthalten. Auf diese Weise können separate Regeln für Repositories festgelegt werden, die beispielsweise Images für die Produktion und für Tests enthalten. + Die Replikationskonfiguration unterstützt die Filterung, welche Repositorys in einer privaten Registrierung repliziert werden, indem ein Repository-Präfix angegeben wird. Ein Beispiel finden Sie unter [Beispiel: Konfigurieren der regionsübergreifenden Replikation mithilfe eines Repository-Filters](registry-settings-examples.md#registry-settings-examples-crr-filter). + Eine Replikationsaktion erfolgt nur einmal pro Image-Push oder Imagewiederherstellung. Wenn Sie z. B. die regionsübergreifende Replikation von `us-west-2` nach ` us-east-1` und von `us-east-1` nach `us-east-2` konfiguriert haben, wird ein Image, das in die Region `us-west-2` verschoben wird, nur in die Region `us-east-1` repliziert, nicht aber in die Region `us-east-2`. Dieses Verhalten gilt sowohl für die regionen- als auch für die kontoübergreifende Replikation. + Die Mehrheit der Bilder repliziert sich in weniger als 30 Minuten, aber in seltenen Fällen kann die Replikation länger dauern. + Bei der Registrierungsreplikation werden keine Lösch- oder Archivierungsaktionen ausgeführt. Replizierte Images und Repositorys können gelöscht oder archiviert werden, wenn sie nicht mehr verwendet werden. + Wenn das zu replizierende Bild im Ziel archiviert ist, wird es im Ziel wiederhergestellt. + Wenn ein Bild in einer Quellregion archiviert wird, wird es nicht in einer in der Replikationskonfiguration angegebenen Zielregion archiviert. + Repository-Richtlinien, einschließlich IAM-Richtlinien, und Lebenszyklus-Richtlinien werden nicht repliziert und haben nur Auswirkungen auf das Repository, für das sie definiert sind. + Repository-Einstellungen werden standardmäßig nicht repliziert. Sie können die Repository-Einstellungen mithilfe von Vorlagen zur Repository-Erstellung replizieren. Zu diesen Einstellungen gehören die Veränderbarkeit von Tags, Verschlüsselung, Repository-Berechtigungen und Lebenszyklusrichtlinien. Weitere Informationen zu Vorlagen für die Erstellung von Repositorys finden Sie unter[Vorlagen zur Steuerung von Repositorys, die während einer Pull-Through-Cache-, Push-Erstellung oder Replikationsaktion erstellt wurden](repository-creation-templates.md). + Wenn die Tag-Unveränderlichkeit in einem Repository aktiviert ist und ein Image repliziert wird, das denselben Tag wie ein bestehendes Image verwendet, wird das Image repliziert, enthält aber nicht den duplizierten Tag. Dies kann dazu führen, dass das Image nicht gekennzeichnet wird. + Wenn beim Replizieren von Bildern das Blob-Mounting konfiguriert wurde, überprüft ECR, ob alle Ebenen aus dem Quell-Repository bereits in der Zielregistrierung vorhanden sind. Wenn in der Zielregistrierung bereits Ebenen vorhanden sind, hängt ECR diese Ebenen ein. **Anmerkung** Wenn sich die Quellregistrierung von der Zielregistrierung unterscheidet, muss das Blob-Mounting für beide Registrierungen aktiviert sein, damit ECR replizierte Schichten mounten kann. # Beispiele für die Replikation privater Images für Amazon ECR Die folgenden Beispiele zeigen häufige Anwendungsfälle für die Replikation privater Images. Wenn Sie die Replikation mithilfe von konfigurieren AWS CLI, können Sie die JSON-Beispiele als Ausgangspunkt verwenden, wenn Sie Ihre JSON-Datei erstellen. Wenn Sie die Replikation mithilfe von konfigurieren AWS-Managementkonsole, wird Ihnen bei der Überprüfung Ihrer Replikationsregel auf der Seite **Überprüfen und Absenden** ein ähnliches JSON-Format angezeigt. ## Beispiel: Konfigurieren der regionenübergreifenden Replikation in eine einzige Zielregion Im Folgenden wird ein Beispiel für die Konfiguration der regionenübergreifenden Replikation innerhalb einer einzelnen Registrierung gezeigt. In diesem Beispiel wird davon ausgegangen, dass Ihre Konto-ID ` 111122223333` ist und dass Sie diese Replikationskonfiguration in einer anderen Region als `us-west-2` angeben. ``` { "rules": [ { "destinations": [ { "region": "us-west-2", "registryId": "111122223333" } ] } ] } ``` ## Beispiel: Konfigurieren der regionsübergreifenden Replikation mithilfe eines Repository-Filters Im Folgenden finden Sie ein Beispiel für die Konfiguration der regionsübergreifenden Replikation für Repositorys, die einem Präfixnamenwert entsprechen. In diesem Beispiel wird davon ausgegangen, dass Ihre Konto-ID ` 111122223333` ist und dass Sie diese Replikationskonfiguration in einer anderen Region als `us-west-1` angeben und über Repositories mit dem Präfix `prod` verfügen. ``` { "rules": [{ "destinations": [{ "region": "us-west-1", "registryId": "111122223333" }], "repositoryFilters": [{ "filter": "prod", "filterType": "PREFIX_MATCH" }] }] } ``` ## Beispiel: Konfigurieren der regionenübergreifenden Replikation an mehrere Zielregionen Im Folgenden wird ein Beispiel für die Konfiguration der regionenübergreifenden Replikation innerhalb einer einzelnen Registrierung gezeigt. In diesem Beispiel wird davon ausgegangen, dass Ihre Konto-ID lautet ` 111122223333` und dass Sie diese Replikationskonfiguration in einer anderen Region als `us-west-1` oder angeben`us-west-2`. ``` { "rules": [ { "destinations": [ { "region": "us-west-1", "registryId": "111122223333" }, { "region": "us-west-2", "registryId": "111122223333" } ] } ] } ``` ## Beispiel: Konfigurieren der kontoübergreifenden Replikation Im Folgenden finden Sie ein Beispiel für die Konfiguration der kontoübergreifenden Replikation für Ihre Registrierung. In diesem Beispiel wird die Replikation auf das Konto `444455556666` und auf die Region `us-west-2` konfiguriert. **Wichtig** Damit eine kontoübergreifende Replikation stattfinden kann, muss das Zielkonto eine Richtlinie für Registrierungsberechtigungen konfigurieren, um die Replikation zu ermöglichen. Weitere Informationen finden Sie unter [Private Registrierungsberechtigungen in Amazon ECR](registry-permissions.md). ``` { "rules": [ { "destinations": [ { "region": "us-west-2", "registryId": "444455556666" } ] } ] } ``` ## Beispiel: Festlegen mehrerer Regeln in einer Konfiguration Im Folgenden finden Sie ein Beispiel für die Konfiguration mehrerer Replikationsregeln für Ihre Registrierung. In diesem Beispiel wird die Replikation für das * 111122223333*-Konto mit einer Regel konfiguriert, die Repositorys mit einem Präfix von `prod` in die Region `us-west-2` und Repositorys mit einem Präfix von `test` in die Region `us-east-2` repliziert. Eine Replikationskonfiguration kann bis zu 10 Regeln enthalten, wobei jede Regel bis zu 25 Ziele angeben kann. ``` { "rules": [{ "destinations": [{ "region": "us-west-2", "registryId": "111122223333" }], "repositoryFilters": [{ "filter": "prod", "filterType": "PREFIX_MATCH" }] }, { "destinations": [{ "region": "us-east-2", "registryId": "111122223333" }], "repositoryFilters": [{ "filter": "test", "filterType": "PREFIX_MATCH" }] } ] } ``` ## Beispiel: Alle Replikationseinstellungen werden entfernt Im Folgenden finden Sie ein Beispiel für das Entfernen aller Replikationseinstellungen aus Ihrer Registrierung. Um Replikationseinstellungen zu entfernen, müssen Sie ein leeres Regelarray konfigurieren. ``` { "rules": [] } ``` **Wichtig** Durch das Entfernen von Replizierungseinstellungen werden keine zuvor replizierten Repositorys oder Images gelöscht. Sie müssen replizierte Inhalte manuell löschen, wenn sie nicht mehr benötigt werden. # Konfiguration der privaten Image-Replikation in Amazon ECR Konfigurieren Sie die Replikation pro Region für Ihre private Registrierung. Sie können die regionsübergreifende Replikation oder die kontoübergreifende Replikation konfigurieren. Beispiele dafür, wie Replikation häufig verwendet wird, finden Sie unter [Beispiele für die Replikation privater Images für Amazon ECR](registry-settings-examples.md). ## So konfigurieren Sie die Einstellungen für die Registrierungsreplikation (AWS-Managementkonsole) 1. Öffnen Sie die Amazon ECR-Konsole unter [https://console.aws.amazon.com/ecr/Repositorys](https://console.aws.amazon.com/ecr/repositories). 1. Wählen Sie in der Navigationsleiste die Region aus, für die Sie die Einstellungen für die Registrierungsreplikation konfigurieren möchten. 1. Wählen Sie im Navigationsbereich die Option **Private Registrierung**. 1. Wählen Sie auf der Seite **Private Registry** die Option **Einstellungen** und dann unter **Replikationskonfiguration** die Option **Bearbeiten** aus. 1. Wählen Sie auf der Seite **Replikation** die Option **Replikationsregel hinzufügen**. 1. Wählen Sie auf der Seite **Zieltypen**, ob Sie die regionenübergreifende Replikation, die kontoübergreifende Replikation oder beides aktivieren möchten, und wählen Sie dann **Weiter**. 1. Wenn die regionenübergreifende Replikation aktiviert ist, wählen Sie unter **Zielregionen konfigurieren** eine oder mehrere **Zielregionen** aus und wählen dann **Weiter**. 1. Wenn die kontoübergreifende Replikation aktiviert ist, wählen Sie für die **kontoübergreifende Replikation** die Einstellung für die kontoübergreifende Replikation für die Registrierung. Geben Sie unter **Zielkonto** die Konto-ID für das Zielkonto und eine oder mehrere **Zielregionen** ein, in die repliziert werden soll. Wählen Sie **Zielkonto \$1**, um weitere Konten als Replikationsziele zu konfigurieren. **Wichtig** Damit eine kontoübergreifende Replikation stattfinden kann, muss das Zielkonto eine Richtlinie für Registrierungsberechtigungen konfigurieren, um die Replikation zu ermöglichen. Weitere Informationen finden Sie unter [Private Registrierungsberechtigungen in Amazon ECR](registry-permissions.md). 1. (Optional) Geben Sie auf der Seite **Filter hinzufügen** einen oder mehrere Filter für die Replikationsregel an und wählen Sie dann **Hinzufügen**. Wiederholen Sie diesen Schritt für jeden Filter, den Sie mit der Replikationsaktion verknüpfen möchten. Ein Filter muss als Präfix für den Repository-Namen angegeben werden. Wenn keine Filter hinzugefügt werden, wird der Inhalt aller Repositorys repliziert. Wählen Sie **Weiter**, wenn Sie alle Filter hinzugefügt haben. 1. Überprüfen Sie auf der Seite **Überprüfen und Übermitteln** die Konfiguration der Replikationsregel und wählen Sie anschließend **Regel übermitteln**. ## So konfigurieren Sie die Einstellungen für die Registrierungsreplikation (AWS CLI) 1. Erstellen Sie eine JSON-Datei mit den Replikationsregeln, die Sie für Ihre Registrierung definieren müssen. Eine Replikationskonfiguration kann bis zu 10 Regeln enthalten, wobei jede Regel bis zu 25 einzigartige Ziele und 100 Filter angeben kann. Um die regionenübergreifende Replikation innerhalb Ihres eigenen Kontos zu konfigurieren, geben Sie Ihre eigene Konto-ID an. Weitere Beispiele finden Sie unter [Beispiele für die Replikation privater Images für Amazon ECR](registry-settings-examples.md). ``` { "rules": [{ "destinations": [{ "region": "destination_region", "registryId": "destination_accountId" }], "repositoryFilters": [{ "filter": "repository_prefix_name", "filterType": "PREFIX_MATCH" }] }] } ``` 1. Erstellen Sie eine Replikationskonfiguration für Ihre Registrierung. ``` aws ecr put-replication-configuration \ --replication-configuration file://replication-settings.json \ --region us-west-2 ``` 1. Bestätigen Sie Ihre Registrierungseinstellungen. ``` aws ecr describe-registry \ --region us-west-2 ``` # Replikationseinstellungen für private Bilder in Amazon ECR entfernen Um die Replikationseinstellungen für Ihre private Registrierung zu entfernen oder zu deaktivieren, müssen Sie eine leere Replikationskonfiguration konfigurieren. In der gibt es keinen speziellen Befehl zum Entfernen AWS CLI. ## Um die Einstellungen für die Replikation der Registrierung zu entfernen (AWS-Managementkonsole) 1. Öffnen Sie die Amazon ECR-Konsole unter [https://console.aws.amazon.com/ecr/Repositorys](https://console.aws.amazon.com/ecr/repositories). 1. Wählen Sie in der Navigationsleiste die Region aus, aus der Sie Ihre Registrierungsreplikationseinstellungen entfernen möchten. 1. Wählen Sie im Navigationsbereich die Option **Private Registrierung**. 1. Wählen Sie auf der Seite **Private Registrierung** die Option **Einstellungen** und dann unter **Replikationskonfiguration** die Option **Bearbeiten** aus. 1. Entfernen Sie alle vorhandenen Replikationsregeln, indem Sie für jede Regel die Option Löschen auswählen. 1. Wählen Sie **Speichern**, um die leere Replikationskonfiguration anzuwenden. ## Um die Einstellungen für die Replikation der Registrierung zu entfernen (AWS CLI) 1. Erstellen Sie eine JSON-Datei mit einem leeren Regelarray, um alle Replikationseinstellungen zu entfernen. ``` { "rules": [] } ``` 1. Wenden Sie die leere Replikationskonfiguration auf Ihre Registrierung an. ``` aws ecr put-replication-configuration \ --replication-configuration file://empty-replication-settings.json \ --region us-west-2 ``` 1. Vergewissern Sie sich, dass die Replikationseinstellungen entfernt wurden. ``` aws ecr describe-registry \ --region us-west-2 ``` In der Ausgabe sollte ein leeres Feld `replicationConfiguration` ohne Regeln angezeigt werden. **Wichtig** Durch das Entfernen von Replizierungseinstellungen werden keine zuvor replizierten Repositorys oder Images gelöscht. Sie müssen replizierte Inhalte manuell löschen, wenn sie nicht mehr benötigt werden.