View a markdown version of this page

Erstellen einer Pull-Through-Cache-Regel in Amazon ECR - Amazon ECR
VoraussetzungenVerwenden der AWS-ManagementkonsoleVerwenden der AWS CLINächste Schritte

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.

Erstellen einer Pull-Through-Cache-Regel in Amazon ECR

Für jede Upstream-Registrierung, die Bilder enthält, die Sie in Ihrer privaten Amazon ECR-Registry zwischenspeichern möchten, müssen Sie eine Pull-Through-Cache-Regel erstellen.

Für Upstream-Registrierungen, die eine Authentifizierung mit Geheimnissen erfordern, müssen Sie die Anmeldeinformationen in einem Secrets Manager-Schlüssel speichern. Sie können ein vorhandenes Geheimnis verwenden oder ein neues Geheimnis erstellen. Sie können das Secrets Manager-Geheimnis entweder in der Amazon ECR-Konsole oder der Secrets Manager-Konsole erstellen. Informationen zum Erstellen eines Secrets Manager-Geheimnisses mithilfe der Secrets Manager-Konsole anstelle der Amazon ECR-Konsole finden Sie unter. Speichern Ihrer Upstream-Repository-Anmeldeinformationen in einem AWS Secrets Manager Secret

Voraussetzungen

  • Stellen Sie sicher, dass Sie über die richtigen IAM-Berechtigungen zum Erstellen von Pull-Through-Cache-Regeln verfügen. Weitere Informationen finden Sie unter IAM-Berechtigungen sind erforderlich, um eine Upstream-Registrierung mit einer privaten Amazon ECR-Registrierung zu synchronisieren.

  • Für Upstream-Registrierungen, die eine Authentifizierung mit Geheimnissen erfordern: Wenn Sie ein vorhandenes Geheimnis verwenden möchten, stellen Sie sicher, dass das Secrets Manager-Geheimnis die folgenden Anforderungen erfüllt:

    • Der Name des Geheimnisses beginnt mitecr-pullthroughcache/. Das zeigt AWS-Managementkonsole nur Secrets Manager-Geheimnisse mit dem ecr-pullthroughcache/ Präfix an.

    • Das Konto und die Region, in der sich das Geheimnis befindet, müssen mit dem Konto und der Region übereinstimmen, in denen sich die Pull-Through-Cache-Regel befindet.

Um eine Pull-Through-Cache-Regel zu erstellen (AWS-Managementkonsole)

