本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

整合模型參考

第三方服務有數個預先建置的整合，可協助在管道發行程序中建置現有的客戶工具。合作夥伴或第三方服務供應商會使用整合模型實作 中使用的動作類型 CodePipeline。

當您規劃或使用 中支援整合模型管理的動作類型時，請使用此參考 CodePipeline。

若要將第三方動作類型認證為與 的合作夥伴整合 CodePipeline，請參閱 AWS Partner Network （APN）。此資訊是AWS 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 並指出任務需要繼續的一種方式。例如，在整合商在其資源上為客戶啟動建置之後，它不會等待建置完成，而是透過將建置的唯一 ID 作為 傳回 resultcontinue，並將建置的唯一 ID 傳回給 CodePipeline 作為continuation權杖 CodePipeline ，以表示它沒有終端結果。

CodePipeline 團隊會在 30 秒後在其承載中使用相同的continuation權杖叫用整合器，以便檢查整合器是否完成。如果建置完成，整合器會傳回終端機成功/失敗結果，否則會繼續。

提供在執行階段叫用整合器 Lambda 函數的 CodePipeline 許可

您可以將許可新增至您的整合器 Lambda 函數，以便 CodePipeline 為服務提供使用 CodePipeline 服務主體調用服務的許可：codepipeline.amazonaws.com。您可以使用 AWS CloudFormation 或 命令列新增許可。如需範例，請參閱使用動作類型。

工作工作者整合模型

設計好高階工作流程之後，您就可以建立工作工作者。雖然第三方動作的詳細資訊會決定作業工作者所需的項目，但大多數作業工作者的第三方動作都包含下列功能：

選擇和設定任務工作者的許可管理策略

若要在 中為第三方動作開發作業工作者 CodePipeline，您需要整合使用者和許可管理的策略。

最簡單的策略是透過使用 AWS Identity and Access Management （IAM） EC2執行個體角色建立 Amazon 執行個體來新增作業工作者所需的基礎設施，這可讓您輕鬆擴展整合所需的資源。您可以使用 與 的內建整合 AWS 來簡化作業工作者與 之間的互動 CodePipeline。

進一步了解 Amazon，EC2並判斷其是否適合您的整合。如需詳細資訊，請參閱 Amazon EC2 - Virtual Server Hosting。如需設定 Amazon EC2執行個體的相關資訊，請參閱開始使用 Amazon EC2 Linux 執行個體 。

另一個要考慮的策略是使用身分聯合與 IAM來整合現有的身分提供者系統和資源。如果您已經擁有企業身分提供者，或已設定為支援使用 Web 身分提供者的使用者，則此策略非常有用。身分聯合可讓您授予 AWS 資源的安全存取權，包括 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/"  
      ]              
    }
  ]
}