Amazon ECR 源操作参考 - Amazon CodePipeline
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

  • 描述:输入构件不适用于此操作类型。

输出构件

输出变量

配置后,此操作会生成变量,该变量可由管道中下游操作的操作配置引用。此操作生成的变量可视为输出变量,即使操作没有命名空间也是如此。您可以使用命名空间配置操作,以使这些变量可用于下游操作的配置。

有关更多信息,请参阅 变量参考

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 示例)

YAML
Name: Source Actions: - InputArtifacts: [] ActionTypeId: Version: '1' Owner: AWS Category: Source Provider: ECR OutputArtifacts: - Name: SourceArtifact RunOrder: 1 Configuration: ImageTag: latest RepositoryName: my-image-repo Name: ImageSource
JSON
{ "Name": "Source", "Actions": [ { "InputArtifacts": [], "ActionTypeId": { "Version": "1", "Owner": "AWS", "Category": "Source", "Provider": "ECR" }, "OutputArtifacts": [ { "Name": "SourceArtifact" } ], "RunOrder": 1, "Configuration": { "ImageTag": "latest", "RepositoryName": "my-image-repo" }, "Name": "ImageSource" } ] },

下列相关资源在您使用此操作的过程中会有所帮助。