Die folgenden Schritte zeigen, wie Sie mit der Amazon-ECR-Konsole eine Pull-Through-Cache-Regel und ein Secrets-Manager-Secret erstellen. Informationen zum Erstellen eines Geheimnisses mithilfe der Secrets Manager-Konsole finden Sie unterSpeichern Ihrer Upstream-Repository-Anmeldeinformationen in einem AWS Secrets Manager Secret.

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

  2. Wählen Sie in der Navigationsleiste die Region aus, in der Sie Ihre privaten Registrierungseinstellungen konfigurieren möchten.

  3. Wählen Sie im Navigationsbereich die Option Private Registrierung, Pull-Through-Cache.

  4. Wählen Sie auf der Seite Pull-Through-Cache-Konfiguration die Option Regel hinzufügen aus.

  5. Wählen Sie auf der Seite Schritt 1: Geben Sie eine Quelle für Registry entweder Amazon ECR Public, Kubernetes oder Quay aus der Liste der Upstream-Registrierungen aus und klicken Sie dann auf Weiter.

  6. Geben Sie auf der Seite Schritt 2: Geben Sie ein Ziel an für das Repository-Präfix von Amazon ECR das Präfix für den Repository-Namespace an, das beim Zwischenspeichern von Images verwendet werden soll, und wählen Sie dann Weiter aus. Standardmäßig wird ein Namespace ausgefüllt, aber auch ein benutzerdefinierter Namespace kann angegeben werden.

  7. Überprüfen Sie auf der Seite Schritt 3: Überprüfen und erstellen die Konfiguration der Pull-Through-Cache-Regel und wählen Sie dann Erstellen aus.

  8. Wiederholen Sie den vorangehenden Schritt für jeden Pull-Through-Cache, den Sie erstellen möchten. Die Pull-Through-Cache-Regeln werden für jede Region separat erstellt.

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

  2. Wählen Sie in der Navigationsleiste die Region aus, in der Sie Ihre privaten Registrierungseinstellungen konfigurieren möchten.

  3. Wählen Sie im Navigationsbereich die Option Private Registrierung, Pull-Through-Cache.

  4. Wählen Sie auf der Seite Pull-Through-Cache-Konfiguration die Option Regel hinzufügen aus.

  5. Wählen Sie auf der Seite Schritt 1: Geben Sie eine Quelle an für Registrierung die Option Docker Hub und dann Weiter aus.

  6. Auf der Seite Schritt 2: Authentifizierung konfigurieren müssen Sie für Upstream-Anmeldeinformationen Ihre Authentifizierungsdaten für Docker Hub in einem AWS Secrets Manager -Secret speichern. Sie können ein vorhandenes Secret angeben oder die Amazon-ECR-Konsole verwenden, um ein neues Secret zu erstellen.

    1. Um ein vorhandenes Geheimnis zu verwenden, wählen Sie Use an existing AWS secret. Wählen Sie unter Geheimer Name in der Auswahlliste Ihr vorhandenes Secret aus und wählen Sie dann Weiter aus.

      Anmerkung

      AWS-Managementkonsole Nur Secrets Manager-Geheimnisse werden angezeigt, deren Namen das ecr-pullthroughcache/ Präfix verwenden. Das Secret muss sich außerdem in demselben Konto und derselben Region befinden, in der die Pull-Through-Cache-Regel erstellt wurde.

    2. Um ein neues Secret zu erstellen, wählen Sie Ein AWS -Secret erstellen aus, gehen Sie wie folgt vor und klicken Sie dann auf Weiter.

      1. Geben Sie unter Geheimer Name einen aussagekräftigen Namen für das Secret an. Secret-Namen müssen 1–512 Unicode-Zeichen enthalten.

      2. Geben Sie für Docker Hub-E-Mail Ihre Docker-Hub-E-Mail an.

      3. Geben Sie für das Docker-Hub-Zugriffstoken Ihr Docker-Hub-Zugriffstoken an. Weitere Informationen zum Erstellen eines Docker-Hub-Zugriffstokens finden Sie unter Zugriffstoken erstellen und verwalten in der Docker-Dokumentation.

  7. Geben Sie auf der Seite Schritt 3: Geben Sie ein Ziel an für das Repository-Präfix von Amazon ECR den Repository-Namespace an, der beim Zwischenspeichern von Images verwendet werden soll, und wählen Sie dann Weiter aus.

    Standardmäßig wird ein Namespace ausgefüllt, aber auch ein benutzerdefinierter Namespace kann angegeben werden.

  8. Überprüfen Sie auf der Seite Schritt 4: Überprüfen und erstellen die Konfiguration der Pull-Through-Cache-Regel und wählen Sie dann Erstellen aus.

  9. Wiederholen Sie den vorangehenden Schritt für jeden Pull-Through-Cache, den Sie erstellen möchten. Die Pull-Through-Cache-Regeln werden für jede Region separat erstellt.

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

  2. Wählen Sie in der Navigationsleiste die Region aus, in der Sie Ihre privaten Registrierungseinstellungen konfigurieren möchten.

  3. Wählen Sie im Navigationsbereich die Option Private Registrierung, Pull-Through-Cache.

  4. Wählen Sie auf der Seite Pull-Through-Cache-Konfiguration die Option Regel hinzufügen aus.

  5. Wählen Sie in Schritt 1: Quellseite angeben für Registrierung die Option GitHub Container Registry, Next aus.

  6. Auf der Seite „Schritt 2: Authentifizierung konfigurieren“ müssen Sie für Upstream-Anmeldeinformationen Ihre Anmeldeinformationen für GitHub Container Registry AWS Secrets Manager geheim speichern. Sie können ein vorhandenes Secret angeben oder die Amazon-ECR-Konsole verwenden, um ein neues Secret zu erstellen.

    1. Um ein vorhandenes Geheimnis zu verwenden, wählen Sie Ein vorhandenes AWS Geheimnis verwenden. Wählen Sie unter Geheimer Name in der Auswahlliste Ihr vorhandenes Secret aus und wählen Sie dann Weiter aus.

      Anmerkung

      AWS-Managementkonsole Nur Secrets Manager-Geheimnisse werden angezeigt, deren Namen das ecr-pullthroughcache/ Präfix verwenden. Das Secret muss sich außerdem in demselben Konto und derselben Region befinden, in der die Pull-Through-Cache-Regel erstellt wurde.

    2. Um ein neues Secret zu erstellen, wählen Sie Ein AWS -Secret erstellen aus, gehen Sie wie folgt vor und klicken Sie dann auf Weiter.

      1. Geben Sie unter Geheimer Name einen aussagekräftigen Namen für das Secret an. Secret-Namen müssen 1–512 Unicode-Zeichen enthalten.

      2. Geben Sie als GitHub Container Registry-Benutzernamen Ihren GitHub Container Registry-Benutzernamen an.

      3. Geben Sie als Zugriffstoken für GitHub Container Registry Ihr GitHub Container Registry-Zugriffstoken an. Weitere Informationen zum Erstellen eines GitHub Zugriffstokens finden Sie in der GitHub Dokumentation unter Verwaltung Ihrer persönlichen Zugriffstoken.

  7. Geben Sie auf der Seite Schritt 3: Geben Sie ein Ziel an für das Repository-Präfix von Amazon ECR den Repository-Namespace an, der beim Zwischenspeichern von Images verwendet werden soll, und wählen Sie dann Weiter aus.

    Standardmäßig wird ein Namespace ausgefüllt, aber auch ein benutzerdefinierter Namespace kann angegeben werden.

  8. Überprüfen Sie auf der Seite Schritt 4: Überprüfen und erstellen die Konfiguration der Pull-Through-Cache-Regel und wählen Sie dann Erstellen aus.

  9. Wiederholen Sie den vorangehenden Schritt für jeden Pull-Through-Cache, den Sie erstellen möchten. Die Pull-Through-Cache-Regeln werden für jede Region separat erstellt.

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

  2. Wählen Sie in der Navigationsleiste die Region aus, in der Sie Ihre privaten Registrierungseinstellungen konfigurieren möchten.

  3. Wählen Sie im Navigationsbereich die Option Private Registrierung, Pull-Through-Cache.

  4. Wählen Sie auf der Seite Pull-Through-Cache-Konfiguration die Option Regel hinzufügen aus.

  5. Führen Sie auf der Seite Schritt 1: Geben Sie eine Quelle an die folgenden Schritte aus.

    1. Wählen Sie für Registry Microsoft Azure Container Registry

    2. Geben Sie unter Quellregistrierungs-URL den Namen Ihrer Microsoft Azure Container Registry an und wählen Sie dann Weiter aus.

      Wichtig

      Sie müssen nur das Präfix angeben, da das Suffix .azurecr.io in Ihrem Namen ausgefüllt wird.

  6. Auf der Seite Schritt 2: Authentifizierung konfigurieren müssen Sie für Upstream-Anmeldeinformationen Ihre Authentifizierungsdaten für die Microsoft Azure Container Registry in einem AWS Secrets Manager -Secret speichern. Sie können ein vorhandenes Secret angeben oder die Amazon-ECR-Konsole verwenden, um ein neues Secret zu erstellen.

    1. Um ein vorhandenes Geheimnis zu verwenden, wählen Sie Use an existing AWS secret. Wählen Sie unter Geheimer Name in der Auswahlliste Ihr vorhandenes Secret aus und wählen Sie dann Weiter aus.

      Anmerkung

      AWS-Managementkonsole Nur Secrets Manager-Geheimnisse werden angezeigt, deren Namen das ecr-pullthroughcache/ Präfix verwenden. Das Secret muss sich außerdem in demselben Konto und derselben Region befinden, in der die Pull-Through-Cache-Regel erstellt wurde.

    2. Um ein neues Secret zu erstellen, wählen Sie Ein AWS -Secret erstellen aus, gehen Sie wie folgt vor und klicken Sie dann auf Weiter.

      1. Geben Sie unter Geheimer Name einen aussagekräftigen Namen für das Secret an. Secret-Namen müssen 1–512 Unicode-Zeichen enthalten.

      2. Geben Sie für den Microsoft-Azure-Container-Registry-Benutzernamen Ihren Benutzernamen für die Microsoft Azure Container Registry an.

      3. Geben Sie für den Microsoft-Azure-Container-Registry-Zugriffstoken Ihren Zugriffstoken für die Microsoft Azure Container Registry an. Weitere Informationen zum Erstellen eines Zugriffstokens für die Microsoft Azure Container Registry finden unter Token erstellen – Portal in der Microsoft Azure-Dokumentation.

  7. Geben Sie auf der Seite Schritt 3: Geben Sie ein Ziel an für das Repository-Präfix von Amazon ECR den Repository-Namespace an, der beim Zwischenspeichern von Images verwendet werden soll, und wählen Sie dann Weiter aus.

    Standardmäßig wird ein Namespace ausgefüllt, aber auch ein benutzerdefinierter Namespace kann angegeben werden.

  8. Überprüfen Sie auf der Seite Schritt 4: Überprüfen und erstellen die Konfiguration der Pull-Through-Cache-Regel und wählen Sie dann Erstellen aus.

  9. Wiederholen Sie den vorangehenden Schritt für jeden Pull-Through-Cache, den Sie erstellen möchten. Die Pull-Through-Cache-Regeln werden für jede Region separat erstellt.

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

  2. Wählen Sie in der Navigationsleiste die Region aus, in der Sie Ihre privaten Registrierungseinstellungen konfigurieren möchten.

  3. Wählen Sie im Navigationsbereich die Option Private Registrierung, Pull-Through-Cache.

  4. Wählen Sie auf der Seite Pull-Through-Cache-Konfiguration die Option Regel hinzufügen aus.

  5. Wählen Sie in Schritt 1: Quellseite angeben für Registrierung die Option GitLab Container Registry, Next aus.

  6. Auf der Seite „Schritt 2: Authentifizierung konfigurieren“ müssen Sie für Upstream-Anmeldeinformationen Ihre Anmeldeinformationen für GitLab Container Registry AWS Secrets Manager geheim speichern. Sie können ein vorhandenes Secret angeben oder die Amazon-ECR-Konsole verwenden, um ein neues Secret zu erstellen.

    1. Um ein vorhandenes Geheimnis zu verwenden, wählen Sie Ein vorhandenes AWS Geheimnis verwenden. Wählen Sie unter Geheimer Name in der Auswahlliste Ihr vorhandenes Secret aus und wählen Sie dann Weiter aus. Weitere Informationen zum Erstellen eines Secrets-Manager-Secrets mit der Secrets-Manager-Konsole finden Sie unter Speichern Ihrer Upstream-Repository-Anmeldeinformationen in einem AWS Secrets Manager Secret.

      Anmerkung

      AWS-Managementkonsole Nur Secrets Manager-Geheimnisse werden angezeigt, deren Namen das ecr-pullthroughcache/ Präfix verwenden. Das Secret muss sich außerdem in demselben Konto und derselben Region befinden, in der die Pull-Through-Cache-Regel erstellt wurde.

    2. Um ein neues Secret zu erstellen, wählen Sie Ein AWS -Secret erstellen aus, gehen Sie wie folgt vor und klicken Sie dann auf Weiter.

      1. Geben Sie unter Geheimer Name einen aussagekräftigen Namen für das Secret an. Secret-Namen müssen 1–512 Unicode-Zeichen enthalten.

      2. Geben Sie als GitLab Container Registry-Benutzernamen Ihren GitLab Container Registry-Benutzernamen an.

      3. Geben Sie als Zugriffstoken für GitLab Container Registry Ihr GitLab Container Registry-Zugriffstoken an. Weitere Informationen zum Erstellen eines Zugriffstokens für die GitLab Container Registry finden Sie in der GitLab Dokumentation unter Persönliche Zugriffstoken , Gruppenzugriffstoken oder Projekt-Zugriffstoken.

  7. Geben Sie auf der Seite Schritt 3: Geben Sie ein Ziel an für das Repository-Präfix von Amazon ECR den Repository-Namespace an, der beim Zwischenspeichern von Images verwendet werden soll, und wählen Sie dann Weiter aus.

    Standardmäßig wird ein Namespace ausgefüllt, aber auch ein benutzerdefinierter Namespace kann angegeben werden.

  8. Überprüfen Sie auf der Seite Schritt 4: Überprüfen und erstellen die Konfiguration der Pull-Through-Cache-Regel und wählen Sie dann Erstellen aus.

  9. Wiederholen Sie den vorangehenden Schritt für jeden Pull-Through-Cache, den Sie erstellen möchten. Die Pull-Through-Cache-Regeln werden für jede Region separat erstellt.

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

  2. Wählen Sie in der Navigationsleiste die Region aus, in der Sie Ihre privaten Registrierungseinstellungen konfigurieren möchten.

  3. Wählen Sie im Navigationsbereich die Option Private Registrierung, Pull-Through-Cache.

  4. Wählen Sie auf der Seite Pull-Through-Cache-Konfiguration die Option Regel hinzufügen aus.

  5. Wählen Sie auf der Seite „Schritt 1: Upstream angeben“ für Registrierung die Option Amazon ECR Private und Dieses Konto aus. Wählen Sie für Region die Region für die Upstream-Amazon-ECR-Registrierung aus und klicken Sie dann auf Weiter.

  6. Wählen Sie auf der Seite Schritt 2: Namespaces angeben für Cache-Namespace aus, ob Pull-Through-Cache-Repositorys mit einem bestimmten Präfix oder ohne Präfix erstellt werden sollen. Wenn Sie Ein bestimmtes Präfix auswählen, müssen Sie einen Präfixnamen angeben, der als Teil des Namespace für das Zwischenspeichern von Bildern aus der Upstream-Registrierung verwendet wird.

  7. Wählen Sie für den Upstream-Namespace aus, ob ein bestimmtes Präfix abgerufen werden soll, das in der Upstream-Registrierung vorhanden ist. Wenn Sie kein Präfix auswählen, können Sie es aus jedem Repository in der Upstream-Registrierung abrufen. Geben Sie das Upstream-Repository-Präfix an, wenn Sie dazu aufgefordert werden, und wählen Sie dann Weiter.

    Anmerkung

    Weitere Informationen zum Anpassen von Cache- und Upstream-Namespaces finden Sie unter. Passen Sie die Repository-Präfixe für ECR an, damit ECR den Cache durchläuft

  8. Überprüfen Sie auf der Seite Schritt 3: Überprüfen und erstellen die Konfiguration der Pull-Through-Cache-Regel und wählen Sie dann Erstellen aus.

  9. Wiederholen Sie diese Schritte für jeden Pull-Through-Cache, den Sie erstellen möchten. Die Pull-Through-Cache-Regeln werden für jede Region separat erstellt.

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

  2. Wählen Sie in der Navigationsleiste die Region aus, in der Sie Ihre privaten Registrierungseinstellungen konfigurieren möchten.

  3. Wählen Sie im Navigationsbereich die Option Private Registrierung, Pull-Through-Cache.

  4. Wählen Sie auf der Seite Pull-Through-Cache-Konfiguration die Option Regel hinzufügen aus.

  5. Wählen Sie auf der Seite „Schritt 1: Upstream angeben“ für Registrierung die Optionen Amazon ECR Private und Cross Account aus. Wählen Sie für Region die Region für die Upstream-Amazon-ECR-Registrierung aus. Geben Sie für Konto die AWS Konto-ID für die Upstream-Amazon-ECR-Registrierung an, und wählen Sie dann Weiter aus.

  6. Wählen Sie auf der Seite Schritt 2: Berechtigungen angeben für die IAM-Rolle eine Rolle aus, die für den kontoübergreifenden Pull-Through-Cache-Zugriff verwendet werden soll, und klicken Sie dann auf Erstellen.

    Anmerkung

    Stellen Sie sicher, dass Sie die IAM-Rolle auswählen, die die in erstellten Berechtigungen verwendet. IAM-Richtlinien, die für den kontoübergreifenden Pull Through-Cache von ECR zu ECR erforderlich sind

  7. Wählen Sie auf der Seite Schritt 3: Namespaces angeben für Cache-Namespace aus, ob Pull-Through-Cache-Repositorys mit einem bestimmten Präfix oder ohne Präfix erstellt werden sollen. Wenn Sie Ein bestimmtes Präfix auswählen, müssen Sie einen Präfixnamen angeben, der als Teil des Namespace für das Zwischenspeichern von Bildern aus der Upstream-Registrierung verwendet wird.

  8. Wählen Sie für den Upstream-Namespace aus, ob ein bestimmtes Präfix abgerufen werden soll, das in der Upstream-Registrierung vorhanden ist. Wenn Sie kein Präfix auswählen, können Sie es aus jedem Repository in der Upstream-Registrierung abrufen. Geben Sie das Upstream-Repository-Präfix an, wenn Sie dazu aufgefordert werden, und wählen Sie dann Weiter.

    Anmerkung

    Weitere Informationen zum Anpassen von Cache- und Upstream-Namespaces finden Sie unter. Passen Sie die Repository-Präfixe für ECR an, damit ECR den Cache durchläuft

  9. Überprüfen Sie auf der Seite Schritt 4: Überprüfen und erstellen die Konfiguration der Pull-Through-Cache-Regel und wählen Sie dann Erstellen aus.

  10. Wiederholen Sie diese Schritte für jeden Pull-Through-Cache, den Sie erstellen möchten. Die Pull-Through-Cache-Regeln werden für jede Region separat erstellt.

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

  2. Wählen Sie in der Navigationsleiste die Region aus, in der Sie Ihre privaten Registrierungseinstellungen konfigurieren möchten.

  3. Wählen Sie im Navigationsbereich die Option Private Registrierung, Pull-Through-Cache.

  4. Wählen Sie auf der Seite Pull-Through-Cache-Konfiguration die Option Regel hinzufügen aus.

  5. Wählen Sie im Schritt 1: Quellseite angeben für Registrierung die Option Chainguard Registry, Next.

  6. Auf der Seite Schritt 2: Authentifizierung konfigurieren müssen Sie für Upstream-Anmeldeinformationen Ihre Authentifizierungsdaten für Chainguard Registry geheim speichern. AWS Secrets Manager Sie können ein vorhandenes Secret angeben oder die Amazon-ECR-Konsole verwenden, um ein neues Secret zu erstellen.

    1. Um ein vorhandenes Geheimnis zu verwenden, wählen Sie Ein AWS vorhandenes Geheimnis verwenden. Wählen Sie unter Geheimer Name in der Auswahlliste Ihr vorhandenes Secret aus und wählen Sie dann Weiter aus. Weitere Informationen zum Erstellen eines Secrets-Manager-Secrets mit der Secrets-Manager-Konsole finden Sie unter Speichern Ihrer Upstream-Repository-Anmeldeinformationen in einem AWS Secrets Manager Secret.

      Anmerkung

      AWS-Managementkonsole Nur Secrets Manager-Geheimnisse werden angezeigt, deren Namen das ecr-pullthroughcache/ Präfix verwenden. Das Secret muss sich außerdem in demselben Konto und derselben Region befinden, in der die Pull-Through-Cache-Regel erstellt wurde.

    2. Um ein neues Secret zu erstellen, wählen Sie Ein AWS -Secret erstellen aus, gehen Sie wie folgt vor und klicken Sie dann auf Weiter.

      1. Geben Sie unter Geheimer Name einen aussagekräftigen Namen für das Secret an. Secret-Namen müssen 1–512 Unicode-Zeichen enthalten.

      2. Geben Sie für den Chainguard Registry-Benutzernamen Ihren Chainguard Registry-Benutzernamen an.

      3. Geben Sie für das Chainguard Registry-Pull-Token Ihr Chainguard Registry-Pull-Token an. Weitere Informationen zum Erstellen eines Chainguard-Registry-Pull-Tokens finden Sie in der Chainguard-Dokumentation unter Mit einem Pull-Token authentifizieren.

  7. Geben Sie auf der Seite Schritt 3: Geben Sie eine Zieladresse für das Amazon ECR-Repository-Präfix den Repository-Namespace an, der beim Zwischenspeichern von Bildern aus der Quellregistrierung verwendet werden soll, und wählen Sie dann Weiter.

    Standardmäßig wird ein Namespace ausgefüllt, aber auch ein benutzerdefinierter Namespace kann angegeben werden.

  8. Überprüfen Sie auf der Seite Schritt 4: Überprüfen und erstellen die Konfiguration der Pull-Through-Cache-Regel und wählen Sie dann Erstellen aus.

  9. Wiederholen Sie den vorangehenden Schritt für jeden Pull-Through-Cache, den Sie erstellen möchten. Die Pull-Through-Cache-Regeln werden für jede Region separat erstellt.

