Sélectionner vos préférences de cookies

Nous utilisons des cookies essentiels et des outils similaires qui sont nécessaires au fonctionnement de notre site et à la fourniture de nos services. Nous utilisons des cookies de performance pour collecter des statistiques anonymes afin de comprendre comment les clients utilisent notre site et d’apporter des améliorations. Les cookies essentiels ne peuvent pas être désactivés, mais vous pouvez cliquer sur « Personnaliser » ou « Refuser » pour refuser les cookies de performance.

Si vous êtes d’accord, AWS et les tiers approuvés utiliseront également des cookies pour fournir des fonctionnalités utiles au site, mémoriser vos préférences et afficher du contenu pertinent, y compris des publicités pertinentes. Pour accepter ou refuser tous les cookies non essentiels, cliquez sur « Accepter » ou « Refuser ». Pour effectuer des choix plus détaillés, cliquez sur « Personnaliser ».

Retaguer une image sur Amazon ECR

Mode de mise au point
Retaguer une image sur Amazon ECR - Amazon ECR

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Avec les images Docker Image Manifest V2 Schéma 2, vous pouvez utiliser l'option --image-tag de la commande put-image pour réétiqueter une image existante. Vous pouvez réétiqueter une image sans la transmettre ni l'extraire avec Docker. Pour les images plus grandes, ce processus permet d'économiser une grande quantité de bande passante réseau et de temps nécessaires au réétiquetage d'une image.

Pour réétiqueter une image à l'aide du AWS CLI
  1. Utilisez la commande batch-get-image pour obtenir le manifeste d'image pour l'image à réétiqueter et l'écrire dans un fichier. Dans cet exemple, le manifeste d'une image avec la baliselatest, dans le référentielamazonlinux, est écrit dans une variable d'environnement nomméeMANIFEST.

    MANIFEST=$(aws ecr batch-get-image --repository-name amazonlinux --image-ids imageTag=latest --output text --query 'images[].imageManifest')
  2. Utilisez l'--image-tagoption de la put-image commande pour envoyer le manifeste de l'image à Amazon ECR avec une nouvelle balise. Dans cet exemple, l'image est étiquetée comme2017.03.

    Note

    Si l'--image-tagoption n'est pas disponible dans votre version du AWS CLI, passez à la dernière version. Pour en savoir plus, consultez Installer la AWS Command Line Interface dans le guide de l'utilisateur AWS Command Line Interface .

    aws ecr put-image --repository-name amazonlinux --image-tag 2017.03 --image-manifest "$MANIFEST"
  3. Vérifiez que la nouvelle étiquette de l'image est attachée à l'image. Dans la sortie ci-dessous, l'image porte les étiquettes latest et 2017.03.

    aws ecr describe-images --repository-name amazonlinux

    La sortie est la suivante :

    {
        "imageDetails": [
            {
                "imageSizeInBytes": 98755613,
                "imageDigest": "sha256:8d00af8f076eb15a33019c2a3e7f1f655375681c4e5be157a26EXAMPLE",
                "imageTags": [
                    "latest",
                    "2017.03"
                ],
                "registryId": "aws_account_id",
                "repositoryName": "amazonlinux",
                "imagePushedAt": 1499287667.0
            }
        ]
    }

Réétiqueter une image (AWS CLI)

Pour réétiqueter une image à l'aide du AWS CLI
  1. Utilisez la commande batch-get-image pour obtenir le manifeste d'image pour l'image à réétiqueter et l'écrire dans un fichier. Dans cet exemple, le manifeste d'une image avec la baliselatest, dans le référentielamazonlinux, est écrit dans une variable d'environnement nomméeMANIFEST.

    MANIFEST=$(aws ecr batch-get-image --repository-name amazonlinux --image-ids imageTag=latest --output text --query 'images[].imageManifest')
  2. Utilisez l'--image-tagoption de la put-image commande pour envoyer le manifeste de l'image à Amazon ECR avec une nouvelle balise. Dans cet exemple, l'image est étiquetée comme2017.03.

    Note

    Si l'--image-tagoption n'est pas disponible dans votre version du AWS CLI, passez à la dernière version. Pour en savoir plus, consultez Installer la AWS Command Line Interface dans le guide de l'utilisateur AWS Command Line Interface .

    aws ecr put-image --repository-name amazonlinux --image-tag 2017.03 --image-manifest "$MANIFEST"
  3. Vérifiez que la nouvelle étiquette de l'image est attachée à l'image. Dans la sortie ci-dessous, l'image porte les étiquettes latest et 2017.03.

    aws ecr describe-images --repository-name amazonlinux

    La sortie est la suivante :

    {
        "imageDetails": [
            {
                "imageSizeInBytes": 98755613,
                "imageDigest": "sha256:8d00af8f076eb15a33019c2a3e7f1f655375681c4e5be157a26EXAMPLE",
                "imageTags": [
                    "latest",
                    "2017.03"
                ],
                "registryId": "aws_account_id",
                "repositoryName": "amazonlinux",
                "imagePushedAt": 1499287667.0
            }
        ]
    }
