Envoi de demandes aux registres Amazon ECR

Vous pouvez envoyer, extraire, supprimer, afficher et gérer des images OCI, des images Docker et des OCI-compatible artefacts dans les registres privés Amazon ECR à l'aide de points de terminaison ou de IPv4-only points de terminaison à double pile (IPv4 et IPv6). Pour effectuer des demandes à partir de réseaux IPv4, vous pouvez utiliser des points de terminaison à double pile ou IPv4. Pour effectuer des demandes depuis un réseau IPv6, utilisez un point de terminaison à double pile. Pour plus d'informations sur l'envoi de demandes aux registres publics Amazon ECR à l'aide d'IPv4 et de points de terminaison à double pile, voir Envoyer des demandes aux registres publics Amazon ECR. L'accès à Amazon ECR via IPv6 est gratuit. Pour plus d'informations sur la tarification, consultez la rubrique Tarification d'Amazon Elastic Container Registry.

Les points de terminaison Amazon ECR sont désignés par des attributs qui vont au-delà de la prise en charge des IPv4-only terminaux ou des terminaux à double pile. Ces attributs peuvent inclure :

Pour plus d'informations sur les points de terminaison de service pris en charge par IPv4, Dual-Stack, Docker et le client OCI, qui gère les appels d'API Amazon ECR depuis l' AWS interface de ligne de commande et les AWS kits de développement logiciel, voir Points de terminaison de service. https://docs.aws.amazon.com/general/latest/gr/ecr.html#ecr_region

Commencer à faire des requêtes via IPv6

Pour envoyer une demande à un registre Amazon ECR via IPv6, vous devez utiliser un point de terminaison à double pile. Avant d'accéder à un registre Amazon ECR via IPv6, vérifiez les exigences suivantes :

Test de compatibilité d’adresses IP

Si vous utilisez use Linux/Unix ou Mac OS X, vous pouvez vérifier si vous pouvez accéder à un point de terminaison à double pile via IPv6 à l'aide de la curl commande illustrée dans l'exemple suivant :

curl --verbose https://ecr.us-west-2.api.aws

* About to connect() to ecr.us-west-2.api.aws port 443 (#0)
* Trying IPv6 address... connected
* Connected to ecr.us-west-2.api.aws (IPv6 address) port 443 (#0)
> Host: ecr.us-west-2.api.aws
* Request completely sent off

Si vous utilisez Microsoft Windows 7 ou Windows 10, vous pouvez tester si vous pouvez accéder à un point de terminaison à double pile via IPv4 ou IPv6 en utilisant la ping commande comme indiqué dans l'exemple suivant.

ping ecr.us-west-2.api.aws

Envoi de demandes via IPv6 à l'aide de points de terminaison Dual-Stack

Vous pouvez passer des appels d'API Amazon ECR via IPv6 à l'aide de points de terminaison à double pile. Les fonctionnalités et les performances des opérations d'API Amazon ECR restent constantes, que vous utilisiez IPv4 ou IPv6.

Lorsque vous utilisez le AWS Command Line Interface (AWS CLI) et les AWS kits SDK, vous pouvez activer IPv6 soit en utilisant un paramètre ou un indicateur pour passer à un point de terminaison à double pile, soit en spécifiant directement le point de terminaison à double pile dans votre fichier de configuration pour remplacer le point de terminaison Amazon ECR par défaut. Vous pouvez également modifier la configuration à l'aide d'une commande, qui prend la valeur use_dualstack_endpoint true dans le profil par défaut. Pour plus d'informations suruse_dualstack_endpoint, reportez-vous à la section Points Dual-stack de terminaison FIPS.

Utilisation des points de terminaison Amazon ECR à partir de l'interface de ligne de commande Docker

Une fois connecté à votre référentiel Amazon ECR et marqué votre image, vous pouvez envoyer et extraire des images OCI et des images Docker vers et depuis les registres Amazon ECR. Les exemples suivants illustrent les commandes docker push et Docker pull avec les deux points de terminaison à double pile.

Utilisation d’adresses IPv6 dans les politiques IAM

Avant d'accéder à un registre via IPv6, assurez-vous que vos politiques d'utilisateur IAM et de registre Amazon ECR qui utilisent le filtrage des adresses IP incluent des plages d'adresses IPv6. Si les politiques de filtrage des adresses IP ne sont pas mises à jour pour gérer les adresses IPv6, les clients risquent de perdre ou d'accéder au registre par erreur lorsqu'ils commencent à utiliser IPv6. Pour de plus amples informations sur la gestion des autorisations d'accès avec IAM, veuillez consulter Gestion des identités et des accès au registre de conteneur Amazon Elastic.

Les stratégies IAM qui permettent de filtrer les adresses IP utilisent des opérateurs de condition d'adresse IP. L'exemple de politique de registre suivant montre comment identifier la 54.240.143.* plage d'adresses IPv4 autorisées à l'aide d'opérateurs de condition d'adresse IP. Toutes les adresses IP situées en dehors de cette plage se voient refuser l'accès au registre (exampleregistry). Étant donné que toutes les adresses IPv6 se situent en dehors de la plage autorisée, cette politique empêche l'accès aux adresses IPv6exampleregistry.

Pour autoriser les plages d'adresses IPv4 (54.240.143.0/24) et IPv6 (2001:DB8:1234:5678::/64), modifiez l'élément Condition de la politique de registre comme indiqué dans l'exemple suivant. Vous pouvez utiliser ce format de Condition bloc pour mettre à jour vos politiques d'utilisateur et de registre IAM.

       "Condition": {
         "IpAddress": {
            "aws:SourceIp": [
              "54.240.143.0/24",
               "2001:DB8:1234:5678::/64"
             ]
          }
        }

Vous pouvez consulter vos politiques utilisateur IAM à l'aide de la console IAM à l'adresse. https://console.aws.amazon.com/iam/ Pour de plus amples informations sur IAM, consultez le Guide de l’utilisateur IAM.