Um eine Pull-Through-Cache-Regel zu erstellen (AWS CLI)

Verwenden Sie den AWS CLI Befehl create-pull-through-cache-rule, um eine Pull-Through-Cache-Regel für eine private Amazon ECR-Registry zu erstellen. Für Upstream-Registrierungen, die eine Authentifizierung mit Geheimnissen erfordern, müssen Sie die Anmeldeinformationen in einem Secrets Manager-Schlüssel speichern. Informationen zum Erstellen eines Geheimnisses mithilfe der Secrets Manager-Konsole finden Sie unterSpeichern Ihrer Upstream-Repository-Anmeldeinformationen in einem AWS Secrets Manager Secret.

Die folgenden Beispiele werden für jede unterstützte Upstream-Registrierung bereitgestellt.

Im folgenden Beispiel wird eine Pull-Through-Cache-Regel für die öffentliche Registrierung von Amazon ECR erstellt. Es gibt ein Repository-Präfix von ecr-public, was dazu führt, dass jedes Repository, das mit der Pull-Through-Cache-Regel erstellt wurde, das Benennungsschema von ecr-public/upstream-repository-name hat.

aws ecr create-pull-through-cache-rule \
     --ecr-repository-prefix ecr-public \
     --upstream-registry-url public.ecr.aws \
     --region us-east-2

