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

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

集成模型参考

我们预先构建了若干第三方服务集成，有助于将现有的客户工具植入管道发布流程。合作伙伴或第三方服务提供商使用集成模型来实现操作类型以在中使用 CodePipeline。

当您计划或使用中支持的集成模型管理的操作类型时，请使用此参考 CodePipeline。

要将您的第三方操作类型证明为合作伙伴集成 CodePipeline，请参阅 Amazon 合作伙伴网络 (APN)。此信息是对 Amazon CLI 参考的补充。

第三方操作类型如何与集成商配合工作

您可以向客户管道中添加第三方操作类型，以完成基于客户资源的任务。集成商管理任务请求并使用 CodePipeline运行操作。下图显示了为客户创建的要在其管道中使用的第三方操作类型。客户配置操作后，操作将运行并创建任务请求，这些请求将由集成商的操作引擎处理。

图中显示以下步骤：

有关可用于请求、查看和更新操作类型的步骤的信息，请参阅使用操作类型。

概念

本节对第三方操作类型使用以下术语：

支持的集成模型

CodePipeline 有两种集成模型：

为了进行比较，下表描述了这两种模型的特征：

Lambda 集成模型

支持的 Lambda 集成模型包括创建 Lambda 函数和为第三方操作类型定义输出。

更新您的 Lambda 函数以处理来自的输入 CodePipeline

您可以创建新的 Lambda 函数。您可以向 Lambda 函数中添加业务逻辑，只要您的管道上有适用于操作类型的任务，该函数就会运行。例如，鉴于客户和管道的背景，您可能想在服务中为客户开始构建。

使用以下参数更新您的 Lambda 函数以处理来自的输入。 CodePipeline

格式：

数据类型：

例如：

{
    "jobId": "01234567-abcd-abcd-abcd-012345678910",
    "accountId": "012345678910",
    "data": {
        "actionConfiguration": {
            "key1": "value1",
            "key2": "value2"
        },
        "encryptionKey": {
            "id": "123-abc",
            "type": "KMS"
        },
        "inputArtifacts": [
            {
                "name": "input-art-name",
                "location": {
                    "type": "S3",
                    "s3Location": {
                        "bucketName": "inputBucket",
                        "objectKey": "inputKey"
                    }
                }
            }
        ],
        "outputArtifacts": [
            {
                "name": "output-art-name",
                "location": {
                    "type": "S3",
                    "s3Location": {
                        "bucketName": "outputBucket",
                        "objectKey": "outputKey"
                    }
                }
            }
        ],
        "actionExecutionId": "actionExecutionId",
        "actionCredentials": {
            "accessKeyId": "access-id",
            "secretAccessKey": "secret-id",
            "sessionToken": "session-id"
        },
        "continuationToken": "continueId-xxyyzz"
    }
}

将您的 Lambda 函数的结果返回到 CodePipeline

在成功、失败或延续的情况下，集成商的任务工作者资源必须返回有效的负载。

格式：

例如：

{
    "result": "success",
    "failureType": null,
    "continuation": null,
    "status": {
        "externalExecutionId": "my-commit-id-123",
        "summary": "everything is dandy"
    },
    "outputVariables": {
        "FirstOne": "Nice",
        "SecondOne": "Nicest",
        ...
    }        
}

使用延续令牌等待异步流程的结果

continuation 令牌是有效负载的一部分，也是 Lambda 函数的结果。这是一种将工作状态传递给工作状态 CodePipeline 并表明需要继续工作的方式。例如，集成商在其资源上为客户启动构建后，它不会等待构建完成，而是通过返回 as continue 并将版本的唯一 ID 返回 CodePipeline 到 a result s token 来 CodePipeline 表示它没有最终结果。continuation

CodePipeline 队伍在 30 秒后调用积分器，其有效载荷中包含相同的continuation令牌，这样它就可以检查积分器是否完成。如果构建完成，集成商将返回终端成功/失败结果，否则继续。

提供 CodePipeline 在运行时调用集成商 Lambda 函数的权限

您可以向集成商 Lambda 函数添加权限，为服务提供 CodePipeline 使用服务委托人调用 CodePipeline 该函数的权限:。codepipeline.amazonaws.com您可以使用 Amazon CloudFormation 或命令行添加权限。有关示例，请参阅使用操作类型。

任务工作者集成模型

设计完高层工作流程后，您可以创建任务工作者。尽管第三方操作的细节决定了任务工作者需要什么，但大多数第三方操作的任务工作者都包括以下功能：

为作业辅助角色选择和配置权限管理策略

要为你的第三方操作培养工作人员 CodePipeline，你需要一个整合用户和权限管理的策略。

最简单的策略是通过创建带有 Amazon Identity and Access Management (IAM) 实例角色的 Amazon EC2 实例来添加作业人员所需的基础设施，这样您就可以轻松扩展集成所需的资源。您可以使用内置的集成 Amazon 来简化作业人员与之间的互动 CodePipeline。

了解更多有关 Amazon EC2 的信息，并确定其是否为适合您的集成的正确选择。有关信息，请参阅 Amazon EC2 – 虚拟服务器托管。有关设置 Amazon EC2 实例的更多信息，请参阅 Amazon EC2 Linux 实例入门。

另一个需要考虑的策略是使用 IAM 的身份联合验证来集成您的现有身份提供程序系统和资源。如果您已经拥有企业身份提供程序，或已经配置为支持使用网络身份提供程序的用户，则此策略很有用。联合身份允许您授予对 Amazon 资源（包括）的安全访问权限 CodePipeline，而无需创建或管理 IAM 用户。您可以利用针对密码安全性要求和凭证轮换的功能和策略。您可以使用示例应用程序作为自己设计的模板。有关信息，请参阅管理联合身份验证。

要提供访问权限，请为您的用户、组或角色添加权限：

以下是您可能为搭配第三方任务工作者使用而创建的策略示例。此策略仅作为示例，按原样提供。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "codepipeline:PollForThirdPartyJobs",
        "codepipeline:AcknowledgeThirdPartyJob",
        "codepipeline:GetThirdPartyJobDetails",
        "codepipeline:PutThirdPartyJobSuccessResult",
        "codepipeline:PutThirdPartyJobFailureResult"
      ],
      "Resource": [
        "arn:aws:codepipeline:us-east-2::actionType:ThirdParty/Build/Provider/1/"  
      ]              
    }
  ]
}