View a markdown version of this page

使用源修订覆盖启动管道 - Amazon CodePipeline
使用源修订覆盖启动管道（控制台）使用源修订覆盖启动管道（CLI）
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

使用源修订覆盖启动管道

您可以使用覆盖来启动一个管道，该管道具有您为管道执行提供的特定源修订 ID。例如，如果您想启动一个管道来处理来自您的 CodeCommit 源的特定提交 ID，则可以在启动管道时将提交 ID 添加为替代。

注意

您还可以使用输入转换条目创建源代码覆盖，将输入 EventBridge 用于管道事件，其中源事件源自对象密钥、提交或图像 ID 的源事件变量。revisionValue revisionValue有关更多信息，请参阅亚马逊 ECR 源操作和 EventBridge 资源、连接到启用事件源的 Amazon S3 源操作或CodeCommit 源操作和 EventBridge下的流程中包含的输入转换条目的可选步骤。

revisionType 有四种类型的源修订：

  • COMMIT_ID

  • IMAGE_DIGEST

  • S3_OBJECT_VERSION_ID

  • S3_OBJECT_KEY

注意

对于 COMMIT_ID 和 IMAGE_DIGEST 类型的源修订，源修订 ID 适用于存储库中所有分支的所有内容。

注意

对于源版本的S3_OBJECT_VERSION_ID和S3_OBJECT_KEY类型，这两种类型都可以单独使用，也可以一起使用以使用特定 ObjectKey 和 versionID 覆盖源代码。对于 S3_OBJECT_KEY，配置参数 AllowOverrideForS3ObjectKey 需要设置为 true。有关 S3 源配置参数的更多信息，请参阅 配置参数。

使用源修订覆盖启动管道（控制台）

手动启动管道并通过管道运行最新的修订

  1. 登录 Amazon Web Services 管理控制台 并打开 CodePipeline 控制台，地址为http://console.aws.amazon.com/codesuite/codepipeline/home。

  2. 在名称中，选择要启动的管道的名称。

  3. 在管道详细信息页中，选择发布更改。选择发布更改将打开发布更改窗口。对于源修订覆盖，请选择箭头以展开字段。在源中，输入源修订 ID。例如，如果您的管道有 CodeCommit 来源，请从要使用的字段中选择提交 ID。

    中的覆盖屏幕示例。 CodePipeline

使用源修订覆盖启动管道（CLI）

手动启动管道并通过管道运行构件的指定源修订 ID

  1. 打开终端（Linux、macOS 或 Unix）或命令提示符 (Windows)，并使用 Amazon CLI 运行 start-pipeline-execution 命令，指定您要启动的管道的名称。还可以使用 --source-revisions 参数来提供源修订 ID。源修订由 actionName、revisionType 和 revisionValue 组成。有效的 revisionType 值为 COMMIT_ID | IMAGE_DIGEST | S3_OBJECT_VERSION_ID | S3_OBJECT_KEY。

    在以下示例中，要通过名为的管道开始运行指定的更改codecommit-pipeline，以下命令将源操作名称指定为 Source，修订版本类型为COMMIT_ID，提交 ID 为78a25c18755ccac3f2a9eec099dEXAMPLE。

    aws codepipeline start-pipeline-execution --name codecommit-pipeline --source-revisions actionName=Source,revisionType=COMMIT_ID,revisionValue=78a25c18755ccac3f2a9eec099dEXAMPLE --region us-west-1

  2. 要验证是否成功，请查看返回的对象。该命令将返回执行 ID，如下所示：

    {
    "pipelineExecutionId": "c53dbd42-This-Is-An-Example"
}
    注意

    启动管道后，可以在 CodePipeline 控制台中或通过运行get-pipeline-state命令来监控其进度。有关更多信息，请参阅查看管道（控制台）和查看管道详细信息和历史记录（CLI）。