Im folgenden Beispiel wird eine Pull-Through-Cache-Regel für das öffentliche Kubernetes-Registry erstellt. Es gibt ein Repository-Präfix von kubernetes, was dazu führt, dass jedes Repository, das mit der Pull-Through-Cache-Regel erstellt wurde, das Benennungsschema von kubernetes/upstream-repository-name hat.

aws ecr create-pull-through-cache-rule \
     --ecr-repository-prefix kubernetes \
     --upstream-registry-url registry.k8s.io \
     --region us-east-2

Im folgenden Beispiel wird eine Pull-Through-Cache-Regel für die öffentliche Registrierung von Quay erstellt. Es gibt ein Repository-Präfix von quay, was dazu führt, dass jedes Repository, das mit der Pull-Through-Cache-Regel erstellt wurde, das Benennungsschema von quay/upstream-repository-name hat.

aws ecr create-pull-through-cache-rule \
     --ecr-repository-prefix quay \
     --upstream-registry-url quay.io \
     --region us-east-2

Im folgenden Beispiel wird eine Pull-Through-Cache-Regel für die Docker-Hub-Registrierung von Quay erstellt. Es gibt ein Repository-Präfix von docker-hub, was dazu führt, dass jedes Repository, das mit der Pull-Through-Cache-Regel erstellt wurde, das Benennungsschema von docker-hub/upstream-repository-name hat. Sie müssen den vollständigen Amazon-Ressourcennamen (ARN) des Secrets mit Ihren Anmeldeinformationen für Docker Hub angeben.

