如何允许二级账户在我的 Amazon ECR 映像存储库中推送或拉取映像?

上次更新日期:2022 年 4 月 12 日

我想允许一个二级账户推送或拉取我的 Amazon Elastic Container Registry (Amazon ECR) 映像存储库中的映像。

解决方法

您可以通过另一个账户在 Amazon ECR 存储库中推送或拉取映像。首先,您必须创建一个策略,以允许二级账户对存储库执行 API 调用。然后,使用从二级账户生成的 Docker 身份验证令牌对一级账户的存储库执行推送和拉取命令。

创建一个策略,以允许二级账户对映像存储库执行 API 调用

1.    为您的一级账户打开 Amazon ECR 控制台

2.    选择要修改的存储库的超链接存储库名称

3.    从左侧导航窗格中的“Amazon ECR - Repositories”(Amazon ECR – 存储库) 下,选择 Permissions (权限)

4.    要从您的一级账户为您的二级账户添加存储库策略,请选择 Edit policy JSON (编辑策略 JSON)。在代码编辑器中输入您的策略,然后选择 Save (保存)

重要提示:在您的策略中,包含二级账户的账号和该账户可对存储库执行的操作。要允许访问特定角色,请以主体形式提供角色 arn。例如,AWS: arn:aws:iam::account-id:role/ecsInstanceRole。在保存存储库策略之前,该角色必须存在于二级账户中。如果此角色不存在,您将收到与以下类似的错误:提供的存储库策略无效

以下示例存储库策略允许特定账户推送和拉取映像:

{
    "Version": "2008-10-17",
    "Statement": [
        {
            "Sid": "AllowPushPull",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::account-id:root"
            },
            "Action": [
                "ecr:GetDownloadUrlForLayer",
                "ecr:BatchGetImage",
                "ecr:BatchCheckLayerAvailability",
                "ecr:PutImage",
                "ecr:InitiateLayerUpload",
                "ecr:UploadLayerPart",
                "ecr:CompleteLayerUpload"
            ]
        }
    ]
}

5.    在任务定义中,设置您想用于 Amazon ECS 的映像。您的映像托管在一级账户的 Amazon ECR 存储库中。
注意:确保您的二级账户拥有 AmazonEC2ContainerServiceforEC2Role 托管策略中列出的 ECR 权限。从您的主账户拉取或推送数据必须具备这些权限。

从二级账户中生成临时的 Docker 身份验证令牌并执行推送或拉取测试

注意:如果您在运行 AWS Command Line Interface (AWS CLI) 命令时遇到错误,请确保您使用的是最新版本的 AWS CLI

二级账户在收到有效期为 12 小时的临时身份验证令牌之前,无法对存储库执行策略操作。该令牌允许二级账户对一级账户的存储库使用 Docker 推送和拉取命令。get-login-password 命令可检索并解码授权令牌,然后您可以将授权令牌传送到 docker login 命令以进行身份验证。

注意:获取令牌的账户必须具有相关的 AWS Identify and Access Management (IAM) API 权限才能修改存储库。有关示例,请参阅 Amazon ECR 托管策略。要排查 Docker 的问题,请对您的 Docker 守护程序开启调试模式。使用 AWS CLI 版本 2 的最新版本,或 AWS CLI 版本 1 的 1.17.10 版本或更新版本时,支持此命令。有关更多信息,请参阅 get-login-password

1.    要为在 Amazon ECS 之外推送和拉取映像的账户生成 Docker 身份验证令牌,请运行以下命令。将 aws_account_id 替换为您的一级账户 ID,然后将 regionID 替换为您的区域 ID

使用 AWS CLI:

aws ecr get-login-password --region regionID | docker login --username AWS --password-stdin aws_account_id.dkr.ecr.regionID.amazonaws.com

使用 AWS Tools for Windows PowerShell:

(Get-ECRLoginCommand).Password | docker login --username AWS --password-stdin aws_account_id.dkr.ecr.regionID.amazonaws.com

您将收到以下输出:

aws ecr get-login-password --region ap-south-1 | docker login --username AWS --password-stdin 123456789012.dkr.ecr.ap-south-1.amazonaws.com
WARNING! Your password will be stored unencrypted in /root/.docker/config.json.
Configure a credential helper to remove this warning. See https://docs.docker.com/engine/reference/commandline/login/#credentials-store
    
Login Succeeded

2.    对一级账户执行映像拉取或推送测试。


这篇文章对您有帮助吗?


您是否需要账单或技术支持?