在中创建和添加自定义操作 CodePipeline

要使用创建自定义操作 Amazon 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。只要配置属性既是必需的，又不是秘密的{Config:name}，你就可以在URL模板中的自定义操作的配置属性中按照的格式来引用名称。例如，在上面的示例中，该entityUrlTemplate值指的是配置属性 ProjectName.

   • entityUrlTemplate：用于提供操作服务提供方相关信息的静态链接。在示例中，构建系统包含一个指向每个构建项目的静态链接。链接格式可能不同，具体取决于您的构建提供程序（或者如果您创建的是其他操作类型，比如测试，则取决于其他服务提供方）。您必须提供此链接格式，以便在添加自定义操作时，用户可以选择此链接来打开浏览器，从而打开您的网站上提供生成项目 (或测试环境) 具体细节的页面。

   • executionUrlTemplate：将会使用有关当前或最新运行的操作进行更新的动态链接。当您的自定义作业辅助角色更新作业的状态（例如成功、失败或正在进行）时，它还将提供一个 externalExecutionId 用于完成此链接。此链接可用于提供有关操作运行的详细信息。

   例如，当您查看管道中的操作时，您将看到以下两个链接：

   

   此静态链接在您添加自定义操作时显示，指向 entityUrlTemplate 中您在创建自定义操作时指定的地址。

   此动态链接在每次操作运行后更新，指向 executionUrlTemplate 中您在创建自定义操作时指定的地址。

   有关这些链接类型以及RevisionURLTemplate和的更多信息ThirdPartyURL，请参阅 “CodePipeline API参考” CreateCustomActionType中的 “ActionTypeSettings和”。有关操作结构要求以及如何创建操作的更多信息，请参阅 CodePipeline 管道结构参考。

2. 保存JSON文件并为其指定一个易于记住的名称（例如，MyCustomAction.json）。

3. 在您安装了 Amazon CLI的计算机上打开终端会话 (Linux、OS X、Unix) 或命令提示符 (Windows)。

4. Amazon 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 自动分配Custom为自定义操作类型的所有者。使用 create-custom-action-type 命令或 update-pipeline 命令时，无法分配或更改此值。

设置 Amazon EC2 实例

1. 了解有关Amazon的更多信息，EC2并确定它是否是您集成的正确选择。有关信息，请参阅 Amazon EC2-虚拟服务器托管。

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 控制台，然后选择刚才编辑的管道的名称。

   管道将显示您的更改。当您下一次更改源位置时，管道会通过管道修订后的结构运行该修订。