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

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

CodePipeline 管道结构参考

默认情况下，您成功创建的任何管道都 Amazon CodePipeline 具有有效的结构。但是，如果您手动创建或编辑 JSON 文件来创建管道或更新管道 Amazon CLI，则可能会无意中创建了一个无效的结构。以下参考可帮助您更好地了解管道结构的要求以及如何排查问题。请参阅 中的配额 Amazon CodePipeline 中适用于所有管道的约束。

中的有效操作类型和提供者 CodePipeline

管道结构格式用于在管道中构建操作和阶段。操作类型由操作类别和提供方类型组成。

以下是中的有效操作类别 CodePipeline：

每个操作类别都有一组指定的提供方。每个操作提供方（比如 Amazon S3）都有一个提供方名称（比如 S3），您必须在管道结构中操作类别的 Provider 字段中使用该名称。

管道结构中的操作类别部分的 Owner 字段有三个有效值：AWS、ThirdParty 和 Custom。

要查找操作提供方的提供方名称和所有者信息，请参阅操作结构参考或每个操作类型的输入和输出构件数量。

此表按操作类型列出了有效的提供方。

中的 CodePipeline 某些操作类型仅在部分 Amazon 区域可用。某一 Amazon 地区可能有操作类型可用，但该操作类型的 Amazon 提供者不可用。

有关各个操作提供方的更多信息，请参阅与动 CodePipeline 作类型的集成。

以下部分提供了每种操作类型的提供方信息和配置属性的示例。

中的管道和舞台结构要求 CodePipeline

两阶段管道具有以下基本结构：

{
    "roleArn": "An IAM ARN for a service role, such as arn:aws:iam::80398EXAMPLE:role/CodePipeline_Service_Role",
    "stages": [
        {
            "name": "SourceStageName",
            "actions": [
            ... See 中的操作结构要求  CodePipeline ...
            ]
        },
        {
            "name": "NextStageName",
            "actions": [
            ... See 中的操作结构要求  CodePipeline ...
            ]
        }
    ],
    "artifactStore": {
        "type": "S3",
        "location": "The name of the Amazon S3 bucket automatically generated for you the first time you create a pipeline
            using the console, such as codepipeline-us-east-2-1234567890, or any Amazon S3 bucket you provision for this purpose"
    },
    "name": "YourPipelineName",
    "version": 1
}

管道结构具有以下要求：

每次更新管道时，都会自动生成和更新管道的版本号。

中的操作结构要求 CodePipeline

操作具有以下高级结构：

[
                {
                   "inputArtifacts": [
                        An input artifact structure, if supported for the action category
                    ],
                   "name": "ActionName",
                   "region": "Region", 
                   "namespace": "source_namespace", 
                   "actionTypeId": {
                        "category": "An action category",
                        "owner": "AWS",
                        "version": "1"
                        "provider": "A provider type for the action category",
                   },
                   "outputArtifacts": [
                        An output artifact structure, if supported for the action category
                   ],
                   "configuration": {
                        Configuration details appropriate to the provider type
                   },
                   "runOrder": A positive integer that indicates the run order within the stage,
                }
            ]

有关适用于提供方类型的示例 configuration 详细信息的列表，请参阅按提供方类型列出的配置详细信息。

操作结构具有以下要求：

每个操作类型的输入和输出构件数量

根据操作类型，您可以具有以下数量的输入和输出项目：

PollForSourceChanges 参数的默认设置

PollForSourceChanges 参数默认值由用于创建管道的方法确定，如下表所述。许多情况下，PollForSourceChanges 参数默认为 true，并且必须被禁用。

当 PollForSourceChanges 参数默认为 true 时，应执行以下操作：

按提供方类型列出的配置详细信息

本节列出每个操作提供方的有效 configuration 参数。

以下示例为使用 Service Catalog 的部署操作显示了一个有效的配置，用于在控制台中创建的管道（没有单独的配置文件）：

"configuration": {
  "TemplateFilePath": "S3_template.json",
  "ProductVersionName": "devops S3 v2",
  "ProductType": "CLOUD_FORMATION_TEMPLATE",
  "ProductVersionDescription": "Product version description",
  "ProductId": "prod-example123456"
}

以下示例为使用 Service Catalog 的部署操作显示了一个有效的配置，用于在控制台中创建的管道（有单独的 sample_config.json 配置文件）：

"configuration": {
  "ConfigurationFilePath": "sample_config.json",
  "ProductId": "prod-example123456"
}

以下示例显示使用 Alexa Skills Kit 的部署操作的有效配置：

"configuration": {
  "ClientId": "amzn1.application-oa2-client.aadEXAMPLE",
  "ClientSecret": "****",
  "RefreshToken": "****",
  "SkillId": "amzn1.ask.skill.22649d8f-0451-4b4b-9ed9-bfb6cEXAMPLE"
}

以下示例显示手动审批的有效配置：

"configuration": {
  "CustomData": "Comments on the manual approval",
  "ExternalEntityLink": "http://my-url.com",
  "NotificationArn": "arn:aws:sns:us-west-2:12345EXAMPLE:Notification"
}