aws ecr create-pull-through-cache-rule \
     --ecr-repository-prefix docker-hub \
     --upstream-registry-url registry-1.docker.io \
     --credential-arn arn:aws:secretsmanager:us-east-2:111122223333:secret:ecr-pullthroughcache/example1234 \
     --region us-east-2

Das folgende Beispiel erstellt eine Pull-Through-Cache-Regel für die GitHub Container Registry. Es gibt ein Repository-Präfix von github, was dazu führt, dass jedes Repository, das mit der Pull-Through-Cache-Regel erstellt wurde, das Benennungsschema von github/upstream-repository-name hat. Sie müssen den vollständigen Amazon-Ressourcennamen (ARN) des Secrets angeben, das Ihre GitHub Container Registry-Anmeldeinformationen enthält.

aws ecr create-pull-through-cache-rule \
     --ecr-repository-prefix github \
     --upstream-registry-url ghcr.io \
     --credential-arn arn:aws:secretsmanager:us-east-2:111122223333:secret:ecr-pullthroughcache/example1234 \
     --region us-east-2

Das folgende Beispiel erstellt eine Pull-Through-Cache-Regel für die Microsoft Azure Container Registry. Es gibt ein Repository-Präfix von azure, was dazu führt, dass jedes Repository, das mit der Pull-Through-Cache-Regel erstellt wurde, das Benennungsschema von azure/upstream-repository-name hat. Sie müssen den vollständigen Amazon-Ressourcennamen (ARN) des Secrets mit Ihren Anmeldeinformationen für die Microsoft Azure Container Registry angeben.

