重新为镜像添加标签 - Amazon ECR
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

重新为镜像添加标签

借助 Docker Image Manifest V2 Schema 2 镜像，可以使用 --image-tag 命令的 put-image 选项重新为现有镜像添加标签。无需使用 Docker 提取或推送镜像，即可重新添加标签。对于大型镜像，此过程可大大节省重新为镜像添加标签所需的网络带宽和时间。

要使用重新标记图像 Amazon CLI

  1. 使用 batch-get-image 命令可获取要重新添加标签的镜像的镜像清单并将其写入文件中。在此示例中，标签为 latest，所在存储库为 amazonlinux 的镜像的清单被写入名为 MANIFEST 的环境变量中。

    MANIFEST=$(aws ecr batch-get-image --repository-name amazonlinux --image-ids imageTag=latest --output text --query 'images[].imageManifest')

  2. 使用 put-image 命令的 --image-tag 选项将镜像清单与新标签一起放置到 Amazon ECR 中。在此示例中，镜像的标签为 2017.03。

    注意

    如果该--image-tag选项在您的版本中不可用 Amazon CLI，请升级到最新版本。有关更多信息，请参阅 Amazon Command Line Interface 用户指南 中的安装 Amazon Command Line Interface。

    aws ecr put-image --repository-name amazonlinux --image-tag 2017.03 --image-manifest "$MANIFEST"

  3. 验证您的新镜像标签是否已附加到您的镜像。在以下输出中，镜像具有标签 latest 和 2017.03。

    aws ecr describe-images --repository-name amazonlinux

    您可以在一个 (扩展) 代码行中执行所有这些操作：

    {
    "imageDetails": [
        {
            "imageSizeInBytes": 98755613,
            "imageDigest": "sha256:8d00af8f076eb15a33019c2a3e7f1f655375681c4e5be157a26EXAMPLE",
            "imageTags": [
                "latest",
                "2017.03"
            ],
            "registryId": "aws_account_id",
            "repositoryName": "amazonlinux",
            "imagePushedAt": 1499287667.0
        }
    ]
}
要使用重新标记图像 Amazon Tools for Windows PowerShell

  1. 使用 Get-ECRImageBatch cmdlet 获取要重新添加标签的镜像的描述，并将该镜像写入到环境变量。在此示例中，标签为 latest、所在存储库为 amazonlinux 的镜像被写入环境变量 $Image 中。

    注意

    如果您的系统上没有可用的 Get-ECRImageBatch cmdlet，请参阅 Amazon Tools for Windows PowerShell 用户指南中的设置 Amazon Tools for Windows PowerShell。

    $Image = Get-ECRImageBatch -ImageId @{ imageTag="latest" } -RepositoryName amazonlinux

  2. 将该镜像的清单写入到 $Manifest 环境变量。

    $Manifest = $Image.Images[0].ImageManifest

  3. 使用 Write-ECRImage cmdlet 的 -ImageTag 选项将镜像清单与新标签一起放置到 Amazon ECR 中。在此示例中，镜像的标签为 2017.09。

    Write-ECRImage -RepositoryName amazonlinux -ImageManifest $Manifest -ImageTag 2017.09

  4. 验证您的新镜像标签是否已附加到您的镜像。在以下输出中，镜像具有标签 latest 和 2017.09。

    Get-ECRImage -RepositoryName amazonlinux

    您可以在一个 (扩展) 代码行中执行所有这些操作：

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