Amazon ECR 源操作参考
在新映像推送到 Amazon ECR 存储库时触发管道。此操作提供了一个映像定义文件,该文件引用推送到 Amazon ECR 的映像的 URI。此源操作通常与其他源操作(例如 CodeCommit)结合使用,以允许使用所有其他源构件的源位置。有关更多信息,请参阅 教程:创建包含 Amazon ECR 源和 ECS 至 CodeDeploy 部署的管道。
当您使用控制台创建或编辑管道时,CodePipeline 会创建一个 EventBridge 规则,用于在存储库中发生更改时启动您的管道。
注意
对于 Amazon ECR、Amazon S3 或 CodeCommit 源,您还可以使用输入转换条目创建源覆盖,以便在管道事件中使用 EventBridge 中的 revisionValue,其中 revisionValue 源于您的对象密钥、提交或映像 ID 的源事件变量。有关更多信息,请参阅Amazon ECR 源操作和 EventBridge 资源、连接到启用事件源的 Amazon S3 源操作或CodeCommit 源操作和 EventBridge下的流程中包含的输入转换条目的可选步骤。
您必须事先创建 Amazon ECR 存储库并推送映像,然后才能通过 Amazon ECR 操作连接管道。
操作类型
-
类别:
Source -
拥有者:
AWS -
提供方:
ECR -
版本:
1
配置参数
- RepositoryName
-
必需:是
向其中推送映像的 Amazon ECR 存储库的名称。
- ImageTag
-
必需:否
为映像使用的标签。
注意
如果未指定
ImageTag的值,则该值默认为latest。
输入构件
-
构件数:
0 -
描述:输入构件不适用于此操作类型。
输出构件
-
构件数:
1 -
描述:此操作生成包含
imageDetail.json文件的构件,该文件包含触发管道执行的映像的 URI。有关imageDetail.json文件的信息,请参阅适用于 Amazon ECS 蓝绿部署的 imageDetail.json 文件。
输出变量
配置后,此操作会生成变量,该变量可由管道中下游操作的操作配置引用。此操作生成的变量可视为输出变量,即使操作没有命名空间也是如此。您可以使用命名空间配置操作,以使这些变量可用于下游操作的配置。
有关更多信息,请参阅 变量参考。
- RegistryId
-
与包含存储库的注册表关联的 Amazon 账户 ID。
- RepositoryName
-
向其中推送映像的 Amazon ECR 存储库的名称。
- ImageTag
-
为映像使用的标签。
注意
当源修订被覆盖时,
ImageTag输出变量不会输出 - ImageDigest
-
映像清单的
sha256摘要。 - ImageURI
-
映像的 URI。
服务角色权限:Amazon ECR 操作
对于 Amazon ECR 支持,请将以下内容添加到策略语句中:
{ "Effect": "Allow", "Action": [ "ecr:DescribeImages" ], "Resource": "resource_ARN" },
有关此操作的更多信息,请参阅Amazon ECR 源操作参考。
操作声明(Amazon ECR 示例)
另请参阅
下列相关资源在您使用此操作的过程中会有所帮助。
-
教程:创建包含 Amazon ECR 源和 ECS 至 CodeDeploy 部署的管道:本教程提供了一个示例应用程序规范文件以及示例 CodeDeploy 应用程序和部署组,以创建具有 CodeCommit 和 Amazon ECR 源的管道,用于向 Amazon ECS 实例进行部署。