aws ecr create-pull-through-cache-rule \
     --ecr-repository-prefix azure \
     --upstream-registry-url myregistry.azurecr.io \
     --credential-arn arn:aws:secretsmanager:us-east-2:111122223333:secret:ecr-pullthroughcache/example1234 \
     --region us-east-2

Das folgende Beispiel erstellt eine Pull-Through-Cache-Regel für die GitLab Container Registry. Es gibt ein Repository-Präfix von gitlab, was dazu führt, dass jedes Repository, das mit der Pull-Through-Cache-Regel erstellt wurde, das Benennungsschema von gitlab/upstream-repository-name hat. Sie müssen den vollständigen Amazon-Ressourcennamen (ARN) des Secrets angeben, das Ihre GitLab Container Registry-Anmeldeinformationen enthält.

aws ecr create-pull-through-cache-rule \
     --ecr-repository-prefix gitlab \
     --upstream-registry-url registry.gitlab.com \
     --credential-arn arn:aws:secretsmanager:us-east-2:111122223333:secret:ecr-pullthroughcache/example1234 \
     --region us-east-2

Das folgende Beispiel erstellt eine Pull-Through-Cache-Regel für die private Amazon ECR-Registrierung für regionsübergreifend innerhalb desselben Kontos. AWS Es gibt ein Repository-Präfix von ecr, was dazu führt, dass jedes Repository, das mit der Pull-Through-Cache-Regel erstellt wurde, das Benennungsschema von ecr/upstream-repository-name hat. 

