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

# 在 中規劃建置 AWS CodeBuild
<a name="planning"></a>

在使用之前 AWS CodeBuild，您必須回答下列問題：

1. **原始程式碼存放在哪裡？** CodeBuild 目前支援從下列來源碼儲存庫提供者建置 。原始程式碼必須包含建置規格 (Buildspec) 檔案。*buildspec* 是組建命令和相關設定的集合，採用 YAML 格式，可供 CodeBuild 用來執行組建。您可以在組建專案定義中宣告 buildspec。

     
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/codebuild/latest/userguide/planning.html)

1. **您需要執行哪些組建命令和依什麼順序執行？** 根據預設，CodeBuild 會從您指定的提供者下載建置輸入，並將建置輸出上傳至您指定的儲存貯體。您使用 buildspec 來指示如何將下載的組建輸入變成預期的組建輸出。如需更多資訊，請參閱[Buildspec 參考](build-spec-ref.md)。

1. **您執行組建需要哪些執行時間和工具？** 例如，您是為 Java、Ruby、Python 或 Node.js 而組建嗎？ 組建需要 Maven 或 Ant，還是 Java、Ruby 或 Python 的編譯器？ 建置是否需要 Git AWS CLI、 或其他工具？ 

   CodeBuild 會在使用 Docker 映像的建置環境中執行組建。這些 Docker 映像必須存放在 CodeBuild 支援的儲存庫類型中。其中包括 CodeBuild Docker 映像儲存庫、Docker Hub 和 Amazon Elastic Container Registry (Amazon ECR)。如需 CodeBuild Docker 映像儲存庫的詳細資訊，請參閱 [CodeBuild 提供的 Docker 映像](build-env-ref-available.md)。

1. **您需要非 CodeBuild 自動提供 AWS 的資源嗎？ 如果是這樣，這些資源需要哪些安全政策？** 例如，您可能需要修改 CodeBuild 服務角色，以允許 CodeBuild 使用這些資源。

1. **您希望 CodeBuild 使用您的 VPC 嗎？** 若是如此，您需要有 VPC 組態的 VPC ID、子網路 ID 和安全群組 ID。如需詳細資訊，請參閱[AWS CodeBuild 搭配 Amazon Virtual Private Cloud 使用](vpc-support.md)。

回答這些問題之後，您應該就具備成功執行組建所需的設定和資源。若要執行組建，您可以：
+ 使用 AWS CodeBuild 主控台 AWS CLI，或 AWS SDKs。如需詳細資訊，請參閱[手動執行組建](run-build.md)。
+ 在 中建立或識別管道 AWS CodePipeline，然後新增組建或測試動作，指示 CodeBuild 自動測試您的程式碼、執行組建或兩者。如需詳細資訊，請參閱[搭配 CodePipeline 使用 CodeBuild CodePipeline](how-to-create-pipeline.md)。