Pour réétiqueter une image à l'aide du AWS Tools for Windows PowerShell
  1. Utilisez l'applet de commande Get-ECRImageBatch afin d'obtenir la description de l'image à réétiqueter et l'écrire dans une variable d'environnement. Dans cet exemple, une image avec la baliselatest, dans le référentielamazonlinux, est écrite dans la variable d'environnement,$Image.

    Note

    Si l'applet de commande Get-ECRImageBatch n'est pas disponible sur votre système, consultez Configuration de AWS Tools for Windows PowerShell dans le guide de l'utilisateur AWS Tools for Windows PowerShell .

    $Image = Get-ECRImageBatch -ImageId @{ imageTag="latest" } -RepositoryName amazonlinux
  2. Écrivez le manifeste de l'image dans la variable d'$Manifestenvironnement.

    $Manifest = $Image.Images[0].ImageManifest
  3. Utilisez l'-ImageTagoption de l'Write-ECRImageapplet de commande pour envoyer le manifeste de l'image à Amazon ECR avec une nouvelle balise. Dans cet exemple, l'image est étiquetée comme2017.09.

    Write-ECRImage -RepositoryName amazonlinux -ImageManifest $Manifest -ImageTag 2017.09
  4. Vérifiez que la nouvelle étiquette de l'image est attachée à l'image. Dans la sortie ci-dessous, l'image porte les étiquettes latest et 2017.09.

    Get-ECRImage -RepositoryName amazonlinux

    La sortie est la suivante :

    ImageDigest                                                             ImageTag
    -----------                                                             --------
    sha256:359b948ea8866817e94765822787cd482279eed0c17bc674a7707f4256d5d497 latest
    sha256:359b948ea8866817e94765822787cd482279eed0c17bc674a7707f4256d5d497 2017.09

Pour réétiqueter une image à l'aide du AWS Tools for Windows PowerShell
  1. Utilisez l'applet de commande Get-ECRImageBatch afin d'obtenir la description de l'image à réétiqueter et l'écrire dans une variable d'environnement. Dans cet exemple, une image avec la baliselatest, dans le référentielamazonlinux, est écrite dans la variable d'environnement,$Image.

    Note

    Si l'applet de commande Get-ECRImageBatch n'est pas disponible sur votre système, consultez Configuration de AWS Tools for Windows PowerShell dans le guide de l'utilisateur AWS Tools for Windows PowerShell .

    $Image = Get-ECRImageBatch -ImageId @{ imageTag="latest" } -RepositoryName amazonlinux
  2. Écrivez le manifeste de l'image dans la variable d'$Manifestenvironnement.

    $Manifest = $Image.Images[0].ImageManifest
  3. Utilisez l'-ImageTagoption de l'Write-ECRImageapplet de commande pour envoyer le manifeste de l'image à Amazon ECR avec une nouvelle balise. Dans cet exemple, l'image est étiquetée comme2017.09.

    Write-ECRImage -RepositoryName amazonlinux -ImageManifest $Manifest -ImageTag 2017.09
  4. Vérifiez que la nouvelle étiquette de l'image est attachée à l'image. Dans la sortie ci-dessous, l'image porte les étiquettes latest et 2017.09.

    Get-ECRImage -RepositoryName amazonlinux

    La sortie est la suivante :

    ImageDigest                                                             ImageTag
    -----------                                                             --------
    sha256:359b948ea8866817e94765822787cd482279eed0c17bc674a7707f4256d5d497 latest
    sha256:359b948ea8866817e94765822787cd482279eed0c17bc674a7707f4256d5d497 2017.09
ConfidentialitéConditions d'utilisation du sitePréférences de cookies
© 2025, Amazon Web Services, Inc. ou ses affiliés. Tous droits réservés.