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

# CodePipeline 管道結構參考
<a name="reference-pipeline-structure"></a>

您可以使用 CodePipeline 建構自動化步驟的 CI/CD 管道，完成建置、測試和部署應用程式原始碼的任務。此參考區段提供管道中 JSON 結構和參數的詳細資訊。如需描述管道使用方式的高階概念清單，請參閱 [CodePipeline 概念](concepts.md)。

 
+ 建立管道時，您可以選擇可用的來源動作和提供者，例如 S3 儲存貯體、CodeCommit 儲存庫、Bitbucket 儲存庫或 GitHub 儲存庫，其中包含您的原始程式碼，並在您遞交原始程式碼變更時啟動管道。此參考區段提供管道可用來源的參考資訊。如需如何使用來源動作的詳細資訊，請參閱 [在 CodePipeline 中啟動管道](pipelines-about-starting.md)。
+ 您可以選擇在管道執行時自動包含的測試、建置和部署動作和提供者。此參考區段提供有關可用動作及其如何符合管道 JSON 的參考資訊。
+ 您完成的管道將包含一個來源階段，以及您設定動作以部署和測試應用程式的其他階段。如需部署應用程式的 DevOps 管道概念範例，請參閱 [DevOps 管道範例](concepts-devops-example.md)。

根據預設，您在 中成功建立的任何管道都 AWS CodePipeline 具有有效的結構。不過，如果您手動建立或編輯 JSON 檔案來建立管道或從 更新管道 AWS CLI，您可能會不小心建立無效的結構。下列參考可協助您更進一步了解管道結構的要求，以及如何對問題進行故障排除。請參閱 [AWS CodePipeline 中的配額](limits.md) 中的限制，這些限制適用於所有管道。

下列各節提供高階參數及其在管道結構中的位置。下列管道元件類型的管道結構需求會在每個區段中詳細說明：
+ 的欄位參考 [管道宣告](pipeline-requirements.md)
+ 的欄位參考 [階段宣告](stage-requirements.md)
+ 的欄位參考 [動作宣告](action-requirements.md)
+ [CodePipeline 中的有效動作提供者](actions-valid-providers.md) 依動作類型列出的
+ 的參考 [`PollForSourceChanges` 參數的有效設定](PollForSourceChanges-defaults.md)
+ 的參考 [每個動作類型的有效輸入和輸出成品](reference-action-artifacts.md)
+ 的連結清單 [每個提供者類型的有效組態參數](structure-configuration-examples.md)

如需詳細資訊，請參閱 *CodePipeline * API 指南中的 [PipelineDeclaration](https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_PipelineDeclaration.html) 物件。

下列範例管道主控台檢視顯示名為 new-github 的管道、名為 `Source`、 `manual`和 的階段`Build`，以及來自 GitHub （透過 GitHub 應用程式） 的動作、手動核准和 CodeBuild 動作提供者。

![\[CodePipeline 主控台中的管道檢視範例。\]](http://docs.aws.amazon.com/zh_tw/codepipeline/latest/userguide/images/pipeline-console-view.png)


在主控台圖表中檢視時，管道編輯模式可讓您編輯來源覆寫、觸發條件和動作，如下列範例所示。

![\[CodePipeline 主控台中的管道編輯模式範例。\]](http://docs.aws.amazon.com/zh_tw/codepipeline/latest/userguide/images/pipeline-console-view-edit.png)


**Topics**
+ [管道宣告](pipeline-requirements.md)
+ [階段宣告](stage-requirements.md)
+ [動作宣告](action-requirements.md)
+ [CodePipeline 中的有效動作提供者](actions-valid-providers.md)
+ [`PollForSourceChanges` 參數的有效設定](PollForSourceChanges-defaults.md)
+ [每個動作類型的有效輸入和輸出成品](reference-action-artifacts.md)
+ [每個提供者類型的有效組態參數](structure-configuration-examples.md)