使用缓存提取规则

1. 打开位于 https://console.aws.amazon.com/ecr/ 的 Amazon ECR 控制台。

2. 从导航栏中，选择您在其中配置私有注册表权限语句的区域。

3. 在导航窗格中，选择 Private registry（私有注册表）、Registry permissions（注册表权限）。

4. 在 Registry permissions（注册表权限）页面上，选择 Generate statement（生成语句）。

5. 对于要创建的每个缓存提取权限策略语句，请执行以下操作。

   1. 对于 Policy type（策略类型），请选择 Pull through cache policy（推送缓存策略）。

   2. 对于 Statement id（语句 ID），为推送缓存语句策略提供名称。

   3. 对于 IAM entities（IAM 实体），指定要包含在策略中的用户、组或角色。

   4. 对于 Repository namespace（存储库命名空间），选择要与策略关联的推送缓存规则。

   5. 对于 Repository names（存储库名称），指定要应用规则的存储库基本名称。例如，如果您想在 Amazon ECR Public 上指定 Amazon Linux 存储库，存储库名称将为 amazonlinux。

1. 创建名为 ptc-registry-policy.json 的本地文件，其中包含注册表策略的内容。以下示例授予创建存储库并从 Amazon ECR Public 中拉取镜像的 ecr-pull-through-cache-user 权限，Amazon ECR Public 是与之前创建的拉取缓存规则相关联的上游源。

   {
     "Sid": "PullThroughCacheFromReadOnlyRole",
     "Effect": "Allow",
     "Principal": {
       "AWS": "arn:aws:iam::111122223333:user/ecr-pull-through-cache-user"
     },
     "Action": [
       "ecr:CreateRepository",
       "ecr:BatchImportUpstreamImage"
     ],
     "Resource": "arn:aws:ecr:us-east-1:111122223333:repository/ecr-public/*"
   }

   重要

   仅当存储缓存镜像的存储库不存在时才需要 ecr-CreateRepository 权限。例如，如果存储库创建操作和镜像拉取操作是由单独的 IAM 主体（例如管理员和开发人员）完成。

2. 使用 put-registry-policy 命令设置注册表策略。

   aws ecr put-registry-policy \
        --policy-text file://ptc-registry.policy.json

要创建缓存提取规则 (Amazon Web Services Management Console)

1. 打开位于 https://console.aws.amazon.com/ecr/ 的 Amazon ECR 控制台。

2. 从导航栏中，选择要配置私有注册表设置的区域。

3. 在导航窗格中，选择 Private registry（私有注册表）、Pull through cache（缓存提取）。

4. 在 Pull through cache configuration（缓存提取配置）页面上，选择 Add rule（添加规则）。

5. 在 Create pull through cache rule（创建缓存提取规则）页面上，执行以下操作。

   1. 对于 Public registry（公有注册表），选择其中一个预配置的公有注册表。

   2. 对于 Amazon ECR repository namespace（Amazon ECR 存储库命名空间），指定缓存从源公有注册表中提取镜像时要使用的存储库命名空间。默认情况下，已填充命名空间，但也可以指定自定义命名空间。

   3. 选择 Save（保存）以将缓存提取规则保存到注册表设置中。

6. 对要创建的每个缓存提取重复上一步骤。单独为每个区域创建了缓存提取规则。

要删除缓存提取规则 (Amazon Web Services Management Console)

1. 打开位于 https://console.aws.amazon.com/ecr/ 的 Amazon ECR 控制台。

2. 从导航栏中，选择要配置私有注册表设置的区域。

3. 在导航窗格中，选择 Private registry（私有注册表）、Pull through cache（缓存提取）。

4. 在 Pull through cache configuration（缓存提取配置）页面上，选择要删除的缓存提取规则，然后选择 Delete rule（删除规则）。

5. 在导航窗格中，选择 Private registry（私有注册表）、Registry permissions（注册表权限）。

6. （可选）在 Registry permissions（注册表权限）页面中，查看现有的注册表权限策略语句。您可以删除任何与已删除的缓存提取规则的存储库命名空间关联的注册表权限策略语句。