在 中建立和新增自訂動作 CodePipeline

若要使用 建立自訂動作 AWS CLI

1. 開啟文字編輯器，並為自訂動作建立JSON檔案，其中包含動作類別、動作提供者，以及自訂動作所需的任何設定。例如，若要建立只需要一個屬性的自訂建置動作，您的JSON檔案可能如下所示：

   {
       "category": "Build",
       "provider": "My-Build-Provider-Name",
       "version": "1",
       "settings": {
           "entityUrlTemplate": "https://my-build-instance/job/{Config:ProjectName}/",
           "executionUrlTemplate": "https://my-build-instance/job/{Config:ProjectName}/lastSuccessfulBuild/{ExternalExecutionId}/"
       },
       "configurationProperties": [{
           "name": "ProjectName",
           "required": true,
           "key": true,
           "secret": false,
           "queryable": false,
           "description": "The name of the build project must be provided when this action is added to the pipeline.",
           "type": "String"
       }],
       "inputArtifactDetails": {
           "maximumCount": integer,
           "minimumCount": integer
       },
       "outputArtifactDetails": {
           "maximumCount": integer,
           "minimumCount": integer
       },
       "tags": [{
         "key": "Project",
         "value": "ProjectA"
       }]
   }

   此範例透過在自訂動作上包含 Project 標籤索引鍵和 ProjectA 值，將標籤新增到自訂動作。如需在 中標記資源的詳細資訊 CodePipeline，請參閱 標記 資源。

   JSON 檔案中包含兩個屬性，entityUrlTemplate以及 executionUrlTemplate。您可以按照 的格式參考URL範本中自訂動作的組態屬性中的名稱{Config:name}，只要組態屬性是必要的，而不是秘密。例如，在上述範例中， entityUrlTemplate值是指組態屬性 ProjectName.

   • entityUrlTemplate：靜態連結，可提供動作服務提供者的相關資訊。在此範例中，建置系統包含每個建置專案的靜態連結。此連結格式會根據建置提供者而不同 (或者，如果您建立不同的動作類型 (例如測試)，則為其他服務提供者)。您必須提供此連結格式，在新增自訂動作時，使用者可以選擇此連結，以將瀏覽器開啟到您網站上提供建置專案 (或測試環境) 特性的頁面。

   • executionUrlTemplate：動態連結，可使用目前或最近執行動作的相關資訊予以更新。當您的自訂任務工作者更新任務狀態 (例如，成功、失敗或進行中) 時，也會提供將用來完成連結的 externalExecutionId。此連結可以用來提供動作執行的詳細資訊。

   例如，當您在管道中檢視動作時，請參閱下列兩個連結：

   

   在您新增自訂動作並指向 entityUrlTemplate 中的地址 (於建立自訂動作時所指定) 之後，會出現此靜態連結。

   在每次執行動作並指向 executionUrlTemplate 中的地址 (於建立自訂動作時所指定) 之後，會更新動態連結。

   如需這些連結類型以及 RevisionURLTemplate和 的詳細資訊ThirdPartyURL，請參閱 參考 CreateCustomActionType中的 ActionTypeSettings和 。 CodePipeline API 如需動作結構需求以及如何建立動作的詳細資訊，請參閱 CodePipeline 管道結構參考。

2. 儲存JSON檔案並為其提供您容易記住的名稱 （例如，MyCustomAction.json）。

3. 在已安裝 AWS CLI的電腦上，開啟終端機工作階段 (Linux、OS X、Unix) 或命令提示字元 (Windows)。

4. 使用 AWS CLI 執行aws codepipeline create-custom-action-type命令，指定您剛建立的JSON檔案名稱。

   例如，若要建立建置自訂動作：

   重要

   請確認在檔案名稱之前包含 file://。這是此命令必要項目。

   aws codepipeline create-custom-action-type --cli-input-json file://MyCustomAction.json

