Remblai de réplication

Vous pouvez répliquer des images préexistantes dans votre registre privé Amazon ECR vers les destinations de réplication que vous avez configurées. Par défaut, la réplication ne s'applique qu'aux images envoyées après l'application de la configuration de réplication. Le remblayage de réplication vous permet de répliquer les images que vous avez envoyées avant de configurer la réplication.

Comment fonctionne le remblayage par réplication

Lorsque vous démarrez un remblai de réplication, vous spécifiez une destination unique composée d'une région et d'un ID de registre. Amazon ECR évalue votre configuration de réplication existante afin de déterminer quelles images de votre registre peuvent être rechargées vers la destination spécifiée. Seules les images qui correspondent à vos règles de configuration de réplication actuelles sont incluses dans le remblai.

Chaque remblai de réplication cible une seule destination. Pour remplir des images vers plusieurs destinations, lancez un remplissage de réplication distinct pour chaque destination. Chacune d'entre elles est identifiée par un replicationBackfillId que vous utilisez pour suivre la progression, afficher les résultats et l'arrêter si nécessaire.

Cycle de vie du remblai de réplication

Un remblai de réplication passe par les états suivants :

• PREPARING: Amazon ECR identifie les images éligibles dans votre registre.

• IN_PROGRESS: Amazon ECR réplique activement les images vers la destination.

• COMPLETE: Toutes les images éligibles ont été répliquées avec succès.

• FAILED: Un remblayage de réplication échoue automatiquement si 50 % ou plus des réplications sous-jacentes échouent. Ce seuil n'est évalué qu'une fois qu'au moins 100 réplications ont été traitées.

• STOPPING: Un arrêt a été demandé et Amazon ECR attend que les réplications en vol soient terminées.

• STOPPED: vous avez arrêté le remblayage de réplication et toutes les réplications en cours sont terminées.

Note

Vous ne pouvez arrêter un remblai de réplication que s'il se trouve dans PREPARING ou IN_PROGRESS statut.

Considérations relatives au remblayage par réplication

Les éléments suivants doivent être pris en compte lors de l'utilisation du remblai de réplication.

• Seules les images correspondant à votre configuration de réplication actuelle pour la destination spécifiée sont incluses dans le remblai. Si vous devez renvoyer des images vers une destination qui ne figure pas dans votre configuration de réplication, vous devez d'abord ajouter cette destination à vos règles de réplication.

• Vous pouvez exécuter jusqu'à 10 remblais de réplication simultanément par registre. Si vous recommencez, Amazon ECR renvoie un LimitExceededException erreur.

• Vous ne pouvez avoir qu'un seul remblai de réplication actif pour une région de destination donnée à la fois. Une deuxième demande pour la même région de destination renvoie un ReplicationBackfillInProgressException erreur.

• Amazon ECR conserve les remblais de réplication dans un état terminal (COMPLETE, FAILED, ou STOPPED) pendant 90 jours après l'achèvement. Pendant ce temps, ils restent visibles dans ListReplicationBackfills réponses.

• L'arrêt d'un remblayage de réplication n'annule pas les images déjà répliquées. Ces images restent dans le registre de destination.

• Le remblai de réplication utilise le même rôle lié à un service qu'Amazon ECR crée lorsque vous configurez la réplication pour votre registre privé pour la première fois.

• Le remplissage de la plupart des registres devrait être terminé en une heure. Cependant, le remplissage complet d'un registre contenant une grande quantité de données peut prendre des heures, voire des jours.

• Le remblayage de réplication ignore les images dont le référentiel source a été supprimé. Ces images apparaissent avec un FAILED statut dans les résultats du remblayage.

• Amazon ECR envoie un EventBridge événement lorsqu'un remblai de réplication atteint le statut de terminal. Pour plus d’informations, consultez Exemples d'événements d'Amazon ECR.

Démarrage d'un remblai de réplication

Pour démarrer un remblai de réplication (Console de gestion AWS)

1. Ouvrez la console Amazon ECR à l'adresse https://console.aws.amazon.com/ecr/repositories.

2. Dans la barre de navigation, choisissez la région du registre source à partir de laquelle vous souhaitez effectuer le remplissage.

3. Dans le panneau de navigation, choisissez Registre de schémas.

4. Sur le Registre privé page, choisissez Réglages puis choisissez Modifier sous Configuration de réplication.

5. Sur le Réplication page, choisissez le Travaux de remblayage onglet.

6. Choisissez Commencer le travail de remblayage.

7. Choisissez jusqu'à 10 destinations vers lesquelles vous souhaitez effectuer le remblayage.

8. Choisissez Commencez les travaux de remblayage.

Pour démarrer un remblai de réplication (AWS CLI)

• Démarrez un remblai de réplication.

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

Surveillance de la progression du remblayage de la réplication et affichage des résultats

Pour suivre la progression du remblayage de réplication et afficher les résultats du remblayage de réplication (Console de gestion AWS)

1. Ouvrez la console Amazon ECR à l'adresse https://console.aws.amazon.com/ecr/repositories.

2. Dans la barre de navigation, choisissez la région qui contient vos remblais de réplication.

3. Dans le panneau de navigation, choisissez Registre de schémas.

4. Sur le Registre privé page, choisissez Réglages puis choisissez Modifier sous Configuration de réplication.

5. Sur le Réplication page, choisissez le Travaux de remblayage onglet pour suivre la progression et afficher les résultats de vos remblais de réplication.

Pour suivre la progression du remblayage de réplication et afficher les résultats du remblayage de réplication (AWS CLI)

1. Pour suivre la progression ou consulter les résultats d'un remblayage de réplication, exécutez la commande suivante. Pendant que le remblayage de réplication est en cours, la réponse ne contient que les chiffres de progression. Per-image les résultats et la pagination ne sont disponibles qu'une fois l'opération terminée.

   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. Pour afficher les informations récapitulatives de tous les remblais de réplication, exécutez la commande suivante.

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

Arrêt d'un remblai de réplication

Pour arrêter un remblai de réplication (Console de gestion AWS)

1. Ouvrez la console Amazon ECR à l'adresse https://console.aws.amazon.com/ecr/repositories.

2. Dans la barre de navigation, choisissez la région qui contient vos remblais de réplication.

3. Dans le panneau de navigation, choisissez Registre de schémas.

4. Sur le Registre privé page, choisissez Réglages puis choisissez Modifier sous Configuration de réplication.

5. Sur le Réplication page, choisissez le Travaux de remblayage onglet.

6. Choisissez le remblai de réplication que vous souhaitez arrêter.

7. Choisissez Arrêter le travail de remblayage.

Pour arrêter un remblai de réplication (AWS CLI)

• Pour arrêter un remblayage de réplication, exécutez la commande suivante.

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