aws ecr create-pull-through-cache-rule \
     --ecr-repository-prefix ecr \
     --upstream-registry-url aws_account_id.dkr.ecr.region.amazonaws.com \
     --region us-east-2

Das folgende Beispiel erstellt eine Pull-Through-Cache-Regel für das private Amazon ECR-Register für regionsübergreifend innerhalb desselben Kontos. AWS Es gibt ein Repository-Präfix von ecr, was dazu führt, dass jedes Repository, das mit der Pull-Through-Cache-Regel erstellt wurde, das Benennungsschema von ecr/upstream-repository-name hat. Sie müssen den vollständigen Amazon-Ressourcennamen (ARN) der IAM-Rolle mit den in erstellten Berechtigungen angeben. Erstellen einer Pull-Through-Cache-Regel in Amazon ECR

aws ecr create-pull-through-cache-rule \
 --ecr-repository-prefix ecr \
 --upstream-registry-url aws_account_id.dkr.ecr.region.amazonaws.com \
 --custom-role-arn arn:aws:iam::aws_account_id:role/example-role \
 --region us-east-2

Das folgende Beispiel erstellt eine Pull-Through-Cache-Regel für die Chainguard-Registry. Es gibt ein Repository-Präfix von chainguard, was dazu führt, dass jedes Repository, das mit der Pull-Through-Cache-Regel erstellt wurde, das Benennungsschema von chainguard/upstream-repository-name hat. Sie müssen den vollständigen Amazon-Ressourcennamen (ARN) des Secrets angeben, das Ihre Chainguard-Registrierungsdaten enthält.

aws ecr create-pull-through-cache-rule \
     --ecr-repository-prefix chainguard \
     --upstream-registry-url cgr.dev \
     --credential-arn arn:aws:secretsmanager:us-east-2:111122223333:secret:ecr-pullthroughcache/example1234 \
     --region us-east-2

Nächste Schritte

Nachdem Sie Ihre Pull-Through-Cache-Regeln erstellt haben, gehen Sie wie folgt vor: