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.
Synchronisieren Sie eine Upstream-Registrierung mit einer privaten Amazon ECR-Registrierung
Mithilfe von Pull-Through-Cache-Regeln können Sie den Inhalt einer Upstream-Registrierung mit Ihrer privaten Amazon ECR-Registry synchronisieren.
Amazon ECR unterstützt derzeit die Erstellung von Pull-Through-Cache-Regeln für die folgenden Upstream-Registrierungen:
-
Amazon ECR Public, Kubernetes Container Image Registry und Quay (erfordert keine Authentifizierung)
-
Docker Hub, Microsoft Azure Container Registry, Container Registry, GitHub Container Registry und Chainguard Registry (erfordert Authentifizierung mit Secret) GitLab AWS Secrets Manager
-
Amazon ECR (erfordert Authentifizierung mit IAM-Rolle) AWS
Für GitLab Container Registry unterstützt Amazon ECR Pull-Through-Cache nur im Rahmen des SaaS-Angebots (Software GitLab as a Service). Weitere Informationen zur Nutzung GitLab des SaaS-Angebots finden Sie unter GitLab.com
Für Upstream-Registrierungen, die eine Authentifizierung mit Geheimnissen erfordern (wie Docker Hub), müssen Sie Ihre Anmeldeinformationen geheim speichern. AWS Secrets Manager Sie können die Amazon ECR-Konsole verwenden, um Secrets Manager-Geheimnisse für jede authentifizierte Upstream-Registrierung zu erstellen. Weitere Informationen zum Erstellen eines Secrets Manager-Geheimnisses mithilfe der Secrets Manager-Konsole finden Sie unter. Speichern Ihrer Upstream-Repository-Anmeldeinformationen in einem AWS Secrets Manager Secret
Für Amazon ECR müssen Sie eine IAM-Rolle erstellen, wenn die vor- und nachgelagerten Amazon ECR-Registrierungen zu unterschiedlichen Konten gehören. AWS Weitere Informationen zum Erstellen einer IAM-Rolle finden Sie unter IAM-Richtlinien, die für den kontoübergreifenden Pull Through-Cache von ECR zu ECR erforderlich sind.
Nachdem Sie eine Pull-Through-Cache-Regel für die Upstream-Registrierung erstellt haben, rufen Sie mithilfe Ihrer privaten Amazon ECR-Registrierungs-URI ein Image aus dieser Upstream-Registrierung ab. Amazon ECR erstellt dann ein Repository und zwischenspeichert dieses Image in Ihrer privaten Registrierung. Bei nachfolgenden Pull-Requests des zwischengespeicherten Images mit einem bestimmten Tag überprüft Amazon ECR die Upstream-Registry auf eine neue Version des Images mit diesem spezifischen Tag und versucht, das Image in Ihrer privaten Registrierung mindestens einmal alle 24 Stunden zu aktualisieren.
Vorlagen zur Repository-Erstellung
Amazon ECR hat Unterstützung für Vorlagen zur Repository-Erstellung hinzugefügt, sodass Sie mithilfe von Pull-Through-Cache-Regeln die Anfangskonfigurationen für neue Repositorys angeben können, die von Amazon ECR in Ihrem Namen erstellt wurden. Jede Vorlage enthält ein Präfix für den Repository-Namespace, das verwendet wird, um neue Repositorys einer bestimmten Vorlage zuzuordnen. In Vorlagen kann die Konfiguration für alle Repository-Einstellungen festgelegt werden, einschließlich ressourcenbasierter Zugriffsrichtlinien, Unveränderlichkeit von Tags, Verschlüsselung und Lebenszyklusrichtlinien. Die Einstellungen in einer Repository-Erstellungsvorlage werden nur bei der Repository-Erstellung angewendet und haben keine Auswirkung auf bestehende Repositorys oder Repositorys, die mit einer anderen Methode erstellt wurden. Weitere Informationen finden Sie unter Vorlagen zur Steuerung von Repositorys, die während einer Pull-Through-Cache-, Push-Erstellung oder Replikationsaktion erstellt wurden.
Überlegungen zur Verwendung von Pull-Through-Cache-Regeln
Beachten Sie Folgendes, wenn Sie die Pull-Through-Cache-Regeln von Amazon ECR verwenden.
-
AWS Lambda unterstützt nicht das Abrufen von Container-Images aus Amazon ECR mithilfe einer Pull-Through-Cache-Regel.
-
Beim Abrufen von Images mit dem Pull-Through-Cache werden die Amazon-ECR-FIPS-Service-Endpunkte beim ersten Abrufen eines Images nicht unterstützt. Die Verwendung der Amazon-ECR-FIPS-Service-Endpunkte funktioniert jedoch bei nachfolgenden Abrufen.
-
Bei Upstream-Repositorys, die eine Authentifizierung erfordern, werden die Image-Pulls von dem Benutzer initiiert, der den in der Pull-Through-Cache-Regel konfigurierten Anmeldeinformationen zugeordnet ist, wenn ein Image zum ersten Mal über die private Amazon-Registrierungs-URI abgerufen wird oder um den Cache zu aktualisieren. Bei nachfolgenden Abrufen wird das Bild direkt aus dem Cache in der privaten Registrierung des Kunden zurückgegeben.
-
Bei Upstream-Repositorys, für die keine Authentifizierung erforderlich ist, werden die Image-Pulls von IP-Adressen initiiert, wenn ein Image über den privaten Registrierungs-URI von Amazon ECR abgerufen wird. AWS
-
Wenn ein Kunde ein zwischengespeichertes Image über die private Amazon-ECR-Registrierungs-URI abruft, prüft Amazon ECR, ob das Image innerhalb der letzten 24 Stunden anhand der Upstream-Registrierung validiert wurde. Wenn das 24-Stunden-Fenster abgelaufen ist, sendet Amazon ECR eine Anfrage an den Upstream, um nach einer neueren Version zu suchen, und aktualisiert den Cache, falls eine vorhanden ist. Wenn das Zeitfenster nicht abgelaufen ist, stellt Amazon ECR das zwischengespeicherte Image bereit, ohne den Upstream zu kontaktieren.
-
Wenn Sie die
ListImageReferrersAPI für ein durch einen Pull-Through-Cache erstelltes Repository aufrufen, werden die OCI-compliant Referrer-Artefakte an den privaten Cache zurückgegeben. -
Amazon ECR überprüft, ob die Referrer-Artefakte innerhalb der letzten 6 Stunden aktualisiert wurden. Wenn das 6-Stunden-Fenster abgelaufen ist, sendet Amazon ECR eine Upstream-Anfrage, um nach neueren Versionen zu suchen, und aktualisiert den Cache, falls diese vorhanden sind.
-
Wenn Amazon ECR das Image aus der Upstream-Registrierung aus irgendeinem Grund nicht aktualisieren kann und das Image abgerufen wird, wird trotzdem das letzte zwischengespeicherte Image abgerufen.
-
Bei der Erstellung des Secrets-Manager-Secrets, das die Anmeldeinformationen für die Upstream-Registrierung enthält, muss der geheime Name das Präfix
ecr-pullthroughcache/verwenden. Das Secret muss sich außerdem in demselben Konto und derselben Region befinden, in der die Pull-Through-Cache-Regel erstellt wurde. -
Wenn ein Image mit mehreren Architekturen mithilfe einer Pull-Through-Cache-Regel abgerufen wird, werden die Manifestliste und jedes in der Manifestliste referenzierte Image in das Amazon-ECR-Repository abgerufen. Wenn Sie nur eine bestimmte Architektur abrufen möchten, können Sie das Image mithilfe des mit der Architektur verknüpften Image-Digests oder -Tags anstelle des mit der Manifestliste verknüpften Tags abrufen.
-
Amazon ECR verwendet eine serviceverknüpfte IAM-Rolle, die die Berechtigungen bereitstellt, die Amazon ECR benötigt, um das Repository für Sie zu erstellen, den Wert des Secrets-Manager-Secrets für die Authentifizierung abzurufen und das zwischengespeicherte Image in Ihrem Namen zu übertragen. Die serviceverknüpfte IAM-Rolle wird beim Erstellen einer Pull-Through-Cache-Regel erstellt. Weitere Informationen finden Sie unter Serviceverknüpfte Amazon-ECR-Rolle für Pull-Through-Cache.
-
Standardmäßig verfügen der IAM-Prinzipal, der das zwischengespeicherte Image abruft, über die Berechtigungen, die ihnen durch ihre IAM-Richtlinie erteilt wurde. Sie können die Berechtigungsrichtlinie für die private Registrierung von Amazon ECR verwenden, um die Berechtigungen einer IAM-Entität weiter einzugrenzen. Weitere Informationen finden Sie unter Verwenden von Registrierungsberechtigungen.
-
Amazon-ECR-Repositorys, die mit dem Pull-Through-Cache-Workflow erstellt wurden, werden wie jedes andere Amazon-ECR-Repository behandelt. Alle Repository-Features wie Replikation und Image-Scan werden unterstützt.
-
Wenn Amazon ECR in Ihrem Namen mithilfe einer Pull-Through-Cache-Aktion ein neues Repository erstellt, werden die folgenden Standardeinstellungen auf das Repository angewendet, sofern es keine passende Repository-Erstellungsvorlage gibt. Sie können eine Repository-Erstellungsvorlage verwenden, um die Einstellungen zu definieren, die auf Repositorys angewendet werden, die von Amazon ECR in Ihrem Namen erstellt wurden. Weitere Informationen finden Sie unter Vorlagen zur Steuerung von Repositorys, die während einer Pull-Through-Cache-, Push-Erstellung oder Replikationsaktion erstellt wurden.
-
Tag-Unveränderlichkeit — Die Tag-Unveränderlichkeit gibt an, ob Bild-Tags überschrieben werden können. Standardmäßig sind Bild-Tags veränderbar (können überschrieben werden). Sie können das Tag-Verhalten ändern, indem Sie Tag-Ausschlussfilter entweder im Textfeld für den Ausschluss veränderbarer Tags konfigurieren, wenn Veränderbar ausgewählt ist, oder im Textfeld für den Ausschluss unveränderlicher Tags, wenn Unveränderlich ausgewählt ist.
-
Verschlüsselung — Die
AES256Standardverschlüsselung wird verwendet. -
Repository-Berechtigungen — Ausgelassen, es wird keine Repository-Berechtigungsrichtlinie angewendet.
-
Lebenszyklusrichtlinie — Ausgelassen, es wird keine Lebenszyklusrichtlinie angewendet.
-
Ressourcen-Tags — Ausgelassen, es werden keine Ressourcen-Tags angewendet.
-
-
Wenn Sie die Unveränderlichkeit von Image-Tags für Repositorys aktivieren, die eine Pull-Through-Cache-Regel verwenden, wird Amazon ECR daran gehindert, Images zu aktualisieren, die dasselbe Tag verwenden.
-
Wenn ein Bild zum ersten Mal mithilfe der Pull-Through-Cache-Regel abgerufen wird, ist möglicherweise eine Route zum Internet erforderlich. Unter bestimmten Umständen ist eine Route zum Internet erforderlich. Daher empfiehlt es sich, eine Route einzurichten, um Ausfälle zu vermeiden. Wenn Sie Amazon ECR für die Verwendung eines VPC-Schnittstellen-Endpunkts konfiguriert haben, müssen Sie AWS PrivateLink also sicherstellen, dass der erste Pull eine Route zum Internet hat. Eine Möglichkeit, dies zu tun, besteht darin, in derselben VPC ein öffentliches Subnetz mit einem Internet-Gateway zu erstellen und dann den gesamten ausgehenden Verkehr von ihrem privaten Subnetz zum öffentlichen Subnetz ins Internet weiterzuleiten. Bei nachfolgenden Image-Pulls mithilfe der Pull-Through-Cache-Regel ist dies nicht erforderlich. Weitere Informationen finden Sie unter Beispiel für Routing-Optionen im Benutzerhandbuch von Amazon Virtual Private Cloud.
-
Das direkte Verschieben von Bildern in ein Pull-Through-Cache-Repository ist kein unterstütztes Muster. Diese Vorgehensweise kann zu einer vorübergehenden Inkonsistenz führen, bei der bei nachfolgenden Abrufen von Bildern weiterhin die zuvor zwischengespeicherte Version und nicht das neu übertragene Bild zurückgegeben wird. Um diese Inkonsistenz zu beheben, löschen Sie das Image und ziehen Sie es erneut ab, um die zwischengespeicherte Kopie zu aktualisieren. Warten Sie alternativ bis zu 24 Stunden, bis der Cache aktualisiert ist, und rufen Sie das Image dann erneut ab.