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 并指示任务需要延续。例如，集成商在其资源上为客户启动构建后，它不会等待构建完成，而是通过返回 result 为 continue 并将构建的唯一 ID 返回到 CodePipeline 作为 continuation 令牌，向 CodePipeline 表明它没有最终结果。

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 用户。您可以利用针对密码安全性要求和凭证轮换的功能和策略。您可以使用示例应用程序作为自己设计的模板。有关信息，请参阅管理联合身份验证。

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

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

JSON

{
  "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/"  
      ]              
    }
  ]
}