5. 此命令會傳回您所建立自訂動作的整個結構，以及為您新增的 JobList 動作組態屬性。當您將自訂動作新增至管道時，可以使用 JobList 指定提供者中您可以輪詢任務的專案。如果您未設定此項目，則會在自訂任務工作者輪詢任務時傳回所有可用的任務。

   例如，上述命令可能會傳回與下列類似的結構：

   {
       "actionType": {
           "inputArtifactDetails": {               
               "maximumCount": 1,                
               "minimumCount": 1
          },
          "actionConfigurationProperties": [
               {
                   "secret": false,
                   "required": true,
                   "name": "ProjectName",
                   "key": true,
                   "description": "The name of the build project must be provided when this action is added to the pipeline."
               }
           ],
           "outputArtifactDetails": {               
               "maximumCount": 0,                
               "minimumCount": 0
           },
           "id": {
               "category": "Build",
               "owner": "Custom",
               "version": "1",
               "provider": "My-Build-Provider-Name"
           },
           "settings": {
               "entityUrlTemplate": "https://my-build-instance/job/{Config:ProjectName}/",
               "executionUrlTemplate": "https://my-build-instance/job/mybuildjob/lastSuccessfulBuild/{ExternalExecutionId}/"
           }
       }
   }

   注意

   作為create-custom-action-type命令輸出的一部分， id區段包含 "owner": "Custom". CodePipeline automatic 指派Custom為自訂動作類型的擁有者。當您使用 create-custom-action-type 命令或 update-pipeline 命令時，無法指派或變更此值。

設定 Amazon EC2執行個體

1. 進一步了解 Amazon，EC2並判斷其是否適合您的整合。如需詳細資訊，請參閱 Amazon EC2 - Virtual Server Hosting。

2. 開始建立您的 Amazon EC2執行個體。如需詳細資訊，請參閱開始使用 Amazon EC2 Linux 執行個體 。

設定聯合身分

1. 進一步了解 IAM 聯合身分。如需資訊，請參閱管理聯合。

2. 檢閱授予臨時存取藍本中的範例，以識別最符合您自訂動作需求的臨時存取藍本。

3. 檢閱與基礎設施相關的聯合身分程式碼範例，例如：

   • 適用於 Active Directory 使用案例的聯合身分範例應用程式

4. 開始設定聯合身分。如需詳細資訊，請參閱 IAM 使用者指南 中的身分提供者和聯合。

1. 開啟終端機工作階段 （Linux、macOS 或 Unix） 或命令提示字元 （Windows），然後執行 get-pipeline命令，將您要編輯的管道結構複製到 JSON 檔案。例如，針對名為 MyFirstPipeline 的管道，您會輸入下列命令：

   aws codepipeline get-pipeline --name MyFirstPipeline >pipeline.json

   此命令不會傳回任何內容，但您建立的檔案應該會顯示在您執行命令的目錄中。

2. 在任何文字編輯器中開啟 JSON 檔案，並修改檔案的結構，將自訂動作新增至現有階段。

   注意

   如果您想要您的動作與該階段中的另一個動作平行執行，則請確保您將與該動作相同的 runOrder 值指派給它。

   例如，若要修改管道結構以新增名為 Build 的階段，以及將建置自訂動作新增至該階段，您可以修改 JSON 以新增部署階段之前的建置階段，如下所示：

   ,
       {
         "name": "MyBuildStage",
         "actions":  [
                 {
                   "inputArtifacts": [
                   {
                      "name": "MyApp"
                    }
                      ],
                       "name": "MyBuildCustomAction",
                       "actionTypeId": {
                           "category": "Build",
                           "owner": "Custom",
                           "version": "1",
                           "provider": "My-Build-Provider-Name"
                       },
                       "outputArtifacts": [
                           {
                             "name": "MyBuiltApp"
                           }
                       ],
                       "configuration": {
                           "ProjectName": "MyBuildProject"
                       },
                       "runOrder": 1
                   }
               ]
           },      
           {
               "name": "Staging",
               "actions": [
                       {
                           "inputArtifacts": [
                               {
                                   "name": "MyBuiltApp"
                               }
                           ],
                           "name": "Deploy-CodeDeploy-Application",
                           "actionTypeId": {
                               "category": "Deploy",
                               "owner": "AWS",
                               "version": "1",
                               "provider": "CodeDeploy"
                           },
                           "outputArtifacts": [],
                           "configuration": {
                               "ApplicationName": "CodePipelineDemoApplication",
                               "DeploymentGroupName": "CodePipelineDemoFleet"
                           },
                           "runOrder": 1
                       }
                   ]
                }      
       ]
   }

3. 若要套用變更，請執行 update-pipeline命令，指定管道JSON檔案，如下所示：

   重要

   請確認在檔案名稱之前包含 file://。這是此命令必要項目。

   aws codepipeline update-pipeline --cli-input-json file://pipeline.json

   此命令會傳回所編輯管道的整個結構。

4. 開啟 CodePipeline 主控台，然後選擇您剛編輯的管道名稱。

   此管道會顯示您的變更。下次您變更來源位置時，管道會透過修訂過的管道結構來執行該修訂版。